---
description: "通过 config.toml 将 Codex 接入在问 Responses 协议模型。"
---

# 接入 Codex

> 三大平台都可以使用 npm 一键安装：
> `npm install -g @openai/codex`

打开 `~/.codex/config.toml`，文件不存在则创建，并写入以下内容（将 `你的在问APIKEY` 替换为实际 Key）：

```toml
model_provider = "custom"
model = "gpt-5.6-luna"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.custom]
name = "custom"
base_url = "https://oneapi.zaiwenai.com/v1"
wire_api = "responses"
requires_openai_auth = false
http_headers = { "x-openai-actor-authorization" = "local-image-extension" }
experimental_bearer_token = "你的在问APIKEY"
```

也可以使用以下辅助命令自动备份并写入。macOS、Linux 或 WSL：

```bash
mkdir -p "$HOME/.codex"
[ ! -f "$HOME/.codex/config.toml" ] || cp "$HOME/.codex/config.toml" "$HOME/.codex/config.toml.bak"
cat > "$HOME/.codex/config.toml" << 'CODEX_EOF'
model_provider = "custom"
model = "gpt-5.6-luna"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.custom]
name = "custom"
base_url = "https://oneapi.zaiwenai.com/v1"
wire_api = "responses"
requires_openai_auth = false
http_headers = { "x-openai-actor-authorization" = "local-image-extension" }
experimental_bearer_token = "你的在问APIKEY"
CODEX_EOF
```

Windows PowerShell：

```powershell
$codexDir = Join-Path $HOME ".codex"
$configPath = Join-Path $codexDir "config.toml"
New-Item -ItemType Directory -Force -Path $codexDir | Out-Null
if (Test-Path $configPath) { Copy-Item $configPath "$configPath.bak" -Force }
@'
model_provider = "custom"
model = "gpt-5.6-luna"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.custom]
name = "custom"
base_url = "https://oneapi.zaiwenai.com/v1"
wire_api = "responses"
requires_openai_auth = false
http_headers = { "x-openai-actor-authorization" = "local-image-extension" }
experimental_bearer_token = "你的在问APIKEY"
'@ | Set-Content -Encoding utf8 $configPath
```

:::: tip 配置说明
- `model`：默认使用 `gpt-5.6-luna`，也可以替换为在问 OneAPI 支持的其他 Codex 系列模型
- `requires_openai_auth = false` + `experimental_bearer_token`：将 API Key 直写于 `config.toml` 的 provider 配置中，无需再维护 `~/.codex/auth.json`；`experimental_bearer_token` 与 `env_key` / `requires_openai_auth` / `[model_providers.*.auth]` 互斥
- `wire_api = "responses"`：走 OpenAI Responses 协议（`/v1/responses`），与在问服务端一致，能正确下发 `reasoning.effort`
- `http_headers`：激活 Codex 客户端本地图片工具（`image_gen`，Responses Lite）；该 header 透传到服务端，在问服务端忽略未知 header，无副作用；改完需完全重启 Codex 并开新会话重建工具列表
- 辅助命令会在覆盖前将已有配置文件备份为 `~/.codex/config.toml.bak`
- 旧版 `~/.codex/auth.json`（`OPENAI_API_KEY`）已废弃，如仍存在可手动删除
::::