Skip to content

环境检查

配置任何 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@latest
bash
npm install -g @openai/codex@latest
bash
npm install -g @google/gemini-cli@latest

国内网络下安装慢,可在命令末尾追加 --registry=https://registry.npmmirror.com 临时使用镜像源。

(3)验证安装并生成配置目录

运行对应命令:

bash
claude
bash
codex
bash
gemini

出现欢迎界面或输入提示,说明安装成功,可以退出(Ctrl + C)。

重要

首次运行会在用户目录下生成配置文件夹(如 ~/.claude~/.codex~/.gemini),这是后续配置的基础,请务必执行此步骤!

下一步

环境就绪后,继续配置工具接入 AI HUB API:

遇到问题?