Skip to content

通过 Amazon Bedrock 使用 ChatGPT Work 与 Codex

Codex 中文站说明: 本页围绕“通过 Amazon Bedrock 使用 ChatGPT Work 与 Codex”重新补充了中文使用场景和验证重点。界面名称可能随 Codex 版本更新,请以当前客户端为准。

配置本地 ChatGPT Work 与 Codex 界面,使用 Amazon Bedrock 上可用的 OpenAI 模型。

配置完成后,本地客户端会通过 AWS 管理的认证与访问控制,把模型请求发送到 Bedrock。

工作方式

当你把 Amazon Bedrock 配置为本地 ChatGPT Work 或 Codex 界面的模型提供方时,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 路径的认证。

配置模型提供方

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

toml
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 凭据链。

选项 1:Bedrock API key

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

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

选项 2:AWS SDK 凭据

如果你的组织通过 AWS SDK 凭据链管理 Bedrock 访问,请使用这条路径。本地客户端可以使用以下标准 AWS SDK 凭据来源:

  1. 共享的 AWS configcredentials 文件。
bash
aws configure
  1. 环境变量。
bash
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>
  1. AWS Management Console 凭据。
bash
aws login
  1. AWS SSO 或具名 profile。
bash
aws sso login --profile codex-bedrock
export AWS_PROFILE=codex-bedrock
  1. 通过 credential_process 配置的联合身份。对于企业 SSO 或 OIDC 联合身份,请在本地客户端之外配置 AWS profile,让 AWS SDK 解析凭据。浏览器登录、令牌交换、缓存和刷新应放在 AWS profile 的 credential_process helper 中。

桌面应用与 IDE 扩展

桌面 App 和 IDE 扩展可能不会继承 shell 中的环境变量。请把必需值写入 ~/.codex/.env,然后重启 App 或扩展。

bash
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 Region 中可用,并且 AWS identity 有权访问该 Bedrock 模型。

支持的模型

使用精确模型 ID:

text
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 工作流。Web 端托管的 ChatGPT Work、Codex 云端,以及依赖 OpenAI 托管云服务、托管工具或云端管理发现能力的功能当前不可用。

Fast Mode 不适用于 Amazon Bedrock。Fast Mode 使用优先级处理,而 Amazon Bedrock 的初始方案仅支持按需推理。

Detailed feature availability(详细功能可用性)

访问与使用界面

能力Amazon Bedrock
Web 端 ChatGPT Work不可用
Codex 云端不可用
ChatGPT 桌面应用中的 ChatGPT Work 或 Codex可用
Codex CLI可用
IDE 扩展可用
Codex SDK、codex exec 与可脚本化工作流可用

模型与多模态

能力Amazon Bedrock
使用受支持 OpenAI 模型的 Bedrock-backed inference可用
Fast Mode不可用
图片生成与编辑不可用
语音听写不可用
Web 搜索不可用

本地功能

能力Amazon Bedrock
使用 /review 的本地代码评审可用
审批请求的自动评审可用
沙箱与权限控制可用
项目与独立定时任务可用
定时任务可用
工作树与内置 Git 工具可用
本地环境与可重复动作可用
Appshots可用

浏览器与远程控制

能力Amazon Bedrock
内置浏览器预览与评论可用
浏览器中的 Computer Use有限支持(*)
通过 Chrome 使用 ChatGPT有限支持(*)
Computer Use有限支持(*)
SSH 远程连接可用
移动端远程控制不可用

自定义与扩展

能力Amazon Bedrock
通过 AGENTS.md 编写自定义指令可用
技能可用
插件有限支持(†)
插件共享不可用
连接器不可用
MCP可用
子智能体与自定义智能体可用
Memories有限支持(*)
Chronicle不可用

云端与集成

能力Amazon Bedrock
Codex 云端聊天不可用
Sites不可用
通过 @codex 委派 GitHub issue 与 PR 任务不可用
GitHub 代码评审与自动 PR 评审不可用
Slack 云端集成不可用
Linear 云端集成不可用

管理、安全与分析

能力Amazon Bedrock
SAML SSO、MFA 与工作区用户管理不可用
requirements.toml 托管配置可用
云端托管配置策略不可用
ChatGPT 工作区 RBAC 与自定义角色不可用
SCIM、EKM 与域名验证不可用
企业数据保留与驻留控制不可用
API 或业务数据默认不用于训练可用
分析仪表盘不可用
Analytics API不可用
Compliance API 与审计日志不可用
连接 GitHub 仓库的 Codex Security不可用
  • 功能当前只在特定区域或特定能力范围内可用。请查看对应功能文档了解地域限制。

† 当能力不需要 ChatGPT 认证时,支持本地插件包。OpenAI 精选插件发现,以及依赖连接器或云端托管共享的功能不可用。

故障排查

如果配置失败,请检查以下内容:

  • 模型 ID 与受支持模型完全匹配。
  • 你指定的是该模型可用的 AWS Region。
  • Bedrock API key 或 AWS 凭据有效且未过期。
  • AWS identity 有权访问所选 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。

本站实践建议

阅读“通过 Amazon Bedrock 使用 ChatGPT Work 与 Codex”时,建议先在非生产项目中走完一次完整流程,并记录实际界面、命令输出和验证结果。产品更新后,可据此快速判断哪些步骤需要调整。

Codex API 与国内使用

在实践“通过 Amazon Bedrock 使用 ChatGPT Work 与 Codex”相关功能时,如需为 Codex 配置 OpenAI-compatible API,可以前往 APIBest 获取 API Key。第三方服务的模型映射、价格、额度和数据处理方式以 APIBest 当前说明为准。

Powered by ChatGPT中文版