Reach APIReach API
进入 Dashboard
Integrations

Codex 集成

本教程介绍如何让 Codex CLI 使用 ReachAPI 网关。

本文示例网关地址：https://direct.reachapi.ai/v1

说明：以下内容基于 2026-04-17 查阅的 OpenAI Codex 官方文档整理。

1. 前置条件

开始前请先确认：

  • 你已准备可用的 ReachAPI Key（例如：sk-xxxxxx）
  • 网关支持 Responses API
  • 本机已安装 Node.js（建议 LTS）

2. Windows（推荐 PowerShell）

2.1 安装 Codex CLI

npm install -g @openai/codex
codex --version

2.2 一键写入配置

# 创建目录
New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null

# 创建 config.toml
@'
model_provider = "reachapi"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.reachapi]
name = "reachapi"
base_url = "https://direct.reachapi.ai/v1"
wire_api = "responses"
requires_openai_auth = true
'@ | Set-Content -Path "$HOME\.codex\config.toml" -Encoding utf8

# 创建 auth.json
@'
{
  "OPENAI_API_KEY": "YOUR_REACH_API_KEY"
}
'@ | Set-Content -Path "$HOME\.codex\auth.json" -Encoding utf8

2.3 验证是否生效

codex

输入测试提示词：

只回复：Codex 网关连接成功

3. macOS / Linux / WSL

3.1 安装 Codex CLI

npm install -g @openai/codex
codex --version

macOS 也可选 Homebrew：

brew install codex

3.2 一键写入配置

mkdir -p ~/.codex

# 创建 config.toml
cat > ~/.codex/config.toml << 'EOF'
model_provider = "reachapi"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.reachapi]
name = "reachapi"
base_url = "https://direct.reachapi.ai/v1"
wire_api = "responses"
requires_openai_auth = true
EOF

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

把 YOUR_REACH_API_KEY 替换为你的真实 Key。

3.3 验证是否生效

codex

输入测试提示词：

只回复：Codex 网关连接成功

4. 常见问题排查

401 / 403 鉴权失败

  • 检查 auth.json 中的 Key 是否正确
  • 检查 Key 是否过期、是否有对应模型权限

404 / Not Found

  • 检查 base_url 是否为 https://direct.reachapi.ai/v1
  • 检查 wire_api = "responses" 是否正确

模型不存在 / model not found

  • 把 model = "gpt-5.4" 改为你网关实际开通的模型 ID

Windows 下命令执行异常

  • 建议优先使用 PowerShell
  • 若提示权限或执行策略问题，可尝试管理员 PowerShell

5. 官方参考

Claude Code 集成

Previous Page

On this page

1. 前置条件
2. Windows（推荐 PowerShell）
2.1 安装 Codex CLI
2.2 一键写入配置
2.3 验证是否生效
3. macOS / Linux / WSL
3.1 安装 Codex CLI
3.2 一键写入配置
3.3 验证是否生效
4. 常见问题排查
401 / 403 鉴权失败
404 / Not Found
模型不存在 / model not found
Windows 下命令执行异常
5. 官方参考