为Codex配置Bedrock上的OpenAI GPT模型
本文介绍如何为OpenAI的Codex CLI工具配置Amazon Bedrock上的OpenAI兼容模型。Codex默认使用OpenAI订阅,但也支持外部模型接入,当要求模型提供商必须是OpenAI规范。自2026年6月起AWS Bedrock服务提供GPT 5.4/5.5系列模型。以下介绍如何创建Bedrock API Key、以及Codex配置文件设置。
一、背景
Codex是OpenAI推出的CLI下的开发辅助软件,与Anthropic的Claude Code,Amazon/AWS的Kiro CLI是同类型产品。此外,国内许多厂家也有类似定位的产品,这里不一一详表。Codex默认可以直接使用OpenAI提供的模型,也支持通过Amazon Bedrock调用可用的OpenAI模型。
此外,Codex支持使用外部模型,这需要通过配置API Key来实现。现在Amazon Bedrock已经支持通过兼容的接口方式为Codex提供OpenAI模型,不再局限于GPT-OSS这类开源模型;例如GPT-5.4、GPT-5.5都已经可用。本文以us-east-2区域上的GPT-5.4模型为例。
二、安装Codex
MacOS上执行如下命令:
brew install --cask codex
Linux上则需要通过node的包管理程序npm安装:
npm install -g @openai/codex
安装完成。
三、配置和测试
1、创建Bedrock的API Key
进入Bedrock服务,找到左上角的Discover菜单中的API Keys菜单,新建一个API Key。API Key本身不绑定单一区域,但在Codex里通过Bedrock API Key方式调用时,仍需要显式指定要访问的region。本文使用us-east-2。
获得API Key后,为本机增加环境变量:
export AWS_BEARER_TOKEN_BEDROCK=xxxxxxxxxxxxxxxxxxxxxxx
export AWS_REGION=us-east-2
2、编辑Codex配置文件
编辑如下配置文件:
vim ~/.codex/config.toml
内容如下:
model_provider = "amazon-bedrock"
model = "openai.gpt-5.4"
model_context_window = 131072
web_search = "disabled"
model_catalog_json = "/Users/username/.codex/models.json"
[model_providers.amazon-bedrock.aws]
region = "us-east-2"
[projects."/Users/username"]
trust_level = "trusted"
保存退出。
3、测试
运行codex命令,即可开始对话。
四、参考资料
https://developers.openai.com/codex/amazon-bedrock
https://developers.openai.com/codex/config-advanced
最后修改于 2026-06-17