跳至主要內容

通用配置步骤

GoodCode2026/7/8大约 2 分钟

Node.js 检查

在 Windows 或 macOS 中打开终端，先确认 Node.js 和 npm 是否可用：

node -v
npm -v

如果能看到版本号（例如 v22.x.x），说明环境已准备好。如果提示命令不存在，请先安装 Node.js LTS 版本：

  • Node.js 下载地址：https://nodejs.org/en/download
  • Windows 安装后如果终端仍识别不到 node，请关闭终端重新打开
  • macOS 用户也可以通过 Homebrew 安装：brew install node

CLI 安装

打开终端，按需安装你要使用的 CLI。也可以一次性安装全部工具：

npm i -g @anthropic-ai/claude-code@latest
npm i -g @openai/codex@latest
npm i -g @google/gemini-cli@latest

安装完成后，执行版本检查：

claude --version
codex --version
gemini --version

只要对应命令能输出版本号，说明 CLI 已经安装成功。后续配置 API Key 时，请继续阅读 CLI 配置 章节。

启动检查

分别运行下面的命令，确认每个客户端都能正常启动：

claude
codex
gemini

首次启动时可能会提示登录、配置 API Key 或选择模型。这里只做启动检查：看到交互界面或登录提示就说明本地 CLI 本身没有问题，可以直接退出，接下来再按对应客户端文档接入 GoodCode 网关。不要在这一步先完成官方账号登录，避免后续排查时混淆官方配置和 GoodCode 配置。

提示

如果只打算使用其中一个客户端，只需要安装和测试对应的 CLI。例如只用 Codex，就安装 @openai/codex 并运行 codex --version 即可。

常见问题

Claude Code 提示缺少 Git

如果 Claude Code 提示缺少 Git 环境，请先安装 Git：

安装完成后重新打开终端，再运行：

git --version
claude --version

两个命令都能输出版本号后，再继续配置 Claude Code。

最近更新: