文档

安装配置

从零开始,把 Claude Code 和 Codex 装好并连到 CCSub。跟着步骤复制命令即可,全程约 10 分钟。

第一步:安装 Node.js

Claude Code 依赖 Node.js(建议 18+)。前往 nodejs.org 下载 LTS 版本安装,然后在终端验证:

node -v
npm -v

第二步:安装 Claude Code

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

安装完成后输入 claude 即可启动。

第三步:配置 Claude Code 连到 CCSub

设置两个环境变量。Claude Code 会在专用 Base URL 后自动拼接 /v1/messages:

export ANTHROPIC_BASE_URL=https://ccsub.xyz/api
export ANTHROPIC_AUTH_TOKEN=sk-你的CCSub密钥

写入 ~/.zshrc 或 ~/.bashrc 后 source 一下即可永久生效。

第四步:安装 Codex CLI

npm install -g @openai/codex

第五步:配置 Codex 连到 CCSub

先在终端设置密钥:

export CCSUB_API_KEY=sk-你的CCSub密钥

再把下面配置写入用户级 ~/.codex/config.toml。Codex 会在专用 Base URL 后自动拼接 /responses;wire_api = "responses" 用于保留工具调用能力。

model = "gpt-5.6-sol"
model_provider = "ccsub"

[model_providers.ccsub]
name = "CCSub"
base_url = "https://ccsub.xyz/openai"
env_key = "CCSUB_API_KEY"
wire_api = "responses"

第六步(可选):CC Switch 图形化管理

不想记命令?用 CC-Switch 一键在多个中转配置间切换,图形界面填好 Key 和地址即可,适合新手。

其他工具接入

Cursor、VS Code(Continue / Cline)、Windsurf、CherryStudio 等只要支持自定义 API 端点,把地址填 https://ccsub.xyz、Key 填 CCSub 密钥即可。

验证一切正常

启动 Claude Code 输入一句「你好」,能正常回复说明接入成功。也可以用 curl 测试专用 Claude 路由:

curl https://ccsub.xyz/api/v1/messages \
  -H "Authorization: Bearer sk-xxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":64,"messages":[{"role":"user","content":"hi"}]}'