此頁面目前僅提供簡體中文版本。導覽與選單已經是繁體中文。

配置 Codex

Codex CLI 可以通过 OpenAI Responses 协议接入 InOneAPI。配置后，Codex 仍在本地读取和修改代码，模型请求则发送到 InOneAPI，由网关按所选公共模型和路由策略选择可用供应商。

准备工作

  1. 在控制台创建项目和 API Key，并限制允许调用的模型与预算。
  2. 在模型详情页复制模型 ID，原样复制。YOUR_MODEL_ID 只是文档占位符。
  3. 安装 Codex CLI，并确认终端可以执行 codex。

不要把真实 Key 写入 config.toml。配置文件只引用环境变量。

配置模型供应商

创建或打开 ~/.codex/config.toml，把下面内容与已有配置合并：

model = "YOUR_MODEL_ID"
model_provider = "inoneapi"

[model_providers.inoneapi]
name = "InOneAPI"
base_url = "https://api.inoneapi.com/v1"
env_key = "INONEAPI_API_KEY"
wire_api = "responses"

根字段 model、model_provider 必须放在第一个 [表] 之前；已有这些字段时更新原值，不要重复追加。设置了 CODEX_HOME 时，配置位于该目录。

wire_api 必须使用 responses。模型 ID 必须原样复制，不能只填写展示名称。

设置 API Key

macOS 或 Linux：

export INONEAPI_API_KEY="ioa_sk_..."
codex

需要长期生效时，把 export 写入 ~/.zshrc 或 ~/.bashrc，然后重新打开终端。Windows PowerShell：

[Environment]::SetEnvironmentVariable("INONEAPI_API_KEY", "ioa_sk_...", "User")

设置后重新打开 PowerShell。

验证配置

在一个测试仓库中启动 Codex，先执行只读任务：

阅读 README，并概括项目的启动方式。不要修改文件。

随后在 InOneAPI 控制台检查是否出现对应请求、模型 ID 和 X-Gateway-Trace-ID。首次验证不要直接授予高风险命令权限。

常见问题

  • 401：当前终端没有读取到 INONEAPI_API_KEY，或 Key 已被撤销。
  • 404：base_url 缺少 /v1，或模型 ID 不存在。
  • Responses 参数错误：确认 wire_api = "responses"，并选择支持 Responses 与工具调用的模型。
  • 402：检查余额和预算；429：检查速率限制和上游容量；不要让 Agent 无限制重试。

生产使用时，为 Codex 单独创建子 Key，并设置预算、模型白名单和告警。参阅团队 Key 与用量。

可选：通过 CC Switch 导入

在模型详情页选择本工具和 API Key，点击「打开 CC Switch 并导入」。使用 CC Switch 官方版本，导入链接已包含当前模型 ID，无需重新填写。确认导入后，按本工具的供应商启用与默认模型设置完成接入。若提示不支持该 app，请升级 CC Switch 或按本文手动接入。

导入链接只添加 Provider，不代表已设为默认模型或已成功请求。链接包含 API Key，请勿分享。手动接入与 CC Switch 接入二选一即可。

官方参考：Codex 配置项。

Codex · 文件 · InOneAPI