Appearance
环境检查
配置任何 CLI 工具前,先花两分钟确认本机环境就绪:终端里能跑通 node 和你要用的 CLI 命令。配置报错时,先回到这一页排除环境问题,再去查配置。
(1)确认 Node.js 已安装
打开终端,运行:
bash
node --version
npm --version能显示版本号即可(建议 Node.js 20+,用 Codex 需要 22+)。
提示「命令未找到」说明未安装 Node.js,请参考 code cli 客户端下载 安装后再继续。
(2)安装 CLI 工具
按你要用的工具选择安装(可只装其中一个):
bash
npm install -g @anthropic-ai/claude-code@latestbash
npm install -g @openai/codex@latestbash
npm install -g @google/gemini-cli@latest国内网络下安装慢,可在命令末尾追加 --registry=https://registry.npmmirror.com 临时使用镜像源。
(3)验证安装并生成配置目录
运行对应命令:
bash
claudebash
codexbash
gemini出现欢迎界面或输入提示,说明安装成功,可以退出(Ctrl + C)。
重要
首次运行会在用户目录下生成配置文件夹(如
~/.claude、~/.codex、~/.gemini),这是后续配置的基础,请务必执行此步骤!
下一步
环境就绪后,继续配置工具接入 AI HUB API:
- (3)配置 CLI 工具(手动配置,进阶用户)
- (4)CC-Switch 可视化配置(不熟悉命令行推荐)
遇到问题?
- 安装或运行报错,先看 CLI 配置教程的常见问题
- 仍未解决,前往 控制台 联系客服