常见问题
注册与账号
注册需要审核吗？
通常不需要。注册后可以直接进入 网站控制台，并按提示创建 API Key。
必须接受服务条款吗？
是的。服务条款、使用政策或隐私政策更新时，控制台可能会弹出确认提示。不同意时可能无法继续使用控制台服务。
一个账号可以多人共用吗？
技术上可以，但不建议。团队使用时建议按成员或用途分别创建 API Key，方便后续统计用量、禁用单个 Key、排查异常调用。
忘记密码怎么办？
在登录页点击 忘记密码，输入注册邮箱，根据提示流程重置密码。
API 密钥
一个账号能创建几个 API Key？
一般可以按需创建多个。推荐按设备或用途分开命名，例如：
codex-mac
codex-windows
codex-work
ci-prod
这样某台设备不用了，只删除对应 Key，不影响其他设备。
API Key 泄露了怎么办？
立即回到 API 密钥 页面：
- 禁用或删除泄露的 Key。
- 创建一个新的 Key。
- 重新导入到 CCSwitch。
- 重启 Codex。
不要把 API Key 发到群聊、截图外传、提交到 GitHub，或写进公开配置文件。
可以设置日额度上限吗？
如果控制台提供额度或速率限制选项，可以在编辑 Key 时设置。建议生产环境、团队共享 Key、CI/CD Key 都设置单独限制，避免误调用造成余额快速消耗。
导入到 CCS 没反应怎么办？
先检查：
- 本机是否已经安装 CCSwitch。
- CCSwitch 是否至少打开过一次。
- 浏览器是否拦截了
打开外部应用的弹窗。 - 是否使用 Chrome 或 Edge 操作。
如果还没安装，请从官方渠道下载：GitHub Releases。
计费
怎么计费？
API 调用通常按 Token 消耗实时扣费。每次请求会根据输入 Token、输出 Token、模型价格和分组倍率计算实际消费。
具体单价和倍率以控制台展示为准。
倍率是什么意思？
倍率可以理解为渠道质量和成本系数。倍率越高，通常代表渠道更稳定、限制更宽松，但实际消费也会按倍率放大。
新用户建议先用默认配置跑通，再根据稳定性需求决定是否升级。
充值有最低金额吗？
以控制台实际展示为准。建议先小额测试，确认能正常使用后再充值更多余额。
支持哪些支付方式？
以控制台展示为准。常见方式可能包括支付宝、微信、USDT 等。
余额可以退款吗？
以平台退款政策为准。一般建议先小额测试，避免一次性充值过多。
模型与调用
支持哪些模型？
以控制台可用模型列表为准。
base_url 要不要带 /v1？
看客户端：
| 客户端 | base_url |
|---|---|
| OpenAI SDK / 一般 HTTP 调用 | 通常带 /v1 |
| Codex CLI / Claude Code CLI | 通常不带 /v1 |
使用 导入到 CCS 时，CCSwitch 会自动写入配置，普通用户不需要手动填写。
支持流式响应吗？
支持。代码调用时可以在请求里开启 stream: true。
客户端接入
推荐的客户端是什么？
如果你主要使用 Codex，推荐流程是：
- 创建 API Key。
- 安装 CCSwitch。
- 在网站点击
导入到 CCS。 - 在 CCSwitch 里启用配置。
- 重启 Codex。
这是最简单、最不容易配错的方式。
CCSwitch 是什么？
CCSwitch 是免费开源的桌面工具，用来管理 Codex、Claude Code、OpenCode 等工具的供应商配置。
官方下载入口：
- 官方网站：ccswitch.io
- 下载页面：GitHub Releases
不要从任何要求收费、充值、登录密码的网站下载 CCSwitch。
可以同时配置多个供应商吗？
可以。CCSwitch 支持管理多个 Provider，并在不同 Provider 之间切换。
切换后建议重启 Codex，确保新配置生效。
要不要手动配置 Codex 文件？
正常不需要。推荐使用 导入到 CCS，让 CCSwitch 自动管理配置。
只有高级用户或排查问题时，才需要手动查看配置文件。
性能与故障
为什么调用很慢？
常见原因：
- 模型本身响应慢。
- 上下文太长。
- 当前网络不稳定。
- 当前渠道拥堵。
- 本地代理或 DNS 异常。
可以先重启 Codex，再换网络环境测试。如果持续很慢，联系平台客服排查。
429 限流怎么办？
429 表示请求过快、额度限制或渠道限流。处理方式：
- 降低并发。
- 等待一段时间再试。
- 检查 Key 是否设置了额度或速率限制。
- 必要时联系客服调整。
401 / 403 报错怎么办？
401 通常是 Key 错误、Key 失效、Key 被禁用或没有成功切换到新配置。
403 通常是 Key 没有权限调用当前模型或当前分组不支持该用途。
建议按顺序检查：
- 回到网站确认 Key 状态正常。
- 在 CCSwitch 里重新启用配置。
- 重启 Codex。
- 如果还不行，创建新 Key 后重新导入。
服务异常怎么知道？
以控制台公告、系统状态或客服通知为准。如果本地配置没有改动但突然全部失败，先检查服务公告，再联系平台客服。
邀请与返利
邀请返利怎么算？
以控制台活动规则为准。如果平台有邀请返利，通常会在邀请页面展示返利比例、结算方式和使用限制。
返利能提现吗？
以平台规则为准。部分平台返利只能转入账户余额，用于后续 API 调用。
可以自邀提现吗？
不建议，也可能违反平台规则。异常邀请、马甲账号自邀、刷返利等行为可能导致返利清零或账号受限。
其他
如果你是开发者，需要自己写代码调用接口，再参考 API 调用文档。
提建议或反馈问题怎么做？
通过控制台客服入口、通知入口或平台提供的联系方式反馈。反馈时建议带上：
- 账号邮箱。
- Key 名称，不要发完整 Key。
- 报错截图。
- 大概发生时间。
- 使用的客户端，例如 Codex、CCSwitch、OpenCode。
没找到答案怎么办？
先搜索关键词，例如 CCSwitch、导入到 CCS、401、429、重启 Codex。
仍然无法解决时，联系平台客服处理。