安装客户端

Claude Code、Codex、OpenCode 都装在命令行里。装好之后回到控制台「API 密钥」，点「CCS 导入」就能一键配好。

下面每个工具都给了两种装法：国内镜像在国内直接能装，不用开代理；官方脚本需要能访问外网。

Windows 一键安装包

只用 Claude Code 的 Windows 用户，用这个更省事：装好 Claude Code，顺手配好你的密钥，桌面上多一个图标，双击就能用。不用装 Node.js，也不用开代理。

1. 用电脑上的浏览器（Edge、Chrome 等）打开控制台，进「API 密钥」
2. 在要用的那把密钥那一行点「一键安装」，选一个模型，点「下载安装包」
3. 打开下载好的文件。浏览器说这个文件不常下载，就点「保留」（Edge 要先点提示右边的「…」）
4. 弹出蓝色的「Windows 已保护你的电脑」，点「更多信息」，再点「仍要运行」
5. 等它自己装完，大约 2～10 分钟。以后双击桌面上的「Claude Code（济川）」就能用

几点说明：

• 安装包是给这把密钥专门生成的，下载后 10 分钟内运行有效，只能用一次。过期了回控制台再点一次「一键安装」就行，已经装好的部分会跳过。
• 文件名里带着专属提取码，别把安装包或它的文件名截图发给别人。
• 想升级 Claude Code，也是回控制台重新点「一键安装」运行一次。
• 支持 Windows 10 / 11 64 位。提示「智能应用控制已阻止」的电脑运行不了安装包，请按下面的命令安装，再用「CCS 导入」配置。
• 微信、QQ 里打开的网页和手机都下不了，请换电脑上的浏览器。

不想登录控制台：通用安装包（旧版）

它会装好 Node.js、Claude Code 和 CC Switch，但不会配密钥，装完还要去控制台点「CCS 导入」。

下载通用安装包（Windows）

1. 解压，不要在压缩包里直接双击
2. 双击 Install-ClaudeCode-CCSwitch.bat
3. 问代理地址时，没有代理就直接按回车，会走国内镜像
4. 装完按窗口里的提示，去控制台点「CCS 导入」
5. 打开「命令提示符」（开始菜单搜 cmd，不要选 PowerShell），输入 claude 回车

先装 Node.js

用 npm 装需要 Node.js 22 或更高。已经装过的，在命令行输入 node -v 看版本。

• 国内镜像：npmmirror Node.js 下载，进 v24.x 开头、版本号大的那个目录，Windows 下 .msi，Mac 下 .pkg
• 官方：nodejs.org

Claude Code

国内镜像

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

官方 · Windows

irm https://claude.ai/install.ps1 | iex

官方 · macOS / Linux

curl -fsSL https://claude.ai/install.sh | bash

桌面版：Claude 官方下载页 · 配置看 Claude Code 接入

Codex

国内镜像

npm install -g @openai/codex --registry=https://registry.npmmirror.com

官方 · Windows

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

官方 · macOS / Linux

curl -fsSL https://chatgpt.com/codex/install.sh | sh

桌面版：Codex 桌面版现在在 ChatGPT 桌面应用里，ChatGPT 官方下载页 · 配置看 Codex 接入

OpenCode

国内镜像

npm install -g opencode-ai --registry=https://registry.npmmirror.com

官方 · Windows

scoop install opencode

官方 · macOS / Linux

curl -fsSL https://opencode.ai/install | bash

桌面版：OpenCode 官方下载页 · 配置看 OpenCode 接入

CC Switch：一键导入要用它

控制台的「CCS 导入」会把密钥直接写进 CC Switch，不用手抄地址和模型名。

CC Switch 官方下载页 · 用法看 CC Switch 接入

装好了吗

重新打开一个命令行窗口，输入对应的命令，能打印出版本号就是装好了：

claude --version
codex --version
opencode --version

装不上

提示「不是内部或外部命令」/ command not found 关掉命令行窗口重新打开。还不行，说明 npm 的全局目录不在 PATH 里，重装一次 Node.js 一般就好。

Mac 上 npm 报 EACCES 权限错误 不要加 sudo，改用上面的「官方 · macOS / Linux」脚本装。

Windows 上 PowerShell 提示「禁止运行脚本」 用「国内镜像」那条 npm 命令，或者在命令前加 powershell -ExecutionPolicy ByPass -c。

npm 卡住不动 多半是没走镜像。确认命令末尾带了 --registry=https://registry.npmmirror.com。