日本語

Amazon Bedrock で ChatGPT Work と Codex を使用する

ローカルの ChatGPT Work と Codex の各サーフェスで、Amazon Bedrock を通じて利用できる OpenAI モデルを使用するよう設定します。

ローカルの ChatGPT Work と Codex の各サーフェスで、Amazon Bedrock を通じて利用できる OpenAI モデルを使用するよう設定します。この構成では、ローカルクライアントが AWS 管理の認証とアクセス制御を使用して、モデルリクエストを Bedrock に送信します。

仕組み

ローカルの ChatGPT Work または Codex のサーフェスで、モデルプロバイダーとして Amazon Bedrock を設定すると、OpenAI がホストする Responses API はリクエスト経路に含まれません。ローカルクライアントがモデルリクエストを Amazon Bedrock に送信し、Bedrock が対応する OpenAI モデル向けに OpenAI 互換の Responses API 実装を提供します。

始める前に

以下を用意してください。

  • Amazon Bedrock で対応する OpenAI モデルへのアクセス権。
  • 選択したモデルを利用できる AWS Region。
  • AWS アカウント用に設定された Amazon Bedrock Mantle 経路の認証。

プロバイダーを設定する

Amazon Bedrock Mantle 経路用の amazon-bedrock モデルプロバイダーを ~/.codex/config.toml に追加します。ChatGPT デスクトップアプリ、Codex CLI、IDE 拡張機能、 SDK は、同じローカル設定レイヤーを読み取ります。モデルの指定は任意です。必要に応じて、対応するモデルを明示的に選択してください。

model_provider = "amazon-bedrock"

認証オプション

ローカルの ChatGPT Work と Codex の各サーフェスは、2 つの Bedrock 認証経路に対応しています。次の順序で確認されます。

  1. Bedrock API key。
  2. AWS SDK 認証情報チェーン。

オプション 1:Bedrock API key

ローカルクライアントが読み取る環境に Bedrock API key を設定します。API key 認証を使用する場合は、Region を指定する必要があります。

export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
export AWS_REGION=us-east-2

オプション 2:AWS SDK 認証情報

組織が AWS SDK 認証情報チェーンを通じて Bedrock へのアクセスを管理している場合は、この経路を使用します。ローカルクライアントは、次の標準的な AWS SDK 認証情報ソースを使用できます。

共有 AWS 設定ファイル

共有 AWS config および credentials ファイルを設定します。

aws configure

環境変数

標準の AWS SDK 認証情報環境変数を設定します。

export AWS_ACCESS_KEY_ID=<your-access-key-id>
export AWS_SECRET_ACCESS_KEY=<your-secret-access-key>
export AWS_SESSION_TOKEN=<your-session-token>

AWS Management Console の認証情報

AWS Management Console の認証情報でログインします。

aws login

AWS SSO または名前付きプロファイル

AWS SSO でログインし、名前付きプロファイルを選択します。

aws sso login --profile codex-bedrock
export AWS_PROFILE=codex-bedrock

フェデレーション ID

企業の SSO または OIDC フェデレーションでは、ローカルクライアントの外部で credential_process を使用するフェデレーション ID を設定し、AWS SDK に認証情報を解決させます。ブラウザログイン、トークン交換、キャッシュ、更新処理は、AWS プロファイルの credential_process ヘルパーに実装してください。

デスクトップアプリと IDE 拡張機能

デスクトップアプリや IDE 拡張機能は、シェルから環境変数を継承しない場合があります。必要な値を ~/.codex/.env に記述し、アプリまたは拡張機能を再起動してください。

export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
export AWS_REGION=us-east-2

設定を確認する

  • Codex CLI で /status を開き、Codex が amazon-bedrock モデルプロバイダーを使用していることを確認します。
  • ChatGPT デスクトップアプリでは、アプリの再起動後に Work または Codex を選択し、新しいタスクを開始します。
  • IDE 拡張機能では、拡張機能の再起動後に新しいセッションを開始します。
  • 選択したモデルが設定済みの AWS Region で利用でき、AWS ID にそのモデルへのアクセス権があることを確認します。

対応モデル

正確なモデル ID を使用してください。

openai.gpt-5.6-sol
openai.gpt-5.6-terra
openai.gpt-5.6-luna
openai.gpt-5.5
openai.gpt-5.4

利用できるモデルは AWS Region によって異なります。モデルを選択する前に、AWS Region ごとのモデル対応状況を確認してください。

機能の提供状況

この構成は、ローカルの ChatGPT Work と Codex のワークフローに対応しています。Web 上でホストされる ChatGPT Work、Codex cloud、および OpenAI がホストするクラウドサービス、ホスト型ツール、クラウド管理の検出機能に依存する機能は、現在利用できません。

* 現在、この機能は特定の Region のみで利用できます。地域制限の詳細については、各機能のドキュメントを確認してください。
ChatGPT 認証を必要としない機能であれば、ローカルのプラグインバンドルを利用できます。 OpenAI が選定したプラグインの検出、およびコネクターやクラウドでホストされる共有機能に依存する機能は利用できません。

トラブルシューティング

設定に失敗する場合は、次を確認してください。

  • モデル ID が対応モデルと完全に一致している。
  • モデルを利用できる AWS Region を指定している。
  • Bedrock API key または AWS 認証情報が有効で、期限切れではない。
  • AWS ID に、選択した Bedrock モデルへのアクセス権がある。
  • AWS_BEARER_TOKEN_BEDROCK に、期限切れまたは意図しないキーが設定されていない。
  • デスクトップアプリまたは IDE 拡張機能を使用する場合、必要な環境変数が ~/.codex/.env に存在する。

サポート範囲

OpenAI Support は、ChatGPT Work と Codex クライアントのセットアップ、設定、ローカル CLI の動作、デスクトップアプリの動作、IDE 拡張機能の動作、ローカルでの製品体験について支援できます。

AWS 認証情報、IAM 権限、Bedrock モデルへのアクセス、クォータ、請求、 Region ごとの提供状況、Bedrock リクエストの失敗、AWS サービスログ、Bedrock サービスの動作については、お客様の AWS 管理者または AWS Support にお問い合わせください。