开始使用
第一次连接 Codex
创建密钥、配置服务商,再用一条消息验证连接。
按“创建密钥 → 配置服务商 → 小量验证”的顺序接入。本站账户与 OpenAI / ChatGPT 账户是不同的账户体系,余额也不互通。
1. 创建与模型匹配的密钥
登录 控制台,打开「API 密钥」,选择支持目标模型的分组。建议为本地编程工具单独创建密钥,并根据需要设置额度和有效期。
从 模型广场 复制目标模型 ID。确认分组支持 Responses 接口和所需工具能力。
2. 安装客户端
桌面用户从 OpenAI 官方桌面文档 进入下载渠道;终端用户参考 Codex CLI 教程。
CC-Switch 是可选的第三方配置管理工具,从 项目发布页 获取。已有配置先备份,不必为了首次接入开启历史迁移功能。
3. 配置 SuperFast 服务商
优先使用控制台的「导入到 CCS」,导入后检查实际写入的地址、模型、密钥与协议,再启用供应商。
| 配置项 | 内容 |
|---|---|
| 名称 | SuperFast |
Codex base_url |
https://api.sfapi.de/v1 |
国内线路 base_url |
https://api-cn.sfapi.de/v1 |
| 协议 | responses |
| 模型 | 从本站模型广场复制的可用模型 ID |
| 密钥 | 对应分组的本站 API Key |
地址以最终请求路径为准:Codex 直接连接本站时,应请求 /v1/responses。某些工具的“主机地址”字段会自动追加 /v1,另一些“Base URL”字段不会。不要把“不加 /v1”当成所有客户端通用的规则,也不要拼成 /v1/v1/responses。
手动配置方式及环境变量见 Codex CLI。使用已有 ChatGPT 登录时,要确认当前模型供应商确实切到了 SuperFast;不能仅凭登录邮箱判断请求走向。
4. 重启并核验
保存配置后退出并重新启动客户端;macOS 可用 ⌘Q,Windows 使用应用的退出入口并确认后台进程已结束。新建对话,发送一条简短测试消息。
随后在本站「使用记录」核对时间、模型、密钥与费用。看到正常回复且有匹配记录,才能确认这次请求经过本站。测试也可能计费。
5. 出错时怎么做
- 401:核对密钥是否正确、过期、禁用,以及实际发送给哪个地址。
- 404:检查最终请求路径和协议,避免缺少或重复
/v1。 - 503:可能没有可用上游、分组不匹配、通道限流或临时故障,结合错误正文判断。
- 余额 / 额度提示:不要忽略。先确认提示来自哪个账户、当前供应商和实际请求地址。
- 切换后找不到历史:先备份本地状态,核对供应商与历史筛选;迁移工具不是接入的必要步骤,也不能保证恢复所有历史。
资料依据:OpenAI 认证说明 · 自定义模型供应商。
最后更新:2026-11-05模型以官方模型广场为准 ↗
SuperFast AI文档中心