Codex 完整入门：从桌面应用到 CLI，用一个阅读时长计算器跑通 agent 工作流

一篇手把手的 Codex 教程：先搭一个带测试的阅读时长计算器小项目，再让 Codex 排除 Markdown 代码块并验证改动。文章覆盖桌面应用、CLI、IDE 扩展和云端四种入口的适用场景，以及各 ChatGPT 套餐的功能差异和用量共享机制。

Codex 是什么、怎么工作

• Codex 是 OpenAI 的编码 agent，能读项目、改文件、跑命令，任务可跨多个文件，桌面端还能在浏览器里打开 Web 应用验证结果
• 它以循环方式工作：读取文件、编辑并执行命令、检查结果，验证发现问题会自动重试，最后才交给人审阅
• 作者把它当成刚入职的开发者：说清要什么、指明有用的上下文、定义怎样算完成

入口选择与账号要求

• 桌面应用适合本地项目加浏览器流程验证；CLI 适合终端会话和可重复脚本；IDE 扩展适合从打开的文件发起任务；Cloud 适合委托给远程环境
• 需要 ChatGPT 账号或 OpenAI API key、Git 和较新版本的 Node.js；用 API key 计费时，依赖 ChatGPT 账号的云端功能（如自动 GitHub code review）不可用
• Free 和 Go 套餐可用桌面端（GPT-6 Luna，仍在逐步开放）；Plus 解锁 CLI、IDE 扩展、网页、iOS 和云端功能（GPT-6.1 Sol）；只有 $500 的 Pro 才有 GPT-6 Astra Ultrafast（生成速度最高 8 倍）
• Codex 与 ChatGPT Work 共享同一用量池，建议每一两周查看用量页了解自己的消耗节奏

桌面应用上手

• 从 openai.com/codex 下载应用（macOS/Windows/Linux），登录后在切换器里选 Codex，再添加本地项目文件夹
• 改动前先问一个只读问题，比如'用 ELI5 解释这个项目做什么'，确认它找对了项目和文件再让它动手
• 应用内可看 diff、开文件、用终端、预览 Web 应用、装插件、建定时任务，长任务可以挂着去忙别的

实战：阅读时长计算器

• 项目结构很简单：readingTime 函数按空白分词、向上取整、最少 1 分钟，用 Node 内置 test runner，零依赖
• 先自己跑 npm test 确认基线通过，再 git init 提交一个检查点，之后才引入 agent
• 先让 Codex 只解释不改动，确认它理解函数和测试文件；再提改动需求：排除 Markdown fenced code block（支持反引号和波浪线围栏、含未闭合围栏），保留 1 分钟下限、wordsPerMinute 参数和公共 API，行内代码仍算文本，加测试并跑 npm test
• 需求里写明支持哪些围栏格式、保留哪些行为、如何验证，是让 agent 一次做对的关键

验证与审查

• 模型每次可能选不同实现，别指望它写出某个特定正则，应审查行为是否符合预期
• 检查 agent 新增的测试是否真的有区分度，再跑全部测试、看 diff，确认原有测试没被破坏
• Git 提供了改动历史和回退手段，出问题随时能回到已知版本