环境检查（通用步骤）

1. 确认 Node.js 与 npm

bash

node --version
npm --version
npm list -g --depth=0

如果命令不存在，先安装 Node.js LTS。Windows 用户同时检查终端编码和 PATH 配置。

按需安装：

bash

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

安装失败时，重新执行上面的安装命令；Codex 可按下面官方入口安装。

Codex 官方入口：

bash

claude --version
codex --version
gemini --version

任一命令不可用时，先修复 PATH 或重新安装对应 CLI。

bash

curl -i https://api.avemujica.moe/v1/models

未带 API Key 时，接口返回 401 Invalid token 表示网络已连通。连接超时、DNS 错误或 TLS 错误表示本机网络、代理或防火墙需要先处理。

bash

echo "$OPENAI_API_KEY"
echo "$OPENAI_BASE_URL"
echo "$ANTHROPIC_BASE_URL"
echo "$GOOGLE_GEMINI_BASE_URL"

旧环境变量会覆盖客户端配置。确认不需要后再清理。