このガイドでは、Amazon Bedrock 経由で利用可能な OpenAI モデルを使用するよう Codex を設定します。
この構成では、Codex は Amazon Bedrock 認証情報を使用し、Bedrock による Responses API の実装を通じてモデルリクエストを送信します。OpenAI ホスト型 API はリクエストパスに含まれません。
このセットアップは、次のローカル Codex ワークフローをサポートします:
Codex CLI
Codex デスクトップアプリ
Codex VS Code 拡張機能
この記事は、ChatGPT サインインまたは OpenAI API キーで構成された Codex には適用されません。
開始前に
次のものがあることを確認してください:
Codex CLI バージョン 0.128.0 以降
Codex デスクトップアプリまたは VS Code 拡張機能バージョン 26.429.30905 以降
Amazon Bedrock でサポートされている OpenAI モデルへのアクセス
選択したモデルが利用可能な AWS リージョン
AWS アカウント用に設定された Bedrock 対応認証
サポート対象モデル
次の正確なモデル ID のいずれかを使用します:
openai.gpt-5.6-sol
openai.gpt-5.6-terra
openai.gpt-5.6-luna
openai.gpt-5.5
openai.gpt-5.4
推奨デフォルト:
openai.gpt-5.6-sol
Codex の設定
次を以下に追加します:
~/.codex/config.toml
model = "openai.gpt-5.6-sol"
model_provider = "amazon-bedrock"
[model_providers.amazon-bedrock.aws]
region = "us-west-2"
wire_api = "responses"
# Optional for AWS SDK auth. If omitted, the AWS SDK uses AWS_PROFILE or the default profile.
# profile = "codex-bedrock"
us-west-2 を、選択したモデルを利用できる AWS リージョンに置き換えます。
認証オプション
Codex は 2 つの Amazon Bedrock 認証パスに対応しています:
AWS_BEARER_TOKEN_BEDROCKを使用する Bedrock API キーIAM 署名付きリクエスト用の AWS SDK 認証情報チェーン
Codex は次の順序で認証を確認します:
AWS_BEARER_TOKEN_BEDROCKAWS SDK 認証情報チェーン
AWS_BEARER_TOKEN_BEDROCK が設定されている場合、Codex はまずそれを使用します。それ以外の場合、Codex は AWS SDK 認証情報チェーンにフォールバックします。
この構成では OPENAI_API_KEY を使用しないでください。model_provider が amazon-bedrock に設定されている場合、Codex は Amazon Bedrock 認証情報を使用します。
AWS アカウントが Bedrock API キーに対応している場合は、Bedrock API キーを使用してください。組織が IAM、AWS SSO、名前付きプロファイル、またはフェデレーテッド ID を通じて Bedrock アクセスを管理している場合は、AWS SDK 認証情報を使用してください。
オプション 1: Bedrock API キーの使用
Bedrock API キーを、Codex が読み取る環境に設定します:
export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
次に、Codex 設定に Bedrock リージョンが含まれていることを確認します:
model = "openai.gpt-5.6-sol"
model_provider = "amazon-bedrock"
[model_providers.amazon-bedrock.aws]
wire_api = "responses"
region = "us-west-2"
Bedrock API キー認証を使用する場合は、リージョンが必要です。
オプション 2：AWS SDK 認証情報の使用
Codex を AWS IAM 認証情報で認証する場合は、この方法を使用します。
Codex は AWS SDK の認証情報チェーンを使用するため、AWS 共有設定ファイル、環境変数、AWS SSO、指定プロファイルなど、標準的な AWS 認証情報の設定を利用できます。
AWS の共有認証情報
aws configure
環境変数
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 login
AWS SSO または指定プロファイル
aws sso login --profile <profile-name>
export AWS_PROFILE=<profile-name>
~/.codex/config.toml でプロファイルを直接指定することもできます。
model = "openai.gpt-5.6-sol"
model_provider = "amazon-bedrock"
[model_providers.amazon-bedrock.aws]
profile = "codex-bedrock"
wire_api = "responses"
region = "us-west-2"
model_providers.amazon-bedrock.aws.region が設定されている場合、Codex はその値を優先して使用します。設定されていない場合、SDK 認証では、Codex はリージョンの決定を AWS SDK のデフォルト設定チェーンに委ねます。これには AWS_REGION、AWS_DEFAULT_REGION、選択した AWS プロファイルが含まれます。
~/.codex/config.tomlAWS_REGIONAWS_DEFAULT_REGION選択した AWS プロファイル
リージョンを ~/.codex/config.toml で指定するのが最も明示的な方法です。
credential_process によるフェデレーション ID
企業の SSO または OIDC フェデレーションでは、AWS プロファイルを Codex の外部で設定し、認証情報の解決を AWS SDK に任せます。
~/.aws/config エントリの例:
[profile codex-bedrock]
region = us-west-2
credential_process = /path/to/your/idp-helper --profile codex-bedrock
次に、~/.codex/config.toml で Codex がそのプロファイルを参照するようにします:
model = "openai.gpt-5.6-sol"
model_provider = "amazon-bedrock"
[model_providers.amazon-bedrock.aws]
profile = "codex-bedrock" wire_api = "responses"
region = "us-west-2"
デスクトップアプリと VS Code 拡張機能
デスクトップアプリや IDE 拡張機能は、シェルから環境変数を継承しない場合があります。
Codex が AWS_BEARER_TOKEN_BEDROCK などの環境変数を必要とする場合は、次に追加します:
~/.codex/.env
例:
AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
AWS_REGION=us-west-2
~/.codex/config.toml または ~/.codex/.env を変更した後は、Codex デスクトップアプリまたは VS Code 拡張機能を再起動してください。
セットアップの確認
構成後:
Codex CLI で
/statusを開き、Codex がamazon-bedrockモデルプロバイダーを使用していることを確認します。Codex デスクトップアプリまたは VS Code 拡張機能では、アプリを再起動した後に新しいセッションを開始します。
既知の制限事項
この構成では、現在次の機能は利用できません:
画像生成
入力用の音声文字起こし
クラウドプラグインストア
クラウド構成とポリシー
レビュー、セキュリティ、Web エージェントを含むクラウドエージェント
機能の可用性は、ChatGPT サインインを使用する Codex、OpenAI API キーを使用する Codex、Amazon Bedrock API キーを使用する Codex の間で異なる場合があります。
トラブルシューティング
セットアップに失敗した場合は、次を確認してください:
Codex のバージョンが最小要件を満たしている
モデル ID がサポートされているモデルと完全に一致している
AWS リージョンが設定され、選択したモデルがそのリージョンで利用可能である
AWS 認証情報または Bedrock API キーが有効で、期限切れではない
AWS ID に、選択した Bedrock モデルへアクセスする権限がある
AWS_BEARER_TOKEN_BEDROCKが期限切れまたは意図しないキーに設定されていないAWS SDK 認証情報を使用している場合、選択した AWS プロファイルが有効である
デスクトップアプリまたは VS Code 拡張機能で使用する場合、必要な環境変数が
~/.codex/.envに存在する設定ファイルまたは環境ファイルを変更した後、アプリまたは拡張機能を再起動している
AWS 認証情報、IAM 権限、Bedrock モデルアクセス、クォータ、課金、リージョン別の可用性、または Bedrock サービスエラーについては、AWS 管理者または AWS Support にお問い合わせください。
OpenAI サポートは、Codex クライアントのセットアップ、構成、ローカル Codex の動作について支援できます。