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

前言

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

一、安装前的准备

1.1 系统要求

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/Linuxexport 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*.pycdist/build/

六、费用预估

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

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

下篇预告

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

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