Codex CLI 接入指南

先确认 Responses 支持

提供 GPT 模型或 Chat Completions 不等于兼容 Codex。当前自定义 provider 使用 Responses；还需确认流式响应、工具调用和目标模型支持。

本节针对 Codex CLI 配置。桌面端和托管环境可能另有管理员配置，先确认实际配置来源。

合并配置，不直接覆盖原文件

以下假设已安装 Codex CLI，先运行 codex --help 确认可用。默认配置文件是 macOS / Linux 的 ~/.codex/config.toml，Windows 原生的 %USERPROFILE%\.codex\config.toml；WSL 使用 Linux 路径。若设置了 CODEX_HOME，使用该目录下的 config.toml，且目录必须已存在。官方配置位置

先保留现有配置。下面的 model_provider、model 是顶层字段，放在第一个 [表] 之前，provider 表放在后面。同名字段和 provider 表修改已有项，不重复粘贴。替换域名和 EXACT_MODEL_ID；示例域名不能调用。

model_provider = "my_provider"
model = "EXACT_MODEL_ID"

[model_providers.my_provider]
name = "My provider"
base_url = "https://api.example.com/v1"
env_key = "PROVIDER_API_KEY"
wire_api = "responses"

env_key 只填环境变量名，不填 Key 本身。将 PROVIDER_API_KEY 安全注入启动 Codex 的进程后再启动客户端；不要把密钥写进 TOML、命令历史或仓库。base_url 不带 /responses，是否含 /v1 按服务商说明。

在同一个终端临时启动

保存配置后，进入空测试目录，以下命令适用于 Bash（macOS、Linux 或 WSL），不是 PowerShell。隐藏输入临时 Key，子 shell 退出后不把新变量留在外层终端。先用 codex --help 确认版本支持 --no-daemon，以免复用已有后台进程。终端环境变量不保证被从桌面启动的应用继承。

(
  set +x
  IFS= read -r -s -p "请输入临时 API Key: " PROVIDER_API_KEY || exit 1
  printf "\n"
  [ -n "$PROVIDER_API_KEY" ] || exit 1
  export PROVIDER_API_KEY
  codex --no-daemon
)

Windows：PowerShell 7.4+

在 pwsh 中进入空测试目录，同样先核对 codex --help 支持 --no-daemon，再运行下面整段。Key 不写入命令历史；运行期间会进入 Codex 的进程环境，正常退出或启动报错后恢复终端原有变量。不要直接关闭整个终端来验证恢复。

& {
  $hadKey = Test-Path -LiteralPath Env:PROVIDER_API_KEY
  $previousKey = $env:PROVIDER_API_KEY
  $secureKey = $null
  try {
    $secureKey = Read-Host 'Temporary API Key' -AsSecureString
    if ($secureKey.Length -eq 0) { throw 'Empty key.' }
    $env:PROVIDER_API_KEY = [Net.NetworkCredential]::new('', $secureKey).Password
    codex --no-daemon
  } catch {
    Write-Warning 'Launch failed. Check Codex installation and configuration.'
  } finally {
    if ($hadKey) {
      $env:PROVIDER_API_KEY = $previousKey
    } else {
      Remove-Item -LiteralPath Env:PROVIDER_API_KEY -ErrorAction SilentlyContinue
    }
    if ($null -ne $secureKey) { $secureKey.Dispose() }
  }
}

启动后先输入 /status 查看实际模型和 provider；确认无误后再发请求，调用会消耗该服务商额度。Codex 交互可能产生多次请求，应另设账户用量限制。本段按本机 CLI 帮助及官方文档核对，未进行付费推理验收。

完成一次最小验证

用临时 Key、可控用量上限和空测试目录先发短文本请求，核对后台账单后再逐步测试工具调用与流式。

路径或参数错误应先查服务商文档，不要照旧教程改成 wire_api="chat" 或随意指定高推理等级。保留原 provider 配置方便切回。

当前官方配置依据

配置字段参考 · 环境变量说明 · 连接网关说明