Codex Setup

Codex 配置教程

按系统切换步骤，直接找到配置目录、写入 `config.toml` 和 `auth.json`，再用 `codex` 做一次终端验证。

配置目录

Windows 通常用 `%userprofile%\.codex`，macOS 通常用 `~/.codex`。如果目录和文件不存在，可以手动创建。

核心文件

Codex 的中转接入通常需要两个文件：`config.toml` 负责模型和地址，`auth.json` 负责 API Key。

验证方式

配置完成后进入项目目录执行 `codex`，只要能正常进入交互界面并收到回复，就说明连接成功。

Windows

Windows 配置步骤

按下 `Win + R`，输入 `%userprofile%\\.codex` 后回车，打开 Codex 配置目录。
如果目录里没有 `config.toml` 和 `auth.json`，手动创建这两个文件。

把下面这段配置写入 `config.toml`。

disable_response_storage = true
model = "替换为中转站支持的模型名"
model_provider = "relay"
model_reasoning_effort = "high"
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.relay]
base_url = "https://api.i9vc.com/v1"
name = "relay"
requires_openai_auth = true
wire_api = "responses"

再把下面这段配置写入 `auth.json`。

{
  "OPENAI_API_KEY": "替换成你的 API Key"
}

保存文件后，重新打开终端或进入项目文件夹打开终端，输入 `codex`，启动 Codex。

macOS

macOS 配置步骤

在 Finder 中按 `Command + Shift + G`，输入 `~/.codex` 并回车。
如果目录不存在先创建；如果缺少 `config.toml` 和 `auth.json`，手动补齐。

把下面这段内容写入 `config.toml`。

disable_response_storage = true
model = "替换为中转站支持的模型名"
model_provider = "relay"
model_reasoning_effort = "high"
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.relay]
base_url = "https://api.i9vc.com/v1"
name = "relay"
requires_openai_auth = true
wire_api = "responses"

再把下面这段内容写入 `auth.json`。

{
  "OPENAI_API_KEY": "替换成你的 API Key"
}

保存后打开终端或进入项目文件夹打开终端，输入 `codex`，启动 Codex。

补充说明

示例里的中转域名使用 `api.i9vc.com`，如果你的实际接入文档给出了其他路径或字段名，请以实际说明为准。
`model` 这一项请替换成你中转站实际支持的模型名称。
如果启动后仍报错，优先检查 `.codex` 目录位置、`config.toml` 格式和 API Key 是否填写完整。