ChatGPT 中文教程
中文
联系我 goolvyouyou@gmail.com

通过 Amazon Bedrock 使用 Codex

将 ChatGPT Work 和 Codex 与 Amazon Bedrock 搭配使用

配置本地 ChatGPT Work 和 Codex 界面，以使用通过 Amazon Bedrock 提供的 OpenAI 模型。

配置本地 ChatGPT Work 和 Codex 界面，以使用通过 Amazon Bedrock 提供的 OpenAI 模型。在此设置中，本地客户端使用 AWS 管理的身份验证和访问控制 向 Bedrock 发送模型请求。

工作原理

将本地 ChatGPT Work 或 Codex 界面的模型提供商配置为 Amazon Bedrock 后， 请求路径将不经过由 OpenAI 托管的 Responses API。本地客户端向 Amazon Bedrock 发送模型请求，而 Bedrock 会为受支持的 OpenAI 模型提供 与 OpenAI 兼容的 Responses API 实现。

开始之前

请确保你具备：

  • Amazon Bedrock 中受支持 OpenAI 模型的访问权限。
  • 所选模型可用的 AWS 区域。
  • 已为 AWS 账号配置 Amazon Bedrock Mantle 路径的身份验证。

配置提供商

将 Amazon Bedrock Mantle 路径的 amazon-bedrock 模型提供商添加到 ~/.codex/config.toml。ChatGPT 桌面应用、Codex CLI、IDE 扩展和 SDK 读取相同的本地配置层。模型为可选配置。 需要时，请明确选择受支持的模型。

model_provider = "amazon-bedrock"

身份验证选项

本地 ChatGPT Work 和 Codex 界面支持两种 Bedrock 身份验证路径。 它们会按以下顺序检查：

  1. Bedrock API key。
  2. AWS SDK 凭据链。

选项 1：Bedrock API key

在本地客户端读取的环境中设置 Bedrock API key。使用 API key 身份验证时， 必须指定区域。

export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
export 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 login

AWS SSO 或命名配置文件

使用 AWS SSO 登录并选择命名配置文件：

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

联合身份

对于企业 SSO 或 OIDC 联合，请在本地客户端之外使用 credential_process 配置联合身份，并让 AWS SDK 解析 凭据。将浏览器登录、令牌交换、缓存和刷新逻辑放入 AWS 配置文件的 credential_process 辅助程序中。

桌面应用和 IDE 扩展

桌面应用和 IDE 扩展可能不会继承 shell 中的环境变量。 请将必需的值放入 ~/.codex/.env，然后重启应用或 扩展。

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

验证设置

  • 在 Codex CLI 中，打开 /status 并确认 Codex 正在使用 amazon-bedrock 模型提供商。
  • 在 ChatGPT 桌面应用中，选择 Work 或 Codex，并在 重启应用后开始新任务。
  • 在 IDE 扩展中，重启扩展后开始新会话。
  • 确认所选模型在配置的 AWS 区域中可用，并且 AWS 身份有权访问该模型。

支持的模型

请使用确切的模型 ID：

openai.gpt-5.6-sol
openai.gpt-5.6-terra
openai.gpt-5.6-luna
openai.gpt-5.5
openai.gpt-5.4

模型可用性因 AWS 区域而异。选择模型前，请参阅按 AWS 区域划分的模型 支持情况。

功能可用性

此配置支持本地 ChatGPT Work 和 Codex 工作流。目前不支持 Web 上托管的 ChatGPT Work、Codex cloud，以及依赖 OpenAI 托管的 云服务、托管工具或云端管理的发现功能。

* 功能目前仅限特定区域使用。请查看 各项功能的文档，详细了解地理限制。
† 如果本地插件包的功能不需要 ChatGPT 身份验证，则支持这些插件包。目前不支持 OpenAI 精选插件发现，以及 依赖连接器或云端托管共享的功能。

问题排查

如果设置失败，请检查以下各项：

  • 模型 ID 与受支持的模型完全匹配。
  • 你指定了模型可用的 AWS 区域。
  • Bedrock API key 或 AWS 凭据有效且未过期。
  • AWS 身份有权访问所选 Bedrock 模型。
  • AWS_BEARER_TOKEN_BEDROCK 未设置为已过期或非预期的 key。
  • 使用桌面应用或 IDE 扩展时，所需的环境变量 存在于 ~/.codex/.env 中。

支持范围

OpenAI Support 可以协助处理 ChatGPT Work 和 Codex 客户端设置、 配置、本地 CLI 行为、桌面应用行为、IDE 扩展行为 以及本地产品体验。

如需处理 AWS 凭据、IAM 权限、Bedrock 模型访问权限、配额、计费、 区域可用性、Bedrock 请求失败、AWS 服务日志或 Bedrock 服务行为，请联系客户的 AWS 管理员或 AWS Support。