SpyBara
Go Premium

amazon-bedrock.md 2026-09-29 22:59 UTC to 2026-09-30 23:01 UTC

This page contains 60 additions and 22 deletions.

2026
Tue 22 23:00 Wed 23 23:58 Wed 30 23:01

Use ChatGPT Work and Codex with Amazon Bedrock

For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.

Configure local ChatGPT Work and Codex surfaces to use OpenAI models available through Amazon Bedrock. In this setup, the local client sends model requests to Bedrock using AWS-managed authentication and access controls.

This page covers direct access to Bedrock. If your organization already provides a model gateway, follow Connect to a gateway. To configure a gateway backed by Bedrock, see Bedrock through LiteLLM.

How it works

When you configure a local ChatGPT Work or Codex surface with Amazon Bedrock as the model provider, the OpenAI-hosted Responses API isn't in the request path. The local client sends model requests to Amazon Bedrock, and Bedrock provides an OpenAI-compatible Responses API implementation for supported OpenAI models.

Authentication is AWS-native. Users authenticate with a Bedrock API key or AWS IAM credentials. They do not use ChatGPT sign-in or OPENAI_API_KEY for this provider.

Before you start

Make sure you have:

  • Credentials for the AWS account you want to use.
  • Access to supported OpenAI models in Amazon Bedrock.
  • Access to an AWS Region where the selected model is available.
  • AWS permission to invoke the selected model or inference profile.

Check the model-specific IAM requirements. For example, GPT-6 Sol through Runtime also requires bedrock:InvokeModel on the account's default project. See AWS's GPT-6 Sol setup instructions.

Configure the provider

Codex allows you to configure the provider by setting model_provider in ~/.codex/config.toml. The ChatGPT desktop app, Codex CLI, IDE extension, and SDK read the same local configuration layers.

Choose the provider for the Amazon Bedrock endpoint you want to use: Bedrock Runtime for cross-Region inference (CRIS), or Bedrock Mantle for in-Region inference.

Use Bedrock Runtime for new configurations:

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

Hosted web search isn't available on Bedrock Runtime. If you need it, use Bedrock Mantle. The amazon-bedrock provider selects Mantle; amazon-bedrock-runtime selects Runtime.

For the Bedrock Mantle endpoint:

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

Choose a model

Codex uses the configured model_provider to choose which models appear in the model picker: models supported through the Bedrock Runtime endpoint for amazon-bedrock-runtime, or through the Bedrock Mantle endpoint for amazon-bedrock.

You can optionally specify a supported model in the configuration file. The built-in provider supplies its own model catalog. When switching endpoints, change the provider and any explicit model ID together.

Model availability varies by AWS Region. Refer to AWS Regional availability by models.

Authentication options

Local ChatGPT Work and Codex surfaces support two Bedrock authentication paths. They check them in this order:

  1. Bedrock API key.
  2. AWS SDK credential chain.

Option 1: Bedrock API key

Set the Bedrock API key in the environment the local client reads. You must specify a Region when using API-key authentication.

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

On Windows PowerShell:

$env:AWS_BEARER_TOKEN_BEDROCK = "<your-bedrock-api-key>"
$env:AWS_REGION = "us-east-2"

Option 2: AWS SDK credentials

Use this path when your organization manages Bedrock access through the AWS SDK credential chain. The local client can use these standard AWS SDK credential sources:

Shared AWS configuration files

Configure the shared AWS config and credentials files:

aws configure

Environment variables

Set the standard AWS SDK credential environment variables:

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 credentials

Log in with AWS Management Console credentials:

aws login

AWS SSO or a named profile

Log in with AWS SSO and select the named profile:

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

Federated identity

For corporate SSO or OIDC federation, configure a federated identity with credential_process outside the local client and let the AWS SDK resolve credentials. Put browser login, token exchange, caching, and refresh in your AWS profile's credential_process helper.

Desktop app and IDE extension

Desktop apps and IDE extensions may not inherit environment variables from the shell. Put required values in ~/.codex/.env, then restart the app or extension. On Windows, the default path is %USERPROFILE%\.codex\.env.

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

Verify setup

  • In Codex CLI, open /status and confirm the model provider matches your endpoint: amazon-bedrock for Mantle in-Region inference, or amazon-bedrock-runtime for Runtime Global or Geo cross-Region inference.
  • In the ChatGPT desktop app, select Work or Codex and start a new task after restarting the app.
  • In the IDE extension, start a new session after restarting the extension.
  • Confirm the selected model is available in the configured AWS Region and that the AWS identity has permission to access it.

Then send a short prompt in a new task:

Reply with exactly: bedrock-ok

Expect bedrock-ok. Confirm the provider and model in the client; the reply alone doesn't identify the route. For rollout qualification, use a disposable folder with read-only permissions and verify a harmless local tool task and a follow-up turn.

Supported models

Use an inference profile ID for Bedrock Runtime provider or a model ID for Bedrock Mantle provider. The selected model or profile must be available in your AWS Region and accessible to your AWS identity.

Global and Geo cross-Region inference using the Bedrock Runtime endpoint

Global CRIS can route requests to supported commercial AWS Regions worldwide, whereas Geo CRIS routes requests within the profile's geography. Choose a routing scope that meets your AWS permissions and data-residency requirements.

Use model_provider = "amazon-bedrock-runtime" with the optional model configuration set to an inference profile ID from the following lists. The provider uses https://bedrock-runtime.{region}.amazonaws.com/openai/v1, where {region} is the supported source AWS Region from which you send requests. Both Global and Geo CRIS use this endpoint address.

Global CRIS

Supported models and inference profile IDs:

  • GPT-6 Astra: global.openai.gpt-6-astra
  • GPT-6 Sol: global.openai.gpt-6-sol
  • GPT-6 Luna: global.openai.gpt-6-luna

For example, configure Astra with Global CRIS in ~/.codex/config.toml:

model_provider = "amazon-bedrock-runtime"
model = "global.openai.gpt-6-astra"

United States Geo CRIS

Supported models and inference profile IDs:

  • 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's built-in Runtime model picker lists the United States Geo and Global variants.

Model and CRIS availability vary by source AWS Region. See AWS Supported Regions and models for inference profiles, which links to each model's exact inference profile IDs and regional availability, and AWS Regional availability by models before selecting a provider and a model.

In-Region inference using the Bedrock Mantle endpoint

Use model_provider = "amazon-bedrock" with an optional model ID. The provider uses https://bedrock-mantle.{region}.api.aws/openai/v1.

Supported models and model IDs:

  • GPT-6 Astra: openai.gpt-6-astra
  • GPT-6 Sol: openai.gpt-6-sol
  • GPT-6 Luna: openai.gpt-6-luna

GPT-6 Sol and Luna are available through Mantle in us-east-1 (N. Virginia). Model availability varies by AWS Region. See AWS Regional availability by models before selecting a provider and a model. For GPT-6 Astra, refer to the Bedrock model page for GPT-6 Astra.

Feature availability

This configuration supports local ChatGPT Work and Codex workflows. Hosted ChatGPT Work on the web, Codex cloud, and features that depend on OpenAI-hosted cloud services or cloud-managed discovery aren't currently available. Hosted web search is unavailable on Runtime; use Mantle if you need it.

Codex Security CLI uses its own provider configuration. Follow its Amazon Bedrock setup rather than the native client settings above.

Fast Mode isn't available with Amazon Bedrock. Fast Mode uses priority processing, and the initial Amazon Bedrock offering supports on-demand inference only.

* Feature is currently limited to only specific regions. Check the individual feature documentation to learn more about regional restrictions.
† Local plugin bundles and OpenAI-curated plugins that don't require ChatGPT authentication, including Codex Security, are available. Plugins that require ChatGPT authentication, connectors, or cloud-hosted sharing aren't available.

Troubleshooting

If setup fails, check the following:

  • The model ID exactly matches a supported model.
  • You use the correct model provider for the endpoint: amazon-bedrock-runtime for Runtime endpoint or amazon-bedrock for Mantle endpoint.
  • You specify an AWS Region where the model is available.
  • The Bedrock API key or AWS credentials are valid and not expired.
  • The AWS identity has permission to access the selected Bedrock model.
  • AWS_BEARER_TOKEN_BEDROCK isn't set to an expired or unintended key.
  • For desktop app or IDE extension usage, required environment variables are present in ~/.codex/.env.

For AWS SDK profile authentication, run aws sts get-caller-identity --profile codex-bedrock to confirm the identity for your selected profile. Replace codex-bedrock with your profile name, or omit --profile when using the default credential chain. This checks AWS identity, not permission to invoke a Bedrock model. Check AWS_BEARER_TOKEN_BEDROCK separately so an unintended API key doesn't select a different authentication path.

Support boundaries

OpenAI Support can help with ChatGPT Work and Codex client setup, configuration, local CLI behavior, desktop app behavior, IDE extension behavior, and the local product experience.

For AWS credentials, IAM permissions, Bedrock model access, quotas, billing, regional availability, Bedrock request failures, AWS service logs, or Bedrock service behavior, contact the customer's AWS administrator or AWS Support.