文档
安装配置
从零开始,把 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"}]}'