2026年9月最新版 Codex 上手教程：GPT-6 时代，从安装到实战一篇讲透

最后更新：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 test

Codex 每次启动会自动读这个文件，省得每次都重复交代背景。这是提升 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 月版本信息撰写，后续版本更新可能使部分细节过时，请以官方文档为准。

标签： codex教程