环境检查

在配置 Claude Code、Codex 或其他小马AI支持的本地 AI CLI 前，先确认本机已经能正常使用 Node.js 和 npm。

检查 Node.js 环境

打开终端，执行：

bash

npm list -g --depth=0

如果命令能正常输出全局 npm 包列表，说明 Node.js 与 npm 已可用。输出里没有安装任何 CLI 工具也没关系，下一步会单独安装。

如果提示 npm: command not found、不是内部或外部命令 或类似错误，请先安装 Node.js，再重新执行上面的检查命令。

建议

新手建议直接安装 Node.js LTS 版本。安装完成后，重新打开终端再执行检查命令，避免旧终端没有刷新环境变量。

按你要使用的工具安装即可：

bash

npm install -g @anthropic-ai/claude-code@latest
npm install -g @openai/codex@latest

如果只使用其中一个工具，只安装对应命令即可。

分别执行：

bash

claude --version
codex --version

能输出版本号，就说明 CLI 已经装好。

必须先完成这一步

CLI 工具的首次运行会创建后续配置需要用到的目录。环境没有准备好时，后面的令牌、接口地址和模型配置都无法稳定验证。

继续阅读配置 CLI 工具，选择 CC-Switch 自动配置或手动配置。