环境检查（通用步骤）

配置任何 CLI 前，先确认本地运行环境正常。

1. 确认 Node.js 已安装

Windows PowerShell：

powershell

node -v
npm -v

macOS / Linux：

bash

node -v
npm -v

按需要安装对应工具：

bash

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

WARNING

如果你的网络无法访问 npm registry，请先配置可信的 npm 镜像或代理。不要从不明来源下载 CLI 二进制。

Claude Code：

bash

claude --version

Codex CLI：

bash

codex --version

Gemini CLI：

bash

gemini --version

IMPORTANT

只有版本命令正常返回后，再继续写配置文件。否则后续报错很难区分是 CLI 未安装还是 aivoyz 配置错误。