很多 AI 编程用户会同时使用 Cherry Studio、Cursor、VS Code 等多款工具，但每款工具都单独配置 API Key 不仅麻烦，还可能造成额度分散。CCSub 提供统一的中转 API，支持一个密钥在多个客户端中使用。本文将手把手教你如何共用一把 CCSub Key，并附上常见问题的排查方法。
为什么选择 CCSub 作为统一中转？
CCSub（ccsub.xyz）是一个国内可直接访问的 API 中转平台，支持 OpenAI 和 Anthropic 接口，覆盖 Cherry Studio、Cursor、VS Code、Claude Code、Codex、Windsurf 等主流工具。使用同一把 CCSub Key，你可以在不同工具间无缝切换，并统一查看调用量和费用。
准备工作：获取 CCSub API Key
- 访问 ccsub.xyz 注册账号。
- 在控制台完成充值（1 元 = 1 美元余额）。
- 创建 API Key，格式类似
sk-你的CCSub密钥。注意保存好，只显示一次。
提示：如果已有多个 Key，建议合并为一个，便于管理和排查。CCSub 支持创建多个 Key，但共用一把即可。
通用设置：OpenAI 和 Anthropic 兼容端点
CCSub 同时提供 OpenAI 兼容接口（供 Cherry Studio、Cursor、VS Code 等）和 Anthropic 原生接口（供 Claude Code 等）。两者都基于同一把 Key，无需分别创建。
- OpenAI 兼容：Base URL 为
https://ccsub.xyz/v1，Chat Completions 端点为https://ccsub.xyz/v1/chat/completions。 - Anthropic 兼容：Base URL 为
https://ccsub.xyz，Messages 端点为https://ccsub.xyz/v1/messages。
可用模型通过 GET https://ccsub.xyz/v1/models 查询，也可参考 CCSub 文档中的模型列表。
在 Cherry Studio 中配置 CCSub Key
步骤一：打开设置
启动 Cherry Studio，点击左下角「设置」→「模型服务」。
步骤二：添加 OpenAI 兼容服务
- 选择「OpenAI 兼容」类型。
- 名称随意，例如
CCSub。 - API 地址填
https://ccsub.xyz/v1。 - API Key 粘贴你的
sk-你的CCSub密钥。 - 点击「检查」测试连接，出现模型列表即成功。
步骤三：选择模型
在 Cherry Studio 的对话界面，选择 CCSub 服务下的模型（如 gpt-5.6-sol、claude-sonnet-4-6 等）。如果模型列表为空，请确认 API Key 有余额。
在 Cursor 中配置 CCSub Key
步骤一：进入 Settings
打开 Cursor，点击右上角用户头像 → Settings → Models。
步骤二：切换 API Key 模式
在 OpenAI API Key 区域，选择 Override OpenAI Base URL（如果没有，可开启开发者模式）。
步骤三：填入 Base URL 和 Key
- Base URL：
https://ccsub.xyz/v1 - API Key：粘贴
sk-你的CCSub密钥
然后在模型列表中选择所需模型。如果 Cursor 不显示自定义模型，可尝试在 Models 中添加模型 ID（例如 gpt-5.6-sol）。
在 VS Code 中配置 CCSub Key（通过开源扩展）
VS Code 本身不带 AI 对话，但可以通过安装支持 OpenAI 兼容的扩展（如 Continue、cline 等）来接入 CCSub。这里以 Continue 为例：
步骤一：安装扩展
在 VS Code 扩展市场搜索 Continue 并安装。
步骤二：修改配置文件
按 Ctrl+Shift+P 打开命令面板，输入 Continue: Open config，编辑 config.json，添加：
{
"models": [
{
"title": "CCSub GPT",
"provider": "openai",
"model": "gpt-5.6-sol",
"apiBase": "https://ccsub.xyz/v1",
"apiKey": "sk-你的CCSub密钥"
}
]
}
保存后重启 VS Code，即可在 Continue 面板中选择 CCSub 模型。
其他客户端（Claude Code、Codex 等）配置参考
如果你也使用 Claude Code 或 Codex，可参考以下环境变量（Windows 用 set，Mac/Linux 用 export）：
- Claude Code：
ANTHROPIC_BASE_URL=https://ccsub.xyz和ANTHROPIC_API_KEY=sk-你的CCSub密钥。 - Codex：设置
OPENAI_BASE_URL=https://ccsub.xyz/v1和OPENAI_API_KEY=sk-你的CCSub密钥。
详细配置可参考 CCSub 文档中的相应教程。
常见错误排查
401 Unauthorized
API Key 错误或已失效。请检查是否复制完整，包括 sk- 前缀。
404 Not Found
模型不存在或端点错误。确认模型 ID 是否正确，或通过 GET /v1/models 查看可用模型。
Connection Error
网络问题，或 Base URL 填错。检查是否使用 https://ccsub.xyz/v1（OpenAI）或 https://ccsub.xyz（Anthropic）。
余额不足
调用返回 402 或相关错误。请前往 CCSub 控制台充值。
注意：所有客户端共用一把 Key，费用会统一从余额扣除，建议定期在控制台查看用量明细。
成本控制与充值提醒
CCSub 采用预付费模式，1 元 = 1 美元余额。不同模型价格不同（例如 gpt-5.6-sol 输入 20 元/百万 Token，输出 60 元/百万 Token）。在控制台可以设置消费提醒，避免超额。建议充值适量金额，按需充值。
行动引导
现在你已经知道如何在 Cherry Studio、Cursor、VS Code 中配置同一把 CCSub Key。如果遇到问题，可查阅 故障排查 或 常见问题。立即访问 ccsub.xyz 创建你的密钥，开启跨客户端统一体验吧！