Bedrock GovCloud の設定
AWS GovCloud の Amazon Bedrock を使用するローカル Codex ワークフローを設定します
このガイドでは、GovCloud の Amazon Bedrock で推論を実行するための Codex の設定方法を説明します。AWS へのアクセス、管理対象デバイスの設定、ネットワーク制御を取り上げます。
責任共有
AWS 責任共有モデルと、選択したサービスのドキュメントを確認し、AWS が提供する制御を把握してください。それらの利用を認可する責任は、所属機関にあります。
サポート対象のデプロイ構成では、Codex は AWS 認証を使用して、設定された Bedrock エンドポイントに推論リクエストを送信します。Codex を実行するデバイスのセキュリティ確保は、認証情報、リポジトリ、ローカルの記録、有効になっているサードパーティサービスも含め、組織の責任です。推論に GovCloud を使用しても、ワークフロー全体が所属機関の要件を満たすことが保証されるわけではありません。
始める前に
デスクトップアプリの バージョン 26.1002.51308 以降 を使用してください。バージョンは バージョン情報 で確認できます。
| 準備項目 | 必要なもの |
|---|---|
| AWS アクセス | 使用する Bedrock モデルにアクセスできる AWS GovCloud アカウント。 |
| 構成 | レビュー済みの requirements.toml、承認済みのネットワーク接続先、ロールバック手順。 |
| デバイス管理 | システム構成または MDM へのアクセス権と、アプリ、デバイス、エージェントのコマンドに適用するネットワークポリシー。 |
1. デバイス要件をデプロイする
アプリの起動前に、システム構成または MDM を通じて requirements.toml をデプロイします。ファイルの配置場所と MDM による配布については、管理対象の構成に従ってください。管理対象ポリシーを保護し、手順 3で Codex を実行するマシン上の設定を検証します。
推奨の requirements.toml
以下のデフォルトの requirements.toml は、意図的に厳しく制限しています。管理者は、追加機能がもたらすリスクを受け入れる場合、その機能を有効にできます。機能のドキュメントとネットワーク制御のドキュメントを参照してください。
requirements.toml
# Disable ChatGPT sign-in.
allowed_login_methods = ["api"]
# https://learn.chatgpt.com/docs/agent-approvals-security#common-sandbox-and-approval-combinations
allowed_sandbox_modes = ["read-only", "workspace-write"]
# Approval prompts are reviewed by the user.
allowed_approvals_reviewers = ["user"]
allowed_approval_policies = [
{ granular = { sandbox_approval = false, rules = true, mcp_elicitations = false, request_permissions = false, skill_approval = true } },
]
# Allow cached search only if your AWS GovCloud Region supports web search.
allowed_web_search_modes = ["disabled", "cached"]
# Block agent browser use and native-app control.
allow_browser_and_computer_use = false
# Appshots: https://learn.chatgpt.com/docs/appshots
allow_appshots = false
# Remote control: https://learn.chatgpt.com/docs/remote-connections#pick-up-work-from-another-device
allow_remote_control = false
# Managed hooks: https://learn.chatgpt.com/docs/enterprise/managed-configuration#enforce-managed-hooks-from-requirements
allow_managed_hooks_only = true
check_for_update_on_startup = false
# MCP servers, apps, and plugins are disabled by default.
# Admins can enable supported integrations after accepting the risks
# for their use case and configuring access and network controls.
# https://learn.chatgpt.com/docs/enterprise/managed-configuration
mcp_servers = {}
[features]
apps = false
enable_mcp_apps = false
plugins = false
# Enable the network proxy for sandboxed commands.
# https://learn.chatgpt.com/docs/agent-approvals-security#network-isolation
network_proxy = true
in_app_dictation = false
realtime_conversation = false
# Browser controls: https://learn.chatgpt.com/docs/enterprise/managed-configuration#disable-codex-feature-surfaces
# Note that both browser use and computer use are up to your organization's risk appetite.
# An agent using your browser or computer may navigate to any websites or applications that the
# computer has access to. OpenAI does not currently provide additional protections restricting
# the network paths that browser use and computer use may exercise.
in_app_browser = false
browser_use = false
browser_use_external = false
browser_use_full_cdp_access = false
# Computer Use: https://learn.chatgpt.com/docs/computer-use
# Enable after accepting the risks and configuring app and network access.
computer_use = false
# Set to true to let users update through the app.
# App-store, package-manager, and MDM updates are controlled separately.
# https://learn.chatgpt.com/docs/enterprise/manage-app-updates#turn-off-in-app-updates
in_app_updates = false
image_generation = false
# Memories: https://learn.chatgpt.com/docs/customization/memories
memories = false
# Computer History: https://learn.chatgpt.com/docs/customization/computer-history
chronicle = false
external_agent_memory_import = false
# We recommend that users review approval requests themselves.
# Admins can enable automatic review after accepting the risks for their use case.
# https://learn.chatgpt.com/docs/agent-approvals-security#automatic-approval-reviews
guardian_approval = false
guardianv2 = false
# Disable background skill-search experiments.
skill_search = false
# Hooks: https://learn.chatgpt.com/docs/hooks
hooks = false
# If you enable web search, use cached search through Bedrock Mantle
# where supported by your AWS GovCloud Region.
standalone_web_search = false
# Disable feedback submissions to OpenAI.
[feedback]
enabled = false
# Network controls for agent commands:
# https://learn.chatgpt.com/docs/enterprise/managed-configuration#configure-network-access-requirements
[experimental_network]
enabled = true
managed_allowed_domains_only = true
# No domains allowed by default. Add destinations approved for your use case.
domains = {}
# Add approved Unix socket paths here.
unix_sockets = {}
# Set to true when using an organization-approved upstream proxy.
allow_upstream_proxy = false
# Keep the command proxy bound to localhost.
dangerously_allow_non_loopback_proxy = false
dangerously_allow_all_unix_sockets = false
# Local/private networking: https://learn.chatgpt.com/docs/agent-approvals-security#local-and-private-destinations
allow_local_binding = false
# App network controls: https://learn.chatgpt.com/docs/enterprise/managed-configuration#control-desktop-app-network-destinations
[application.network]
enabled = true
# Example: Bedrock Mantle in us-gov-west-1.
# Replace this hostname with the Bedrock endpoint configured in config.toml.
[application.network.domains]
"bedrock-mantle.us-gov-west-1.api.aws" = "allow"
# OpenAI and ChatGPT endpoints.
# We recommend denying these endpoints to avoid any risk that user data is sent to commercial OpenAI infrastructure.
"api.openai.com" = "deny"
"chat.openai.com" = "deny"
"chatgpt.com" = "deny"
"ab.chatgpt.com" = "deny"
"platform.openai.com" = "deny"
"auth.openai.com" = "deny"
"gov.api.openai.com" = "deny"
"gov.chatgpt.com" = "deny"
"sdfedpreastus2.oaiusercontent.com" = "deny"
"o33249.ingest.us.sentry.io" = "deny"
"persistent.oaistatic.com" = "deny"
"oaisidekickupdates.blob.core.windows.net" = "deny"
# Windows only: https://learn.chatgpt.com/docs/config-file/config-reference#requirementstoml
[windows]
allowed_sandbox_implementations = ["elevated"]2. プロバイダーのルーティングとネットワーク制御を構成する
config.toml または管理対象のデフォルト設定で、プロバイダー、モデル、リージョン、エンドポイントを設定します。ユーザーは、requirements.toml で定められた制限の範囲内で、これらのデフォルト設定を変更できます。
推奨の config.toml
以下の例では、us-gov-west-1 の Mantle を使用しています。モデル ID と AWS プロファイルを、デプロイ環境の値に置き換えてください。サポートされている別のリージョンやエンドポイントを使用する場合は、URL、リージョン、ネットワークポリシーをまとめて更新してください。
この例では、任意の診断機能とデータ共有を無効にしています。AWS 認証情報は TOML ファイルの外部に保管してください。AWS プロファイル、認証情報、認証情報ヘルパースクリプトは、Codex が変更できるフォルダーの外部に保管してください。
config.toml
# Replace with your approved Bedrock model ID.
model = "openai.gpt-5.6-terra"
model_provider = "amazon-bedrock"
approval_policy = { granular = { sandbox_approval = false, rules = true, mcp_elicitations = false, request_permissions = false, skill_approval = true } }
sandbox_mode = "workspace-write"
# Set to "cached" only when supported by your model and GovCloud Region
# and approved for your deployment.
# https://docs.aws.amazon.com/bedrock/latest/userguide/web-search.html
web_search = "disabled"
# Example: Bedrock Mantle in us-gov-west-1.
[model_providers.amazon-bedrock]
base_url = "https://bedrock-mantle.us-gov-west-1.api.aws/openai/v1"
wire_api = "responses"
requires_openai_auth = false
[model_providers.amazon-bedrock.aws]
region = "us-gov-west-1"
# Replace with your AWS profile name.
profile = "codex-govcloud"
[sandbox_workspace_write]
# Command destinations are controlled by requirements.toml.
network_access = true
# Disable sending Codex usage analytics to OpenAI.
[analytics]
enabled = false
# OpenTelemetry exports are off by default.
# Admins can configure an approved collector for logs, traces, and metrics.
# https://learn.chatgpt.com/docs/config-file/config-advanced#observability-and-telemetry
[otel]
exporter = "none"
trace_exporter = "none"
metrics_exporter = "none"
log_user_prompt = falseこの例では、Bedrock Mantle で AWS 認証情報を使用しています。Bedrock Runtime またはゲートウェイを使用する場合は、プロバイダーのセットアップ手順に従ってください。
ネットワーク制御を適用する
Bedrock を含む、承認済みのアプリの接続先を application.network.domains に追加します。承認済みのコマンドの接続先を experimental_network.domains に追加します。
Codex のネットワーク設定は、デバイスのファイアウォールの代わりにはなりません。
3. デプロイを検証する
- ポリシーが有効であり、Codex が意図した AWS 認証情報と Bedrock 設定を使用していることを確認します。
- サンプルデータを使用して、承認済みのワークフローを実行します。
- ユーザー設定で管理対象の制限を上書きできないことを確認します。
- 無効または期限切れの認証情報と、ルーティングの障害をテストします。未承認の接続先にコンテンツが送信されないことを確認します。
よくある問題のトラブルシューティング
| 問題 | 確認事項 |
|---|---|
| サポートされていないエンドポイント | インストール済みのデスクトップアプリと app-server のバージョンが、そのエンドポイントとモデルをサポートしているか OpenAI に確認してください。 |
| AWS アカウントまたはロールが正しくない | 現在使用中の認証情報と、選択されている AWS プロファイルを確認してください。Bedrock API key がプロファイルより優先される場合があります。 |
| 制限が適用されない | Codex を実行するマシンで、意図した requirements.toml が読み込まれていることを確認してください。 |
| 機能が引き続き利用できない | 機能のドキュメントで必要な設定と Bedrock のサポート状況を確認し、その後ネットワーク制御を確認してください。 |
機能の設定
ユーザーは、requirements.toml によって強制される機能設定を上書きできません。
次の表は、上記の構成をまとめたものです。オン は、サポートされている場合に使用が許可されることを意味します。その他の権限やネットワーク制御は引き続き適用されます。
プロバイダーのサポート状況については、Bedrock の機能の利用可否を参照してください。
| 機能 | デフォルト | 注記 |
|---|---|---|
| ローカルでのコーディング、ファイル、Git、サブエージェント | オン | — |
| ローカルのスケジュール済みタスク | オン | — |
| ブラウザー | オフ | 内蔵ブラウザー、接続済みブラウザー、エージェントによるブラウザー制御、開発者モードが含まれます。 |
| Computer Use と Appshots | オフ | — |
| メモリとコンピューター履歴 | オフ | — |
| 画像生成 | オフ | 画像の入力や既存の画像ファイルの読み取りはブロックされません。 |
| ウェブ検索 | オフ | キャッシュ検索には、モデルと GovCloud リージョンでのサポートが必要です。コマンドのネットワークルールは、ホスト型検索を制限しません。 |
| アプリとプラグイン | オフ | — |
| 構成済みの MCP server | オフ | 管理者は、ユースケースに伴うリスクを受け入れ、アクセス制御とネットワーク制御を構成したうえで、承認済みのサーバーを有効にできます。 |
| 対話型 MCP アプリ | オフ | — |
| 音声入力 | オフ | — |
| 承認の自動レビュー | オフ | — |
| リモート制御 | オフ | SSH 接続は別扱いです。 |
| アプリの更新 | オフ | — |
エージェントによるブラウザーの使用または Computer Use を有効にするには、allow_browser_and_computer_use = true も必要です。
GovCloud の Amazon Bedrock に対して推論を実行するように Codex CLI を構成します。責任共有に関するガイダンスは、CLI のデプロイにも適用されます。
始める前に
Codex CLI をインストールし、インストール済みのバージョンを確認します。
codex --versionCodex CLI 0.162.0 以降 を使用してください。
使用する Bedrock モデルにアクセスできる AWS GovCloud アカウントと、Codex を実行するマシンに requirements.toml をデプロイするための管理者権限が必要です。WSL または SSH を使用する場合は、CLI が実行される環境内で構成を適用してください。
1. デバイスの要件をデプロイする
CLI を起動する前に、システム構成または MDM を通じて requirements.toml をデプロイします。ファイルの配置場所と MDM による配布については、管理対象の構成を参照してください。管理対象ポリシーを保護し、ステップ 3で Codex を実行するマシン上の設定を確認します。
推奨の requirements.toml
以下のデフォルトの requirements.toml は、意図的に制限を厳しくしています。管理者は、追加機能に伴うリスクを受け入れる場合、それらの機能を有効にできます。機能のドキュメントとネットワーク制御のドキュメントを参照してください。
requirements.toml
# Disable ChatGPT sign-in.
allowed_login_methods = ["api"]
# https://learn.chatgpt.com/docs/agent-approvals-security#common-sandbox-and-approval-combinations
allowed_sandbox_modes = ["read-only", "workspace-write"]
# Approval prompts are reviewed by the user.
allowed_approvals_reviewers = ["user"]
allowed_approval_policies = [
{ granular = { sandbox_approval = false, rules = true, mcp_elicitations = false, request_permissions = false, skill_approval = true } },
]
# Allow cached search only if your AWS GovCloud Region supports web search.
allowed_web_search_modes = ["disabled", "cached"]
# Remote control: https://learn.chatgpt.com/docs/cli/reference#codex-remote-control
allow_remote_control = false
# Managed hooks: https://learn.chatgpt.com/docs/enterprise/managed-configuration#enforce-managed-hooks-from-requirements
allow_managed_hooks_only = true
check_for_update_on_startup = false
# MCP servers, apps, and plugins are disabled by default.
# Admins can enable supported integrations after accepting the risks
# for their use case and configuring access and network controls.
# https://learn.chatgpt.com/docs/enterprise/managed-configuration
mcp_servers = {}
[features]
apps = false
plugins = false
# Enable the network proxy for sandboxed commands.
# https://learn.chatgpt.com/docs/agent-approvals-security#network-isolation
network_proxy = true
realtime_conversation = false
image_generation = false
# Memories: https://learn.chatgpt.com/docs/customization/memories
memories = false
external_agent_memory_import = false
# We recommend that users review approval requests themselves.
# Admins can enable automatic review after accepting the risks for their use case.
# https://learn.chatgpt.com/docs/agent-approvals-security#automatic-approval-reviews
guardian_approval = false
guardianv2 = false
# Disable background skill-search experiments.
skill_search = false
# Hooks: https://learn.chatgpt.com/docs/hooks
hooks = false
# If you enable web search, use cached search through Bedrock Mantle
# where supported by your AWS GovCloud Region.
standalone_web_search = false
# Disable feedback submissions to OpenAI.
[feedback]
enabled = false
# Network controls for agent commands:
# https://learn.chatgpt.com/docs/enterprise/managed-configuration#configure-network-access-requirements
[experimental_network]
enabled = true
managed_allowed_domains_only = true
# No domains allowed by default. Add destinations approved for your use case.
domains = {}
# Add approved Unix socket paths here.
unix_sockets = {}
# Set to true when using an organization-approved upstream proxy.
allow_upstream_proxy = false
# Keep the command proxy bound to localhost.
dangerously_allow_non_loopback_proxy = false
dangerously_allow_all_unix_sockets = false
# Local/private networking: https://learn.chatgpt.com/docs/agent-approvals-security#local-and-private-destinations
allow_local_binding = false
# Application network controls: https://learn.chatgpt.com/docs/config-file/config-reference#requirementstoml
[application.network]
enabled = true
# Example: Bedrock Mantle in us-gov-west-1.
# Replace this hostname with the Bedrock endpoint configured in config.toml.
[application.network.domains]
"bedrock-mantle.us-gov-west-1.api.aws" = "allow"
# OpenAI and ChatGPT endpoints.
# We recommend denying these endpoints to avoid any risk that user data is sent to commercial OpenAI infrastructure.
"api.openai.com" = "deny"
"chat.openai.com" = "deny"
"chatgpt.com" = "deny"
"ab.chatgpt.com" = "deny"
"platform.openai.com" = "deny"
"auth.openai.com" = "deny"
"gov.api.openai.com" = "deny"
"gov.chatgpt.com" = "deny"
"sdfedpreastus2.oaiusercontent.com" = "deny"
"o33249.ingest.us.sentry.io" = "deny"
"persistent.oaistatic.com" = "deny"
"oaisidekickupdates.blob.core.windows.net" = "deny"
# Windows only: https://learn.chatgpt.com/docs/config-file/config-reference#requirementstoml
[windows]
allowed_sandbox_implementations = ["elevated"]2. プロバイダーのルーティングとネットワーク制御を設定する
config.toml を、Linux または macOS では ~/.codex/config.toml に、Windows では %USERPROFILE%\.codex\config.toml に配置します。CODEX_HOME を設定している場合は、その配下の config.toml を代わりに使用します。ユーザーは、requirements.toml で定められた制限の範囲内で、これらのデフォルト設定を変更できます。
推奨の config.toml
この例では、us-gov-west-1 の Mantle を使用します。モデル ID と AWS プロファイルを、デプロイ環境に合った値に置き換えてください。サポートされている別のリージョンやエンドポイントを使用する場合は、URL、リージョン、ネットワークポリシーをまとめて更新してください。
AWS 認証情報は TOML ファイルの外部に保管してください。AWS プロファイル、認証情報、認証情報ヘルパースクリプトは、Codex が変更できるフォルダーの外部に保管してください。CLI は、このプロバイダーに AWS 認証情報を使用するため、ChatGPT へのサインインや OpenAI API key は必要ありません。Bedrock の認証オプションを参照してください。
config.toml
# Replace with your approved Bedrock model ID.
model = "openai.gpt-5.6-terra"
model_provider = "amazon-bedrock"
approval_policy = { granular = { sandbox_approval = false, rules = true, mcp_elicitations = false, request_permissions = false, skill_approval = true } }
sandbox_mode = "workspace-write"
# Set to "cached" only when supported by your model and GovCloud Region
# and approved for your deployment.
# https://docs.aws.amazon.com/bedrock/latest/userguide/web-search.html
web_search = "disabled"
# Example: Bedrock Mantle in us-gov-west-1.
[model_providers.amazon-bedrock]
base_url = "https://bedrock-mantle.us-gov-west-1.api.aws/openai/v1"
wire_api = "responses"
requires_openai_auth = false
[model_providers.amazon-bedrock.aws]
region = "us-gov-west-1"
# Replace with your AWS profile name.
profile = "codex-govcloud"
[sandbox_workspace_write]
# Command destinations are controlled by requirements.toml.
network_access = true
# Disable sending Codex usage analytics to OpenAI.
[analytics]
enabled = false
# OpenTelemetry exports are off by default.
# Admins can configure an approved collector for logs, traces, and metrics.
# https://learn.chatgpt.com/docs/config-file/config-advanced#observability-and-telemetry
[otel]
exporter = "none"
trace_exporter = "none"
metrics_exporter = "none"
log_user_prompt = falseネットワーク制御を適用する
Bedrock を含む、承認済みの CLI の接続先を application.network.domains に追加します。承認済みのコマンドの接続先を experimental_network.domains に追加します。これらは別々の制御です。モデルリクエストで Bedrock への接続を許可しても、エージェントのコマンドによる接続は許可されません。
CLI 0.162.0 では、対話型セッションと codex exec において、Codex のモデルおよびサービスへのリクエストに application.network が適用されます。単独で実行する codex login や、デーモンの更新プログラムのダウンロードには適用されません。Codex のネットワーク設定は、デバイスのファイアウォールの代わりにはなりません。ファイアウォールを使用して、これらの接続先と認証情報ヘルパーの通信を制限してください。
3. デプロイを検証する
設定を変更した後は、新しい CLI プロセスを起動してください。リポジトリ内で次を実行します。
codex/statusを開き、モデルとプロバイダーを確認します。設定された AWS プロファイルが意図した認証情報を使用していることを確認します。- サンプルデータを使って、承認済みのワークフローを実行します。
- ユーザー設定や CLI フラグで、管理対象の制限を上書きできないことを確認します。
- 無効または期限切れの認証情報とルーティングの失敗をテストします。未承認の接続先にコンテンツが送信されないことを確認します。
リポジトリ内で非対話型の使用も確認します。
codex exec --sandbox read-only "Reply with exactly: bedrock-ok"codex exec では承認を求めるプロンプトは表示されず、承認が必要な操作は失敗します。
bedrock-ok が返されることを確認します。CLI の出力でプロバイダーとモデルを確認してください。応答だけではルーティング先を特定できません。続いて、サンプルファイルを読み取る承認済みのワークフローを実行し、codex exec でもポリシーの確認を繰り返します。
よくある問題のトラブルシューティング
| 問題 | 確認事項 |
|---|---|
| サポートされていないエンドポイント | インストール済みの CLI バージョンが、そのエンドポイントとモデルをサポートしているか OpenAI に確認してください。 |
| AWS アカウントまたはロールが正しくない | model_providers.amazon-bedrock.aws のプロファイルと、そのプロファイルで現在有効な認証情報を確認してください。 |
| 制限が適用されない | CLI を実行するマシンに requirements.toml が配置されていることを確認し、新しいプロセスを起動してください。 |
| コマンドがネットワークにアクセスできない | 現在のサンドボックス、sandbox_workspace_write.network_access、管理対象のコマンド接続先ドメインの許可リストを確認してください。このサンプルでは、デフォルトでコマンドの接続先を一切許可していません。 |
| 機能が依然として利用できない | 機能のドキュメントで必要な設定と Bedrock のサポート状況を確認し、その後ネットワーク制御を確認してください。 |
機能の設定
ユーザーは、requirements.toml によって強制される機能設定を上書きできません。
この表は、上記の設定をまとめたものです。オン は、サポートされている場合に利用が許可されることを意味します。ほかの権限やネットワーク制御は引き続き適用されます。
プロバイダーのサポートについては、Bedrock の機能の提供状況をご覧ください。
| 機能 | デフォルト | 備考 |
|---|---|---|
| ローカルでのコーディング、ファイル、Git、サブエージェント | オン | — |
| CLI 音声 | オフ | — |
| メモリ | オフ | — |
| 画像生成 | オフ | 画像の入力や既存の画像ファイルの読み取りはブロックしません。 |
| ウェブ検索 | オフ | キャッシュされた検索を使うには、モデルと GovCloud リージョンでのサポートが必要です。コマンドのネットワークルールはホスト型検索を制限しません。 |
| アプリとプラグイン | オフ | — |
| 設定済みの MCP server | オフ | 管理者は、ユースケースに伴うリスクを受け入れ、アクセス制御とネットワーク制御を設定したうえで、承認済みのサーバーを有効にできます。 |
| 自動承認レビュー | オフ | — |
| リモートコントロール | オフ | — |