跳转至

环境检查

在配置各种 CLI 工具之前,先确认你的开发环境满足基本要求。

检查 Node.js

打开终端输入以下命令检查 Node.js 是否已安装:

node -v

如果终端显示版本号(如 v20.x.x),说明已安装。如果提示「命令未找到」或「不是内部命令」,需要先安装 Node.js。

安装 Node.js

前往官网下载安装:https://nodejs.org/,选择 LTS 版本即可。安装完成后重启终端再验证。

一键安装所有 CLI 工具

Node.js 安装好之后,可以用 npm 一次性安装所有支持的 CLI 工具:

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

说明

以上命令会全局安装 Claude Code、Codex CLI 和 Gemini CLI 三个工具。你也可以根据需要只安装其中某个。

安装完成后,验证是否成功:

# 验证 Codex CLI
codex --version

# 验证 Claude Code
claude --version

# 验证 Gemini CLI
gemini --version

常见环境问题

npm 安装报错

权限不足

  • macOS / Linux:在命令前加 sudo,如 sudo npm i -g @openai/codex@latest
  • Windows:以管理员身份运行终端

命令安装成功但找不到

解决方案

检查 npm 全局安装路径是否在系统 PATH 中:

npm config get prefix
确保该路径下的 bin 目录(Windows 下直接是该路径)已添加到系统环境变量 PATH 中。