小白速通 Codex App：先把这个工作台用明白，再谈 AI 编程

小白速通 Codex App：先把这个工作台用明白，再谈 AI 编程 小白速通 Codex App：先把这个工作台用明白，再谈 AI 编程 Modified May 28 Code block Plain Text Copy If a simpler approach exists, say so. Push back when warranted. If something is unclear, stop. Name what's confusing. Ask. 2. Simplicity First Minimum code that solves the problem. Nothing speculative. No features beyond what was asked. No abstractions for single use code. No "flexibility" or "configurability" that wasn't requested. No error handling for impossible scenarios. If you write 200 lines and it could be 50, rewrite it. Ask yourself: "Would a senior engineer say this is overcomplicated?" If yes, simplify. 3. Surgical Changes Touch only what you must. Clean up only your own mess. When editing existing code: Don't "improve" adjacent code, comments, or formatting. Don't refactor things that aren't broken. Match existing style, even if you'd do it differently. If you notice unrelated dead code, mention it don't delete it. When your changes create orphans: Remove imports/variables/functions that YOUR changes made unused. Don't remove pre existing dead code unless asked. The test: Every changed line should trace directly to the user's request. 4. Goal Driven Execution Define success criteria. Loop until verified. Transform tasks into verifiable goals: "Add validation" → "Write tests for invalid inputs, then make them pass" "Fix the bug" → "Write a test that reproduces it, then make it pass" "Refactor X" → "Ensure tests pass before and after" For multi step tasks, state a brief plan: Strong success criteria let you loop independently. Weak criteria ("make it work") require constant clarification. These guidelines are working if: fewer unnecessary changes in diffs, fewer rewrites due to overcomplication, and clarifying questions come before implementation rather than after mistakes. 这段话很朴素，但好用。 它能把 Codex 的默认工作方式往“小白可验收”方向拉一点。 AGENTS.md 要不要写 要写。 AGENTS.md 可以理解成项目规则。Codex 进项目以后，先知道哪些地方别乱动。 你可以在项目根目录放一个，这是个极简版本，你也可以通过 /init 反向推导当前项目内容： Code block Markdown Copy 项目协作规则 修改前先输出计划 不要主动新增依赖 不要修改数据库结构 不要修改支付、鉴权、部署配置，除非我明确同意 前端改动需要检查移动端显示 每次改动后说明修改了哪些文件、为什么改、怎么验证 如果信息不确定，直接标注“不确定” 优先做最小改动，不要大范围重构 它不能保证 AI 永远不犯错。 但至少比你每次临时补一句“别乱改”靠谱。 5 分钟上手任务 先别拿公司老项目练手。 新建一个空文件夹，做一个静态页面，比如“周末露营活动报名页”。 第一句话不要写： Code block Plain Text Copy 帮我做个好看的活动页。 这句话太虚。 可以这样写： Code block Plain Text Copy 我想做一个“周末露营活动报名页”的网页原型。 先不要创建文件。 请先告诉我： 1. 你准备生成几个文件 2. 页面会分成哪几块 3. 哪些内容需要我确认 4. 做完以后我应该怎么验收 页面给普通朋友看，手机和电脑都要能读。 内容包括活动标题、时间地点、费用、行程安排、报名表单、注意事项。 方案没问题，再发： Code block Plain Text Copy 按刚才方案执行。 请在当前空目录创建一个可以直接用浏览器打开的 index.html。 限制： 只做静态单页 不接后台 不使用外部图片 不安装依赖 不生成复杂工程 验收： 打开 index.html 能看到完整页面 手机和电脑都能正常阅读 表单包含姓名、电话、人数、备注 底部有明显的“我要报名”按钮 完成后告诉我： 1. 生成了什么文件 2. 怎么打开 3. 你做了哪些设计取舍 4. 我应该检查哪几个地方 这就是任务卡。 目标、范围、限制、验收都在里面。AI 可以发挥，但不能乱跑。 并行任务怎么用 回到开头那个例子。 早上 9 点，你要同时做三件事： Thread 任务 验收方式 Thread A 重构 utils 模块 看 diff，跑测试 Thread B 给 utils 写测试 看测试覆盖和失败用例 Thread C 整理 README 文档 看文档是否能让新人读懂 在 Codex App 里，你可以开三个 thread，让它们分别跑。 但别让它们都在主目录里乱改。能用 worktree 就用 worktree。每个 thread 单独隔离，最后回来 Review。 你不是要盯着 AI 每一秒。 你要做的是回来收结果。看它有没有越界，测试有没有过，文档有没有写成人话。 这就是 Codex App 比较适合小团队和产品经理的地方。 任务可以派出去，但收活口还在你手里。 Automations 先做只读 Automations 很好用，但小白别第一天就让它自动改代码。 先做只读。官方的案例里就有一些不错的。 再比如你也可以自己建立，每天晚上检查最近改动： Code block Plain Text Copy 每天晚上 10 点检查这个项目最近 24 小时的 Git 改动。 请输出： 1. 今天改了哪些主要内容 2. 哪些文件改动最大 3. 有没有看起来风险较高的改动 4. 有没有未完成的 TODO 5. 明天建议先检查什么 限制： 不要修改文件 不要提交代码 不要运行破坏性命令 不确定的地方标注“不确定” 这个安全。 它只读，只总结，不动项目。等你熟悉以后，再让它在 worktree 里做小修复。 自动化最怕没边界。 没边界的自动化，比手动犯错还烦。 Computer Use 和 Appshots 简单带过 Computer Use、Appshots 这类能力主要和 Mac 相关，本文不展开（别问，问就是我不喜欢Mac = = ）。 1. [Step] → verify: [check] 2. [Step] → verify: [check] 3. [Step] → verify: [check] 这段话很朴素，但好用。 它能把 Codex 的默认工作方式往“小白可验收”方向拉一点。 AGENTS.md 要不要写 要写。 AGENTS.md 可以理解成项目规则。Codex 进项目以后，先知道哪些地方别乱动。 你可以在项目根目录放一个，这是个极简版本，你也可以通过 /init 反向推导当前项目内容： 它不能保证 AI 永远不犯错。 但至少比你每次临时补一句“别乱改”靠谱。 5 分钟上手任务 先别拿公司老项目练手。 新建一个空文件夹，做一个静态页面，比如“周末露营活动报名页”。 第一句话不要写： 这句话太虚。 可以这样写： 方案没问题，再发： 这就是任务卡。 目标、范围、限制、验收都在里面。AI 可以发挥，但不能乱跑。 并行任务怎么用 回到开头那个例子。 早上 9 点，你要同时做三件事： Thread 任务 验收方式 Thread A 重构 utils 模块 看 diff，跑测试 Thread B 给 utils 写测试 看测试覆盖和失败用例 Thread C 整理 README 文档 看文档是否能让新人读懂 Thread Thread 任务 任务 验收方式 验收方式 Thread A Thread A 重构 utils 模块 重构 utils 模块 看 diff，跑测试 看 diff，跑测试 Thread B Thread B 给 utils 写测试 给 utils 写测试 看测试覆盖和失败用例 看测试覆盖和失败用例 Thread C Thread C 整理 README 文档 整理 README 文档 看文档是否能让新人读懂 看文档是否能让新人读懂 在 Codex App 里，你可以开三个 thread，让它们分别跑。 但别让它们都在主目录里乱改。能用 worktree 就用 worktree。每个 thread 单独隔离，最后回来 Review。 你不是要盯着 AI 每一秒。 你要做的是回来收结果。看它有没有越界，测试有没有过，文档有没有写成人话。 这就是 Codex App 比较适合小团队和产品经理的地方。 任务可以派出去，但收活口还在你手里。 Automations 先做只读 Automations 很好用，但小白别第一天就让它自动改代码。 先做只读。官方的案例里就有一些不错的。 再比如你也可以自己建立，每天晚上检查最近改动： 这个安全。 它只读，只总结，不动项目。等你熟悉以后，再让它在 worktree 里做小修复。 自动化最怕没边界。 没边界的自动化，比手动犯错还烦。 Computer Use 和 Appshots 简单带过 Computer Use、Appshots 这类能力主要和 Mac 相关，本文不展开（别问，问就是我不喜欢Mac = = ）。 老金是 Win 党，这部分我不会写成自己实测。你可以先知道有这些能力：让 Codex 看屏幕、操作 App、捕获当前窗口、处理 GUI 流程。 普通网页开发，先用 Browser。 需要登录网页，用 Chrome Extension。 必须操作桌面 App、模拟器、图形界面流程，再研究 Computer Use。 这类能力越接近“让 AI 操作你的电脑”，越要谨慎，而且。。。它非常消耗Token。 和 Claude Code 怎么配 Claude Code 很强，但这篇不讲安装。 这里就讲位置。 我更愿意这么用： 场景 更适合 还没想清楚，要一起拆方案 Claude Code 老项目复杂 bug，要看过程 Claude Code 需要跨文件分析、架构判断 Claude Code 边界已经清楚的小任务 Codex App 多个任务并行跑 Codex App 做完回来集中看 diff Codex App 自动化重复检查 Codex App 场景 场景 更适合 更适合 还没想清楚，要一起拆方案 还没想清楚，要一起拆方案 Claude Code Claude Code 老项目复杂 bug，要看过程 老项目复杂 bug，要看过程 Claude Code Claude Code 需要跨文件分析、架构判断 需要跨文件分析、架构判断 Claude Code Claude Code 边界已经清楚的小任务 边界已经清楚的小任务 Codex App Codex App 多个任务并行跑 多个任务并行跑 Codex App Codex App 做完回来集中看 diff 做完回来集中看 diff Codex App Codex App 自动化重复检查 自动化重复检查 Codex App Codex App 我自己的工作流很简单： 先用 Claude Code 把复杂问题拆清楚。 再把边界清楚的小任务丢给 Codex App。 回来用 Review 和 Diff 收结果。 这俩不是非要选一个。 它们更像两个位置：一个靠近现场，一个更适合派单。 最后说句实话 我重点讲 Codex App，不是因为它永远最强。 它适合小白，是因为它把 AI 编程这件事摆到了明面上。 你能看到项目。 能看到 thread， worktree，diff。 能看到浏览器预览。 能看到插件、Skill、自动化和 Pets 这些东西怎么挂在一起。 它更像是一个私人管家，你说完它就去做，做完为止。但抛弃的是过程，你想看过程就需要来回点一点展开。 这就是和Claude Code最大的不同，CC更像是你的搭子，边做边讨论，清晰可见，框架以及跨文件能力要更好一些。 普通人最缺的不是一个更玄的工具，而是一个能看见、能收活、能回退的工作台。 很多人用 AI 翻车，不是因为模型不行。 是因为交出去的不是任务，只是一团愿望。 同样一句“帮我做一下”，有的人交出去的是感觉，有的人交出去的是目标、范围、限制和验收。 差距从这里开始。 You don't have permission to access this synced block. Please log in and try again. Log In • 作者：老金 • GitHub：https://github.com/KimYx0207 • 公众号：老金带你玩AI • X（Twitter）：老金带你玩AI • 个人博客：https://aiking.dev • 飞书会议回放：https://waytoagi.feishu.cn/minutes/obcnvbteczv6t3k5rigv1cnp • 元架构理论 帮你更好地使用AI： 元：从混沌许愿到系统治理 WaytoAgi直播教学版 元：从混沌许愿到系统治理 WaytoAgi直播教学版 • 作者：老金 • GitHub：https://github.com/KimYx0207 • 公众号：老金带你玩AI • X（Twitter）：老金带你玩AI • 个人博客：https://aiking.dev • 飞书会议回放：https://waytoagi.feishu.cn/minutes/obcnvbteczv6t3k5rigv1cnp • 元架构理论 帮你更好地使用AI： 元：从混沌许愿到系统治理 WaytoAgi直播教学版 元：从混沌许愿到系统治理 WaytoAgi直播教学版 早上 9 点，你同时有三件事要干：改一个页面、修一个小 bug、整理一份项目说明。 以前这三件事排在一起，你大概率会先挑一个做，剩下两个往后拖。用 AI 编程以后，情况变了。你可以让不同任务并行跑，自己回来只看结果、看 diff、看哪里需要确认。 这也是我为什么要重点讲 Codex App。 Codex 入口很多，CLI、IDE、Cloud/Web、Mobile 都能聊。但对小白来说，第一步不是把所有入口都学一遍。第一步是先找到一个能看见任务、能看见改动、能看见验收结果的地方。 Codex App 就是这个地方。 先说清楚，老金我一直是 Win 党。Windows 相关内容主要来自我的使用习惯和资料核对；Mac 相关信息来自官方文档和网上资料收集，我没有长期在 Mac 上跑完整工作流。Mac 用户可以参考，但遇到系统权限、Computer Use、Appshots、锁屏运行这些细节，自己还要按官方文档和实际界面再试一遍。 这篇文章只重点讲 Codex App。 一句话讲清楚 Codex App Codex App 可以理解成一个 AI 编程工作台。 它不是单纯聊天框，也不是普通编辑器。你可以在里面打开项目，创建 thread，让 Codex 读文件、改文件、跑命令、看网页预览、检查 diff、用插件、调用 Skill，还能设置自动化任务。 我更愿意把它理解成三件东西放在一起： 你看到的东西 它解决的问题 小白为什么需要 Projects / Threads 把不同项目和任务分开 不容易把上下文搅乱 Worktree / Review / Diff 隔离修改、检查改动 AI 改错了还能回头 Browser / Plugins / Skills / Automations 预览页面、扩展工具、复用流程 不用每次从零开始说 你看到的东西 你看到的东西 它解决的问题 它解决的问题 小白为什么需要 小白为什么需要 Projects / Threads Projects / Threads 把不同项目和任务分开 把不同项目和任务分开 不容易把上下文搅乱 不容易把上下文搅乱 Worktree / Review / Diff Worktree / Review / Diff 隔离修改、检查改动 隔离修改、检查改动 AI 改错了还能回头 AI 改错了还能回头 Browser / Plugins / Skills / Automations Browser / Plugins / Skills / Automations 预览页面、扩展工具、复用流程 预览页面、扩展工具、复用流程 不用每次从零开始说 不用每次从零开始说 这套东西对工程师来说可能只是效率工具。 对小白来说，它更重要的价值是：让 AI 干活这件事变得可见。 你能看到任务在哪里跑，改了哪些文件，哪里等你确认，最后结果能不能收。 下载地址和安装入口 先把地址放前面，别让大家第一步就到处找。 入口 适合谁 下载 / 访问地址 老金建议 Codex App 官方页面 macOS / Windows 用户 https://developers.openai.com/codex/app 优先从这里进，下载按钮以官方页面为准 Windows Microsoft Store Windows 用户 https://apps.microsoft.com/detail/9plm9xgg6vks Win 党优先走这个 Codex Web / Cloud 想先浏览器试试的人 https://chatgpt.com/codex 不想本地安装时可以试 Codex CLI 文档 命令行用户 https://developers.openai.com/codex/cli 小白先别急，后面补 Codex GitHub 想看开源仓库和 release 的人 https://github.com/openai/codex 进阶用户看 VS Code 扩展 VS Code / Cursor / Windsurf 用户 https://marketplace.visualstudio.com/items?itemName=openai.chatgpt 写代码时顺手用 入口 入口 适合谁 适合谁 下载 / 访问地址 下载 / 访问地址 老金建议 老金建议 Codex App 官方页面 Codex App 官方页面 macOS / Windows 用户 macOS / Windows 用户 https://developers.openai.com/codex/app https://developers.openai.com/codex/app 优先从这里进，下载按钮以官方页面为准 优先从这里进，下载按钮以官方页面为准 Windows Microsoft Store Windows Microsoft Store Windows 用户 Windows 用户 https://apps.microsoft.com/detail/9plm9xgg6vks https://apps.microsoft.com/detail/9plm9xgg6vks Win 党优先走这个 Win 党优先走这个 Codex Web / Cloud Codex Web / Cloud 想先浏览器试试的人 想先浏览器试试的人 https://chatgpt.com/codex https://chatgpt.com/codex 不想本地安装时可以试 不想本地安装时可以试 Codex CLI 文档 Codex CLI 文档 命令行用户 命令行用户 https://developers.openai.com/codex/cli https://developers.openai.com/codex/cli 小白先别急，后面补 小白先别急，后面补 Codex GitHub Codex GitHub 想看开源仓库和 release 的人 想看开源仓库和 release 的人 https://github.com/openai/codex https://github.com/openai/codex 进阶用户看 进阶用户看 VS Code 扩展 VS Code 扩展 VS Code / Cursor / Windsurf 用户 VS Code / Cursor / Windsurf 用户 https://marketplace.visualstudio.com/items?itemName=openai.chatgpt https://marketplace.visualstudio.com/items?itemName=openai.chatgpt 写代码时顺手用 写代码时顺手用 如果你是 Windows 用户，最直接的方式是 Microsoft Store 搜 Codex，安装官方 Codex App（需要网络环境）。 如果你是 Mac 用户，去官方 Codex App 页面下载 macOS 版本。页面上会区分 Apple Silicon 和 Intel Mac，别下错。 Linux 用户这篇不重点讲 App。Linux 更适合走 CLI 或 IDE 扩展。 如果你只想 5 分钟试一下 虽然这篇重点讲 App，但 CLI 适合拿来做一次快速体验。你要是想先确认 Codex 能不能跑，可以用下面命令。 CLI虽然是编程的最强形态，但老金觉得Codex APP才是在Codex生态中做的最好的产品。反观Claude Code我更推荐CLI。 然后web和mobile使用方法，建议在录播中查看。 macOS / Linux： Windows PowerShell： npm 方式： Homebrew 方式： 我还是那句话：小白别一上来就扎进 CLI。 CLI 强，但终端、路径、环境、权限、Node 版本这些东西会把人绕晕。你只是想先用 AI 做点东西，先装 App 更稳。 平台功能速查表 这张表先给你一个大概判断，不用背。 功能 / 入口 Windows macOS Linux 老金建议 Codex App 支持 支持 暂不作为主入口 小白优先学 App Codex CLI 支持 支持 支持 进阶再补 Codex Web / Cloud 支持 支持 支持 浏览器试用、后台任务 IDE 扩展 支持 支持 支持 会用编辑器后再装 Worktree App 内可用 App 内可用 走 CLI / IDE 新功能尽量用 Review / Diff App 内可用 App 内可用 走 CLI / IDE 每次改完都看 Browser 预览 App 内可用 App 内可用 看入口 做网页很好用 Plugins / Skills App 内可用 App 内可用 走对应入口 先装少量 Automations App 内可用 App 内可用 看入口 先做只读任务 功能 / 入口 功能 / 入口 Windows Windows macOS macOS Linux Linux 老金建议 老金建议 Codex App Codex App 支持 支持 支持 支持 暂不作为主入口 暂不作为主入口 小白优先学 App 小白优先学 App Codex CLI Codex CLI 支持 支持 支持 支持 支持 支持 进阶再补 进阶再补 Codex Web / Cloud Codex Web / Cloud 支持 支持 支持 支持 支持 支持 浏览器试用、后台任务 浏览器试用、后台任务 IDE 扩展 IDE 扩展 支持 支持 支持 支持 支持 支持 会用编辑器后再装 会用编辑器后再装 Worktree Worktree App 内可用 App 内可用 App 内可用 App 内可用 走 CLI / IDE 走 CLI / IDE 新功能尽量用 新功能尽量用 Review / Diff Review / Diff App 内可用 App 内可用 App 内可用 App 内可用 走 CLI / IDE 走 CLI / IDE 每次改完都看 每次改完都看 Browser 预览 Browser 预览 App 内可用 App 内可用 App 内可用 App 内可用 看入口 看入口 做网页很好用 做网页很好用 Plugins / Skills Plugins / Skills App 内可用 App 内可用 App 内可用 App 内可用 走对应入口 走对应入口 先装少量 先装少量 Automations Automations App 内可用 App 内可用 App 内可用 App 内可用 看入口 看入口 先做只读任务 先做只读任务 Pets App 设置内 App 设置内 暂不作为主入口 可开可不开 Computer Use 不是本文主线 Mac 相关能力 不作为本文主线 Mac 用户自行尝试 Appshots 不作为本文主线 Mac 相关能力 不作为本文主线 Mac 用户自行尝试 Mobile 远程 看官方当前支持 更适合配合 Mac 主机 不作为本文主线 先知道有这回事 这篇重点讲 Windows 和 Codex App。Mac 相关能力我会提醒，但不装成我实测。 Codex App 的界面怎么看 打开 App 后，先别急着输入“帮我做个项目”。 先看三个位置。 左边是项目和 thread。一个项目可以有很多条 thread。你可以把官网、后台、小工具、文档项目分开放，不要全塞在一个聊天里。 中间是会话区。你给任务、Codex 回答、任务推进，都在这里发生。 右侧或相关面板是 Review、Diff、文件改动、Git 状态、预览结果。这里才是你收活的地方。 很多小白只看聊天区。 Codex 说“我完成了”，你就信了。这个习惯不好。AI 说完成只是它的口头交付，你还要看它改了哪些文件、有没有越界、页面能不能打开、测试有没有跑。 聊天区负责沟通，Review 负责验收，这两个位置别混。 我们从左到右来讲解。 第1+2步：你需要加入一个项目文件夹，推荐使用现有文件夹，可以是空的。 第3步：在加入的文件夹项目上，点击新建对话。 第4步：在聊天区域输入内容即可开始。 这里先讲聊天区域的功能。 1、可以在聊天区域选择对应的项目。 2、选择你要使用的场景。本地就是主干，推荐建立基础骨架时使用。其次频率最高的应该是新worktree，这个在下面讲它为什么重要。云端是可以快速通过移动端等链接做一些小任务的，因为它的使用模型目前应该是5.3。 3、分支，分支和工作树可能对大家会产生歧义，这里简单解释一下： 分支（Branch）是 Git 里的不同开发路线，用来区分主线、修 Bug、新功能等代码方向。 工作树（Worktree）是把同一个仓库的不同分支放到不同文件夹里，让多个任务可以同时改代码，互不干扰。 4、其他一看就懂的，但是这里要说一下，模型并不是最高就最好，而是相对于你要做