Codex (OpenAI) 配置教程

安装并配置 Codex，通过 ~/.codex 连接 OmniApexRoute 平台。

按系统选择一键脚本

脚本会自动检测 Node.js 和 Codex CLI，缺失时引导安装；随后提示输入 API Key，并写入 ~/.codex 配置。复制命令不包含密钥。

Windows PowerShell

irm https://docs.omniapexroute.com/install/codex.ps1 | iex

macOS / Linux / WSL

curl -fsSL https://docs.omniapexroute.com/install/codex.sh | bash

配置写入说明

配置写入 ~/.codex 后，Codex CLI 和 Codex App 客户端会同时生效；配置写入后，已打开的 CLI 需要重启后才会读取新配置。

备用方式：手动安装 Codex

一键脚本不可用时再使用以下步骤。

注意

手动安装前请先完成 Node.js 环境安装教程。

第一步：安装 Codex

npm install -g @openai/codex@latest

以上命令会从 npm 官方仓库下载并安装最新版本的 Codex 工具。

验证安装：

codex --version

如果显示版本号，恭喜你！Codex 已经成功安装了。

第二步：创建配置文件

Codex 使用配置文件进行连接设置，需要创建 config.toml 和 auth.json 两个文件。

Windows

# 删除旧目录并创建新目录
if (Test-Path "$env:USERPROFILE\.codex") { Remove-Item -Recurse -Force "$env:USERPROFILE\.codex" }
mkdir "$env:USERPROFILE\.codex"

# 创建 config.toml
@"
model_provider = "omniapexroute"
model = "gpt-5.6-sol"
review_model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.omniapexroute]
name = "omniapexroute"
base_url = "https://api.omniapexroute.com/v1"
wire_api = "responses"
requires_openai_auth = false
"@ | Out-File -FilePath "$env:USERPROFILE\.codex\config.toml" -Encoding utf8

# 创建 auth.json
@"
{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}
"@ | Out-File -FilePath "$env:USERPROFILE\.codex\auth.json" -Encoding utf8

macOS / Linux

# 删除旧目录并创建新目录
rm -rf ~/.codex && mkdir -p ~/.codex

# 创建 config.toml
cat > ~/.codex/config.toml << 'EOF'
model_provider = "omniapexroute"
model = "gpt-5.6-sol"
review_model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
network_access = "enabled"

[model_providers.omniapexroute]
name = "omniapexroute"
base_url = "https://api.omniapexroute.com/v1"
wire_api = "responses"
requires_openai_auth = false
EOF

# 创建 auth.json
cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}
EOF

提示

请将命令中的 YOUR_API_KEY 替换为在 密钥管理 页面中复制的任意 API Key。可用模型：gpt-5.6-sol、gpt-5.6-luna、gpt-5.6-terra、gpt-5.5、gpt-5.4。

第三步：开始使用

进入项目目录后运行：

codex

更多使用说明请参考 OpenAI 官方文档。