环境与 CLI 检查
这是 Claude Code 和 Codex 共用的准备步骤。CLI 工具需要 Node.js 和 npm，请先确认本机环境及全局安装状态正常。
步骤一：检查 Node.js 和 npm
node -v
npm -v如果两条命令都能输出版本号，说明 Node.js 和 npm 已经可用。建议使用 Node.js 当前的 LTS 版本。
步骤二：检查已安装的 CLI
在 PowerShell、命令提示符或终端中运行：
npm list -g --depth=0
在输出中查找对应的软件包：
| 客户端 | npm 软件包 | 命令 |
|---|---|---|
| Claude Code | @anthropic-ai/claude-code | claude |
| Codex | @openai/codex | codex |
如果列表中没有目标客户端，请继续到对应配置页完成安装。
安装后重新打开终端
全局安装 CLI 后，建议关闭并重新打开终端，让 PATH 环境变量重新加载。
常见问题
| 现象 | 处理方式 |
|---|---|
node 或 npm 命令不存在 | 安装 Node.js，并确认安装目录已加入 PATH |
| CLI 已安装但命令不存在 | 重新打开终端，检查 npm 全局安装目录是否已加入 PATH |
| 全局安装提示权限不足 | 使用有权限的终端，或调整 npm 全局安装目录 |
| Node.js 版本过低 | 升级到当前 LTS 版本后重新安装 CLI |