OpenAI Codex

Codex 是 OpenAI 推出的编程代理，可帮助你更快地编写、审查并交付代码。你可以在 IDE 中与 Codex 并行使用，或将更大规模的任务交由云端执行。

你可以查看 帮助文档 了解更多详情。

安装 Codex

你可以通过以下任一方式安装 Codex。

方式一：通过 Homebrew 安装

brew install codex

方式二：通过 npm 安装

npm install -g @openai/codex

配置 Codex

Codex 使用 TOML 格式的本地配置文件来读取设置。

步骤 1：打开配置文件

vim ~/.codex/config.toml

步骤 2：定义默认模型和提供方

# Codex 使用的默认模型
model = "o3"

# 默认模型提供方
model_provider = "openai-chat-completions"

步骤 3：配置模型提供方

[model_providers.openai-chat-completions]
# 在 Codex 界面中显示的名称
name = "gateway.theturbo"

# OpenAI 兼容 API 的基础 URL
base_url = "https://gateway.theturbo.ai"

# 存储 API Key 的环境变量名称
env_key = "YOUR_AI_GATEWAY_API_KEY"

# API 协议类型（可选，默认为 "chat"）
wire_api = "chat"

设置 API Key

将你的 API Key 设置为环境变量：

export YOUR_AI_GATEWAY_API_KEY="sk-xxxxxxxxxxxxxx"

该 API Key 会在创建 AI 网关实例时生成。

使用 Codex

完成配置后，你即可立即开始使用 Codex。

启动交互式会话

codex

发送一次性请求

codex "Summarize the purpose of this repository."

所有请求都会通过 AI Gateway 进行转发，从而实现集中式的身份认证、请求路由和使用情况统计。

注意

• Codex 需要使用 OpenAI 兼容 API，AI Gateway 提供了该接口。

• API Key 应始终以环境变量的方式存储，而不应硬编码在配置文件中。

• 你可以随时更改默认模型或提供方，而无需重新安装 Codex。