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

Codex 是 AI 编程客户端，支持从终端直接与 Claude 协作写代码。安装后通过 API Key 认证，选好模型（Opus 4.8 适合复杂任务），就能在项目里用自然语言驱动代码生成、重构和调试。

Codex 是什么

Codex 是面向开发者的 AI 编程客户端，让你在终端或编辑器里用自然语言驱动代码工作：

• 生成新功能、重构老代码、定位和修复 bug
• 理解多文件上下文，自动读写相关代码
• 支持审批模式，你掌控每次修改
• 基于 Claude API，支持 Opus / Sonnet / Haiku 全系列模型

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

安装 Codex

macOS / Linux

# 使用 Homebrew（推荐）
brew install codex-cli

# 或使用 npm
npm install -g codex-cli

# 验证安装
codex --version

Windows

# 使用 npm
npm install -g codex-cli

# 或下载二进制包
# 访问 https://codex.dev/download 下载 .exe

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

认证：连接你的 Claude 账号

Codex 通过 Anthropic API Key 调用 Claude 模型。

1. 获取 API Key

1. 访问 console.anthropic.com
2. 注册 / 登录账号
3. 进入 API Keys 页面
4. 点击 Create Key，复制生成的密钥（格式：sk-ant-...）

计费说明：API 按 token 计费，不是订阅制。Opus 4.8 约 $15 / 1M input tokens，日常编程任务单次成本通常在 $0.05–0.50。

2. 配置 API Key

# 方式 1：交互式配置（推荐新手）
codex auth login

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

# 方式 3：写入配置文件
echo 'ANTHROPIC_API_KEY=sk-ant-你的密钥' >> ~/.codex/config

验证：

codex auth status
# 输出：✓ Authenticated as your-email@example.com

选择模型

Codex 支持三档 Claude 模型，按任务复杂度选择：

设置默认模型

# 全局默认（写入 ~/.codex/config）
codex config set model opus-4.8

# 单次使用
codex chat --model sonnet-4 "重构这个函数"

推荐起步配置：默认 Sonnet 4（性价比高），复杂任务手动切 Opus。

第一次对话：验证配置

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

cd ~/my-project
codex chat

输入测试任务：

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

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

常见问题

API Key 无效

• 检查密钥是否复制完整（以 sk-ant- 开头）
• 确认在 console.anthropic.com 上账号有可用余额
• 密钥可能已过期，重新生成

网络连接失败

• 检查本地代理配置：export HTTPS_PROXY=http://127.0.0.1:7890
• 确认防火墙未拦截 api.anthropic.com

找不到 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 编程客户端怎么选