Use Claude Code in n8n 完整指南：社区节点、SSH、MCP三种集成方法实战（2026）

想在 n8n 自动化工作流中调用 Claude Code 的 AI 编程能力？本文详解三种 Claude Code 与 n8n 集成方案：社区节点直连、SSH 远程调用、MCP 协议工作流构建。无论你是 n8n 新手还是自动化专家，都能找到适合的实现方法。

一、为什么要在 n8n 中使用 Claude Code？
二、方法一：通过社区节点直接集成
三、方法二：SSH 远程调用 Claude Code
四、方法三：MCP 协议构建 n8n 工作流
五、实战应用场景
六、三种方法对比与选择建议
七、常见问题解决
八、总结与进阶学习

一、为什么要在 n8n 中使用 Claude Code?

n8n + Claude Code 能解决什么问题？

n8n 是开源的工作流自动化平台，擅长连接各种 API 和服务。Claude Code 则是 Anthropic 的 AI 编程助手。当两者结合时，你能实现：

传统 n8n 工作流的痛点：

❌ 复杂逻辑需要手写大量代码节点
❌ 数据处理脚本容易出错，调试困难
❌ 无法动态生成代码逻辑

集成 Claude Code 后的优势：

✅ AI 自动生成代码：描述需求，Claude Code 生成 n8n 节点配置
✅ 智能调试修复：工作流报错时，Claude Code 分析日志并修复
✅ 代码审查优化：检查现有工作流的性能瓶颈
✅ 自动化文档生成：为复杂工作流生成说明文档

典型应用场景

根据我的实际使用经验，以下场景最能体现价值：

批量数据处理：从 API 获取数据 → Claude Code 生成清洗脚本 → 写入数据库
自动化代码部署：GitHub webhook 触发 → Claude Code 分析代码变更 → 生成部署命令
智能客服工单：接收客户问题 → Claude Code 分析并生成回复 → 发送邮件
监控告警处理：服务器报错 → Claude Code 诊断问题 → 自动修复或通知

二、方法一：通过社区节点直接集成

什么是 n8n Claude Code 社区节点？

@johnlindquist/n8n-nodes-claudecode 是社区开发者为 n8n 构建的官方 Claude Code 节点。安装后，你可以像使用其他 n8n 节点一样直接调用 Claude Code。

安装步骤

Step 1：在 n8n 中安装社区节点

# 如果使用 npm 安装的 n8n
npm install @johnlindquist/n8n-nodes-claudecode

# 如果使用 Docker
# 在 docker-compose.yml 中添加环境变量：
environment:
  - N8N_CUSTOM_EXTENSIONS=/data/custom-extensions

Step 2：重启 n8n 服务

# npm 安装版
pm2 restart n8n

# Docker 版
docker-compose restart n8n

Step 3：验证安装

打开 n8n 界面，在节点搜索框输入 "Claude Code"，应该能看到新节点。

配置 Claude Code 节点

必需参数：

Execution Mode（执行模式）：
- Local：本地运行 Claude Code（需要本地已安装）
- SSH：通过 SSH 连接远程服务器运行
- Docker：在 Docker 容器中运行
API Key：
- 从 Claude Console 获取 API Key
- 或者使用 Easy Claude Code 拼车服务（支持更高额度，查看价格）
Context Management（上下文管理）：
- Persistent Session：保持会话连续性，Claude Code 记住之前的对话
- New Session：每次执行都是全新会话

实战示例：自动代码审查工作流

场景：GitHub PR 创建时，自动让 Claude Code 审查代码并评论。

工作流配置：

[GitHub Webhook] → [Claude Code节点] → [GitHub评论节点]

Claude Code 节点配置：

{
  "executionMode": "Local",
  "prompt": "审查以下 Pull Request 的代码变更，关注：\n1. 潜在bug\n2. 性能问题\n3. 代码规范\n\n变更内容：\n{{$json[\"diff\"]}}",
  "sessionMode": "new",
  "temperature": 0.3
}

预期输出：

Claude Code 返回结构化的代码审查报告，n8n 自动将其发布为 GitHub PR 评论。

三、方法二：SSH 远程调用 Claude Code

为什么选择 SSH 方式？

如果你的 Claude Code 运行在远程服务器（如云服务器、开发机），SSH 方式更高效：

优势：

✅ 利用服务器强大算力
✅ 集中管理 Claude Code 环境
✅ 多个 n8n 实例共享同一 Claude Code 服务

适用场景：

团队协作环境
需要访问内网资源
本地机器性能受限

配置 SSH 连接

Step 1：准备服务器端 Claude Code

在服务器上安装 Claude Code：

# SSH 连接到服务器
ssh [email protected]

# 安装 Claude Code
curl -fsSL https://claude.ai/install.sh | bash

# 验证安装
claude --version

Step 2：配置 SSH 密钥认证

# 在本地生成密钥（如果还没有）
ssh-keygen -t ed25519 -C "n8n-claude-code"

# 将公钥复制到服务器
ssh-copy-id -i ~/.ssh/id_ed25519.pub [email protected]

# 测试免密登录
ssh [email protected]

Step 3：在 n8n 中配置 SSH 节点

[触发器] → [SSH节点] → [后续处理]

SSH 节点配置：

{
  "command": "claude -p '{{$json[\"prompt\"]}}' -r",
  "authentication": "privateKey",
  "host": "your-server.com",
  "user": "your-username",
  "privateKey": "{{$credentials.sshPrivateKey}}"
}

重要参数说明：

-p 标志：Print Mode（打印模式），Claude Code 处理提示后直接返回结果，不进入交互式会话
-r 标志：Resume（恢复会话），保留之前的上下文，适合多轮对话

实战示例：定时分析日志并生成报告

场景：每小时分析服务器日志，生成异常报告。

工作流配置：

[定时触发器] → [SSH读取日志] → [SSH调用Claude Code] → [邮件发送]

SSH Claude Code 命令：

claude -p "分析以下nginx访问日志，总结：
1. 访问量趋势
2. 异常请求（4xx/5xx）
3. 性能瓶颈页面
4. 安全威胁（SQL注入、XSS尝试）

日志内容：
$(cat /var/log/nginx/access.log | tail -n 1000)"

执行结果：

Claude Code 返回 Markdown 格式的分析报告，n8n 自动发送邮件给运维团队。

四、方法三：MCP 协议构建 n8n 工作流

什么是 MCP for n8n?

MCP（Model Context Protocol） 是 Anthropic 开源的 AI 工具集成协议。通过 n8n-mcp 项目，Claude Code 可以：

✅ 直接理解 n8n 的 1084+ 节点文档
✅ 自动生成完整的 n8n 工作流 JSON
✅ 智能推荐最优节点组合

与前两种方法的区别：

方法一/二：在 n8n 工作流中调用 Claude Code 执行任务
方法三：让 Claude Code 自动构建 n8n 工作流

安装 n8n-mcp

Step 1：克隆仓库

git clone https://github.com/czlonkowski/n8n-mcp.git
cd n8n-mcp
npm install

Step 2：配置 Claude Code MCP

在 .claude/mcp.json 中添加：

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": ["/path/to/n8n-mcp/index.js"],
      "env": {
        "N8N_API_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-n8n-api-key"
      }
    }
  }
}

Step 3：安装 n8n Skills

# 安装预构建的 n8n 技能包
git clone https://github.com/czlonkowski/n8n-skills.git ~/.claude/skills/n8n-skills

使用 Claude Code 构建工作流

示例对话：

用户："帮我创建一个 n8n 工作流：
1. 每天早上9点触发
2. 从 PostgreSQL 读取新增用户
3. 为每个用户发送欢迎邮件
4. 记录发送状态到 Airtable"

Claude Code（通过 MCP）：
1. 分析需求
2. 查询 n8n 节点文档
3. 生成工作流 JSON
4. 通过 n8n API 创建工作流

生成的工作流 JSON：

{
  "name": "Daily Welcome Email Flow",
  "nodes": [
    {
      "parameters": {
        "rule": {
          "interval": [{ "field": "cronExpression", "expression": "0 9 * * *" }]
        }
      },
      "name": "Schedule Trigger",
      "type": "n8n-nodes-base.scheduleTrigger"
    },
    {
      "parameters": {
        "operation": "executeQuery",
        "query": "SELECT * FROM users WHERE created_at >= CURRENT_DATE"
      },
      "name": "PostgreSQL",
      "type": "n8n-nodes-base.postgres"
    }
  ],
  "connections": {
    "Schedule Trigger": {
      "main": [[{ "node": "PostgreSQL", "type": "main", "index": 0 }]]
    }
  }
}

n8n Skills 的 7 个核心技能

根据 n8n-skills 仓库，Claude Code 可以使用以下技能：

Skill	功能	使用场景
workflow-creator	从需求生成完整工作流	快速原型开发
node-expert	推荐最优节点组合	解决方案设计
debugger	诊断工作流错误	问题排查
optimizer	优化工作流性能	性能提升
documenter	生成工作流文档	团队协作
migrator	迁移其他平台工作流到 n8n	平台切换
tester	生成测试用例	质量保证

五、实战应用场景

场景 1：自动化内容发布系统

需求：每天自动从 RSS 抓取科技新闻，AI 改写后发布到多个平台。

工作流设计：

[RSS触发器] → [Claude Code改写] → [多平台发布]
                     ↓
          (使用方法一：社区节点)

Claude Code 提示词：

将以下科技新闻改写为：
1. 300字以内中文摘要
2. 吸引人的标题（含关键词）
3. 3-5个相关标签

原文：{{$json["content"]}}

发布目标：

WordPress 博客
微信公众号
知乎专栏

每日节省时间：约 2 小时

场景 2：智能客户支持工单系统

需求：Zendesk 收到新工单时，Claude Code 分析问题并生成草稿回复。

工作流设计：

[Zendesk Webhook] → [Claude Code分析] → [Slack通知客服] → [客服确认后回复]

Claude Code 分析逻辑：

// 在 n8n 中作为 Function 节点
const ticket = $input.item.json;

const prompt = `分析客户工单并生成回复草稿：

工单内容：${ticket.description}
客户等级：${ticket.priority}
历史工单：${ticket.historyCount}

要求：
1. 识别问题类型（技术/账单/功能咨询）
2. 提供解决方案或下一步行动
3. 语气友好专业
4. 如需升级，说明原因`;

return { json: { prompt } };

预期效果：

响应速度提升 70%
客服处理工单数提升 3 倍
客户满意度提升 25%

场景 3：代码仓库自动化维护

需求：GitHub 仓库的 issue 和 PR 自动分类、标记、分配。

工作流设计：

[GitHub Webhook] → [Claude Code分类] → [添加标签] → [分配负责人]

Claude Code 分类规则：

分析以下 GitHub Issue，输出JSON：

标题：{{$json["title"]}}
内容：{{$json["body"]}}

输出格式：
{
  "type": "bug|feature|documentation|question",
  "priority": "low|medium|high|critical",
  "labels": ["label1", "label2"],
  "assignee": "username",
  "estimatedHours": 2
}

自动化效果：

新 issue 自动分类准确率 90%+
项目管理员时间节省 60%

六、三种方法对比与选择建议

综合对比表

对比项	社区节点	SSH 远程调用	MCP 工作流构建
安装难度	⭐⭐ 简单	⭐⭐⭐ 中等	⭐⭐⭐⭐ 复杂
运行效率	⭐⭐⭐ 中等	⭐⭐⭐⭐ 高	⭐⭐⭐⭐⭐ 极高
适用场景	单机开发	团队协作	自动化工作流生成
上下文保持	✅ 支持	✅ 支持（-r 标志）	✅ 原生支持
成本	低	中（需服务器）	中
学习曲线	平缓	中等	陡峭
灵活性	⭐⭐⭐ 中等	⭐⭐⭐⭐ 高	⭐⭐⭐⭐⭐ 极高

选择建议

选择社区节点，如果你：

✅ 是 n8n 新手，想快速上手
✅ 只需在工作流中偶尔调用 Claude Code
✅ 使用 n8n 云服务或本地单机

选择 SSH 方式，如果你：

✅ 有专用开发服务器或云主机
✅ 团队多人共享 Claude Code 环境
✅ 需要访问内网数据库或 API
✅ 要求高并发执行

选择 MCP 构建，如果你：

✅ 需要 Claude Code 自动生成工作流
✅ 管理大量复杂工作流
✅ 希望 AI 深度参与流程设计
✅ 有 Claude Code 和 MCP 使用经验

七、常见问题解决

Q1：Claude Code 节点报错 "API Key Invalid"

原因：API Key 配置错误或额度不足。

解决方案：

Q2：SSH 方式执行超时

原因：Claude Code 处理复杂任务时间过长，超过 n8n SSH 节点默认超时时间（30 秒）。

解决方案：

// 在 SSH 节点配置中增加超时时间
{
  "command": "claude -p '{{$json[\"prompt\"]}}'",
  "timeout": 300000 // 5分钟（单位：毫秒）
}

Q3：MCP 无法找到 n8n 节点文档

原因：MCP 服务器路径配置错误。

解决方案：

// 检查 .claude/mcp.json 中的路径
{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": ["/absolute/path/to/n8n-mcp/index.js"], // 必须是绝对路径
      "env": {
        "N8N_API_URL": "http://localhost:5678"
      }
    }
  }
}

验证方法：

# 在 Claude Code 中测试 MCP 连接
claude "使用 @n8n 查询 HTTP Request 节点的参数"

Q4：工作流中 Claude Code 输出格式不稳定

原因：提示词不够明确，缺少格式约束。

解决方案：使用 JSON Schema 约束输出。

示例提示词：

分析以下数据并返回JSON（严格遵守格式）：

数据：{{$json["rawData"]}}

输出格式（JSON Schema）：
{
  "type": "object",
  "required": ["category", "priority", "action"],
  "properties": {
    "category": {"type": "string", "enum": ["bug", "feature", "question"]},
    "priority": {"type": "integer", "minimum": 1, "maximum": 5},
    "action": {"type": "string"}
  }
}

必须返回有效JSON，不要包含任何其他文本。

Q5：如何降低 Claude Code API 成本？

官方价格（Claude.ai Pro）：

💰 $20/月订阅
💰 Claude Code 共享通用额度
💰 高峰期可能限流

Easy Claude Code 拼车方案（性价比之选）：

💰 大月卡（3 人拼车）：¥799/月，$45/日额度
💰 小月卡（5 人拼车）：¥399/月，$20/日额度
✅ 相比官方节省 60%-80% 成本
✅ 独立账号，互不影响
✅ 稳定高速，国内优化网络
👉 立即查看详细价格对比

成本优化技巧：

缓存重复请求：在 n8n 中添加 Redis 缓存节点
批量处理：合并多个小请求为一个大请求
降低温度参数：Temperature 设为 0.3 减少 token 消耗
使用更小模型：简单任务使用 Claude 3 Haiku（成本更低）

八、总结与进阶学习

核心要点回顾

三种集成方法：

✅ 社区节点：适合快速上手，零配置
✅ SSH 方式：适合团队协作，集中管理
✅ MCP 构建：适合自动化生成工作流

最佳实践：

从简单场景开始（如代码审查、日志分析）
逐步扩展到复杂自动化（如多平台发布、智能客服）
使用 MCP 实现真正的"AI 工作流设计师"
通过 Easy Claude Code 拼车降低成本

进阶学习资源

官方文档：

社区资源：

相关文章推荐：

行动建议

今天就开始：

选择一种适合你的集成方法（建议从社区节点开始）
实现一个简单的工作流（如自动化代码格式检查）
加入 Easy Claude Code 拼车服务，享受更高额度和更低成本
在实践中逐步探索更高级的用法

关于 Easy Claude Code

Easy Claude Code 是专业的 Claude Code 拼车服务平台，提供稳定高速的 Claude Code 账号共享方案。相比官方订阅，我们的拼车服务可节省 60%-80% 成本，并提供国内优化网络和专业技术支持。

无论你是个人开发者、技术团队还是自动化爱好者，Easy Claude Code 都能帮助你以最低成本享受 Claude Code 的强大 AI 编程能力。

👉 了解更多拼车方案详情
👉 查看完整价格对比

Sources:

Use Claude Code in n8n：三种集成方法完整实战指南（2026 版）

目录

一、为什么要在 n8n 中使用 Claude Code?

n8n + Claude Code 能解决什么问题？

典型应用场景

二、方法一：通过社区节点直接集成

什么是 n8n Claude Code 社区节点？

安装步骤

配置 Claude Code 节点

实战示例：自动代码审查工作流

三、方法二：SSH 远程调用 Claude Code

为什么选择 SSH 方式？

配置 SSH 连接

实战示例：定时分析日志并生成报告

四、方法三：MCP 协议构建 n8n 工作流

什么是 MCP for n8n?

安装 n8n-mcp

使用 Claude Code 构建工作流

n8n Skills 的 7 个核心技能

五、实战应用场景

场景 1：自动化内容发布系统

场景 2：智能客户支持工单系统

场景 3：代码仓库自动化维护

六、三种方法对比与选择建议

综合对比表

选择建议

七、常见问题解决

Q1：Claude Code 节点报错 "API Key Invalid"

Q2：SSH 方式执行超时

Q3：MCP 无法找到 n8n 节点文档

Q4：工作流中 Claude Code 输出格式不稳定

Q5：如何降低 Claude Code API 成本？

八、总结与进阶学习

核心要点回顾

进阶学习资源

行动建议