1. 为什么要在 n8n 里接 Claude Code 做代码审查代码审查这件事最尴尬的地方在于写代码的速度已经被 AI 拉起来了但审代码还是人一行行看。我所在的团队月均 PR 数量在 300 上下靠人工盯评审人一到下午就明显走神漏掉的边界条件、硬编码密钥、N1 查询这类问题往往要等到上线后才被翻出来。n8n 是一个开源的低代码工作流引擎能把 Webhook、HTTP 请求、脚本执行、消息通知这些节点串成一条可视化流水线Claude Code 是运行在终端里的 AI 编程 Agent能读代码、跑命令、按提示词输出结构化结论。把两者拼起来就得到一条「PR 一提交 → 自动拉代码 → Claude Code 审查 → 结果回写 PR」的流水线。它适合有基本 DevOps 能力、月均 PR 在 200 以上、又不想把核心代码整包交给第三方 SaaS 的团队。真正卡住大多数人的不是 n8n 的拖拽而是 Claude Code 的接入配置settings.json 写在哪、config.toml 怎么填、API Key 怎么统一管理、n8n 节点里怎么把这两份配置喂进去。这篇就把这套骨架拆开给出一份可以直接复制的配置并用一次可复现的审查触发动作把流水线跑通。2. 前置准备用 TaoToken 统一 Key 与 API 通道Claude Code 默认走 Anthropic 官方通道但在 n8n 这种需要多节点、多环境复用的场景里把 Key 散落在每个节点的环境变量里非常难维护。更稳的做法是所有模型调用统一走一个 API 网关n8n 里只保留一份凭证。TaoToken 在这里扮演的就是这个统一通道的角色。它提供兼容 Anthropic 协议的 API 入口Claude Code 的 settings.json 和 config.toml 都支持自定义 base_url所以只要把地址指过去Key 换成 TaoToken 的 Key整条链路就能跑。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。你需要先拿到两样东西一是 API Key。登录后进入控制台在 API Keys 页面创建一个新 Key建议按环境命名比如n8n-review-prod方便后续轮换时定位。创建入口https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentn8n_claude_review 。二是确认模型名。Claude Code 的配置里要写具体的模型标识建议先在模型对话页面确认当前可用的模型名避免配置写完报 404。模型对话入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentn8n_claude_review 。注意Key 只创建一次复制后立刻存进 n8n 的 Credentials 或服务器的密钥管理里不要写进工作流 JSON 明文也不要在节点参数里硬编码。如果你后续要把这条流水线扩展到长期编码、Agent 常驻任务可以顺带看一下 Coding Plan 的额度说明避免审查高峰期被限流https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentn8n_claude_review 。3. 可复制配置settings.json 与 config.toml 骨架Claude Code 的配置分两层settings.json管权限、工具白名单、环境变量config.toml管模型通道和 base_url。两份文件都要指向 TaoToken才能保证 n8n 调用时走统一通道。3.1 settings.json 骨架这份文件放在 Claude Code 的工作目录下或者用户级配置目录。核心是把 API 基址和 Key 通过环境变量注入同时限制工具权限审查场景只需要只读能力。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: ${TAOTOKEN_API_KEY}, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [ Read, Grep, Glob ], deny: [ Write, Edit, Bash(rm:*), Bash(curl:*), Bash(env:*), Read(.env), Read(**/id_rsa), Read(**/*.pem) ] }, maxTurns: 20, timeout: 300 }这里有几个点值得展开。ANTHROPIC_BASE_URL指向 TaoToken 的 API 基址Claude Code 会把所有请求发到这里而不是官方域名。ANTHROPIC_API_KEY用${TAOTOKEN_API_KEY}占位实际值由 n8n 在执行节点时通过环境变量传入这样 Key 不会落盘到配置文件里。permissions.deny里我特意禁掉了Bash(env:*)和Read(.env)原因是审查 Agent 一旦能读环境变量就可能被恶意 PR 里的提示词诱导把密钥带进输出。审查场景只需要读代码不需要写文件、不需要跑 shell权限收到最小。3.2 config.toml 骨架config.toml负责模型通道的细节包括超时、重试、并发。放在 Claude Code 的配置目录下[api] base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY timeout_seconds 300 max_retries 2 [model] default claude-sonnet-4-20250514 review_deep claude-opus-4-20250514 [agent] max_turns 20 max_concurrent 2 queue_dedupe_window 300 [output] format markdown severity_levels [blocker, suggestion, optimization]api_key_env指定从哪个环境变量读 Key和 settings.json 里的占位保持一致。max_concurrent 2是并发上限防止多个 PR 同时触发时把通道打满。queue_dedupe_window 300表示同一个 PR 在 5 分钟内重复触发只审一次避免 webhook 重发导致重复消耗。3.3 n8n 节点参数n8n 里执行 Claude Code 有两种方式用社区节点或者用 Execute Command 节点直接调 CLI。前者更省事后者更可控。这里给 Execute Command 的配置因为它不依赖第三方节点包复现性最好。在 n8n 的 Execute Command 节点里命令这样写cd /workspace/repo \ TAOTOKEN_API_KEY{{$credentials.taotokenApiKey}} \ claude --config /etc/claude/config.toml \ --settings /etc/claude/settings.json \ --print \ 审查本次 PR 的变更按 blocker/suggestion/optimization 三级输出 Markdown只列关键发现{{$credentials.taotokenApiKey}}是 n8n 的凭证引用语法Key 存在 Credentials 里节点执行时注入为环境变量不会出现在工作流 JSON 中。--print让 Claude Code 输出纯文本结果方便后续节点解析。工作流整体节点顺序是Webhook 触发 → 解析 PR payload → git clone/checkout → Execute Command 调 Claude Code → 解析输出 → 回写 PR 评论。Webhook 节点监听merge_request或pull_request事件解析节点从 payload 里取仓库地址、PR 编号、源分支、目标分支。4. 验证请求一次可复现的审查触发配置写完先别急着接真实 PR。用一个本地仓库做一次最小验证确认通道通、配置生效、输出格式对。4.1 准备测试仓库mkdir -p /workspace/repo cd /workspace/repo git init cat UserService.java EOF public class UserService { public String findUser(String name) { String query SELECT * FROM users WHERE name name ; return query; } } EOF git add . git commit -m test: add user service这段代码故意留了一个字符串拼接 SQL 的问题用来验证审查 Agent 能不能识别。4.2 手动跑一次 Claude Code在 n8n 之外先手动验证配置排除通道问题export TAOTOKEN_API_KEY你的Key claude --config /etc/claude/config.toml \ --settings /etc/claude/settings.json \ --print \ 审查 UserService.java指出安全问题如果配置正确几秒到几十秒内会返回一段 Markdown里面应该包含 SQL 注入相关的提示。如果返回 401说明 Key 或 base_url 有问题如果返回 404说明模型名写错了回模型对话页面核对。4.3 在 n8n 里触发手动验证通过后在 n8n 里点 Execute Workflow用一条模拟 payload 触发{ object_kind: merge_request, project: { git_http_url: https://your-git/repo.git }, object_attributes: { iid: 42, source_branch: feature/test, target_branch: main } }预期结果是Execute Command 节点返回审查 Markdown解析节点把它拆成结构化数据回写节点在 PR 上生成一条评论。实测下来一个 20 文件以内的 PR从触发到回写完成大约 2 到 4 分钟其中大部分时间花在代码克隆和模型推理上。4.4 成功结果的判断标准一次成功的审查触发应该满足三个条件Execute Command 节点退出码为 0输出里包含至少一条按严重程度分级的发现回写节点返回 201 或 200。如果输出为空但退出码为 0通常是提示词太模糊Agent 没找到问题把提示词改具体一点再试。5. 本篇常见错排查5.1 报 401 Unauthorized最常见的原因是 Key 没注入成功。检查 n8n Credentials 里的字段名是否和节点里的{{$credentials.taotokenApiKey}}一致以及 settings.json 里的${TAOTOKEN_API_KEY}占位是否和实际环境变量名对得上。另一个可能是 Key 复制时带了空格重新复制一次。5.2 报 404 model not found模型名写错了。Claude Code 的配置里模型标识必须和通道支持的名称完全一致大小写、日期后缀都不能差。回模型对话页面确认当前可用模型名再改 config.toml 里的default字段。5.3 审查结果格式不稳定解析失败Claude Code 的输出每次可能略有差异尤其是提示词不够具体时。解决办法是在提示词里强制规定输出模板比如「每条发现必须包含文件路径、行号、严重级别、修复建议四个字段」并在 n8n 解析节点里加容错解析失败时降级为输出原始文本不要让整个工作流挂掉。5.4 并发触发时通道被限流多个 PR 同时提交时如果max_concurrent设得太大会触发通道限流。把 config.toml 里的max_concurrent降到 2并开启queue_dedupe_window让重复触发合并。如果团队 PR 量确实大考虑把审查任务排队而不是全部并行。5.5 Execute Command 节点找不到 claude 命令n8n 容器里没装 Claude Code CLI或者 PATH 没配。确认容器内which claude有输出没有的话在 Dockerfile 里补上安装步骤或者改用社区节点方式调用。另外注意 n8n 容器如果以非 root 用户运行要确保该用户对配置目录有读权限。5.6 审查结果里出现敏感信息如果输出里带了环境变量或密钥片段说明权限没收紧。检查 settings.json 的deny列表是否包含Bash(env:*)、Read(.env)、Read(**/*.pem)以及是否误开了Bash权限。审查场景永远只给只读工具。6. 把流水线稳定复用下去跑通一次不难难的是让它稳定复用。我的做法是把配置文件和 n8n 工作流都纳入版本管理settings.json 和 config.toml 放在仓库里Key 只存在 n8n Credentials 和服务器环境变量中。每次调整提示词或权限都走一次 PR 流程让配置变更本身也被审查。另一个经验是给审查结果加一个「置信度」字段让 Agent 自己标注哪些发现是确定的、哪些是推测的。这样评审人可以优先看高置信度的条目低置信度的当参考减少误报带来的干扰。实测下来加了置信度标注后团队对自动审查结果的采纳率明显提升。如果你要把这条流水线扩展到更多仓库建议按仓库类型分组核心服务用 Opus 做深度审查边缘服务用 Sonnet 做快速扫描通过 config.toml 里的review_deep和default两个模型字段切换。接入文档里有更细的通道参数说明配置卡住时可以对照排查https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentn8n_claude_review 。