Reach APIReach API
ダッシュボードへ
Integrations

Codex 連携

このガイドでは、Codex CLI を ReachAPI ゲートウェイ経由で利用する方法を説明します。

このガイドで使用するゲートウェイ URL 例: https://direct.reachapi.ai/v1

注: 以下の手順は、2026-04-17 時点で確認した OpenAI 公式 Codex ドキュメントをもとに整理しています。

1. 前提条件

始める前に、次の条件を確認してください。

  • sk-xxxxxx のような有効な ReachAPI キーを持っている
  • ゲートウェイが Responses API に対応している
  • 端末に Node.js が入っている。できれば LTS 版を推奨

2. Windows（PowerShell 推奨）

2.1 Codex CLI をインストールする

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

2.2 設定を一括で書き込む

# Create directory
New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null

# Create 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

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

2.3 設定を確認する

codex

次のテストプロンプトを入力します。

Reply with: Codex gateway connection successful

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

# Create 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

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

YOUR_REACH_API_KEY は実際のキーに置き換えてください。

3.3 設定を確認する

codex

次のテストプロンプトを入力します。

Reply with: Codex gateway connection successful

4. トラブルシューティング

401 / 403 Authentication Failed

  • auth.json のキーが正しいか確認してください
  • キーの有効期限が切れていないか、対象モデルへのアクセス権があるか確認してください

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 Authentication Failed
404 / Not Found
model not found
Windows でコマンドがうまく動かない
5. 公式参考資料