Amazon Bedrock で ChatGPT Work と Codex を使用する
Amazon Bedrock で利用可能な OpenAI モデルを使用するように、ローカルの ChatGPT Work および Codex サーフェスを設定します。
Amazon Bedrock で利用可能な OpenAI モデルを使用するように、ローカルの ChatGPT Work および Codex サーフェスを設定します。この構成では、ローカルクライアントが AWS 管理の認証とアクセス制御を使用して Bedrock にモデルリクエストを送信します。
仕組み
Amazon Bedrock をモデルプロバイダーとしてローカルの ChatGPT Work または Codex サーフェスに設定すると、OpenAI がホストする Responses API はリクエスト経路に含まれません。ローカルクライアントが Amazon Bedrock にモデルリクエストを送信し、Bedrock が対応する OpenAI モデル向けに OpenAI 互換の Responses API 実装を提供します。
始める前に
次の項目を確認してください。
- 使用する AWS アカウントの認証情報。
- Amazon Bedrock のサポート対象 OpenAI モデルへのアクセス権。
- 選択したモデルを利用できる AWS リージョンへのアクセス権。
- 選択したモデルまたは推論プロファイルを呼び出すための AWS 権限。
モデル固有の IAM 要件を確認してください。たとえば、Runtime 経由で GPT-6 Sol を使用する場合は、アカウントのデフォルトプロジェクトに対する bedrock:InvokeModel も必要です。AWS の GPT-6 Sol の設定手順を参照してください。
プロバイダーを設定する
Codex では、~/.codex/config.toml の model_provider を設定してプロバイダーを構成できます。ChatGPT デスクトップアプリ、Codex CLI、IDE 拡張機能、SDK は、同じローカル構成レイヤーを読み取ります。
使用する Amazon Bedrock エンドポイントのプロバイダーを選択します。クロスリージョン推論（CRIS）には Bedrock Runtime、リージョン内推論には Bedrock Mantle を使用します。
新規設定には Bedrock Runtime を使用してください。
model_provider = "amazon-bedrock-runtime"
web_search = "disabled"ホスト型ウェブ検索に Mantle を使用する
Bedrock Mantle エンドポイントの場合：
model_provider = "amazon-bedrock"
web_search = "cached"モデルを選択する
Codex は、設定された model_provider に基づいて、モデルピッカーに表示するモデルを選択します。amazon-bedrock-runtime の場合は Bedrock Runtime エンドポイントでサポートされるモデル、amazon-bedrock の場合は Bedrock Mantle エンドポイントでサポートされるモデルが表示されます。
必要に応じて、設定ファイルでサポート対象モデルを指定できます。組み込みプロバイダーは独自のモデルカタログを提供します。エンドポイントを切り替える際は、プロバイダーと、明示的に指定したモデル ID を一緒に変更してください。
認証オプション
ローカルの ChatGPT Work および Codex サーフェスは、2 つの Bedrock 認証パスに対応しています。次の順序で確認されます。
- Bedrock API key。
- 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-2Windows PowerShell の場合：
$env:AWS_BEARER_TOKEN_BEDROCK = "<your-bedrock-api-key>"
$env: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 loginAWS 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 に設定し、アプリまたは拡張機能を再起動してください。Windows でのデフォルトパスは %USERPROFILE%\.codex\.env です。
export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
export AWS_REGION=us-east-2設定を確認する
- Codex CLI で
/statusを開き、モデルプロバイダーが使用するエンドポイントと一致していることを確認します。Mantle のリージョン内推論にはamazon-bedrock、Runtime の Global または Geo クロスリージョン推論にはamazon-bedrock-runtimeを使用します。 - ChatGPT デスクトップアプリでは、アプリを再起動した後に Work または Codex を選択し、新しいタスクを開始します。
- IDE 拡張機能では、拡張機能を再起動した後に新しいセッションを開始します。
- 選択したモデルが、設定した AWS Region で利用可能であり、AWS ID にそのモデルへのアクセス権限があることを確認します。
次に、新しいタスクで短いプロンプトを送信してください。
Reply with exactly: bedrock-okbedrock-ok が返されることを確認します。クライアントでプロバイダーとモデルを確認してください。応答だけでは経路を特定できません。ロールアウトの適格性を確認するには、読み取り専用権限を設定した一時的なフォルダーを使用し、無害なローカルツールのタスクと、それに続くターンの動作を検証してください。
対応モデル
Bedrock Runtime プロバイダーには推論プロファイル ID、Bedrock Mantle プロバイダーにはモデル ID を使用します。選択したモデルまたはプロファイルが AWS Region で利用可能であり、使用する AWS ID からアクセスできる必要があります。
Bedrock Runtime エンドポイントを使用した Global および Geo クロスリージョン推論
Global CRIS は、世界中のサポート対象の商用 AWS リージョンにリクエストをルーティングできます。一方、Geo CRIS はプロファイルの地理的範囲内でリクエストをルーティングします。 AWS の権限とデータレジデンシーの要件を満たすルーティング範囲を選択してください。
model_provider = "amazon-bedrock-runtime"を使用し、任意のmodel設定に、以下のリストにある推論プロファイル ID を指定します。プロバイダーは
https://bedrock-runtime.{region}.amazonaws.com/openai/v1を使用します。ここで{region}は、リクエストの送信元としてサポートされている AWS Region です。Global CRIS と Geo CRIS は、どちらもこのエンドポイントアドレスを使用します。
Global CRIS
サポート対象のモデルと推論プロファイル ID：
- GPT-6 Astra:
global.openai.gpt-6-astra - GPT-6 Sol:
global.openai.gpt-6-sol - GPT-6 Luna:
global.openai.gpt-6-luna
たとえば、~/.codex/config.tomlで Global CRIS を使用するように Astra を設定します：
model_provider = "amazon-bedrock-runtime"
model = "global.openai.gpt-6-astra"米国 Geo CRIS
サポート対象のモデルと推論プロファイル ID：
- GPT-6 Astra:
us.openai.gpt-6-astra - GPT-6 Sol:
us.openai.gpt-6-sol - GPT-6 Luna:
us.openai.gpt-6-luna
Codex に組み込まれた Runtime のモデル選択には、米国 Geo と Global のバリアントが表示されます。
モデルと CRIS の提供状況は、送信元の AWS Region によって異なります。プロバイダーとモデルを選択する前に、各モデルの正確な推論プロファイル ID とリージョン別の提供状況へのリンクを掲載している AWS の「推論プロファイルでサポートされるリージョンとモデル」および「モデル別のリージョン提供状況」を参照してください。
Bedrock Mantle エンドポイントを使用したリージョン内推論
model_provider = "amazon-bedrock"を使用し、必要に応じてモデル ID を指定します。プロバイダーは
https://bedrock-mantle.{region}.api.aws/openai/v1を使用します。
サポート対象のモデルとモデル ID：
- GPT-6 Astra:
openai.gpt-6-astra - GPT-6 Sol:
openai.gpt-6-sol - GPT-6 Luna:
openai.gpt-6-luna
GPT-6 Sol と Luna は、Mantle を通じて us-east-1 (N. Virginia) で利用できます。モデルの可用性は AWS Region によって異なります。プロバイダーとモデルを選択する前に、AWS の モデル別のリージョン提供状況 を参照してください。GPT-6 Astra については、GPT-6 Astra の Bedrock モデルページ を参照してください。
機能の提供状況
この設定は、ローカルの ChatGPT Work と Codex のワークフローをサポートします。ホスト型のウェブ版 ChatGPT Work、Codex cloud、および OpenAI がホストするクラウドサービスやクラウド管理の検出機能に依存する機能は、現在利用できません。Runtime ではホスト型ウェブ検索を利用できません。必要な場合は、 Mantle を使用してください。
Codex Security CLI は独自のプロバイダー設定を使用します。 Amazon Bedrock のセットアップに従ってください。上記のネイティブクライアントの設定は使用しません。
機能の利用可否の詳細
* この機能は現在、特定の地域でのみ利用できます。地域制限の詳細は、各機能のドキュメントを確認してください。
† ローカルのプラグインバンドルと、Codex Security を含む、ChatGPT 認証を必要としない OpenAI 選定のプラグインを利用できます。ChatGPT 認証、コネクター、またはクラウド上での共有を必要とするプラグインは利用できません。
トラブルシューティング
設定に失敗する場合は、次の項目を確認してください。
- モデル ID がサポート対象のモデルと完全に一致していること。
- エンドポイントに適したモデルプロバイダーを使用していること。Runtime エンドポイントには
amazon-bedrock-runtime、Mantle エンドポイントにはamazon-bedrockを使用します。 - モデルを利用できる AWS リージョンを指定していること。
- Bedrock の API key または AWS 認証情報が有効で、期限切れになっていないこと。
- AWS ID に、選択した Bedrock モデルへのアクセス権限があること。
AWS_BEARER_TOKEN_BEDROCKに期限切れのキーや意図しないキーが設定されていないこと。- デスクトップアプリまたは IDE 拡張機能を使用する場合、必要な環境変数が
~/.codex/.envに存在すること。
AWS SDK のプロファイル認証では、aws sts get-caller-identity --profile codex-bedrock を実行して、選択したプロファイルの ID を確認します。codex-bedrock を自分のプロファイル名に置き換えるか、デフォルトの認証情報チェーンを使用する場合は --profile を省略してください。この操作で確認するのは AWS ID であり、Bedrock モデルを呼び出す権限ではありません。
AWS_BEARER_TOKEN_BEDROCK も別途確認し、意図しない API key によって別の認証経路が選択されないようにしてください。
サポート範囲
OpenAI Support は、ChatGPT Work および Codex クライアントのセットアップ、設定、ローカル CLI の動作、デスクトップアプリの動作、IDE 拡張機能の動作、ローカルでの製品利用についてサポートできます。
AWS 認証情報、IAM 権限、Bedrock モデルへのアクセス、クォータ、課金、地域別の提供状況、Bedrock リクエストの失敗、AWS サービスログ、Bedrock サービスの動作については、お客様の AWS 管理者または AWS Support にお問い合わせください。