Codex VS Code API キー：カスタムエンドポイントを使用

セットアップ内容

VS CodeのコーディングアシスタントはHTTP経由でモデルと通信します。ほとんどのアシスタントはOpenAI API形式をサポートしており、ベンダーデフォルトの代わりにカスタムベースURLとキーを受け付けます。このサービスはOpenAI互換であるため、そのオプションを提供するツールに接続できます。

エンドポイントの先が何であるかを明確にしてください。これは独立したプロバイダが運用するオープンウェイトモデルの1つであり、法的な成人利用においてコンテンツ拒否なしで回答するように調整されています。OpenAIのCodexモデルでもなく、他のベンダーの公式APIでもありません。テキストのみに対応し、100,000トークンのコンテキストウィンドウ、関数呼び出し、JSON モードをサポートします。OpenAI互換のAPIエンドポイントの詳細を知りたい場合は ドキュメント をお読みください。アドレスのみが必要な場合は、Codex APIのベースURLのページをご覧ください。

すべての場所で使用する3つの値は次の通りです：

キーを取得し、まずテストしてください

Googleまたはメールアドレスとパスワードで API キーページ にアカウントを作成してください。新規ユーザーはワンクリックで7日間有効な$0.50の無料トライアルクレジットを獲得でき、クレジットカードは不要です。その後、VS Codeを操作する前にターミナルでAPI キーをテストしてください。curlコマンドが成功すればAPI キーとURLが正しいことが証明され、その後のエラーは拡張機能に起因するものだとわかります。

Copy# macOS or Linux, add to ~/.zshrc or ~/.bashrc
export CODEX_API_KEY="YOUR_KEY"

# then verify the endpoint answers
curl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer $CODEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python one-liner that reverses a string."}]}'

レスポンスはチャット完了のJSON形式であり、レスポンスには残高クレジットを示すX-Balance-USDヘッダーが含まれます。キーは環境変数または拡張機能のシークレットストレージに保存し、リポジトリには入れないでください。

Codex拡張機能とCLI：設定ファイル

OpenAIのCodexツールは、ホームディレクトリのTOML設定ファイルを通じてカスタムモデルプロバイダをサポートしており、VS Code拡張機能はCLIとその設定を共有するように文書化されています。フォーマットは変化したため、現在のCodexドキュメントであなたのバージョンの情報を確認してください。

Copy# ~/.codex/config.toml
model = "uncensored"
model_provider = "custom"

[model_providers.custom]
name = "Custom endpoint"
base_url = "https://api.getcodexapi.com/v1"
env_key = "CODEX_API_KEY"
wire_api = "chat"

確認すべきポイント：

• base_url は /v1 で終わりますが、/chat/completions は含めないでください。
• env_keyはキー自体ではなく、環境変数の名前です。
• wire_apiはリクエスト形式を選択します。このサービスはPOST /v1/chat/completionsとPOST /v1/responsesの両方を受け入れます。まず「chat」を試してください。Codexのバージョンで「responses」が必要であれば、それを使用してください。
• 変数が設定されたシェルからVS Codeを起動するか、変数をプロファイルに追加した後に再起動してください。macOSでのGUI起動では、シェルのエクスポートが認識されないことがあります。

エージェント型ツールはツール呼び出しに依存します。ストリーミングされたツール呼び出しを含むこちらでのサポートはありますが、モデルによって品質が異なるため、まずは小さなタスクを実行してください。CursorでのAPIの使用方法 に関する関連ページでは、他のエディタでの同様のセットアップについて解説しています。

Continue、Clineおよびその他の拡張機能

サードパーティの拡張機能はそれぞれ独自の画面を持っていますが、パターンは一定です：OpenAIまたは「OpenAI互換」プロバイダを選択し、ベースURL、キー、モデルを入力します。ContinueはYAML設定を使用します：

Copy# Continue (config.yaml), model entry
models:
  - name: Hosted uncensored
    provider: openai
    model: uncensored
    apiBase: https://api.getcodexapi.com/v1
    apiKey: YOUR_KEY

ClineとRoo Codeは設定パネルに「OpenAI互換」プロバイダを提供し、同じ3つのフィールドを使用します。名前やメニューは頻繁に変更されるため、「OpenAI互換」または「カスタムベースURL」で拡張機能自身のドキュメントを検索してください。拡張機能にベースURLのフィールドがない場合、このエンドポイントは使用できません。

時間を節約するヒント：

• ホストされたモデルに対してタブ補完を無効にします。各ポーズごとにリクエストを送信したい場合は有効にしてください。チャットや編集アクションはコストが安いです。
• 日常の編集には拡張機能で小さいコンテキストを設定してください。モデルにリポジトリ全体を送信すると、毎回入力トークンが消費されます。
• ツールごとに別のキーを使用して、どのツールがクレジットを使用しているかを確認できるようにしてください。

このモデルに適したエディタのタスク

大きなコンテキストウィンドウを持つ汎用テキストモデルは、見知らぬコードの説明、関数のユニットテストの作成、スクリプトの言語間変換、docstringsやregexの草案作成、ファイル全体を貼り付けた際のモジュールの書き換えなど、いくつかの日常的なタスクに適切です。100,000トークンのコンテキストウィンドウにより、数個のミディアムサイズのファイルとプロンプトを1つのリクエストに収めることができ、生成結果は残りの容量をすべて使用できます。

残りの部分について現実的になりましょう。エディタ対応のトレーニングを持つ専門的なコーディングモデルではないため、大規模なマルチファイルエージェントの実行には、それ用に構築されたツールに指示を出す場合よりも、より多くのガイダンスと確認が必要です。ファイル全体ではなく差分を依頼し、受け入れる前に変更をレビューし、テストを実行してください。フィルタリングされたアシスタントが拒否するコンテンツ（法的な使用のための大人向けフィクションのスケルトンやセキュリティ調査テキストなど）が必要なタスクの場合、コンテンツ拒否のないエンドポイントを使用する理由になります。

エディターでのコスト

料金は入力トークン100万トークンあたり$0.15、出力トークン100万トークンあたり$0.50です。コーディングツールは大量のコンテキストを送信するため、まず入力のコストを確認してください。

例：ファイルコンテキスト8,000トークンと600トークンの回答を含む編集リクエストのコストは、8,000 x $0.15 / 1M + 600 x $0.50 / 1M = $0.0012 + $0.0003 = $0.0015です。1日150件の同様のリクエストの場合、150 x $0.0015 = $0.225となります。20営業日で$4.50です。

多くのファイルを読み取るエージェントは、1ステップあたり40,000トークンを送信できます。そのサイズでは1ステップあたりのコストは$0.006に出力コストが加算されるため、100ステップで約$0.60プラス出力コストがかかります。エージェントループには注意してください。失敗または拒否されたリクエストは課金されず、クレジットは期限切れになりません。$20から$500までのチャージは、クレジットカード（Visa、Mastercard、Apple Pay、Google Pay）または暗号資産で支払えます。現在のプランは 料金ページ に記載されています。

トラブルシューティング

401 Unauthorized

キーが不足している、余分なスペースがある、または環境変数がVS Codeから参照できません。変数が設定されたターミナルからエディタを再起動してください。

404または「モデルが見つかりません」

正確なモデル uncensored と、末尾に /v1 を付けたベースURL を使用してください。

429エラー

フルキーは8つの同時リクエストと1分あたり300リクエストを許可します。トライアルキーは2つと60を許可します。オートコンプリートとチャットなど複数の同時リクエストを発生させる拡張機能は、同時実行数の制限に達する可能性があります。エラーコードは、一度に多すぎる場合に concurrency 、1分あたりの制限に達した場合は rate_limited です。Retry-After: 5 ヘッダーは一時的な過負荷を意味します。

ストリーミングの停止

一部の企業用プロキシはサーバー送信イベントをバッファリングします。異なるネットワークでテストするか、拡張機能でストリーミングをオフにしてください。

回答が他のアシスタントで見たものと異なる

それは予想通りです。これは独自の長所を持つ異なるモデルです。明確で具体的な指示を出し、自分のプロジェクトのコードでテストしてください。

その他のガイド

• PythonでのCodex API：コーディングLLMの呼び出し
• Codex API Base URL：クライアントを ours に接続する方法