最后更新：2026年9月23日（已更新至 GPT-6 Sol/Luna 模型、Codex CLI 0.156 版本）
如果你最近关注 AI 编程，大概率绕不开一个名字——Codex。
这是 OpenAI 用来对标 Claude Code 的编程 Agent。一年多的迭代下来，它早就不是当年那个只会在编辑器里补全代码的小工具了：它能读懂你的整个项目、自己改文件、跑测试、提 PR，一个任务丢给它，端到端帮你干完。
2026 年 9 月，OpenAI 又给它做了一轮大升级：GPT-6 Sol 和 Luna 两款新模型上线 Codex，价格比上一代 GPT-5.6 系列更低，同时 CLI 更新到了 0.156 版本，新增了全屏界面、语音对话、用量统计面板等一堆实用功能。
这篇教程就把国内用户从安装到跑通第一个任务的全流程讲清楚，每一步都写到新手能照着抄。文章较长，建议先收藏再看。
一、Codex 是什么？和 Copilot、Claude Code 有什么区别？
先用一句话给三者定位：
| 工具 | 定位 | 一句话理解 |
|---|---|---|
| GitHub Copilot | 代码补全起家 | “你写一半，它猜一半” |
| Claude Code | 编程 Agent | “你说需求，它自己干” |
| OpenAI Codex | 编程 Agent | “你说需求，它自己干，生态还在快速长” |
Copilot 和后两者的本质区别在于自主性：补全工具是”你打字它接话”，Agent 是”你下指令它自己拆任务、改代码、跑验证、汇报结果”。
而 Codex 和 Claude Code 属于同一赛道的两个头部选手。选择上没有绝对答案，但有几个事实可以参考：
- Codex 的订阅门槛更低：ChatGPT Plus（约 20 美元/月）就能正经使用，Claude Code 主力模型基本要用 Max 档（100 美元/月起）。
- Codex 最近更新很猛：9 月刚上线 GPT-6 系列模型，还加入了插件（Plugins）和技能（Skills）体系，扩展性上了一个台阶。
- 如果你已经订阅了 ChatGPT 会员，Codex 属于”不用白不用”的赠品，这是它对国内用户最大的吸引力。
二、2026年9月，Codex 现在都有什么？
这次更新值得关注的点，我按重要程度排个序：
1. GPT-6 Sol 和 GPT-6 Luna 两款新模型
- Sol：主打复杂编码和 Agent 任务，适合让它独立完成大块工作
- Luna：主打聚焦的高频任务，速度快、价格更低，适合小修小补
- Plus、Pro、Business、Enterprise、Edu 用户都能用；免费和 Go 档用户也能在桌面 App 里用 Luna
2. 全屏 TUI 界面（CLI 0.156+）
命令行党狂喜：输入 /tui 可以切换到全屏界面，支持文字搜索、鼠标选择、右键复制，终端体验直接看齐桌面软件。
3. 语音对话
按 F8 就能开语音，直接对着麦克风说需求，适合边看代码边口头指挥的场景。
4. 用量面板 /usage
随时查看自己的 token 消耗、额度余量和插件活动情况。Plus/Team 用户还有”额度过半提醒”，不至于用着用着突然没额度。
5. Worktree 工作树（默认开启）
让 Codex 在隔离的代码分支里干活，改崩了也不影响你的主分支。适合并行跑多个任务。
6. 插件和技能系统
可以从官方市场安装插件扩展 Codex 的能力，这是它从”工具”往”平台”走的关键一步。
三、使用前提：你需要准备什么？
使用前提：科学（魔法）上网+ChatGPT账号 + 会员订阅
科学网络环境是基础—机场推荐
国内用户用 Codex，门槛就两条：
1. 一个 ChatGPT 账号
注册流程网上资料很多，此处不展开。
2. 一份订阅
- 免费档：能在桌面 App 里体验 Luna 模型，额度很少，只够尝鲜
- Plus（约 20 美元/月）：绝大多数个人开发者的最佳选择，日常使用绰绰有余
- Pro / Business / Enterprise：重度用户和团队场景
另外，你需要稳定、干净的魔法网络环境来保证登录和使用的连续性，具体方式请自行了解并遵守相关法律法规，本文不作展开。
国内开通 ChatGPT Plus 有三种方式：
| 方式 | 支付 | 到账速度 | 门槛 |
|---|---|---|---|
| 官网直付 | 海外信用卡 | 支付成功难 | 高（国内卡大部分被拒） |
| 苹果内购 | Apple Pay | 数小时，30%苹果税 | 中（需美区Apple ID） |
| 第三方充值平台 | 支付宝/微信 | 半小时内 | 低 |
因国内支付门槛高，怕麻烦的直接走第三方充值平台，支付宝微信付款，一般半小时内到账，开完 Plus 立刻就能登录 Codex 用上，可用👉chatgpt plus官方会员第三方代充平台
四、安装方式怎么选？
Codex 目前有四种使用方式，新手对号入座：
| 方式 | 适合谁 | 推荐指数 |
|---|---|---|
| 桌面 App | 零基础、想先体验的 | ⭐⭐⭐⭐⭐ |
| CLI 命令行 | 终端党、要在 CI 里用的 | ⭐⭐⭐⭐ |
| IDE 扩展 | VS Code / JetBrains 深度用户 | ⭐⭐⭐⭐ |
| Cloud 云端任务 | 想让它云端后台跑任务的 | ⭐⭐⭐ |
我的建议：先用桌面 App 跑通流程，再用 CLI 进阶。 下面两种都讲。
五、桌面 App 安装（新手首选）
第 1 步：下载安装包
在 OpenAI 官网的 Codex 页面下载对应系统的安装包（Windows 为 .exe，macOS 为 .dmg）。
第 2 步：安装
- Windows：双击 .exe，跟着向导下一步走完
- macOS：双击 .dmg，把 Codex 拖进 Applications 文件夹
第 3 步：首次登录
打开 App，选择 Sign in with ChatGPT，浏览器会弹出授权页面，用你的 ChatGPT 账号登录即可。
第 4 步：选择工作目录
App 会让你选一个文件夹作为工作空间。建议选你自己拥有且信任的代码仓库目录——Codex 默认只能在这个目录内读写文件，不会乱动系统其他地方。
第 5 步：选 Local 模式
首次进入会让你选运行模式。新手一定选 Local：Codex 只在你本地干活，最安全。Cloud 和 Full Access 模式等熟悉了再研究。
六、CLI 安装（终端党进阶）
第 1 步：安装 Node.js
Codex CLI 需要 Node.js 22 或更高版本。去 http://nodejs.org 下载 LTS 版安装，然后验证：
node --version
# 应显示 v22.x.x 或更高第 2 步：安装 Codex CLI
三种方式任选其一：
# 方式一：官方独立安装脚本（推荐，不依赖 Node）
# macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Windows（PowerShell）
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
# 方式二：npm 安装（国内用户建议加镜像源，下载更快）
npm install -g @openai/codex --registry=https://registry.npmmirror.com
# 方式三：Homebrew（macOS）
brew install --cask codex第 3 步：验证安装
codex --version
# 2026年9月最新版应为 v0.156.x第 4 步：首次启动并登录
cd ~/your-project-folder
codex首次运行会引导登录，选 Sign in with ChatGPT，终端会打印一个授权 URL 并尝试自动打开浏览器。如果浏览器没弹出来，手动复制 URL 到浏览器完成授权。
第 5 步：配置安全默认值（重要！）
编辑 ~/.codex/config.toml，新手建议这样配置：
model = "gpt-6-sol"
approval_policy = "on-request"
sandbox_mode = "workspace-write"两个参数解释一下：
approval_policy = "on-request"：Codex 执行有风险的命令前会先问你，不会闷头就干sandbox_mode = "workspace-write"：Codex 只能写当前工作目录，碰不到系统其他文件
这两个设置是新手的安全网，别图省事改成 full-auto，除非你清楚自己在干什么。
第 6 步（可选）：开启全屏界面
0.156 版本的新功能，进去后输入：
/tui即可切换到全屏模式，支持搜索、鼠标选择和右键复制，比传统终端输出舒服得多。建议直接在配置里设为默认。
七、模型怎么选？Sol 还是 Luna？
9 月上线的两款 GPT-6 模型，选择逻辑很简单：
| 场景 | 选谁 | 原因 |
|---|---|---|
| 大型重构、跨文件改动、复杂调试 | Sol | 推理能力强，适合硬仗 |
| 修小 bug、写注释、格式化、批量小修改 | Luna | 快、便宜，高频任务性价比高 |
| 不确定 | 先 Sol 后 Luna | 复杂规划用 Sol，机械执行用 Luna |
在 CLI 里切换模型：
/model # 交互式选择
codex --model gpt-6-sol # 启动时直接指定一个省钱小技巧：用 /usage 随时盯额度，Plus 档的额度是按时间窗口滚动计算的，把它放在手边，心里有数。
八、新手第一个实战任务
装好了，跑一个真实任务感受一下。以 CLI 为例（App 操作逻辑相同）：
第 1 步：进入项目并创建 Git 检查点
cd ~/my-project
git add .
git commit -m "checkpoint before codex"⚠️ 重要习惯：用 Codex 前先 commit。 万一改崩了，git reset --hard 一键回退。Codex 的改动是实打实写文件的，不像 ChatGPT 网页版只给你看代码。
第 2 步：先给一个只读任务，让它熟悉项目
codex "帮我分析一下这个项目的目录结构，说明每个模块是做什么的。不要修改任何文件。"新手第一个任务务必从只读分析开始——先确认 Codex 能正确理解你的项目，再让它动手改。这一步也是在建立你对它的信任边界。
第 3 步：让它动手改代码
codex "修复 src/utils/auth.ts 里的 TypeScript 报错，改完跑 pnpm test 验证。"Codex 会：读取文件 → 定位报错 → 应用修复 → 跑测试 → 失败了就自己继续修，直到通过，最后给你看 diff，你确认后再应用。
整个过程自主完成，你只需要在关键节点点头。这就是 AI 编程 Agent 和代码补全的本质区别。
第 4 步：查看改动并提交
git diff # 看改了啥
git add .
git commit -m "fix: auth.ts type errors" # 满意就提交九、让 Codex 更听话的 6 个技巧
技巧 1：写一个 AGENTS.md 文件
在项目根目录放一个 AGENTS.md，告诉 Codex 你的项目规范：
# 项目说明
- 框架：Next.js 14 App Router
- 语言：TypeScript（严格模式）
- 测试：Vitest
- 包管理：pnpm
- 规范：Tailwind CSS，不用内联样式
- 禁止：不要修改 /docs 目录下的文件
- 验证：改完跑 pnpm testCodex 每次启动会自动读这个文件，省得每次都重复交代背景。这是提升 Codex 表现性价比最高的一件事，没有之一。
技巧 2：任务要具体，别给模糊指令
❌ 坏例子：”帮我优化代码”
✅ 好例子：”把用户模块的重试逻辑抽成独立函数，加单元测试，覆盖超时和失败两种场景”
越具体，越不容易跑偏。
技巧 3：对话太长用 /compact
上下文快满时 Codex 会提醒你，输入 /compact 压缩历史对话，腾出空间继续。
技巧 4：拖图给它看
设计稿截图、报错截图直接拖进对话框（App），或 CLI 用：
codex --image error.png "帮我修这个报错"技巧 5：用 Worktree 放心并行
开新任务时加 --worktree，Codex 会在隔离分支里干活，多个任务并行互不干扰，主分支永远干净。
技巧 6：复杂任务先用 Plan 模式
大改动别直接让它动手，先让它出方案。你审完方案再放行执行，返工率会低很多。
十、常见问题 FAQ
Q1：免费账号能用吗？ 能用，桌面 App 里可以体验 Luna 模型，但额度很少。正经使用建议 Plus。
Q2：和 ChatGPT 网页版有什么区别？ 网页版只给你看代码，Codex 直接改你本地的文件、跑你的命令。能力完全不是一个量级。
Q3：它会把我项目改坏吗？ 配好 approval_policy 和 sandbox_mode 后风险可控，加上用前 commit 的习惯，随时可回退。
Q4：额度用完了怎么办？ 用 /usage 查看消耗明细，高频小任务切到 Luna 省额度，等时间窗口刷新后恢复。
Q5：订阅价格以哪里为准？ 以 OpenAI 官网实时价格为准，本文不提供具体报价，避免信息过时误导。
写在最后
Codex 这一年多的进化速度是有目共睹的：从补全工具到 Agent，再到 9 月的 GPT-6 模型和插件生态，它正在变成一个真正的”AI 同事”。
对国内开发者来说，现在上手 Codex 的成本比以往任何时候都低——一个 Plus 订阅，半小时安装配置，就能把日常相当一部分重复性编码工作交出去。
我的建议是：从今天的第一个只读分析任务开始，一周后你会回来看这篇文章给自己点个赞。
如果这篇教程对你有帮助，点个赞或收藏让更多人看到。有问题欢迎在评论区留言，我会挑常见的更新到 FAQ 里。
声明：本文为原创教程，基于 2026 年 9 月版本信息撰写，后续版本更新可能使部分细节过时，请以官方文档为准。
发表回复