为什么选择 CCSub 中转服务？
CCSub 是国内便捷的 AI 模型中转平台，提供 OpenAI 和 Anthropic 兼容的 API 接口，让你在 Cherry Studio 等客户端中直接调用 Claude、GPT 系列模型，无需额外配置网络。通过 CCSub 可以获得稳定的访问体验，模型定价透明，并支持多种主流工具（如 Claude Code、Cursor、Cherry Studio 等）。
准备工作：注册并获取 API Key
在开始配置前，请先完成以下步骤：
- 访问 CCSub 官网 注册账号。
- 进入「注册与充值」页面（/docs/pricing），按需充值（1 元 = 1 美元额度）。
- 创建 API 密钥：在控制台生成一个形如
sk-你的CCSub密钥的密钥，并妥善保存。
在 Cherry Studio 中配置 CCSub
步骤一：打开设置，选择 OpenAI 兼容接口
Cherry Studio 支持自定义 API 接口。打开软件，进入「设置」→「模型服务」，选择「OpenAI 兼容」作为供应商。
步骤二：填写 API 地址和密钥
- API 地址（Base URL）：
https://ccsub.xyz/v1 - API Key：填入你创建的
sk-你的CCSub密钥。
注意：Chat 接口完整地址为 https://ccsub.xyz/v1/chat/completions。
步骤三：选择或添加模型
CCSub 支持通过 GET https://ccsub.xyz/v1/models 查询所有可用模型。在 Cherry Studio 中，你可以手动添加模型 ID，例如：
claude-sonnet-4-6（对应 Claude Sonnet 4.6）claude-opus-4-8（对应 Claude Opus 4.8）gpt-5.6-sol（对应 GPT-5.6 Sol）gpt-5.5（对应 GPT-5.5）
建议先在设置中点击「测试连接」，确保能正常获取模型列表。
步骤四：开始对话
配置完成后，新建对话，在模型下拉菜单中选择你添加的模型即可。例如选择 claude-sonnet-4-6，即可体验 Claude 的对话能力。
常见错误排查
401 认证失败
请检查 API Key 是否填写正确，注意不要有多余空格。如果密钥无效，请重新在 CCSub 控制台生成。
404 模型不存在
模型 ID 可能拼写错误，或该模型暂未开放。请先通过 GET /v1/models 查询可用模型，并确保填写的是“模型 ID”而非模型名称。
连接超时或网络错误
CCSub 服务通常无需特殊网络，但某些环境可能限制外部连接。请检查防火墙或代理设置，必要时联系网络管理员。
余额不足
调用模型会消耗账户余额。如果看到“insufficient_balance”错误，请到 CCSub 控制台充值。
成本与充值提醒
CCSub 采用预付费模式，模型按 Token 计费，价格透明。例如 Claude Sonnet 4.6 输入约 33.6 元/百万 Token，输出 168 元/百万 Token。建议根据日常使用量合理充值，避免余额不足影响使用。
你可以在 CCSub 的「入门使用手册」（/docs/usage）中查看 Token 明细和费用计算方式。
行动引导
现在你已经完成了 Cherry Studio 的接入，快去体验吧！如果遇到问题，可参考 CCSub 官方文档中的「故障排查」（/docs/troubleshooting）和「常见问题」（/docs/faq）。注册时如有疑问，请访问官网或联系客服。
CCSub API 调用方法
如果你使用 OpenAI 兼容客户端，把 Base URL 设置为 https://ccsub.xyz/v1，API Key 使用控制台创建的 sk-你的CCSub密钥。
export OPENAI_BASE_URL=https://ccsub.xyz/v1
export OPENAI_API_KEY=sk-你的CCSub密钥如果你使用 Claude Code 或 Anthropic 兼容客户端，把请求指向 CCSub 的 Messages 接口。
export ANTHROPIC_BASE_URL=https://ccsub.xyz
export ANTHROPIC_AUTH_TOKEN=sk-你的CCSub密钥需要确认当前可用模型时，可以请求 GET https://ccsub.xyz/v1/models。正式长任务前，建议先用短请求验证 Key、余额和模型是否正常。