返回文档首页
Codex 接入
Codex CLI、桌面端和 IDE 扩展都可以通过 qimoq 调用 GPT / Codex 类模型。推荐使用 CC Switch 导入配置，手动配置时只需要确认 Endpoint、API Key 和模型 ID。
配置项
| 项目 | 填写建议 |
|---|---|
| Provider | qimoq 或自定义 OpenAI Compatible Provider |
| Endpoint | 站点根地址，或按客户端提示填写 /v1 |
| API Key | 从「访问凭证」页面复制完整凭证 |
| 主模型 | 从「模型广场」复制，例如 gpt-5.5 |
| 快速模型 | 可填写较快或较低成本的 GPT / Codex 模型 |
如果你同时使用多个客户端，建议为 Codex 单独创建一张访问凭证，后续排查消费和限制会更清晰。
配置步骤
- 进入「模型广场」，复制要使用的 GPT / Codex 模型 ID。
- 进入「访问凭证」，创建或选择一张可调用该模型的凭证。
- 点击凭证右侧的导入配置，选择 Codex。
- 确认 Endpoint、API Key、主模型和快速模型。
- 打开 CC Switch 完成写入。
- 重启 Codex CLI、桌面端或 IDE 扩展。
导入后如果客户端仍读取旧配置，先关闭所有 Codex 相关进程，再重新打开。
安装 CLI
如果本机还没有 Codex CLI，请按客户端官方安装方式安装。安装完成后先运行一次基础命令，确认终端能找到 codex。
codex --version
随后再导入 qimoq Provider，避免把“CLI 未安装”和“Provider 配置错误”混在一起排查。
验证
在任意测试目录运行一次简单对话：
codex "用一句话确认 qimoq 接入成功"
验证通过后，到「使用日志」查看本次请求的模型、Token、费用和状态码。如果日志里没有记录，优先检查客户端是否还在使用旧 Provider。
排查
| 现象 | 处理 |
|---|---|
| 401 Unauthorized | 检查凭证是否完整、是否复制了脱敏展示值、凭证是否被禁用 |
| 404 model not found | 检查模型 ID 是否从「模型广场」复制，且访问凭证的分组支持该模型 |
| 请求仍走官方服务 | 重启 Codex，并确认 CC Switch 写入的是当前系统用户的配置 |
| 能请求但费用异常 | 查看「使用日志」里的模型和倍率，确认没有误选高成本模型 |