# Codex CLI (/docs/zh-CN/code-cli/codex)

在 [Codex CLI](https://github.com/openai/codex) 的配置文件里加一条 provider，它就能跑在 OhMyGPT 上。之后用你的 OhMyGPT Key，Codex 就能使用 GPT 模型和模型列表里的其他模型，每次运行都可以用 `codex -m` 切换。整套配置可以先用 `ohmygpt/mock` 免费测试。

## 配置 [#配置]

在 `~/.codex/config.toml` 中添加 provider：

```toml title="~/.codex/config.toml"
model = "openai/gpt-5.5"
model_provider = "ohmygpt"

[model_providers.ohmygpt]
name = "OhMyGPT"
base_url = "https://api.ohmygpt.com/v1"
env_key = "OHMYGPT_API_KEY"
wire_api = "responses"
```

Codex 从 `env_key` 指定的环境变量读取 Key。在运行 Codex 的 shell 中导出它：

```bash
export OHMYGPT_API_KEY="sk-..."
codex
```

- `base_url` 以 `/v1` 结尾，Codex 会拼上 `/responses`。
- `wire_api = "responses"` 表示使用 Responses API，Codex 对所有 provider 都用这个 API。
- `model` 可以是[选择模型](#选择模型)中的任意模型 ID。想在某次运行中换用其他模型，用 `codex -m <model id>` 启动 Codex。

## 检查连接 [#检查连接]

向免费测试模型 `ohmygpt/mock` 发送一个和 Codex 相同类型的 Responses 请求：

```bash
curl https://api.ohmygpt.com/v1/responses \
  -H "Authorization: Bearer $OHMYGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "ohmygpt/mock", "input": "ping"}'
```

```json
{
  "id": "resp_MRazQMjAopUMBIjoOfs2bSUL",
  "object": "response",
  "status": "completed",
  "model": "mock",
  "output": [
    {
      "type": "message",
      "id": "msg_0",
      "role": "assistant",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "This is a mock reply from OhMyGPT. Your integration works; switch to a real model when ready."
        }
      ]
    }
  ],
  "usage": { "input_tokens": 15, "output_tokens": 17, "total_tokens": 32 }
}
```

想让 Codex 本身免费跑一次，用 `codex -m ohmygpt/mock` 启动。mock 会调用 Codex 声明的第一个工具，拿到结果后回复一段文本，这样你就能看到 agent 循环完整跑一轮。账户完成充值后即可使用 mock 模型。

## 选择模型 [#选择模型]

列出可以在 Codex 中使用的模型：

```bash
curl -s https://api.ohmygpt.com/v1/models \
  | jq -r '.data[] | select(.available and any(.protocols[]?; .id == "openai-responses")) | .id'
```

各模型的价格见[模型](https://www.ohmygpt.com/models)页面。

Codex 针对 OpenAI 的 GPT 模型做了调优，用 `openai/gpt-*` 模型能获得完整体验。列表中的其他模型（如 `zhipu/glm-5.3`）也能运行 Codex，工具调用和推理设置同样可用。

## 问题排查 [#问题排查]

| 现象 | 原因 | 解决办法 |
|---|---|---|
| ``Missing environment variable: `OHMYGPT_API_KEY`.`` | 运行 Codex 的 shell 中没有导出这个变量 | 执行 `export OHMYGPT_API_KEY=...`，然后重新启动 Codex |
| `` `wire_api = "chat"` is no longer supported. `` | provider 配置用的是旧版 Codex 的设置 | 改为 `wire_api = "responses"` |
| 所有请求都返回 `404` | `base_url` 缺少 `/v1`，请求被发到了 `/responses` | 设置 `base_url = "https://api.ohmygpt.com/v1"` |
| `401`，提示 `Invalid API key` | Key 输错了或已被删除 | 从 [API Key](https://www.ohmygpt.com/keys) 页面复制一个 Key |
| `404`，提示模型不存在 | ID 拼写有误 | 从 `GET /v1/models` 复制 ID |
| `402` | 余额或 Key 的消费额度已用完 | 到[账单](https://www.ohmygpt.com/billing)页面充值 |

每个响应都带有 `X-Request-ID` 头，每个请求的费用可以在[用量](https://www.ohmygpt.com/usage)页面查看。