跳转到内容

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

身份 非官方简体中文镜像
翻译状态 AI 翻译 / AI 审校
来源版本 官方未提供
同步日期 2026-07-26
官方原文 learn.chatgpt.com

配置本地 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 端点。

本地 ChatGPT Work 和 Codex 界面支持两种 Bedrock 身份验证路径,检查顺序如下:

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

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

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

当组织通过 AWS SDK 凭证链管理 Bedrock 访问权限时,请使用此路径。本地客户端可以使用以下标准 AWS SDK 凭证来源:

  1. 共享 AWS configcredentials 文件。

    Terminal window
    aws configure
  2. 环境变量。

    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>
  3. AWS Management Console 凭证。

    Terminal window
    aws login
  4. AWS SSO 或命名配置文件。

    Terminal window
    aws sso login --profile codex-bedrock
    export AWS_PROFILE=codex-bedrock
  5. 使用 credential_process 配置的联合身份。对于企业 SSO 或 OIDC 联合身份验证,请在本地客户端之外配置 AWS 配置文件,并让 AWS SDK 解析凭证。将浏览器登录、令牌交换、缓存和刷新操作放入 AWS 配置文件的 credential_process 辅助程序中。

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

Terminal window
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-sol
openai.gpt-5.6-terra
openai.gpt-5.6-luna
openai.gpt-5.5
openai.gpt-5.4

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

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

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

功能 Amazon Bedrock
ChatGPT Work 网页版 不可用
Codex cloud 不可用
ChatGPT 桌面应用中的 ChatGPT Work 或 Codex 可用
Codex CLI 可用
IDE extension 可用
Codex SDK、codex exec 和可编写脚本的工作流 可用
功能 Amazon Bedrock
使用受支持 OpenAI 模型的 Bedrock 支持推理 可用
Fast Mode 不可用
图像生成和编辑 不可用
语音听写 不可用
网页搜索 不可用
功能 Amazon Bedrock
使用 /review 进行本地代码审查 可用
审批请求的自动审查 可用
沙箱和权限控制 可用
项目和独立的计划任务 可用
计划任务 可用
工作树和内置 Git 工具 可用
本地环境和可重复执行的操作 可用
Appshots 可用
功能 Amazon Bedrock
内置浏览器预览和评论 可用
在浏览器中使用 Computer Use 有限
通过 Chrome 使用 ChatGPT 有限
Computer Use 有限
SSH 远程连接 可用
移动端远程控制 不可用
功能 Amazon Bedrock
使用 AGENTS.md 的自定义指令 可用
技能 可用
插件 有限
插件共享 不可用
连接器 不可用
MCP 可用
子代理和自定义代理 可用
记忆 有限
Chronicle 不可用
功能 Amazon Bedrock
Codex cloud 聊天 不可用
Sites 不可用
使用 @codex 委派 GitHub issue 和 PR 不可用
GitHub 代码审查和自动 PR 审查 不可用
Slack 云端集成 不可用
Linear 云端集成 不可用
功能 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。