大约 2 分钟
使用常见问题
这里整理的是接入 CC Code 时最常遇到的问题。配置时优先以控制台「使用密钥」弹窗或本文档对应页面为准。
API 地址应该填哪个？
不同工具填写方式不完全一样：
- Codex：按 Codex 配置 页面生成的
base_url填写。 - CherryStudio：API 地址填
https://api.cccode.top/v1。 - OpenCode：
opencode.jsonc里的baseURL填https://api.cccode.top/v1。 - curl 调用：按 Curl 调用示例 里的完整接口地址调用。
提示
如果工具会自动拼接 /chat/completions、/responses，API 地址通常填到 /v1 即可，不要重复追加接口路径。
API Key 填了还是不能用怎么办？
先检查这几项：
- Key 是否复制完整，没有多余空格。
- Key 是否仍然有效。
- 当前账号余额或套餐是否可用。
- 当前 Key 是否允许使用所选模型。
- 工具里的 API 地址是否填对。
- 模型名称是否和文档或控制台显示一致。
如果同一个 Key 在 curl 里能用，但某个工具不能用，通常是该工具里的 API 地址、模型名或接口类型配置不一致。
模型名应该怎么填？
文档默认使用 gpt-5.5。如果后台后续展示了新的推荐模型，以后台显示的模型名为准。
有些工具会自动获取模型列表，有些工具需要手动填写模型名。比如 OpenCode 的模型列表来自 opencode.jsonc 里的 models，不会自动把所有模型都列出来。
CherryStudio 获取模型列表失败怎么办？
先确认：
- API 地址填的是
https://api.cccode.top/v1。 - 不是
https://api.cccode.top/v1/chat/completions。 - API Key 已保存，并且当前提供商开关已打开。
CherryStudio 预览到 /v1/chat/completions 是正常的，但配置框里一般不需要手动填到这一层。
OpenCode 里已经 /connect 了，为什么还看不到模型？
OpenCode 需要同时完成两步：
/connect保存 API Key。opencode.jsonc声明 provider、API 地址和模型。
这两处靠 provider id 对应。如果 /connect 时填的是 cccode，那么 opencode.jsonc 里也要写：
{
"model": "cccode/gpt-5.5",
"provider": {
"cccode": {}
}
}cccode 这个名字变了，OpenCode 就会找不到之前保存的凭证，需要重新 /connect。
请求超时或一直没有响应怎么办？
图片生成、复杂推理、长文本生成都可能需要更久时间。如果偶发超时，可以稍后重试；如果一直失败，建议先换一个简单问题测试连接是否正常，再确认当前 Key 是否支持所选模型。