将 ChatGPT Work 和 Codex 与 Amazon Bedrock 搭配使用
配置本地 ChatGPT Work 和 Codex 界面,以使用 Amazon Bedrock 中提供的 OpenAI 模型。在此设置中,本地客户端使用 AWS 管理的身份验证和访问控制,向 Bedrock 发送模型请求。
将本地 ChatGPT Work 或 Codex 界面配置为使用 Amazon Bedrock 作为模型提供商时,请求路径中不会包含 OpenAI 托管的 Responses API。本地客户端会向 Amazon Bedrock 发送模型请求,而 Bedrock 会为受支持的 OpenAI 模型提供兼容 OpenAI 的 Responses API 实现。
身份验证采用 AWS 原生方式。用户使用 Bedrock API key 或 AWS IAM 凭证进行身份验证。对于此提供商,用户不会使用 ChatGPT 登录或 OPENAI_API_KEY。
请确保具备以下条件:
- 在 Amazon Bedrock 中可以访问受支持的 OpenAI 模型。
- 所选模型所在的 AWS Region。
- 已为 AWS 账户配置 Amazon Bedrock Mantle 路径所需的身份验证。
将 Amazon Bedrock Mantle 路径的 amazon-bedrock 模型提供商添加到 ~/.codex/config.toml。ChatGPT 桌面应用、Codex CLI、IDE extension 和 SDK 读取相同的本地配置层。提供模型是可选的。需要时可以明确选择受支持的模型。
model_provider = "amazon-bedrock"本指南介绍受支持的商业 AWS Region 中的 Amazon Bedrock Mantle 路径。本地 ChatGPT Work 和 Codex 界面不支持 AWS GovCloud Region 中的 Bedrock Mantle 端点。
身份验证选项
Section titled “身份验证选项”本地 ChatGPT Work 和 Codex 界面支持两种 Bedrock 身份验证路径,检查顺序如下:
- Bedrock API key。
- AWS SDK 凭证链。
选项 1:Bedrock API key
Section titled “选项 1:Bedrock API key”在本地客户端读取的环境中设置 Bedrock API key。使用 API-key 身份验证时,必须指定 Region。
export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>export AWS_REGION=us-east-2选项 2:AWS SDK 凭证
Section titled “选项 2:AWS SDK 凭证”当组织通过 AWS SDK 凭证链管理 Bedrock 访问权限时,请使用此路径。本地客户端可以使用以下标准 AWS SDK 凭证来源:
-
共享 AWS
config和credentials文件。Terminal window aws configure -
环境变量。
Terminal window 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 凭证。
Terminal window aws login -
AWS SSO 或命名配置文件。
Terminal window aws sso login --profile codex-bedrockexport AWS_PROFILE=codex-bedrock -
使用
credential_process配置的联合身份。对于企业 SSO 或 OIDC 联合身份验证,请在本地客户端之外配置 AWS 配置文件,并让 AWS SDK 解析凭证。将浏览器登录、令牌交换、缓存和刷新操作放入 AWS 配置文件的credential_process辅助程序中。
桌面应用和 IDE extension
Section titled “桌面应用和 IDE extension”桌面应用和 IDE extension 可能不会继承 shell 中的环境变量。将所需值放入 ~/.codex/.env,然后重启应用或 extension。
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 extension 中重启 extension 后开始新会话。
- 确认所选模型在配置的 AWS Region 中可用,并且 AWS 身份具有访问该模型的权限。
使用准确的模型 ID:
openai.gpt-5.6-solopenai.gpt-5.6-terraopenai.gpt-5.6-lunaopenai.gpt-5.5openai.gpt-5.4模型可用性因 AWS Region 而异。选择模型前,请参阅按 AWS Region 划分的模型支持情况。
此配置支持本地 ChatGPT Work 和 Codex 工作流。网页端托管的 ChatGPT Work、Codex cloud,以及依赖 OpenAI 托管的云服务、托管工具或云管理发现功能的功能目前不可用。
Fast Mode 不支持 Amazon Bedrock。Fast Mode 使用优先处理,而 Amazon Bedrock 的初始产品仅支持按需推理。
详细功能可用性
Section titled “详细功能可用性”访问方式与界面
Section titled “访问方式与界面”| 功能 | Amazon Bedrock |
|---|---|
| ChatGPT Work 网页版 | 不可用 |
| Codex cloud | 不可用 |
| ChatGPT 桌面应用中的 ChatGPT Work 或 Codex | 可用 |
| Codex CLI | 可用 |
| IDE extension | 可用 |
Codex SDK、codex exec 和可编写脚本的工作流 |
可用 |
模型与多模态
Section titled “模型与多模态”| 功能 | Amazon Bedrock |
|---|---|
| 使用受支持 OpenAI 模型的 Bedrock 支持推理 | 可用 |
| Fast Mode | 不可用 |
| 图像生成和编辑 | 不可用 |
| 语音听写 | 不可用 |
| 网页搜索 | 不可用 |
| 功能 | Amazon Bedrock |
|---|---|
使用 /review 进行本地代码审查 |
可用 |
| 审批请求的自动审查 | 可用 |
| 沙箱和权限控制 | 可用 |
| 项目和独立的计划任务 | 可用 |
| 计划任务 | 可用 |
| 工作树和内置 Git 工具 | 可用 |
| 本地环境和可重复执行的操作 | 可用 |
| Appshots | 可用 |
浏览器与远程控制
Section titled “浏览器与远程控制”| 功能 | Amazon Bedrock |
|---|---|
| 内置浏览器预览和评论 | 可用 |
| 在浏览器中使用 Computer Use | 有限 |
| 通过 Chrome 使用 ChatGPT | 有限 |
| Computer Use | 有限 |
| SSH 远程连接 | 可用 |
| 移动端远程控制 | 不可用 |
自定义与扩展
Section titled “自定义与扩展”| 功能 | Amazon Bedrock |
|---|---|
使用 AGENTS.md 的自定义指令 |
可用 |
| 技能 | 可用 |
| 插件 | 有限† |
| 插件共享 | 不可用 |
| 连接器 | 不可用 |
| MCP | 可用 |
| 子代理和自定义代理 | 可用 |
| 记忆 | 有限 |
| Chronicle | 不可用 |
| 功能 | Amazon Bedrock |
|---|---|
| Codex cloud 聊天 | 不可用 |
| Sites | 不可用 |
使用 @codex 委派 GitHub issue 和 PR |
不可用 |
| GitHub 代码审查和自动 PR 审查 | 不可用 |
| Slack 云端集成 | 不可用 |
| Linear 云端集成 | 不可用 |
管理、安全与分析
Section titled “管理、安全与分析”| 功能 | Amazon Bedrock |
|---|---|
| SAML SSO、MFA 和工作区用户管理 | 不可用 |
requirements.toml 托管配置 |
可用 |
| 云端托管的配置策略 | 不可用 |
| ChatGPT 工作区 RBAC 和自定义角色 | 不可用 |
| SCIM、EKM 和域验证 | 不可用 |
| 企业级保留和数据驻留控制 | 不可用 |
| 默认不使用 API 或业务数据进行训练 | 可用 |
| 分析控制面板 | 不可用 |
| 分析 API | 不可用 |
| 合规 API 和审计日志 | 不可用 |
| 适用于已连接 GitHub 仓库的 Codex Security | 不可用 |
* 功能目前仅限特定区域使用。请查看单项功能文档,了解更多地理限制。
† 当本地插件包的功能不需要 ChatGPT 身份验证时,支持使用这些插件包。不提供 OpenAI 筛选的插件发现功能,以及依赖连接器或云端托管共享的功能。
如果设置失败,请检查以下事项:
- 模型 ID 与受支持的模型完全匹配。
- 指定了模型可用的 AWS Region。
- Bedrock API key 或 AWS 凭据有效且未过期。
- AWS 身份具有访问所选 Bedrock 模型的权限。
AWS_BEARER_TOKEN_BEDROCK未设置为已过期或非预期的密钥。- 对于桌面应用或 IDE extension 的使用,所需的环境变量已存在于
~/.codex/.env中。
OpenAI Support 可以帮助处理 ChatGPT Work 和 Codex 客户端设置、配置、本地 CLI 行为、桌面应用行为、IDE extension 行为,以及本地产品体验。
对于 AWS 凭据、IAM 权限、Bedrock 模型访问权限、配额、账单、区域可用性、Bedrock 请求失败、AWS 服务日志或 Bedrock 服务行为,请联系客户的 AWS 管理员或 AWS Support。