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