通过 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 读取相同的本地配置层。是否指定模型是可选的;需要时可以显式选择一个受支持模型。
model_provider = "amazon-bedrock"本指南覆盖受支持商业 AWS Region 中的 Amazon Bedrock Mantle 路径。本地 ChatGPT Work 与 Codex 界面不支持 AWS GovCloud Region 中的 Bedrock Mantle 端点。
认证选项
本地 ChatGPT Work 与 Codex 界面支持两条 Bedrock 认证路径,并按以下顺序检查:
- Bedrock API key。
- AWS SDK 凭据链。
选项 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 凭据
如果你的组织通过 AWS SDK 凭据链管理 Bedrock 访问,请使用这条路径。本地客户端可以使用以下标准 AWS SDK 凭据来源:
- 共享的 AWS
config与credentials文件。
aws configure- 环境变量。
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 login- AWS SSO 或具名 profile。
aws sso login --profile codex-bedrock
export AWS_PROFILE=codex-bedrock- 通过
credential_process配置的联合身份。对于企业 SSO 或 OIDC 联合身份,请在本地客户端之外配置 AWS profile,让 AWS SDK 解析凭据。浏览器登录、令牌交换、缓存和刷新应放在 AWS profile 的credential_processhelper 中。
桌面应用与 IDE 扩展
桌面 App 和 IDE 扩展可能不会继承 shell 中的环境变量。请把必需值写入 ~/.codex/.env,然后重启 App 或扩展。
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:
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 当前说明为准。