CLI 手动配置
环境检查
配置任何 CLI 之前先确认基础环境到位
无论你最终用 Claude Code、Codex 还是 Gemini,都需要先把 Node.js 和对应的 CLI 装好。这一页帮你跑完前置检查。
1. 检查 Node.js
在终端执行:
node -v
npm -v正常情况下两条命令都会输出版本号(Node.js 建议 18 及以上)。如果提示「命令未找到」或类似错误,说明 Node.js 没装好,请先去 Node.js 官网 下载 LTS 版本安装。
2. 安装 CLI
直接一条龙装齐:
npm i -g @anthropic-ai/claude-code@latest
npm i -g @openai/codex@latest只用其中某一个的话,按需安装即可,不用全装。
Windows 用户:如果上面命令报权限错误,请用「以管理员身份运行」打开 PowerShell / CMD 再执行。
3. 首次运行(生成配置目录)
这一步非常关键,不跑这一步后续要编辑的配置文件不会被自动生成。
claude出现交互界面或登录提示就说明安装成功,按 Ctrl+C 退出。此时 ~/.claude/ 目录已经被创建。
如果运行 claude 时报错 Unable to connect to Anthropic services,看 常见问题:Claude Code 无法连接。
codex同理,看到交互界面就退出。~/.codex/ 目录已被创建。
gemini~/.gemini/ 目录已被创建。
完成上述三步后,就可以挑你要用的工具,去对应的配置页继续。