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