# Codex 接入

## 配置 Codex

将以下内容合并到用户配置 `~/.codex/config.toml`：

```toml
model = "YOUR_MODEL"
model_provider = "creative_reasoning_router"

[model_providers.creative_reasoning_router]
name = "Creative Reasoning Router"
base_url = "https://your-cr-gateway.example/unified/v1"
env_key = "CRR_API_KEY"
wire_api = "responses"
```

`env_key` 是环境变量名称。设置该变量并启动 Codex：

```bash
export CRR_API_KEY="YOUR_API_KEY"
codex
```

## 启动并验证

1. 确认 Codex 显示配置的模型。
2. 完成一个短任务，并验证一次工具调用。
3. 如果请求失败，按[排障与重试](/docs/zh/troubleshooting)保留状态码、模型名称和 CR 请求 ID。

## Codex 配置约束

- 将 `model` 和 `model_provider` 放在第一个 TOML 表之前，并保留已有配置。
- `base_url` 以 `/unified/v1` 结尾，不包含具体操作路径。
- 保持 `wire_api = "responses"`。