先确认本机有 Node.js,再安装客户端
AIGoCode 的 Claude Code 和 Codex CLI 接入文档都把 Node.js 放在安装前提里。Claude Code 文档给出的安装命令是 npm install -g @anthropic-ai/claude-code,Codex 文档给出的命令是 npm install -g @openai/codex@latest;两边都要求先确认本机有 Node.js。
这一步看起来基础,却能把“工具还没安装”和“工具已安装但接入失败”分开。先在终端确认 Node.js 可用,再安装你实际要使用的客户端,不要同时安装两个客户端后再猜是哪一个配置出错。
按实际工具选择对应安装与版本检查
如果使用 Claude Code,安装后运行 claude --version;如果使用 Codex CLI,安装后运行 codex --version。版本命令的作用是确认本机确实找到了对应可执行文件,不能证明 AIGoCode 供应商或 API Key 已经启用。
安装、版本检查和供应商启用是三个不同检查点:
| 检查点 | 能确认什么 | 不能确认什么 |
|---|---|---|
| npm 安装命令完成 | 客户端安装过程结束 | 当前供应商和 Key 已选中 |
--version 有输出 | 本机能找到客户端 | 网络、认证和模型可用 |
| CC Switch 中启用 AIGoCode | 当前页面选择了供应商 | 当前项目已经成功回复 |
按这个顺序记录结果,后面排查错误时不会把本机安装问题误认为服务端问题。
再完成供应商导入和启用
Claude Code 和 Codex CLI 文档都推荐通过 CC Switch 接入 AIGoCode:从对应 API Key 右侧打开 CC Switch,完成一键导入,再回到相应工具页面启用 AIGoCode 供应商。Claude Code 使用 Claude Code(企业)分组,Codex CLI 使用 Codex Pro 分组;不要用工具名称相反的分组来做判断。
如果一键导入未完成,文档也分别提供了手动配置入口。手动配置时建议保留客户端版本、当前供应商和错误信息,先只修正一个配置项。
最后在项目目录做最小验证
安装和启用完成后,分别进入代码项目目录运行 claude 或 codex。两份文档都把“能正常读取项目并回复”作为基本接入验证。
这次验证仍有边界:它只确认当前工具、项目和供应商能完成一次基本交互。遇到 401、403 或 429,按错误码继续排查;如果提示模型不可用,先核对模型名称列表,再检查 API Key 和 Base URL。不要因为 --version 有输出,就跳过这一步。
本站的Codex 接入 GitHub 后如何做高信号 Review介绍的是工具接通后的协作边界;本文只负责把安装、版本、启用和项目验证这条接入前检查链路排清楚。