Freecode 接入常见问题#
先确认实际请求地址、密钥分组和精确模型 ID，再检查额度、网络和工具配置。
按错误排查#
| 现象 | 检查内容 |
|---|---|
| 401 / Unauthorized | 是否使用完整 Freecode 密钥；是否被禁用、过期或删除；客户端是否读到了预期环境变量 |
| 403 / 无权访问分组 | 密钥绑定的分组、账号可用分组，以及分组对客户端类型的要求 |
| No available channel / 模型不可用 | 当前分组是否包含模型；模型白名单是否放行；对应协议是否可用 |
| 404 / Not Found | 是否重复 /v1；是否把完整接口路径误填进 Base URL |
| 429 | 请求速率、并发限制或上游限流；降低并发，按服务返回要求重试 |
| 余额或额度不足 | 钱包余额、密钥剩余额度和有效期；无限额度密钥也会消耗账户余额 |
| 超时 / stream error | DNS、终端代理、网络稳定性和请求超时；保留报错中的 request ID |
| 某个工具可用，另一个不可用 | 两个工具是否使用相同地址、密钥分组、模型及接口；客户端限制是否一致 |
地址怎么填#
| 工具 | Base URL |
|---|---|
| OpenAI SDK / Codex | https://api.freecode.cc/v1 |
| Anthropic SDK / Claude Code | https://api.freecode.cc |
错误示例：https://api.freecode.cc/v1/v1、把 /v1/responses 作为 Codex Base URL，或把 /v1/messages 作为 Anthropic SDK Base URL。
模型目录有结果，为什么请求仍失败#
/v1/models 是模型发现接口；实际生成还要经过额度、模型限制、路由和上游处理。打开 模型广场 核对精确模型 ID，再用这把密钥执行一次最小请求。
Playground 使用当前账号的站内身份，不能替代对具体 API 密钥的验证。
分组怎么选#
首次使用先选一个明确包含目标模型的分组。如果需要备用顺序，在 API 密钥页 创建分组链，再编辑密钥绑定该链。客户端无需额外填写分组参数。
分组链中某个分组没有目标模型时，请按后台可用模型和路由结果检查；不要自行猜测分组名或在请求中追加未知分组参数。
切换配置后仍走旧服务#
- 检查 CC Switch 当前启用的站点。
- 检查终端中的旧 Base URL、认证变量和启动参数。
- 检查用户级配置文件，避免同一个供应商重复定义。
- 完全退出 CLI，重新打开终端并开始新会话。
- 在 使用日志 验证实际使用的模型和分组。
需要协助时提供什么#
提供工具名称与版本、请求时间和时区、模型 ID、Base URL、HTTP 状态、错误消息及 request ID。不要提供完整 API Key、Authorization、Cookie 或包含真实密钥的导入链接。
如果密钥已泄露，在 API 密钥页停用或删除该密钥，创建新的密钥并更新客户端。