[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"$f5GzK1K_S5_vDzXSWTudImuexemgK0BG3z_1FjIUl0Jo":3,"$fdZfcOaZIilKSIgGx3dBYcWOdYiIPSdllVzWyJU5rrEw":5,"tutorial-zh-\u002Ftutorials\u002Fcodex\u002Fwhat-is-codex":7},{"user":4},null,{"google":6,"github":6},true,{"page":8,"related":168},{"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",[169,282],{"id":170,"title":171,"body":172,"category":142,"description":268,"difficulty":144,"draft":145,"extension":146,"intent":269,"keywords":270,"locale":152,"meta":274,"navigation":6,"path":157,"priority":275,"related":276,"seo":277,"sources":278,"stem":280,"tool":165,"updatedAt":166,"__hash__":281},"tutorials_zh\u002Fzh\u002Ftutorials\u002Fcodex\u002Fcodex-download.md","Codex 下载与安装：官方入口怎么选",{"type":12,"value":173,"toc":260},[174,177,180,191,194,198,201,204,208,211,214,225,229,232,235,238,241,251,254,257],[15,175,176],{"id":176},"先选你要的入口",[19,178,179],{},"搜索“Codex 下载”时，最重要的不是找一个按钮，而是先判断你要哪一种 Codex 入口。",[32,181,182,185,188],{},[35,183,184],{},"想要独立任务界面：看 Codex app。",[35,186,187],{},"想要在终端里直接操作项目：看 Codex CLI。",[35,189,190],{},"想要在编辑器里围绕当前文件协作：看 Codex IDE extension。",[19,192,193],{},"不要从不明第三方网站下载所谓安装包。Codex 和账号权限强相关，入口、版本和可用范围都应以官方页面为准。",[15,195,197],{"id":196},"codex-app","Codex app",[19,199,200],{},"Codex app 更适合完整任务流，比如让 Codex 阅读项目、修改多个文件、运行测试、总结改动。",[19,202,203],{},"如果你经常开多个任务线程，或者希望把“需求、代码、验证、总结”放在一个界面里处理，优先看 app。",[15,205,207],{"id":206},"codex-cli","Codex CLI",[19,209,210],{},"Codex CLI 更适合命令行用户。它的优势是贴近本地项目目录，适合在终端里直接发起代码修改、调试和验证。",[19,212,213],{},"安装前建议确认：",[32,215,216,219,222],{},[35,217,218],{},"本机 Node.js、包管理器和 Git 工作流是否正常。",[35,220,221],{},"当前目录是不是你要操作的项目。",[35,223,224],{},"仓库里是否有未提交改动，避免混在一起难以回滚。",[15,226,228],{"id":227},"codex-ide-extension","Codex IDE extension",[19,230,231],{},"IDE extension 更适合编辑器内协作。你可以围绕当前文件、选区、错误信息或局部模块让 Codex 帮你解释和修改。",[19,233,234],{},"如果你的主要工作都在 VS Code 或类似 IDE 中完成，这个入口会更顺手。",[15,236,237],{"id":237},"安装后的第一件事",[19,239,240],{},"安装好之后，不建议一上来就让 Codex 做大重构。更稳的第一步是让它读项目，并回答：",[242,243,248],"pre",{"className":244,"code":246,"language":247,"meta":133},[245],"language-text","请先阅读这个项目，告诉我启动方式、主要模块、测试命令和需要小心的发布边界。\n","text",[249,250,246],"code",{"__ignoreMap":133},[19,252,253],{},"这样你能先确认它理解项目，再进入实际修改。",[15,255,256],{"id":256},"相关教程",[19,258,259],{},"如果你还不确定 Codex 是什么，先看解释页；如果已经安装完成，继续看使用教程。",{"title":133,"searchDepth":134,"depth":134,"links":261},[262,263,264,265,266,267],{"id":176,"depth":134,"text":176},{"id":196,"depth":134,"text":197},{"id":206,"depth":134,"text":207},{"id":227,"depth":134,"text":228},{"id":237,"depth":134,"text":237},{"id":256,"depth":134,"text":256},"整理 Codex app、CLI 和 IDE extension 的官方入口、适合场景和安装前检查项，避免误下第三方安装包。","setup",[271,272,273],"codex下载","codex安装","openai codex下载",{},20,[154,158],{"title":171,"description":268},[162,163,279],"https:\u002F\u002Fdevelopers.openai.com\u002Fcodex\u002Fide","zh\u002Ftutorials\u002Fcodex\u002Fcodex-download","iwxRiqS72XEH438kdu7mHsnwtkRMwkKf5SlARLGuGBE",{"id":283,"title":284,"body":285,"category":142,"description":468,"difficulty":144,"draft":145,"extension":146,"intent":469,"keywords":470,"locale":152,"meta":474,"navigation":6,"path":158,"priority":475,"related":476,"seo":477,"sources":478,"stem":479,"tool":165,"updatedAt":166,"__hash__":480},"tutorials_zh\u002Fzh\u002Ftutorials\u002Fcodex\u002Fcodex-tutorial.md","Codex 使用教程：从第一个工程任务开始",{"type":12,"value":286,"toc":460},[287,291,294,308,311,315,318,324,327,331,334,348,351,357,360,364,367,384,387,391,394,429,432,436,439,453,456],[15,288,290],{"id":289},"第一步从小任务开始","第一步：从小任务开始",[19,292,293],{},"第一次使用 Codex，不要直接丢一个“大改整个系统”的需求。更好的方式是选一个边界清楚的小任务，例如：",[32,295,296,299,302,305],{},[35,297,298],{},"给一个已有页面补 SEO title 和 description。",[35,300,301],{},"修一个明确报错。",[35,303,304],{},"给一个纯函数补测试。",[35,306,307],{},"整理某个模块的 README。",[19,309,310],{},"任务越具体，Codex 越容易给出可验证的结果。",[15,312,314],{"id":313},"第二步让它先读项目","第二步：让它先读项目",[19,316,317],{},"可以先给它这样一句话：",[242,319,322],{"className":320,"code":321,"language":247,"meta":133},[245],"请先阅读项目结构和 README，不要改代码。告诉我这个项目怎么启动、怎么测试、主要模块在哪里。\n",[249,323,321],{"__ignoreMap":133},[19,325,326],{},"这一步的目的是让 Codex 建立上下文，也让你确认它有没有看对仓库。",[15,328,330],{"id":329},"第三步描述目标和边界","第三步：描述目标和边界",[19,332,333],{},"一个好的任务说明通常包含四件事：",[32,335,336,339,342,345],{},[35,337,338],{},"你要什么结果。",[35,340,341],{},"哪些文件或页面相关。",[35,343,344],{},"哪些事情不要动。",[35,346,347],{},"做完后用什么命令验证。",[19,349,350],{},"例如：",[242,352,355],{"className":353,"code":354,"language":247,"meta":133},[245],"请给教程中心新增一个列表页，只做前台展示，不加后台编辑器。完成后跑 typecheck 和相关测试。\n",[249,356,354],{"__ignoreMap":133},[19,358,359],{},"这种描述比“帮我做 SEO 模块”更容易落地。",[15,361,363],{"id":362},"第四步看-diff而不是只看总结","第四步：看 diff，而不是只看总结",[19,365,366],{},"Codex 修改完成后，不要只看它的文字总结。你应该重点看：",[32,368,369,372,375,378,381],{},[35,370,371],{},"新增了哪些文件。",[35,373,374],{},"有没有动到无关模块。",[35,376,377],{},"有没有引入不需要的新依赖。",[35,379,380],{},"测试是否覆盖关键逻辑。",[35,382,383],{},"页面文案是否符合你的产品定位。",[19,385,386],{},"如果 diff 太大，可以要求它按文件解释改动。",[15,388,390],{"id":389},"第五步跑验证","第五步：跑验证",[19,392,393],{},"常见验证包括：",[242,395,399],{"className":396,"code":397,"language":398,"meta":133,"style":133},"language-bash shiki shiki-themes github-light github-dark","pnpm typecheck\npnpm test\npnpm build\n","bash",[249,400,401,414,421],{"__ignoreMap":133},[402,403,406,410],"span",{"class":404,"line":405},"line",1,[402,407,409],{"class":408},"sScJk","pnpm",[402,411,413],{"class":412},"sZZnC"," typecheck\n",[402,415,416,418],{"class":404,"line":134},[402,417,409],{"class":408},[402,419,420],{"class":412}," test\n",[402,422,424,426],{"class":404,"line":423},3,[402,425,409],{"class":408},[402,427,428],{"class":412}," build\n",[19,430,431],{},"具体跑哪个命令，要看项目已有约定。对线上产品来说，代码修改通过测试不等于已经发版；提交、推送、部署应该分开确认。",[15,433,435],{"id":434},"第六步逐步扩大任务","第六步：逐步扩大任务",[19,437,438],{},"等你熟悉流程后，可以让 Codex 做更复杂的事情：",[32,440,441,444,447,450],{},[35,442,443],{},"按现有模式新增一个模块。",[35,445,446],{},"分析线上错误日志并定位代码路径。",[35,448,449],{},"给一个功能写设计文档和实现计划。",[35,451,452],{},"做 code review 并修复高风险问题。",[19,454,455],{},"最稳的用法不是一次让它“全自动完成一切”，而是让它在每个工程节点给你可检查的证据。",[457,458,459],"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":461},[462,463,464,465,466,467],{"id":289,"depth":134,"text":290},{"id":313,"depth":134,"text":314},{"id":329,"depth":134,"text":330},{"id":362,"depth":134,"text":363},{"id":389,"depth":134,"text":390},{"id":434,"depth":134,"text":435},"用一个安全的入门流程讲清 Codex 怎么读项目、拆任务、改代码、跑测试和总结结果，适合第一次上手。","tutorial",[471,472,473],"codex使用教程","codex怎么用","codex入门",{},30,[154,157],{"title":284,"description":468},[161,162,163],"zh\u002Ftutorials\u002Fcodex\u002Fcodex-tutorial","JUqp2TPuhQC9VwTL0xJyhYR4MtuZaF7LI8ZbIno4DzI"]