Codex 基础配置

安装完成后，你需要配置 API Key 才能使用 Codex。本教程将引导你完成所有必要的配置。

获取 API Key

Codex 需要一个 OpenAI API Key 来工作。

方式一：直接申请 OpenAI API Key

  1. 访问 OpenAI Platform
  2. 注册账号并登录
  3. 进入 API Keys 页面
  4. 点击 Create new secret key 创建一个新的 API Key
  5. 复制保存你的 Key（以 sk- 开头）

注意

OpenAI API 需要在账户中充值后才能使用。建议先充值 $5 作为起步。

方式二：使用我们的中转 API Key

联系管理员获取中转 API Key，享受更稳定的网络和更便捷的支付方式。

配置 API Key

方法一：环境变量配置（推荐）

将 API Key 添加到你的 shell 配置文件中：

~/.bashrc 或 ~/.zshrc
# 添加以下内容到文件末尾
export OPENAI_API_KEY="sk-your-api-key-here"

# 保存后，执行以下命令使其生效
source ~/.zshrc  # 或 source ~/.bashrc

方法二：启动时指定

bash
OPENAI_API_KEY="sk-your-key" codex

首次启动

配置好 API Key 后，进入你的项目目录启动 Codex：

bash
# 进入你的项目目录
cd ~/my-project

# 启动 Codex
codex

Codex 支持多种运行模式：

模式命令说明
交互模式codex与 AI 对话式开发
单次执行codex "任务描述"直接执行一个任务
全自动模式codex --full-auto "任务"AI 自主完成，无需确认

首次使用测试

启动后，试试以下简单指令：

Codex 对话
> 帮我创建一个 Python Flask 应用，包含一个返回 "Hello World" 的首页路由

如果 Codex 正常生成代码文件，说明配置成功！

配置完成！

恭喜你成功配置了 Codex！你现在可以开始使用它来辅助开发了。

常用配置项

配置项环境变量说明
API KeyOPENAI_API_KEYOpenAI API 密钥
模型OPENAI_MODEL指定使用的模型（如 o4-mini）
沙箱模式CODEX_SANDBOX设置代码执行沙箱策略

下一步