Codex 快速上手：安装、认证与模型选择

Codex 是 OpenAI 出品的 AI 编程客户端，让你在终端里用自然语言驱动代码工作。安装后登录 ChatGPT 账号或配置 OpenAI API Key，选好模型（gpt-5 适合复杂任务），就能在项目里完成代码生成、重构和调试。

Codex 是什么

Codex 是 OpenAI 出品的开源 AI 编程客户端（GitHub: openai/codex），让你在终端里用自然语言驱动代码工作：

• 生成新功能、重构老代码、定位和修复 bug
• 理解多文件上下文，自动读写相关代码
• 支持审批模式，你掌控每次修改
• 基于 OpenAI 模型，支持 gpt-5 / o3 / o4-mini 等

适合：个人开发者、小团队、需要快速迭代的技术创业者。

安装 Codex

macOS / Linux

# 使用 Homebrew（推荐）
brew install codex

# 或使用 npm
npm install -g @openai/codex

# 验证安装
codex --version

Windows

# 使用 npm
npm install -g @openai/codex

# 或下载二进制包
# 访问 https://github.com/openai/codex/releases 下载 .exe

安装后运行 codex --version，看到版本号说明成功。

认证：登录你的 OpenAI 账号

Codex 调用的是 OpenAI 模型，认证有两种方式：登录 ChatGPT / OpenAI 账号（推荐），或直接用 OpenAI API Key。

1. 登录账号（推荐）

# 浏览器跳转完成 OAuth 登录
codex login

# 查看登录状态
codex login status

codex login 会打开浏览器，用你的 ChatGPT / OpenAI 账号授权。登录后凭证存在 ~/.codex/auth.json。

2. 用 API Key（适合脚本 / CI）

1. 访问 platform.openai.com
2. 进入 API keys 页面，点击 Create new secret key
3. 复制生成的密钥（格式：sk-...）

# 方式 1：通过 stdin 写入（推荐，不落盘到 shell 历史）
printenv OPENAI_API_KEY | codex login --with-api-key

# 方式 2：环境变量
export OPENAI_API_KEY="sk-你的密钥"

计费说明：API 按 token 计费，不是订阅制。日常编程任务单次成本通常在 $0.05–0.50，取决于模型和上下文用量。用 ChatGPT 账号登录则走订阅额度，不单独按 token 收费。

验证：

codex login status
# 输出：Logged in using an API key - sk-xxx***xxx
# 或：Logged in via ChatGPT

选择模型

Codex 默认用 OpenAI 的模型，按任务复杂度选择：

设置默认模型

# 全局默认（写入 ~/.codex/config.toml）
codex -c model="gpt-5"

# 单次使用
codex -m o4-mini "重构这个函数"

推荐起步配置：默认 gpt-5.1（性价比高），复杂任务手动切 gpt-5。

第一次对话：验证配置

进入任意项目目录，启动 Codex：

cd ~/my-project
codex

输入测试任务：

读一下 README.md，用一句话概括这个项目是干什么的

如果 Codex 正确读取文件并回答，说明配置成功。按 Ctrl+C 或输入 /exit 退出。

常见问题

API Key 无效

• 检查密钥是否复制完整（以 sk- 开头）
• 确认在 platform.openai.com 上账号有可用额度
• 密钥可能已过期或被吊销，重新生成

网络连接失败

• 检查本地代理配置：export HTTPS_PROXY=http://127.0.0.1:7890
• 确认能访问 OpenAI 的 API 端点

找不到 codex 命令

• npm 全局安装需确保 npm bin -g 在 PATH 里
• Homebrew 安装检查 /opt/homebrew/bin 或 /usr/local/bin

下一步

配置完成后，可以：

1. 阅读「Codex 基础使用：常用命令与日常工作流」（系列第②篇）
2. 尝试让 Codex 为你的项目生成第一个功能
3. 查看工具评测：Claude for Coding 了解更多使用场景

系列文章

• ✅ ① Codex 快速上手：安装、认证与模型选择（本文）
• ✅ ② Codex 基础使用：常用命令与日常工作流
• ✅ ③ Codex 实战：在真实项目里完成任务
• ✅ ④ Codex 进阶：配置文件、MCP 与自动化集成

延伸：Codex vs Claude Code：两款 AI 编程客户端怎么选