OpenAI Codex 实战指南②：安装配置与快速上手

前言

上篇我们聊了Codex是什么、能做什么、和竞品的对比。这篇进入实操：把Codex装到你的电脑上，跑通第一个程序。

一、安装前的准备

1.1 系统要求

项目	CLI版本	Desktop App
操作系统	macOS / Linux / Windows	macOS 12+ / Windows 10+
Python	3.10 或更高	不需要
Node.js	18+（可选，npm安装用）	不需要
内存	4GB+ 可用	8GB+ 可用
网络	需要访问api.openai.com	需要访问api.openai.com

1.2 获取API Key

无论CLI还是Desktop App，都需要OpenAI API Key：

1. 访问 platform.openai.com
2. 注册/登录OpenAI账号
3. 进入 API Keys 页面 → 点击"Create new secret key"
4. 复制Key并妥善保存（只显示一次）

💡 省钱提示：如果你是ChatGPT Plus订阅用户，Codex Desktop App可以直接用订阅额度，不需要额外购买API额度。但CLI版本仍需API Key。

二、安装Codex CLI

2.1 三种安装方式

方式一：pip安装（推荐）

pip install codex-cli

方式二：npm安装

npm install -g @openai/codex

方式三：Homebrew安装（macOS）

brew install codex-cli

2.2 验证安装

codex --version
# 输出类似：codex-cli 1.8.2

2.3 配置API Key

安装完成后，需要配置API Key。有两种方式：

方式一：环境变量（推荐）

# macOS/Linux
export OPENAI_API_KEY="sk-xxxxxxxxxxxx"

# Windows PowerShell
$env:OPENAI_API_KEY="sk-xxxxxxxxxxxx"

方式二：配置文件

codex config set api_key sk-xxxxxxxxxxxx

2.4 常见安装问题

问题1：pip安装报错"command not found: pip"
→ 你可能需要用 pip3 代替 pip，或者先安装Python 3.10+。

问题2：npm安装报权限错误
→ 加 sudo（macOS/Linux）或以管理员身份运行终端（Windows）。

问题3：Windows上codex命令找不到
→ 检查Python Scripts目录是否在PATH中。运行 python -m pip show codex-cli 查看安装位置，将对应Scripts目录加入PATH。

三、安装Codex Desktop App

3.1 下载地址

• macOS：App Store 搜索"Codex"或访问 openai.com/codex/download
• Windows：访问 openai.com/codex/download 下载安装包

3.2 安装步骤

1. 下载安装包（.dmg 或 .exe）
2. 双击安装，按提示完成
3. 首次启动会要求登录OpenAI账号
4. 登录后自动同步你的ChatGPT订阅额度

3.3 Desktop App vs CLI 怎么选？

维度	Desktop App	CLI
上手难度	⭐ 极低	⭐⭐ 需要终端基础
功能完整度	⭐⭐⭐ 缺少高级配置	⭐⭐⭐⭐⭐ 全功能
Appshots	✅ 支持	❌ 不支持
脚本集成	❌ 不支持	✅ 支持
计费方式	ChatGPT订阅额度	API按量付费

建议：两个都装。日常用Desktop App（方便、便宜），需要脚本集成时切CLI。

四、第一个程序：Hello Codex

4.1 CLI版本

# 启动交互模式
codex

# 输入你的第一个指令
> 用Python写一个Hello World程序

# Codex会生成代码并展示
# 确认后自动保存为文件

4.2 Desktop App版本

1. 打开Codex Desktop App
2. 在对话框中输入："用Python写一个Hello World程序"
3. Codex生成代码，点击"Accept"确认
4. 代码自动保存到当前项目目录

4.3 试试更有趣的

# 让Codex帮你写一个命令行工具
> 写一个Python脚本，接受一个URL参数，抓取网页标题并输出

# 让Codex帮你调试
> 这个函数报错了：[粘贴错误信息]，帮我找出原因

# 让Codex帮你重构
> 把这段代码重构成面向对象的写法，并加上类型注解

五、基本配置优化

5.1 选择默认模型

# 使用o4推理模型（默认）
codex config set model o4

# 使用GPT-4.5（更快的响应速度）
codex config set model gpt-4.5

# 使用GPT-4.5-mini（最便宜，适合简单任务）
codex config set model gpt-4.5-mini

5.2 设置项目上下文

在项目根目录创建 .codex/config.json：

{
  "model": "o4",
  "max_tokens": 4096,
  "temperature": 0.7,
  "project_context": "这是一个Flask Web项目，使用Python 3.12，数据库用PostgreSQL"
}

Codex每次对话都会自动读取这个配置，无需重复说明项目背景。

5.3 设置.ignore文件

创建 .codexignore，避免Codex读取不相关的文件：

node_modules/
__pycache__/
.env
*.pyc
dist/
build/

六、费用预估

这是大家最关心的问题。以API计费为例：

使用场景	模型	预估单次成本
简单问答（写函数/修Bug）	GPT-4.5-mini	$0.001~0.01
中等任务（重构/写测试）	GPT-4.5	$0.01~0.05
复杂任务（架构设计/推理）	o4	$0.05~0.30
大型代码库分析	o4	$0.30~1.00

💡 省钱策略：简单任务用GPT-4.5-mini，复杂任务用o4，日常编码用GPT-4.5——三档模型搭配使用，月均成本可控制在$20~50。

下篇预告

下一篇我们将深入Codex的核心功能：代码生成、审查、重构、Bug定位、测试生成——每个功能都用真实案例演示。

📌 OpenAI Codex实战指南系列：①开篇介绍 → ②安装配置与快速上手（本篇） → ③核心功能详解 → ④工作流集成 → ⑤高级技巧 → ⑥团队使用指南 → ⑦实战案例