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修复 Bugcodex我的 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 URLOpenAI 兼容协议和 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 复核最终代码审查CodexClaude 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即可。