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

身份非官方简体中文镜像

翻译状态 AI 翻译

来源版本官方未提供

同步日期 2026-07-31

如需完整文档索引，请参阅 llms.txt。文档页面的 Markdown 版本可通过在页面后追加 .md 来获取 URL。

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

工作原理

当你将本地 ChatGPT Work 或 Codex 界面配置为以 Amazon Bedrock 作为模型提供方时， OpenAI托管的 Responses API 不在请求路径中。本地客户端会将模型请求发送到 Amazon Bedrock，而 Bedrock 会为受支持的 OpenAI兼容 Responses API 实现提供 OpenAI 模型。

身份验证是 AWS原生的。用户使用 Bedrock API 密钥或 AWS IAM 凭据进行身份验证。他们不会使用 ChatGPT 登录或 OPENAI_API_KEY 用于此提供方。

开始之前

请确保具备以下条件：

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

配置提供商

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

model_provider = "amazon-bedrock"

本指南涵盖受支持商业 AWS 区域中的 Amazon Bedrock Mantle 路径。本地 ChatGPT Work 和 Codex 界面不支持区域中的 Bedrock Mantle 端点。 AWS GovCloud 区域。

身份验证选项

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

Bedrock API key。
AWS SDK 凭证链。

选项 1：Bedrock API key

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

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 extension

桌面应用和 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 身份有权访问它。

支持的模型

使用精确的模型 IDs：

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托管的云服务、托管工具或云管理发现的功能目前不可用。

Amazon Bedrock 不支持 Fast Mode。Fast Mode 使用优先级处理，而初始 Amazon Bedrock 产品仅支持按需推理。

交互内容： CodexPlanFeatureMatrix 的动态演示请参阅页面顶部的官方原文链接。

<sup>*</sup> 该功能目前仅限特定区域使用。请查看
各功能文档，了解更多地理限制信息。



<sup>†</sup> 当本地插件包的能力
不需要 ChatGPT 身份验证时受支持。 OpenAI策划的插件发现和
依赖连接器或云托管共享的功能
不可用。

故障排除

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

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

支持边界

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

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