环境检查¶
在配置各种 CLI 工具之前,先确认你的开发环境满足基本要求。
检查 Node.js¶
打开终端输入以下命令检查 Node.js 是否已安装:
如果终端显示版本号(如 v20.x.x),说明已安装。如果提示「命令未找到」或「不是内部命令」,需要先安装 Node.js。
安装 Node.js
前往官网下载安装:https://nodejs.org/,选择 LTS 版本即可。安装完成后重启终端再验证。
一键安装所有 CLI 工具¶
Node.js 安装好之后,可以用 npm 一次性安装所有支持的 CLI 工具:
说明
以上命令会全局安装 Claude Code、Codex CLI 和 Gemini CLI 三个工具。你也可以根据需要只安装其中某个。
安装完成后,验证是否成功:
常见环境问题¶
npm 安装报错¶
权限不足
- macOS / Linux:在命令前加
sudo,如sudo npm i -g @openai/codex@latest - Windows:以管理员身份运行终端