[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"$f5GzK1K_S5_vDzXSWTudImuexemgK0BG3z_1FjIUl0Jo":3,"$fdZfcOaZIilKSIgGx3dBYcWOdYiIPSdllVzWyJU5rrEw":5,"tutorials-index-zh":7},{"user":4},null,{"google":6,"github":6},true,[8,168,281],{"id":9,"title":10,"body":11,"category":142,"description":143,"difficulty":144,"draft":145,"extension":146,"intent":147,"keywords":148,"locale":152,"meta":153,"navigation":6,"path":154,"priority":155,"related":156,"seo":159,"sources":160,"stem":164,"tool":165,"updatedAt":166,"__hash__":167},"tutorials_zh\u002Fzh\u002Ftutorials\u002Fcodex\u002Fwhat-is-codex.md","Codex 是什么？适合谁用？",{"type":12,"value":13,"toc":132},"minimark",[14,18,22,25,28,31,53,56,60,63,77,80,91,94,97,100,111,114,117,120,123,126,129],[15,16,17],"h2",{"id":17},"一句话解释",[19,20,21],"p",{},"Codex 是 OpenAI 面向编程任务的 AI 助手体系。你可以把它理解成一个会读项目、改代码、跑命令、解释错误、辅助 review 的开发协作工具。",[19,23,24],{},"它不是只会补全几行代码的输入法，也不是单纯聊天机器人。更准确地说，它是围绕真实工程任务设计的 AI coding agent。",[15,26,27],{"id":27},"它能做什么",[19,29,30],{},"Codex 常见用途包括：",[32,33,34,38,41,44,47,50],"ul",{},[35,36,37],"li",{},"阅读一个已有项目，解释模块、数据流和启动方式。",[35,39,40],{},"根据需求修改代码，并尽量沿用项目原有风格。",[35,42,43],{},"运行测试、构建、类型检查，定位失败原因。",[35,45,46],{},"写脚本处理重复性工程任务。",[35,48,49],{},"帮你审查 diff，找潜在 bug、边界条件和缺失测试。",[35,51,52],{},"把需求拆成实现步骤，生成可落地的开发计划。",[19,54,55],{},"如果你的工作经常涉及代码、配置、文档、调试和发布检查，Codex 的价值会比较明显。",[15,57,59],{"id":58},"codex-适合谁","Codex 适合谁",[19,61,62],{},"适合：",[32,64,65,68,71,74],{},[35,66,67],{},"独立开发者和小团队，需要更快完成全栈功能。",[35,69,70],{},"产品型工程师，需要在多个项目之间切换。",[35,72,73],{},"正在学习编程的人，希望有人解释真实项目。",[35,75,76],{},"已经会写代码的人，希望把重复劳动交给 AI。",[19,78,79],{},"不太适合：",[32,81,82,85,88],{},[35,83,84],{},"完全不想读代码，也不想确认改动的人。",[35,86,87],{},"只需要普通问答、写文案、翻译的人。",[35,89,90],{},"对账号、权限、代码仓库边界完全没有概念的人。",[19,92,93],{},"Codex 能提高速度，但它仍然需要你判断需求、验收结果和控制发布边界。",[15,95,96],{"id":96},"几个入口怎么区分",[19,98,99],{},"Codex 常见入口可以按场景分：",[32,101,102,105,108],{},[35,103,104],{},"Codex app：适合在独立界面里处理完整任务、查看线程和让 agent 执行多步工作。",[35,106,107],{},"Codex CLI：适合在终端里操作本地项目，直接和命令行工作流结合。",[35,109,110],{},"Codex IDE extension：适合在编辑器里围绕当前代码进行修改、解释和局部协作。",[19,112,113],{},"新手通常可以先从 app 或 IDE extension 开始；如果你本来就习惯终端，再看 CLI。",[15,115,116],{"id":116},"常见误区",[19,118,119],{},"第一个误区是把 Codex 当作万能自动开发。它可以执行很多步骤，但你仍然要确认目标、检查代码、运行测试，并决定是否提交或发布。",[19,121,122],{},"第二个误区是只让它写新代码。很多时候，Codex 更适合做“理解已有系统、定位问题、验证修复”这类工程活。",[19,124,125],{},"第三个误区是忽略官方入口。涉及下载、安装和账号权限时，应优先看官方页面，不要从第三方站点下载未知安装包。",[15,127,128],{"id":128},"下一步",[19,130,131],{},"如果你只是想确认从哪里开始，先看 Codex 下载与安装；如果你已经能打开 Codex，再看 Codex 使用教程。",{"title":133,"searchDepth":134,"depth":134,"links":135},"",2,[136,137,138,139,140,141],{"id":17,"depth":134,"text":17},{"id":27,"depth":134,"text":27},{"id":58,"depth":134,"text":59},{"id":96,"depth":134,"text":96},{"id":116,"depth":134,"text":116},{"id":128,"depth":134,"text":128},"ai-coding","解释 OpenAI Codex 的作用、入口、适合人群和常见误区，帮助新手判断是否值得上手。","beginner",false,"md","explainer",[149,150,151],"codex是什么","openai codex","codex使用场景","zh",{},"\u002Ftutorials\u002Fcodex\u002Fwhat-is-codex",10,[157,158],"\u002Ftutorials\u002Fcodex\u002Fcodex-download","\u002Ftutorials\u002Fcodex\u002Fcodex-tutorial",{"title":10,"description":143},[161,162,163],"https:\u002F\u002Fdevelopers.openai.com\u002Fcodex\u002F","https:\u002F\u002Fdevelopers.openai.com\u002Fcodex\u002Fapp","https:\u002F\u002Fdevelopers.openai.com\u002Fcodex\u002Fcli","zh\u002Ftutorials\u002Fcodex\u002Fwhat-is-codex","codex","2026-07-09","phDOR4dKZGwLI1EZ2dtfZn6MKiKRVZUD55l1c3ENchg",{"id":169,"title":170,"body":171,"category":142,"description":267,"difficulty":144,"draft":145,"extension":146,"intent":268,"keywords":269,"locale":152,"meta":273,"navigation":6,"path":157,"priority":274,"related":275,"seo":276,"sources":277,"stem":279,"tool":165,"updatedAt":166,"__hash__":280},"tutorials_zh\u002Fzh\u002Ftutorials\u002Fcodex\u002Fcodex-download.md","Codex 下载与安装：官方入口怎么选",{"type":12,"value":172,"toc":259},[173,176,179,190,193,197,200,203,207,210,213,224,228,231,234,237,240,250,253,256],[15,174,175],{"id":175},"先选你要的入口",[19,177,178],{},"搜索“Codex 下载”时，最重要的不是找一个按钮，而是先判断你要哪一种 Codex 入口。",[32,180,181,184,187],{},[35,182,183],{},"想要独立任务界面：看 Codex app。",[35,185,186],{},"想要在终端里直接操作项目：看 Codex CLI。",[35,188,189],{},"想要在编辑器里围绕当前文件协作：看 Codex IDE extension。",[19,191,192],{},"不要从不明第三方网站下载所谓安装包。Codex 和账号权限强相关，入口、版本和可用范围都应以官方页面为准。",[15,194,196],{"id":195},"codex-app","Codex app",[19,198,199],{},"Codex app 更适合完整任务流，比如让 Codex 阅读项目、修改多个文件、运行测试、总结改动。",[19,201,202],{},"如果你经常开多个任务线程，或者希望把“需求、代码、验证、总结”放在一个界面里处理，优先看 app。",[15,204,206],{"id":205},"codex-cli","Codex CLI",[19,208,209],{},"Codex CLI 更适合命令行用户。它的优势是贴近本地项目目录，适合在终端里直接发起代码修改、调试和验证。",[19,211,212],{},"安装前建议确认：",[32,214,215,218,221],{},[35,216,217],{},"本机 Node.js、包管理器和 Git 工作流是否正常。",[35,219,220],{},"当前目录是不是你要操作的项目。",[35,222,223],{},"仓库里是否有未提交改动，避免混在一起难以回滚。",[15,225,227],{"id":226},"codex-ide-extension","Codex IDE extension",[19,229,230],{},"IDE extension 更适合编辑器内协作。你可以围绕当前文件、选区、错误信息或局部模块让 Codex 帮你解释和修改。",[19,232,233],{},"如果你的主要工作都在 VS Code 或类似 IDE 中完成，这个入口会更顺手。",[15,235,236],{"id":236},"安装后的第一件事",[19,238,239],{},"安装好之后，不建议一上来就让 Codex 做大重构。更稳的第一步是让它读项目，并回答：",[241,242,247],"pre",{"className":243,"code":245,"language":246,"meta":133},[244],"language-text","请先阅读这个项目，告诉我启动方式、主要模块、测试命令和需要小心的发布边界。\n","text",[248,249,245],"code",{"__ignoreMap":133},[19,251,252],{},"这样你能先确认它理解项目，再进入实际修改。",[15,254,255],{"id":255},"相关教程",[19,257,258],{},"如果你还不确定 Codex 是什么，先看解释页；如果已经安装完成，继续看使用教程。",{"title":133,"searchDepth":134,"depth":134,"links":260},[261,262,263,264,265,266],{"id":175,"depth":134,"text":175},{"id":195,"depth":134,"text":196},{"id":205,"depth":134,"text":206},{"id":226,"depth":134,"text":227},{"id":236,"depth":134,"text":236},{"id":255,"depth":134,"text":255},"整理 Codex app、CLI 和 IDE extension 的官方入口、适合场景和安装前检查项，避免误下第三方安装包。","setup",[270,271,272],"codex下载","codex安装","openai codex下载",{},20,[154,158],{"title":170,"description":267},[162,163,278],"https:\u002F\u002Fdevelopers.openai.com\u002Fcodex\u002Fide","zh\u002Ftutorials\u002Fcodex\u002Fcodex-download","iwxRiqS72XEH438kdu7mHsnwtkRMwkKf5SlARLGuGBE",{"id":282,"title":283,"body":284,"category":142,"description":467,"difficulty":144,"draft":145,"extension":146,"intent":468,"keywords":469,"locale":152,"meta":473,"navigation":6,"path":158,"priority":474,"related":475,"seo":476,"sources":477,"stem":478,"tool":165,"updatedAt":166,"__hash__":479},"tutorials_zh\u002Fzh\u002Ftutorials\u002Fcodex\u002Fcodex-tutorial.md","Codex 使用教程：从第一个工程任务开始",{"type":12,"value":285,"toc":459},[286,290,293,307,310,314,317,323,326,330,333,347,350,356,359,363,366,383,386,390,393,428,431,435,438,452,455],[15,287,289],{"id":288},"第一步从小任务开始","第一步：从小任务开始",[19,291,292],{},"第一次使用 Codex，不要直接丢一个“大改整个系统”的需求。更好的方式是选一个边界清楚的小任务，例如：",[32,294,295,298,301,304],{},[35,296,297],{},"给一个已有页面补 SEO title 和 description。",[35,299,300],{},"修一个明确报错。",[35,302,303],{},"给一个纯函数补测试。",[35,305,306],{},"整理某个模块的 README。",[19,308,309],{},"任务越具体，Codex 越容易给出可验证的结果。",[15,311,313],{"id":312},"第二步让它先读项目","第二步：让它先读项目",[19,315,316],{},"可以先给它这样一句话：",[241,318,321],{"className":319,"code":320,"language":246,"meta":133},[244],"请先阅读项目结构和 README，不要改代码。告诉我这个项目怎么启动、怎么测试、主要模块在哪里。\n",[248,322,320],{"__ignoreMap":133},[19,324,325],{},"这一步的目的是让 Codex 建立上下文，也让你确认它有没有看对仓库。",[15,327,329],{"id":328},"第三步描述目标和边界","第三步：描述目标和边界",[19,331,332],{},"一个好的任务说明通常包含四件事：",[32,334,335,338,341,344],{},[35,336,337],{},"你要什么结果。",[35,339,340],{},"哪些文件或页面相关。",[35,342,343],{},"哪些事情不要动。",[35,345,346],{},"做完后用什么命令验证。",[19,348,349],{},"例如：",[241,351,354],{"className":352,"code":353,"language":246,"meta":133},[244],"请给教程中心新增一个列表页，只做前台展示，不加后台编辑器。完成后跑 typecheck 和相关测试。\n",[248,355,353],{"__ignoreMap":133},[19,357,358],{},"这种描述比“帮我做 SEO 模块”更容易落地。",[15,360,362],{"id":361},"第四步看-diff而不是只看总结","第四步：看 diff，而不是只看总结",[19,364,365],{},"Codex 修改完成后，不要只看它的文字总结。你应该重点看：",[32,367,368,371,374,377,380],{},[35,369,370],{},"新增了哪些文件。",[35,372,373],{},"有没有动到无关模块。",[35,375,376],{},"有没有引入不需要的新依赖。",[35,378,379],{},"测试是否覆盖关键逻辑。",[35,381,382],{},"页面文案是否符合你的产品定位。",[19,384,385],{},"如果 diff 太大，可以要求它按文件解释改动。",[15,387,389],{"id":388},"第五步跑验证","第五步：跑验证",[19,391,392],{},"常见验证包括：",[241,394,398],{"className":395,"code":396,"language":397,"meta":133,"style":133},"language-bash shiki shiki-themes github-light github-dark","pnpm typecheck\npnpm test\npnpm build\n","bash",[248,399,400,413,420],{"__ignoreMap":133},[401,402,405,409],"span",{"class":403,"line":404},"line",1,[401,406,408],{"class":407},"sScJk","pnpm",[401,410,412],{"class":411},"sZZnC"," typecheck\n",[401,414,415,417],{"class":403,"line":134},[401,416,408],{"class":407},[401,418,419],{"class":411}," test\n",[401,421,423,425],{"class":403,"line":422},3,[401,424,408],{"class":407},[401,426,427],{"class":411}," build\n",[19,429,430],{},"具体跑哪个命令，要看项目已有约定。对线上产品来说，代码修改通过测试不等于已经发版；提交、推送、部署应该分开确认。",[15,432,434],{"id":433},"第六步逐步扩大任务","第六步：逐步扩大任务",[19,436,437],{},"等你熟悉流程后，可以让 Codex 做更复杂的事情：",[32,439,440,443,446,449],{},[35,441,442],{},"按现有模式新增一个模块。",[35,444,445],{},"分析线上错误日志并定位代码路径。",[35,447,448],{},"给一个功能写设计文档和实现计划。",[35,450,451],{},"做 code review 并修复高风险问题。",[19,453,454],{},"最稳的用法不是一次让它“全自动完成一切”，而是让它在每个工程节点给你可检查的证据。",[456,457,458],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":133,"searchDepth":134,"depth":134,"links":460},[461,462,463,464,465,466],{"id":288,"depth":134,"text":289},{"id":312,"depth":134,"text":313},{"id":328,"depth":134,"text":329},{"id":361,"depth":134,"text":362},{"id":388,"depth":134,"text":389},{"id":433,"depth":134,"text":434},"用一个安全的入门流程讲清 Codex 怎么读项目、拆任务、改代码、跑测试和总结结果，适合第一次上手。","tutorial",[470,471,472],"codex使用教程","codex怎么用","codex入门",{},30,[154,157],{"title":283,"description":467},[161,162,163],"zh\u002Ftutorials\u002Fcodex\u002Fcodex-tutorial","JUqp2TPuhQC9VwTL0xJyhYR4MtuZaF7LI8ZbIno4DzI"]