安装配置：CCSub 使用文档

不想手敲配置？用配置生成器选好工具和系统，一键复制 Claude Code / Codex / Cline / Cursor 的配置；各工具的详细步骤见工具接入教程。

本章完成后你的电脑上会有：

Node.js —— Claude Code / Codex 的运行环境
Claude Code —— Anthropic 终端助手
Codex CLI —— OpenAI 终端助手
CC Switch（可选） —— 图形化切换不同 API 供应商

⚠️ 开始前先退出所有翻墙 / 代理软件（Clash、V2Ray、机场客户端等）。浏览器能上网 ≠ 终端能上网。代理是安装过程中最常见的"隐形坑"，详见故障排查 §代理问题。

第一步：安装 Node.js

Node.js 是 Claude Code 和 Codex 的运行环境，版本需 ≥ v18 LTS（推荐最新 LTS）。

Windows

打开 PowerShell（按 Win → 输入 PowerShell → 回车），输入：

winget install OpenJS.NodeJS.LTS

提示确认时输入 Y。安装完毕后关闭 PowerShell 重新打开，输入：

node -v
npm -v

两个版本号都能打印出来，表示安装成功。

macOS

方式 A：官网安装包（最简单）

打开 nodejs.org，下载 macOS 的 .pkg 安装包，双击安装即可。

方式 B：Homebrew

brew install node@20

完成后在终端验证：

node -v
npm -v

Linux

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

其他发行版参考 NodeSource 官方说明。

第二步：安装 Claude Code

macOS / Linux

sudo npm install -g @anthropic-ai/claude-code@latest

Windows

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

验证：

claude --version

第三步：配置 Claude Code 连到 CCSub

Claude Code 通过两个环境变量知道要走 CCSub：

变量	值
`ANTHROPIC_BASE_URL`	`https://www.ccsub.net`
`ANTHROPIC_AUTH_TOKEN`	你在 /keys 创建的 API Key

macOS / Linux

编辑你的 shell 配置文件（zsh 用户改 ~/.zshrc，bash 用户改 ~/.bashrc）：

echo 'export ANTHROPIC_BASE_URL="https://www.ccsub.net"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"' >> ~/.zshrc
source ~/.zshrc

Windows（PowerShell）

永久设置：

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://www.ccsub.net', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'sk-你的密钥', 'User')

设置后关闭所有 PowerShell / 终端窗口重新打开才会生效。

启动 Claude Code

在任意项目目录下：

cd ~/你的项目
claude

首次进入会有引导，一路回车即可。出现对话提示符就可以开始了。

第四步：安装 Codex CLI

macOS / Linux

sudo npm install -g @openai/codex@latest

Windows

npm install -g @openai/codex@latest

第五步：配置 Codex 连到 CCSub

Codex 使用 OpenAI 协议。Codex 0.119 起不再读取 OPENAI_BASE_URL 环境变量，需要在配置文件里加一个自定义服务商。

1. 编辑用户目录下的配置文件：macOS / Linux 是 ~/.codex/config.toml，Windows 是 C:\Users\你的用户名\.codex\config.toml（没有就新建）。把下面内容放在文件最上面（model 和 model_provider 必须在任何 [xxx] 表头之前）：

model = "gpt-5.5"
model_provider = "ccsub"

[model_providers.ccsub]
name = "CCSub"
base_url = "https://www.ccsub.net/api/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

model 可以换成型号列表里的任意型号 ID。项目目录里的 .codex/config.toml 不会读取服务商设置，一定要写在用户目录下。

2. 设置 Key 环境变量：

# macOS / Linux
echo 'export OPENAI_API_KEY="sk-你的密钥"' >> ~/.zshrc
source ~/.zshrc

# Windows PowerShell
[System.Environment]::SetEnvironmentVariable('OPENAI_API_KEY', 'sk-你的密钥', 'User')

3. 重新打开终端后启动：

codex

Codex 0.118 及更早版本也可以只设环境变量 OPENAI_BASE_URL=https://www.ccsub.net/api/v1 加 OPENAI_API_KEY，但新版已不生效，建议统一用上面的配置文件写法。也可以用配置生成器直接生成这段配置，详细说明见 Codex CLI 接入教程。

第六步（可选）：CC Switch 图形化管理

如果你同时用多个 API 供应商（CCSub、官方、其他中转），推荐 CC Switch，一个开源 GUI 工具，一键切换。

下载地址：https://github.com/farion1231/cc-switch/releases

Windows：.msi 安装包
macOS：.dmg

系统要求：Windows 10+ / macOS 12+ / Ubuntu 22.04+

添加 CCSub 供应商：

打开 CC Switch → 点右上角 +
选择「自定义配置」
填写：
- 供应商名称：CCSub
- 请求地址：https://www.ccsub.net（不勾选"完整 URL"）
- API Key：贴入 CCSub 密钥
点「添加」→ 列表中点「启用」→ 点「检测」
顶部出现绿色提示 = 配置成功

CC Switch 会自动帮你写好 Claude Code 的配置，不需要再手动改环境变量。

其他工具接入

工具	Base URL	密钥字段
Cursor	Settings → Models → Override OpenAI Base URL: `https://www.ccsub.net/api/v1`	OpenAI API Key
Continue (VS Code)	`apiBase: "https://www.ccsub.net/api/v1"`	`apiKey`
Cline (VS Code)	API Provider 选 `OpenAI Compatible`，Base URL: `https://www.ccsub.net/api/v1`	API Key
Gemini CLI	参考工具文档，指向 `https://www.ccsub.net`	CCSub Key
JetBrains AI Assistant	通过 Continue 插件或 Proxy 配置	CCSub Key

验证一切正常

在 Claude Code 或 Codex 里问一句：

你现在用的是什么模型？

如果它回答了一个模型名（比如 claude-sonnet-4-6），说明整条链路打通。

遇到报错？ → 翻故障排查 能用了？ → 进入入门使用手册