1. 先把环境跑通Node.js、npm 与 Claude Code 的关系Claude Code 是 Anthropic 推出的命令行 AI 编程工具它不是一个网页聊天框而是直接跑在你终端里的编码助手能读项目文件、改代码、执行命令、跑测试。它适合已经会用命令行、想让 AI 真正落到本地工程里的开发者。而 Agent teams 是它更进一步的玩法——让多个子智能体分工协作一个负责查资料、一个负责改代码、一个负责验证主智能体做调度。skill 则是把常用流程固化成可复用的能力模块。但这一切的前提是你本地得先有一个像样的 Node.js 运行环境。Claude Code 通过 npm 分发没有 Node.js 和 npm后面所有配置都无从谈起。我见过太多人卡在第一步claude: command not found其实不是工具的问题是环境没装对。这篇就按“装环境 → 配 Key/API 通道 → 写 settings.json → 启用 skill 与 Agent teams → 逐步验证”的顺序把整条链路走一遍。你跟着做最后能在本地跑通多智能体协作。需要说明的是Claude Code 默认走官方通道国内网络直连往往不稳定。所以本文会用统一的 Key/API 通道来承接模型请求把ANTHROPIC_BASE_URL指向一个可用的网关地址这样模型调用就稳定了。下面所有配置都以这个思路展开。2. 前置准备Node.js 18 与 npm 的安装Claude Code 要求 Node.js v18 及以上。低于这个版本安装过程可能报错或者运行起来行为异常。推荐用 nvm 管理 Node 版本切换方便也不会污染系统自带的 Node。Linux 或 macOS 下先装 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc如果你用的是 Zsh把最后一行换成source ~/.zshrc。装完 nvm 后安装并切换到 Node 18nvm install 18 nvm use 18 node -v npm -vnode -v应该输出v18.x.xnpm -v输出对应的 npm 版本号。两个命令都有正常输出说明环境就绪。Windows 用户建议先在 WSL 里操作也就是在 Windows 内跑一个 Linux 子系统这样命令和本文完全一致省去路径和权限的麻烦。装好 WSL 后在 WSL 终端里重复上面的 nvm 步骤即可。环境确认无误后全局安装 Claude Codenpm install -g anthropic-ai/claude-code安装完成后执行claude --version能打印出版本号就说明命令已经可用。此时你在任意路径下都能调用claude不用进到某个特定目录。注意如果npm install -g报权限错误不要直接加sudo硬装优先检查 npm 的全局目录权限或者用 nvm 管理的 Node它天然避开了系统目录权限问题。3. 统一 Key/API 通道settings.json 骨架与获取 KeyClaude Code 的模型请求靠环境变量驱动核心是两个ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL。前者是你的密钥后者指向请求要发往的网关地址。把这两个配对模型调用就能走通。Key 的获取如果你在公司一般按内部流程申请即可个人开发者可以到 TaoToken 的控制台创建。拿到 Key 后先别急着写死到代码里而是放进 Claude Code 的配置文件。配置文件有两个层级项目级和全局级。项目级放在项目根目录的.claude/settings.json或.claude/settings.local.json只对当前项目生效全局级放在~/.claude/settings.json对所有项目生效。我一般把通用配置放全局项目特有的放项目级。全局配置可以直接编辑vim ~/.claude/settings.json写入下面这份骨架把sk-***换成你自己的 Key把ANTHROPIC_BASE_URL换成你的网关地址{ env: { ANTHROPIC_AUTH_TOKEN: sk-***, ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_SMALL_FAST_MODEL: gemini-2.5-flash, CLAUDE_CODE_MAX_OUTPUT_TOKENS: 64000, ANTHROPIC_MODEL: claude-sonnet-4.5 }, permissions: { allow: [ Fetch(domain:*), WebFetch(domain:*), Bash(pnpm:*), Bash(pnpm test:*) ] }, model: qwen3-coder-plus }几个字段的作用值得说清楚。ANTHROPIC_BASE_URL决定请求发往哪里指向统一网关后模型调用不再依赖直连。ANTHROPIC_SMALL_FAST_MODEL是处理轻量任务的小模型用来做快速判断省成本也提速。CLAUDE_CODE_MAX_OUTPUT_TOKENS控制单次输出上限写大文件或长代码时调大更稳。permissions.allow是白名单允许 Claude Code 执行哪些操作比如抓取网页、跑 pnpm 命令避免每次都被拦下来问一遍。提示ANTHROPIC_AUTH_TOKEN属于敏感信息别提交到 Git。项目级配置建议用settings.local.json并加进.gitignore。配置写完后首次运行需要显式带上 Key 启动一次让 Claude Code 完成初始化ANTHROPIC_AUTH_TOKENsk-*** claude这次启动会走一遍引导流程没有特殊要求的话按三次回车接受默认项即可。初始化完成后之后在任意路径直接执行claude就能用不用再手动赋值。4. skill 目录结构与 Agent teams 初始化skill 的本质是把一段可复用的工作流固化下来让 Claude Code 在需要时自动调用。它的目录结构很直观放在.claude/skills/下每个 skill 一个文件夹里面放一个SKILL.md描述这个 skill 做什么、什么时候触发、怎么执行。一个典型的 skill 目录长这样.claude/ └── skills/ └── code-review/ └── SKILL.mdSKILL.md里用自然语言写清楚触发条件和步骤比如“当用户要求审查代码时先读 diff再按安全、性能、可读性三个维度输出问题清单”。Claude Code 会根据描述判断是否启用这个 skill。你可以把团队里反复出现的流程——提交规范检查、接口文档生成、测试用例补全——都沉淀成 skill越用越顺手。Agent teams 的启用更简单先在settings.json里加一行开关{ env: { CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: 1 } }保存后重新启动claude在会话里输入启动Agent teamsClaude Code 会列出可选的成员角色你选中几个成员确认后 teams 就启动了。运行过程中终端会实时显示每个成员的工作状态谁在查资料、谁在改代码、谁在验证一目了然。主智能体负责拆解任务并分派子智能体各自推进适合那种一个人做起来容易顾此失彼的复杂需求。注意Agent teams 目前是实验特性行为可能随版本变化。建议先在非关键项目里试跑确认协作效果符合预期后再用到正式工程。5. 验证请求从单次调用到多智能体协作配置写完不算完得实际验证。第一步确认基础调用能通。在任意项目目录下执行claude进入交互后输入一句简单指令比如“读一下当前目录的 package.json告诉我项目名和依赖数量”。如果它能正确读取文件并回答说明 Key、网关、模型三者已经打通。第二步验证 skill 是否被识别。在会话里输入/skills或按提示查看可用 skill 列表确认你放在.claude/skills/下的 skill 出现在列表里。如果没出现检查目录层级和SKILL.md文件名是否拼写正确。第三步验证 Agent teams。启动 teams 后给它一个需要分工的任务比如“检查这个项目的测试覆盖率找出没有测试覆盖的核心模块并给出补测建议”。观察终端里各成员的状态流转应该能看到有成员在读文件、有成员在分析、有成员在汇总。任务完成后主智能体会给出整合结果。如果三步都通过说明整条链路——Node.js 环境、统一 Key/API 通道、settings.json、skill、Agent teams——已经全部跑通。这时候你再去处理真实项目效率会有明显提升。6. 常见报错排查命令找不到、Key 无效、teams 不启动claude: command not found多半是 npm 全局目录没进 PATH。先确认npm bin -g的输出路径在不在 PATH 里。用 nvm 的话重新nvm use 18再试。别急着sudo npm install -g那会把权限搞乱。401或invalid api key检查ANTHROPIC_AUTH_TOKEN是否写对有没有多余空格或换行。确认ANTHROPIC_BASE_URL指向的网关地址正确末尾不要多加斜杠。改完配置后重启claude让环境变量重新加载。模型名报错ANTHROPIC_MODEL和model字段要填网关支持的模型名。填了不存在的模型请求会被拒。先确认你的通道支持哪些模型再对应填写。Agent teams 不启动确认CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS设为1且是字符串不是数字。改完必须重启会话。如果仍不生效检查 Claude Code 版本是否支持该实验特性必要时升级到最新版。skill 不触发SKILL.md里的描述要足够明确写清楚“什么时候用”。描述太模糊Claude Code 判断不出该不该调用。把触发条件写具体比如“当用户提到生成接口文档时”。执行中途自动退出需求给得太多太杂时Claude Code 可能中途退出。把大需求拆成小步骤一次让它做一件事。另外改代码前先用 git 提交一个版本比如标记ss-0.0.1万一改坏了能回退。我踩过的坑就是连续几小时改不好一个问题越改越乱最后靠版本回退才救回来。7. 下一步把通道配好再谈协作环境、Key、配置、skill、Agent teams这条链路里最容易出问题的其实是中间那层——模型请求的通道。通道不稳后面再花哨的协作都跑不起来。所以建议你先把ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN配对验证通过确认单次调用稳定再去折腾 skill 和 teams。Key 的创建和管理在控制台完成接入细节可以对照接入文档逐项核对。如果你更想先感受模型本身的能力可以直接在模型对话里试几轮确认响应质量符合预期。而如果你打算长期用 Claude Code 做编码和 Agent 协作Coding Plan 会更适合额度和模型调度都更省心。把通道这层打牢后面的多智能体协作才真正跑得顺。