普通人如何从零开始用上Codex：OpenAI Codex CLI 小白入门全教程（2025版）

OpenAI 在 2025 年推出了 Codex CLI，直接对标 Claude Code。同样是命令行 AI 编程助手，同样能读写文件、执行命令。但 Codex 依托 OpenAI 的模型生态，有它独特的优势。本文从零教你怎么装上用好它。

一、Codex CLI 是什么？和 ChatGPT 有什么区别？

Codex CLI 是 OpenAI 推出的命令行 AI 编程工具（原名可能叫 Codex Cloud CLI）。它和 Claude Code 类似，运行在终端里，能：

直接读写你电脑上的代码文件
执行 shell 命令（装依赖、跑测试、git 操作等）
理解整个项目的代码结构
支持 OpenAI 全系模型（GPT-5, GPT-4.1 等）

和 ChatGPT 的关系：

ChatGPT 是网页/App 对话产品，不能操作你的本地文件
Codex CLI 是开发者工具，在终端运行，能直接改代码、跑命令
但两者的底层模型是一样的（都是 GPT 系列）

和 Claude Code 的主要区别（先简单了解）：

对比维度	Codex CLI	Claude Code
所属公司	OpenAI	Anthropic
底层模型	GPT-5 / GPT-4.1	Claude Opus 4 / Sonnet 4
代码理解	很强	很强
中文支持	好	非常好
安装方式	npm 全局安装	npm 全局安装
第三方模型	支持（可接入DeepSeek等）	支持（可接入DeepSeek等）

二、准备工作：三步就绪

第一步：安装 Node.js（与 Claude Code 一样）

Codex CLI 同样基于 Node.js。如果你已经按上一篇文章装好了，直接跳过。

没装过的看这里：

访问 https://nodejs.org

下载 LTS 版本（推荐 20.x 或 22.x）

双击安装，注意勾选 “Add to PATH”

验证：终端输入 node --version 看到版本号即成功

第二步：获取 OpenAI API Key

打开 https://platform.openai.com

左侧菜单 → “API Keys”

点击 “Create new secret key”

⚠️ 立即复制保存！ 只显示一次

新用户一般有免费额度，用完后需充值

第三步：安装 Codex CLI

打开终端，输入：

npm install -g @openai/codex

注意：包名可能会变化。如果这条命令找不到包，去 https://github.com/openai/codex 确认最新的包名和安装方式。目前 OpenAI 官方还提供了另一种安装方式：

# 如果上面的 npm 安装失败，尝试：
npm install -g openai-codex

或者用 pip（如果你更熟悉 Python）：
pip install openai-codex

安装完成后验证：

codex --version

看到版本号说明安装成功！

三、配置 API Key 并启动

配置 API Key

Windows（永久配置）：

按 Win+R → 输入 sysdm.cpl → 回车

“高级” → “环境变量”

新建用户变量：

– 变量名：OPENAI_API_KEY
– 变量值：sk-你的OpenAI密钥

确定 → 重启终端

Mac/Linux（永久配置）：

echo 'export OPENAI_API_KEY="sk-你的OpenAI密钥"' >> ~/.zshrc
source ~/.zshrc

临时使用（仅当前窗口有效）：

# Windows PowerShell
$env:OPENAI_API_KEY="sk-你的密钥"

Mac/Linux
export OPENAI_API_KEY="sk-你的密钥"

启动 Codex CLI

codex

首次启动可能有一些初始化设置，按照提示操作即可。然后就可以开始和 Codex 对话了！

四、实战：用 Codex 完成第一个项目

让我们用 Codex 来做一个实用的小工具：一个 Markdown 待办事项列表生成器。

步骤 1：创建项目文件夹

mkdir todo-generator
cd todo-generator
codex

步骤 2：用自然语言描述需求

在 Codex 的交互界面中输入：

帮我用 Python 写一个命令行待办事项工具，要求：
能添加、删除、查看、标记完成待办事项
数据存储在一个 JSON 文件中
支持命令行参数：add、list、done、delete
用不同颜色显示完成和未完成的任务
代码要有清晰的注释

步骤 3：Codex 会做什么

Codex 会：

创建 todo.py 文件并写入完整代码

可能创建 requirements.txt（如果需要第三方库）

帮你运行 python todo.py add "测试任务" 来验证

步骤 4：迭代修改

如果结果不满意，直接继续提要求：

帮我把输出格式改成表格样式，加上序号列

再加一个优先级功能，任务可以设置 high/medium/low

Codex 会自动修改代码文件，你只需要测试运行就行。

五、Codex CLI 的核心功能

1. 交互模式 vs 单次模式

# 交互模式（持续对话）
codex

单次模式（一次性问答）
codex "帮我写一个快速排序的Python函数"

指定模型
codex --model gpt-5 "分析这个项目的架构"

2. 文件操作

Codex 可以直接：

创建新文件

修改现有文件

删除文件（会先确认）

移动/重命名文件

3. 命令执行

Codex 可以运行终端命令，比如：

# 你只需要说：
"帮我安装这个项目需要的依赖并运行测试"

Codex 会执行：
npm install
npm test

4. Git 集成

Codex 内置了 Git 感知能力，可以：

查看 git 状态和历史

帮你写 commit message

创建分支和合并

生成 PR 描述

5. 多文件编辑

这是 Codex 的一个特色功能——它能同时修改多个文件。比如你说”把所有 API 调用的错误处理改成统一的格式”，它会在整个项目中找到相关文件并逐一修改。

六、费用说明和省钱技巧

OpenAI API 定价（以官方最新为准）

模型	输入 (每百万token)	输出 (每百万token)	适用场景
GPT-5	约 $1.75-15	约 $14-56	最强，复杂任务
GPT-4.1	约 $2	约 $8	日常编程主力
GPT-4.1 Mini	约 $0.40	约 $1.60	简单任务，成本敏感

省钱建议

日常使用 GPT-4.1 或 Mini，只有在复杂任务时才切到 GPT-5

设置月度消费上限：在 OpenAI Platform → Billing → Usage limits 设置

用单次模式处理简单问题，避免长时间交互会话积攒大量上下文

定期清理会话，不要让上下文无限增长

接入 DeepSeek V4 等低成本模型（见后续教程）

七、常见问题 FAQ

Q1: Codex 和 Claude Code 应该选哪个？

如果你已经习惯 OpenAI 生态（ChatGPT Plus 用户等），Codex 会更顺手。如果你更看重中文体验和安全性，Claude Code 更优。两者都能胜任日常编程工作，建议都试试看哪个更适合你。

Q2: Windows 能用吗？

完全可以。Windows Terminal 或 PowerShell 都能正常运行 Codex。推荐用 Windows Terminal（微软商店免费下载），体验更好。

Q3: 安装报错 “npm ERR! code EACCES” 怎么办？

权限不足。Mac/Linux 用 sudo npm install -g @openai/codex。Windows 以管理员身份运行终端。

Q4: 支持中文对话吗？

支持。但 GPT 系列的中文理解能力略逊于 Claude，复杂中文需求建议说得更详细一些。

Q5: 能接入 DeepSeek 吗？

可以。Codex 支持配置自定义 API endpoint，后续教程会详细讲解。

Q6: 我的代码安全吗？

OpenAI 表示 API 调用的数据默认不用于模型训练（需要主动 opt-out）。但如果你处理非常敏感的代码，建议阅读 OpenAI 的数据使用政策。

八、总结

Codex CLI 是 OpenAI 在 AI 编程赛道的重要布局。它和 Claude Code 各有千秋：

选 Codex：如果你偏好 OpenAI 生态，或需要 GPT-5 的特定能力
选 Claude Code：如果你更看重中文体验、长文本理解、代码安全性
两个都用：合理搭配，日常用便宜的模型，复杂任务用强的模型

下一步学习路线

📖 学习如何在 Codex 中接入 DeepSeek V4（省钱神器）
🔧 掌握 Claude Code 的 Effort 设置（控制质量与成本的平衡）
⚖️ 看懂 Claude Code vs Codex 的深度对比

有问题可以在评论区交流！

免责声明：本文基于 2025 年 6 月的产品信息撰写。OpenAI Codex CLI 属于较新的产品，包名、安装方式、功能可能有变动，请以 OpenAI 官方文档为准。本文由作者实测后撰写，AI 辅助编辑。