Amazon Bedrock 連携

この構成では、ローカルのクライアントが AWS 管理の認証とアクセス制御を使ってモデルへのリクエストを Bedrock に送ります。Amazon Bedrock をモデルプロバイダーに設定すると、AWS 管理の認証・アカウント管理・課金のもとで Codex をローカル実行できます。

Amazon Bedrock をモデルプロバイダーにすると、OpenAI がホストする Responses API はリクエストの経路に入りません。ローカルのクライアントはモデルへのリクエストを Amazon Bedrock に送り、Bedrock が対応する OpenAI モデル向けに OpenAI 互換の Responses API の実装を提供します。

このプロバイダーでは、ChatGPT へのサインインや OPENAI_API_KEY は使いません。認証には Bedrock API キーまたは AWS IAM の認証情報を使い、Bedrock API キー、AWS SDK の認証情報チェーンの順に確認されます。

ChatGPT のデスクトップアプリ、Codex CLI、IDE 拡張機能、SDK は、同じローカルの設定レイヤーを読み込みます。

プロバイダーを手動で設定する場合や、エンドポイントを変更する場合は ~/.codex/config.toml を編集します。amazon-bedrock は Mantle を、amazon-bedrock-runtime は Runtime を選ぶプロバイダーです。

Bedrock Runtime を使う場合の設定は次のとおりです。

model_provider = "amazon-bedrock-runtime"
web_search = "disabled"

Bedrock Mantle エンドポイントでホスト型の Web 検索を使う場合の設定は次のとおりです。

model_provider = "amazon-bedrock"
web_search = "cached"

Bedrock API キーで認証する場合は、ローカルのクライアントが読み込む環境に API キーを設定し、リージョンも指定する必要があります。デスクトップアプリと IDE 拡張機能では、必要な値を ~/.codex/.env に記述し、アプリまたは拡張機能を再起動します。

デスクトップでは、Sign in another way (別の方法でサインイン) で Use Amazon Bedrock (Amazon Bedrock を使う) を選びます。続いて Set up Amazon Bedrock (Amazon Bedrock の設定) で Choose sign-in method (サインイン方法の選択) を開き、AWS profile、AWS access keys、Bedrock API key のいずれかを選びます。AWS プロファイルの場合は、プロファイル名と AWS リージョンを入力して Continue (続行) を選びます。その後、新しいタスクを開いて設定を確認します。

接続の確認では、Codex CLI で /status を開き、モデルプロバイダーが使うエンドポイントと一致していることを確かめます。そのうえで、新しいタスクで短いプロンプトを送り、応答を確認します。

• Amazon Bedrock ログインは、2026 年 7 月 21 日の追加時点で実験的 (experimental) な機能として提供されました。
• Bedrock Mantle は AWS GovCloud リージョンも受け付けます。
• 対象プランについては、公式のリリースノートには記載がありません。

Codex CLI で Amazon Bedrock をプロバイダーとして設定する流れです。

1. codex を起動し、サインイン画面で Use Amazon Bedrock (Amazon Bedrock を使う) を選びます。
2. 検出された AWS プロファイルや認証情報を選ぶか、認証方法を選びます。認証情報が見つからない場合は、AWS profile (AWS プロファイル)、AWS access keys (AWS アクセスキー)、Environment variables (環境変数)、Bedrock API key (Bedrock API キー) のいずれかを選びます。
3. 選んだ認証方法の案内に従い、求められたら AWS リージョンを入力します。環境変数を選んだ場合は、シェルで環境変数を設定してから Codex を再起動します。