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

# 配置到 Codex CLI

> 将 Codex CLI 接入兼容 OpenAI API 的第三方服务。

## 开始前

请先确认你已经完成以下准备：

* 已在服务控制台创建 API 密钥
* 本地已安装 Codex CLI

## 配置步骤

### macOS / Linux / WSL

写入配置文件：

```text theme={null}
~/.codex/config.toml
~/.codex/auth.json
```

`config.toml` 示例：

```toml theme={null}
model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://as.sub2api.dev"
wire_api = "responses"
requires_openai_auth = true
```

`auth.json` 示例：

```json theme={null}
{
  "OPENAI_API_KEY": "你的API密钥"
}
```

如目录不存在，可先执行：

```bash theme={null}
mkdir -p ~/.codex
```

### Windows

写入配置文件：

```text theme={null}
%userprofile%\.codex\config.toml
%userprofile%\.codex\auth.json
```

`config.toml` 示例：

```toml theme={null}
model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://as.sub2api.dev"
wire_api = "responses"
requires_openai_auth = true
```

`auth.json` 示例：

```json theme={null}
{
  "OPENAI_API_KEY": "你的API密钥"
}
```

如目录不存在，请先手动创建。

## 验证方式

配置完成后，建议执行以下验证：

1. 重新打开终端
2. 启动 Codex CLI
3. 发送一个简单问题，例如 `hi`
4. 若模型能正常返回结果，则说明配置成功

## 常见问题

### `config.toml` 和 `auth.json` 缺一不可吗？

通常需要两者同时存在：前者负责模型与服务配置，后者负责 API 密钥。

### 修改配置后不生效怎么办？

请先确认文件路径是否正确，并重新打开终端或重新启动 Codex CLI。

## 相关页面

* [Codex 接入概览](/codex/overview)
* [VSCode / Cursor 插件](/codex/vscode)
* [Codex Desktop](/codex/desktop)
* [常见报错](/help/common-errors)