主题
环境检查(通用步骤)
不管是手工配置还是用 CC-Switch,都要先做这一步。
第 1 步:确认 Node.js 已安装
Windows / macOS 终端运行:
bash
npm list -g --depth-0- 正常会显示一行版本号 + 全局已装包列表(空输出也算正常)
- 如果显示
command not found,说明 Node.js 没装,先去 Node.js 官网 下载安装(推荐 LTS 版)
装完之后再次运行命令,不再报 command not found 即代表 Node.js 装好。
第 2 步:安装三个 CLI
bash
npm i -g @anthropic-ai/claude-code@latest
npm i -g @openai/codex@latest
npm i -g @google/gemini-cli@latest如果某条命令网络超时,可以加镜像:
npm config set registry https://registry.npmmirror.com,装完后改回官方源。
第 3 步:测试安装(关键!)
这一步必须做。每个 CLI 第一次运行时会在用户目录生成配置文件夹,没生成的话后续配置会找不到目录。
Claude Code
bash
claude出现选项菜单即代表安装成功。
Claude Code 第一次运行可能要求点击链接做 onboarding,按提示走完才能进入正常对话。
Codex
bash
codex出现选项菜单 = 安装成功。
Gemini
bash
gemini出现选项菜单 = 安装成功。
第 4 步:确认配置目录已生成
| 平台 | Claude | Codex | Gemini |
|---|---|---|---|
| Windows | %userprofile%\.claude | %userprofile%\.codex | %userprofile%\.gemini |
| macOS | ~/.claude | ~/.codex | ~/.gemini |
进入对应目录确认存在(里面可能还没有 settings.json / config.toml / .env,我们下一步手工创建)。