Codex

Codex 是一线接入对象。它使用 OpenAI Responses 协议，网关暴露在 /v1/responses。

Codex 的策略 ID 在后端是 codex_direct / codex_auto（与 Chat 风格 OpenAI 分属不同 app family）。UI 显示成 Direct / Auto。只有用 HTTP 直接签发 key 时你才会注意到下划线形式。

ATM 自动检测什么

ATM 通过这两个文件识别 Codex：

• ~/.codex/auth.json — 存 API key。
• ~/.codex/config.toml — Codex 主配置。

ATM 读取激活的 model_provider、model、以及自定义的 [model_providers.*]。

最简方案

桌面 UI 的 Codex 一键启用 是最稳的路径。Agents 页 → Codex → Enable ATM for Codex。ATM 会：

1. 签发 agentType: codex、policyId: codex_direct 的 atm-… key。
2. 写到 ~/.codex/auth.json 的 OPENAI_API_KEY。
3. 在 ~/.codex/config.toml 里追加 [model_providers.ATM] 块。
4. 把 model_provider 切到 "ATM"。

之后重启 Codex（或开新终端会话——Codex 会话启动时重读 config.toml）。

手动接入

要手工配，两份文件都得改。

~/.codex/auth.json

{
  "OPENAI_API_KEY": "atm-xxxxxxxxxxxx"
}

~/.codex/config.toml

model_provider = "ATM"
model = "<your-model-id>"

[model_providers.ATM]
name = "ATM"
base_url = "http://127.0.0.1:4317/v1"
wire_api = "responses"
requires_openai_auth = true

注意：

• model_provider 和 [model_providers.<key>] 大小写要一致 —— ATM 匹配 ATM，atm 不匹配 ATM。
• wire_api = "responses" 必填。写成 chat 会被 ATM 拒绝，因为 Codex 实际发的是 Responses 形状的请求体。
• requires_openai_auth = true 让 Codex 用 Authorization: Bearer <key>，而不是它老的自定义 header。

手动签发 key

curl -s -X POST http://127.0.0.1:4317/api/keys/issue \
  -H 'Content-Type: application/json' \
  -d '{
    "employeeName": "Alice Example",
    "employeeContact": "alice@example.com",
    "agentName": "Codex General",
    "agentType": "codex",
    "sourceTool": "Codex",
    "configPath": "~/.codex/config.toml",
    "policyId": "codex_direct"
  }'

验证

1. 发一次真实 Codex 命令。
2. 打开 GET http://127.0.0.1:4317/api/logs?agent_type=codex&limit=5（或 Overview → Recent Requests 按 Codex 筛选）。
3. 确认日志行存在，resolved_provider 是预期值。

如果没行 → Codex 还在直连 OpenAI，回头检查 model_provider 和 base_url。

切换模型

改顶层 model = "..."。不动 model_provider 和 [model_providers.ATM]。

Direct 策略下，model 就是用的 model。codex_auto 下，ATM 可能根据意图选 Codex 家族里的别的目标。

Chat / Responses 模型列表分离

Codex Provider 端的模型配置拆成两张表：

• chat — 走 /v1/chat/completions 的模型。
• responses — 走 /v1/responses 的模型。

避免把 Codex（永远 Responses 形状）的请求路由到只支持 Chat 的模型。

如果你在 Routing 页写自定义 Codex 策略，target 编辑器里能看到这个分离——从 responses 列表选。

故障排查