01
准备
先完成账号、余额和 API Key
重要区分
兑换码不是 API Key。兑换码用于给账户充值，API Key 才能填到 Codex、SDK 或第三方客户端里。
02
Codex
配置 config.toml Provider
如果你要让 Codex 使用知汇 AI 接口，把下面配置加入 ~/.codex/config.toml 或 Windows 的 C:\Users\你的用户名\.codex\config.toml。
config.toml
model_provider = "zhhai_proxy"
model = "gpt-5.6-sol"
model_reasoning_effort = "medium"
[model_providers.zhhai_proxy]
name = "知汇 AI"
base_url = "https://api.zhhai6699.com/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"可以保留插件、主题、快捷键、项目 trust 配置。
建议替换OpenAI 官方 Provider 和旧的 model_provider 指向。
03
环境变量
设置 API Key
CMD
setx OPENAI_API_KEY "sk-这里填写你的APIKey"看到 SUCCESS: Specified value was saved. 后，关闭所有 CMD 和 Codex，再重新打开。
Terminal
export OPENAI_API_KEY="sk-这里填写你的APIKey"如果要长期保存，可以写入 ~/.zshrc 或你正在使用的 shell 配置文件。
04
客户端
第三方客户端怎么填
ChatBox / LobeHub
接口地址填写到 /v1，API Key 填后台创建的 sk 密钥。
ChatGPT Sidebar
有些插件要求接口后面不能多一个斜杠。优先填完整 /v1 地址。
Open Interpreter
适合进阶用户。使用 OPENAI_API_KEY 和 OPENAI_BASE_URL 环境变量。
OPENAI_API_KEY=sk-你的APIKey
OPENAI_BASE_URL=https://api.zhhai6699.com/v1
05
CC Switch
用 CC Switch 配置中转站
CC Switch 可以用图形化方式管理 Codex 的 Provider 配置，适合不想手动编辑 config.toml 的用户。
下载地址
Windows 用户下载
打开下载页面
.msi 安装包，安装后打开 CC Switch，切换到 Codex 页面。
手动添加 Provider
- 打开 CC Switch，进入 Codex 页面。
- 点击添加供应商，选择 自定义配置。
- 如果后台有“导入到 CCS”或“导入到 CC Switch”，可以直接导入；没有就按下方表格手动填写。
- 保存后点击 启用。
- 完全退出正在运行的 Codex，关闭终端并重新打开。
配置项填写
| 名称 | 知汇AI |
|---|---|
| 官网链接 | https://ai.zhhai6699.com |
| Base URL | https://api.zhhai6699.com/v1 |
| API Key | 自己在后台创建的 Key |
| 模型 | gpt-5.6-sol，或后台实际模型 ID |
| 接口类型 | Responses |
这一点很重要
CC Switch 修改的是本地配置，已经启动的 Codex 不会自动重新读取。保存并启用后，请完全退出 Codex、关闭终端，再重新打开。
06
排错
常见错误
401 Unauthorized密钥错误
API Key 填错，或者把兑换码当成 API Key。请回到 API 密钥页面复制 sk 开头的密钥。
404 Model Not Found模型不存在
模型名称必须和模型广场显示一致，例如 gpt-5.4-mini。不要自行缩写模型名。
Network Error网络或地址问题
确认 Base URL 是 https://api.zhhai6699.com/v1，本地代理也可能影响连接稳定性。