> ## Documentation Index
> Fetch the complete documentation index at: https://docs.000328.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex 配置

Codex CLI 使用 OpenAI 兼容接口，因此 Matrix 地址需要追加 `/v1`。

配置目录：

| 系统            | 配置目录                   |
| ------------- | ---------------------- |
| Windows       | `%USERPROFILE%\.codex` |
| macOS / Linux | `~/.codex`             |

如果 `.codex` 目录不存在，请先创建目录。

创建或编辑 `config.toml`：

```toml theme={null}
model_provider = "matrix"
model = "gpt-5.4"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
model_verbosity = "high"

[model_providers.matrix]
name = "matrix"
base_url = "https://matrix.000328.xyz/v1"
wire_api = "responses"
requires_openai_auth = true
```

创建或编辑 `auth.json`：

```json theme={null}
{
  "OPENAI_API_KEY": "sk-你的Codex分组APIKey"
}
```

配置说明：

| 字段                     | 说明                                           |
| ---------------------- | -------------------------------------------- |
| `model_provider`       | 当前使用的供应商名称，需要与 `[model_providers.matrix]` 对应 |
| `model`                | 默认模型，请按 Matrix 控制台实际可用模型调整                   |
| `base_url`             | OpenAI 兼容接口地址，必须使用 `/v1`                     |
| `wire_api`             | Codex 请求协议，建议使用 `responses`                  |
| `requires_openai_auth` | 使用 `OPENAI_API_KEY` 做鉴权                      |

保存后重启终端，在项目目录运行：

```bash theme={null}
codex
```

如果 Codex 无法正常启动或请求失败，请按顺序检查：

1. `config.toml` 是否位于 `.codex` 目录。
2. `auth.json` 是否位于同一个 `.codex` 目录。
3. `base_url` 是否为 `https://matrix.000328.xyz/v1`。
4. `OPENAI_API_KEY` 是否属于 Codex 分组。
5. `model` 是否为 Matrix 控制台实际可用模型。