Codex 入门实战指南：从桌面端到 CLI 审批模式一次跑通
写在前面
很多人第一次接触 Codex，会把它当成“另一个聊天机器人”。但真正用起来你会发现，它更像一个能进入项目、读取文件、执行命令、修改代码的 AI 编程 Agent。
普通 AI 聊天工具只能回答你“怎么做”，Codex 更进一步：它可以在你的项目目录里看代码、分析结构、给出修改方案，甚至在你授权后直接改文件。桌面端适合新手，CLI 适合开发者，审批模式则决定它能“动手”到什么程度。
这篇文章不讲概念堆砌，直接按入门路径来：先认识 Codex 的界面，再跑通 CLI，理解三种审批模式，最后用几个真实任务完成第一次上手。
AI 编程的门槛，正在从“会写代码”变成“会下任务”
过去写代码，核心能力是逐行实现：你要知道语法、框架、调用链和调试方式。
现在 AI 编程工具正在改变这件事。你不一定要从第一行开始写，而是要学会把任务描述清楚：让 Codex 分析项目结构、定位 Bug、生成接口、根据截图写组件，再由你验收和调整。
这并不意味着开发者不重要了。相反，人的角色从“每行代码都亲手写”变成了“定义目标、控制权限、检查结果”。
Codex 的三种审批模式，就是这个变化的缩影：你可以让它只读分析，也可以允许它自动编辑，甚至在沙箱里全自动执行。不同模式对应不同风险，也对应不同效率。
Codex 桌面端：先看懂三栏结构
Codex 的桌面应用采用标准三栏结构：
- 左侧：任务列表；
- 中间：对话窗口；
- 右侧：多功能区域。
启动 Codex 应用后，可以在左侧添加项目，在中间输入框描述需求。
右侧区域可以设置模型、上传文件，或补充更多上下文。
对新手来说，桌面端最大的好处是不用一开始就碰终端。你可以先用它分析项目、解释文件、生成代码片段，熟悉 Codex 的工作方式后，再进入 CLI。
Codex CLI：真正进入项目目录工作
安装并配置好账号后，在项目目录下打开终端，输入codex即可启动交互界面。
# 进入你的项目目录cd~/my-project# 启动 Codex 交互界面codex# 带初始提示词直接启动codex"帮我分析这个项目的结构"# 启动时指定模型codex--modelgpt-5建议在项目根目录下启动 Codex。这样它能完整读取项目文件结构，理解依赖、入口文件、路由、测试和配置。
比如进入测试目录后启动：
cdcodex-runoob-test codex进入交互界面后，光标所在处就是输入框。你可以直接输入需求，比如：
解释 test.py 文件的代码，并指出可能的边界问题。Codex 会读取相关文件，再给出解释和建议。相关记录也会同步显示在 Codex App 中。
三种审批模式：新手一定要先搞懂
Codex CLI 提供三种操作权限模式。它们决定 Codex 能不能改文件、能不能自动执行，以及什么时候需要你确认。
| 模式 | 说明 | 适用场景 |
|---|---|---|
ask | 默认只读模式：可以读取文件、制定方案，但执行任何操作前都需要确认 | 陌生代码库探索、风险评估 |
auto-edit | 自动编辑：可以读取和修改当前目录文件，但网络操作仍需确认 | 日常开发、重构任务 |
full-auto | 完全自动：在禁用网络的沙箱中全自动运行，无需确认 | 批量任务、CI/CD 自动化 |
启动时可以指定审批模式：
# 默认只读模式codex --approval-mode ask# 自动编辑模式codex --approval-mode auto-edit# 完全自动模式codex --approval-mode full-auto在交互界面中，也可以输入：
/approvals来切换审批模式。
新手建议从ask开始。先让 Codex 读项目、解释结构、提出修改方案；等你确认它的理解没问题，再切到auto-edit。full-auto更适合你已经熟悉项目、任务可回滚、风险可控的场景。
第一次对话：三个最适合新手的任务
示例 1：分析项目结构
codex"分析这个项目的目录结构，告诉我主要文件的作用"Codex 会自动读取文件，输出类似结果：
✓ 读取 package.json ✓ 扫描 src/ 目录（23 个文件） 项目结构分析： - src/index.ts：应用入口，初始化 Express 服务器 - src/routes/：API 路由定义（共 5 个端点） - ...这是入门最推荐的任务，因为它风险低，又能让你快速了解 Codex 是否读懂项目。
示例 2：修复 Bug
codex"我的 login 函数有 bug，用户登录后 token 没有正确保存，帮我找出问题并修复"Codex 通常会按以下流程工作：
- 读取相关文件；
- 分析代码逻辑；
- 找出可能问题；
- 提出修改方案；
- 等待你确认后执行修改。
如果处于ask模式，它不会直接改文件；如果处于auto-edit模式，它可以在当前目录自动编辑。
示例 3：生成新功能
codex"给我的 Express 应用添加一个用户注册接口，需要验证邮箱格式，密码至少 8 位，并把用户信息存入数据库"这类任务更适合在你已经让 Codex 读过项目结构后执行。它需要理解框架、数据库、路由和验证逻辑。
如果有设计图，也可以传入图片上下文：
codex-idesign.png"按照这个设计图，实现对应的 React 组件"图片输入：前端和排错特别好用
Codex CLI 支持把图片作为上下文输入，这对前端开发和排错很有用。
适合场景包括：
- 分析报错截图；
- 根据 UI 设计图生成前端代码；
- 解读架构图并据此实现功能；
- 对比两个界面的差异；
- 根据页面截图还原组件结构。
常见用法：
# 命令行传入图片路径codex-iscreenshot.png"解释这个报错信息，并告诉我如何修复"# 传入多张图片codex--imageimg1.png,img2.jpg"对比这两个界面的区别，实现图一的设计"在 macOS 上，也可以复制图片后，在 Codex 输入框中直接按Cmd + V粘贴；或者按住Shift把图片拖拽到终端窗口。
新手使用 Codex 的安全流程
Codex 很强，但第一次上手一定要控制权限。
推荐流程如下：
1. 在项目根目录启动 Codex 2. 使用 ask 模式分析项目结构 3. 让 Codex 解释它准备怎么改 4. 你确认方案后，再切换 auto-edit 5. 修改完成后运行测试 6. 用 git diff 检查所有改动 7. 再决定是否提交不要一上来就用full-auto改陌生项目。AI Agent 的效率来自自动化，但可靠性来自边界控制。
国内使用 Codex 要注意什么
Codex 依赖账号、模型和 API 访问。国内用户常见问题包括：
- 账号注册和支付不方便；
- 官方 API 网络访问不稳定；
- 多工具重复配置 Base URL；
- OpenAI 兼容协议和 Anthropic 协议容易混用；
- Cursor、Codex、Claude Code 各自配置方式不同。
如果你只是网页体验，可以先走官方订阅；如果要把 Codex 接进本地开发工具流，建议尽早统一模型入口。
涉及 API 中转、统一模型入口和国内渠道时，可以使用https://code.ai80.vip。这样你在 Codex、Claude Code、Cursor 等工具里配置 endpoint 时，会更容易保持一致。
Claude Code 和 Codex 怎么搭配
Codex 很适合代码分析、复杂 Bug、细节推理和图片输入；Claude Code 更适合长上下文理解、跨文件推进、持续执行任务。
一个实用组合是：
| 任务 | 推荐工具 |
|---|---|
| 项目结构理解 | Codex / Claude Code 都可 |
| 日常执行和跨文件改动 | Claude Code |
| 复杂 Bug 深挖 | Codex |
| 图片截图转代码 | Codex |
| 大范围重构 | Claude Code 执行，Codex 复核 |
| 最终代码审查 | Codex |
Claude Code 是 Anthropic 的终端编程 Agent，能读文件、执行命令、修改代码、跑测试，再根据反馈继续修复。官方订阅和 API 对国内用户并不总友好，支付、网络和账号稳定性都需要处理。如果想更省事地接入 Claude / Codex 相关能力，可以看看 Code80，真实订阅帐号转 API，换个 endpoint 就能直接用。
常见问题
1. Codex Desktop 和 Codex CLI 先学哪个？
如果你完全不熟悉终端，先用 Desktop；如果你是开发者，建议直接从 CLI 开始，因为 CLI 更适合真实项目。
2. 新手应该用哪种审批模式？
先用ask。它风险最低，可以让 Codex 读取项目、分析问题、提出方案，但不会在你确认前执行修改。
3. 什么时候可以用 auto-edit？
当你已经理解项目结构，并且任务范围比较明确时，可以用auto-edit。修改后一定要看git diff和测试结果。
4. full-auto 适合什么场景？
适合可回滚、可自动验证的批量任务，比如 CI/CD 自动化、格式化、批量修复简单问题。不建议在陌生生产项目上直接使用。
5. Codex 支持图片输入有什么用？
可以分析报错截图、根据 UI 设计图写前端、对比界面差异、解读架构图。这对前端开发和排错很有帮助。
6. 国内用户怎么更方便地使用 Codex 和 Claude Code？
如果能稳定访问官方并完成支付，可以走官方订阅或 API；如果不想折腾网络、支付和多工具配置，国内用户可以通过 Code80 更方便地接入。涉及 API 中转、统一模型入口和国内渠道时，直接使用https://code.ai80.vip即可。
)
