[{"data":1,"prerenderedAt":447},["ShallowReactive",2],{"navigation":3,"layout-toc-\u002Fcodex\u002Fworkflows\u002Fapp-first-task":176,"page-\u002Fcodex\u002Fworkflows\u002Fapp-first-task":345,"\u002Fcodex\u002Fworkflows\u002Fapp-first-task-surround":442},[4,168,172],{"title":5,"path":6,"stem":7,"children":8,"page":167},"Codex","\u002Fcodex","1.codex",[9,43,69,91,121],{"title":10,"path":11,"stem":12,"children":13,"page":-1},"Codex 安装与账号配置","\u002Fcodex\u002Finstall","1.codex\u002F1.install\u002Findex",[14,15,19,23,27,31,35,39],{"title":10,"path":11,"stem":12},{"title":16,"path":17,"stem":18},"Codex 一键安装图文教程","\u002Fcodex\u002Finstall\u002Fapp-installation","1.codex\u002F1.install\u002F01.app-installation",{"title":20,"path":21,"stem":22},"Codex API Key 配置教程","\u002Fcodex\u002Finstall\u002Fsubscribe-plus","1.codex\u002F1.install\u002F02.subscribe-plus",{"title":24,"path":25,"stem":26},"Codex Windows 安装包下载","\u002Fcodex\u002Finstall\u002Fwindows-download","1.codex\u002F1.install\u002F03.windows-download",{"title":28,"path":29,"stem":30},"Codex API Key 获取与配置教程","\u002Fcodex\u002Finstall\u002Fapi-key-configuration","1.codex\u002F1.install\u002F04.api-key-configuration",{"title":32,"path":33,"stem":34},"Codex 官网入口与下载入口","\u002Fcodex\u002Finstall\u002Fofficial-website","1.codex\u002F1.install\u002F05.official-website",{"title":36,"path":37,"stem":38},"Codex 注册账号与登录教程","\u002Fcodex\u002Finstall\u002Fregister","1.codex\u002F1.install\u002F06.register",{"title":40,"path":41,"stem":42},"Codex Windows 系统要求与 Win10 兼容性","\u002Fcodex\u002Finstall\u002Fwindows-requirements","1.codex\u002F1.install\u002F07.windows-requirements",{"title":44,"path":45,"stem":46,"children":47,"page":-1},"认识 Codex 与使用入口","\u002Fcodex\u002Fbasics","1.codex\u002F2.basics\u002Findex",[48,49,53,57,61,65],{"title":44,"path":45,"stem":46},{"title":50,"path":51,"stem":52},"Codex 是什么软件，怎么用","\u002Fcodex\u002Fbasics\u002Fwhat-is-codex","1.codex\u002F2.basics\u002F01.what-is-codex",{"title":54,"path":55,"stem":56},"03 了解 Codex 基本组成","\u002Fcodex\u002Fbasics\u002Fapp-overview","1.codex\u002F2.basics\u002F02.app-overview",{"title":58,"path":59,"stem":60},"16 Codex Cloud、IDE 与桌面 App","\u002Fcodex\u002Fbasics\u002Fcloud-ide-app","1.codex\u002F2.basics\u002F03.cloud-ide-app",{"title":62,"path":63,"stem":64},"04 用手机端 Codex 跟进桌面任务","\u002Fcodex\u002Fbasics\u002Fmobile-control-desktop","1.codex\u002F2.basics\u002F04.mobile-control-desktop",{"title":66,"path":67,"stem":68},"Codex 中文设置教程","\u002Fcodex\u002Fbasics\u002Fchinese-settings","1.codex\u002F2.basics\u002F05.chinese-settings",{"title":70,"path":71,"stem":72,"children":73,"page":-1},"Codex CLI 与开发环境","\u002Fcodex\u002Fcli","1.codex\u002F3.cli\u002Findex",[74,75,79,83,87],{"title":70,"path":71,"stem":72},{"title":76,"path":77,"stem":78},"11 Codex CLI 安装","\u002Fcodex\u002Fcli\u002Fcli-installation","1.codex\u002F3.cli\u002F01.cli-installation",{"title":80,"path":81,"stem":82},"12 Codex CLI 首次运行","\u002Fcodex\u002Fcli\u002Fcli-first-run","1.codex\u002F3.cli\u002F02.cli-first-run",{"title":84,"path":85,"stem":86},"13 在 VS Code \u002F IDE 中使用 Codex","\u002Fcodex\u002Fcli\u002Fide-vscode","1.codex\u002F3.cli\u002F03.ide-vscode",{"title":88,"path":89,"stem":90},"14 AGENTS.md 项目规则","\u002Fcodex\u002Fcli\u002Fagents-md","1.codex\u002F3.cli\u002F04.agents-md",{"title":92,"path":93,"stem":94,"children":95,"page":-1},"Codex 工作流与扩展","\u002Fcodex\u002Fworkflows","1.codex\u002F4.workflows\u002Findex",[96,97,101,105,109,113,117],{"title":92,"path":93,"stem":94},{"title":98,"path":99,"stem":100},"05 用 Codex 完成第一个任务","\u002Fcodex\u002Fworkflows\u002Fapp-first-task","1.codex\u002F4.workflows\u002F01.app-first-task",{"title":102,"path":103,"stem":104},"06 任务的顺序执行和并行","\u002Fcodex\u002Fworkflows\u002Ftask-execution","1.codex\u002F4.workflows\u002F02.task-execution",{"title":106,"path":107,"stem":108},"Codex Skills 与 Plugins 安装教程","\u002Fcodex\u002Fworkflows\u002Fskills-plugins","1.codex\u002F4.workflows\u002F03.skills-plugins",{"title":110,"path":111,"stem":112},"09 自动化","\u002Fcodex\u002Fworkflows\u002Fautomation","1.codex\u002F4.workflows\u002F04.automation",{"title":114,"path":115,"stem":116},"10 桌面宠物","\u002Fcodex\u002Fworkflows\u002Fdesktop-pet","1.codex\u002F4.workflows\u002F05.desktop-pet",{"title":118,"path":119,"stem":120},"Codex Computer Use Windows 安装与使用","\u002Fcodex\u002Fworkflows\u002Fcomputer-use-windows","1.codex\u002F4.workflows\u002F06.computer-use-windows",{"title":122,"path":123,"stem":124,"children":125,"page":-1},"Codex 配置、安全与排错","\u002Fcodex\u002Fconfig","1.codex\u002F5.config\u002Findex",[126,127,131,135,139,143,147,151,155,159,163],{"title":122,"path":123,"stem":124},{"title":128,"path":129,"stem":130},"07 权限管理","\u002Fcodex\u002Fconfig\u002Fpermissions","1.codex\u002F5.config\u002F01.permissions",{"title":132,"path":133,"stem":134},"15 沙箱与审批模式","\u002Fcodex\u002Fconfig\u002Fsandbox-approvals","1.codex\u002F5.config\u002F02.sandbox-approvals",{"title":136,"path":137,"stem":138},"17 常见问题与排错","\u002Fcodex\u002Fconfig\u002Ftroubleshooting","1.codex\u002F5.config\u002F03.troubleshooting",{"title":140,"path":141,"stem":142},"Codex 第三方 API 与中转配置教程","\u002Fcodex\u002Fconfig\u002Fthird-party-api","1.codex\u002F5.config\u002F04.third-party-api",{"title":144,"path":145,"stem":146},"Codex config.toml 与 auth.json 配置说明","\u002Fcodex\u002Fconfig\u002Fconfig-toml-auth-json","1.codex\u002F5.config\u002F05.config-toml-auth-json",{"title":148,"path":149,"stem":150},"Codex Windows 原生沙箱设置与报错修复","\u002Fcodex\u002Fconfig\u002Fwindows-sandbox","1.codex\u002F5.config\u002F06.windows-sandbox",{"title":152,"path":153,"stem":154},"Codex 更新与升级失败排错","\u002Fcodex\u002Fconfig\u002Fupdate","1.codex\u002F5.config\u002F07.update",{"title":156,"path":157,"stem":158},"Codex 卸载干净与重新安装","\u002Fcodex\u002Fconfig\u002Funinstall","1.codex\u002F5.config\u002F08.uninstall",{"title":160,"path":161,"stem":162},"Codex Windows 中文乱码解决方法","\u002Fcodex\u002Fconfig\u002Fchinese-garbled-text","1.codex\u002F5.config\u002F09.chinese-garbled-text",{"title":164,"path":165,"stem":166},"Codex WSL2 安装、配置与常见问题","\u002Fcodex\u002Fconfig\u002Fwsl2","1.codex\u002F5.config\u002F10.wsl2",false,{"title":169,"path":170,"stem":171},"关于 Codex Guide","\u002Fabout","1.codex\u002F6.site\u002F01.about",{"title":173,"path":174,"stem":175},"隐私与数据说明","\u002Fprivacy","1.codex\u002F6.site\u002F02.privacy",{"id":177,"title":98,"author":178,"body":179,"description":329,"extension":330,"keywords":331,"links":338,"meta":339,"navigation":340,"path":99,"seo":341,"sources":338,"stem":100,"updatedAt":338,"__hash__":344},"docs\u002F1.codex\u002F4.workflows\u002F01.app-first-task.md","Codex Guide 编辑",{"type":180,"value":181,"toc":319},"minimark",[182,186,189,194,197,200,207,211,214,231,238,242,245,251,254,260,264,267,273,276,282,285,291,295,298,301,307,310,316],[183,184,185],"p",{},"::: tip 最后核对\n官方资料最后核对日期：2026-05-27。本章以开发一个简单网页为例，演示从创建工作目录到任务迭代的完整操作流程。\n:::",[183,187,188],{},"本章以\"用 Codex 桌面 App 开发一个关于 AI 发展历史的简单网页\"为例，走完一次完整的任务闭环，帮助你快速上手 Codex 桌面 App 的基本用法。",[190,191,193],"h2",{"id":192},"第一步创建本地工作文件夹","第一步：创建本地工作文件夹",[183,195,196],{},"在本地新建一个空文件夹，作为 Codex 的工作目录。Codex 生成的所有文件都会保存在这里。",[183,198,199],{},"::: warning\n文件夹路径中尽量不要包含中文，避免部分工具出现兼容性问题。\n:::",[183,201,202],{},[203,204],"img",{"alt":205,"src":206},"新建本地文件夹","\u002Fimages\u002Fimage-20260511175758960.png",[190,208,210],{"id":209},"第二步选择对话还是项目","第二步：选择对话还是项目",[183,212,213],{},"打开 Codex 桌面 App 后，你需要选择用\"对话\"还是\"项目\"来开始任务。",[215,216,217,225],"ul",{},[218,219,220,224],"li",{},[221,222,223],"strong",{},"对话","：适合一次性任务，操作简单，但多个对话之间不共享工作目录。",[218,226,227,230],{},[221,228,229],{},"项目","：支持在同一工作目录下创建多个对话，每个对话处理不同的子任务，管理更方便。",[183,232,233,234,237],{},"如果你不确定选哪个，",[221,235,236],{},"优先选择项目","——后续扩展任务时更灵活，工作目录也只需要配置一次。",[190,239,241],{"id":240},"第三步添加工作目录","第三步：添加工作目录",[183,243,244],{},"选择项目后，点击\"使用现有文件夹\"，选中刚才创建的文件夹。",[183,246,247],{},[203,248],{"alt":249,"src":250},"选择工作目录","\u002Fimages\u002Fimage-20260511180342249.png",[183,252,253],{},"选择完成后，对话框左下角会显示当前工作目录的路径，确认路径正确即可。",[183,255,256],{},[203,257],{"alt":258,"src":259},"确认工作目录","\u002Fimages\u002Fimage-20260511180544468.png",[190,261,263],{"id":262},"第四步输入任务描述开始执行","第四步：输入任务描述，开始执行",[183,265,266],{},"在对话框中输入你的需求，点击发送，Codex 就会开始执行任务。",[183,268,269],{},[203,270],{"alt":271,"src":272},"输入任务并发送","\u002Fimages\u002Fimage-20260511180648409.png",[183,274,275],{},"任务完成后，Codex 会在对话中展示结果，同时将生成的文件写入工作目录。",[183,277,278],{},[203,279],{"alt":280,"src":281},"任务完成","\u002Fimages\u002Fimage-20260511184050002.png",[183,283,284],{},"如果生成的是网页文件，可以直接点击 Codex 弹出的\"打开\"按钮，在 App 内置浏览器中预览效果，无需手动打开文件夹。",[183,286,287],{},[203,288],{"alt":289,"src":290},"内置浏览器预览","\u002Fimages\u002Fimage-20260511184146656.png",[190,292,294],{"id":293},"第五步逐步迭代","第五步：逐步迭代",[183,296,297],{},"对结果不满意时，直接在当前对话框中继续描述修改需求，Codex 会在已有基础上进行调整。",[183,299,300],{},"随着对话轮次增加，上下文窗口会逐渐被填满。点击对话框右下角的小圆圈图标，可以查看当前上下文使用情况。",[183,302,303],{},[203,304],{"alt":305,"src":306},"上下文使用情况","\u002Fimages\u002Fimage-20260511184315443.png",[183,308,309],{},"::: info 什么是上下文窗口？\n每次对话都有容量上限，每一轮问答都会占用一定空间。当上下文接近满载时，建议在项目中新建一个对话继续处理后续任务——新对话仍然共享同一工作目录，不需要重新配置。\n:::",[183,311,312],{},[203,313],{"alt":314,"src":315},"项目中新建对话","\u002Fimages\u002Fimage-20260511184528218.png",[183,317,318],{},"如果使用的是\"对话\"模式而非项目，新建对话时需要重新指定工作目录，两个对话之间也是相互隔离的，不方便统一管理。这也是推荐使用项目的主要原因之一。",{"title":320,"searchDepth":321,"depth":322,"links":323},"",1,2,[324,325,326,327,328],{"id":192,"depth":322,"text":193},{"id":209,"depth":322,"text":210},{"id":240,"depth":322,"text":241},{"id":262,"depth":322,"text":263},{"id":293,"depth":322,"text":294},"用 Codex 完成第一个任务的入门教程，带你选择工作目录、输入任务、查看结果并完成基础验证，形成操作习惯。","md",[332,333,334,335,336,337],"Codex 第一个任务","Codex 入门教程","Codex 工作目录","Codex 项目","Codex 对话","Codex 实战",null,{},true,{"title":342,"description":343},"Codex 第一个任务实战教程","Codex 新手实战教程，从创建工作目录、选择项目或对话、输入任务、预览结果到继续迭代。","K46Lw8DbYwqrXHaDO2iErQ4GVnW8TTCf8rFrrSCdTp4",{"id":177,"title":98,"author":178,"body":346,"description":329,"extension":330,"keywords":439,"links":338,"meta":440,"navigation":340,"path":99,"seo":441,"sources":338,"stem":100,"updatedAt":338,"__hash__":344},{"type":180,"value":347,"toc":432},[348,350,352,354,356,358,362,364,366,376,380,382,384,388,390,394,396,398,402,404,408,410,414,416,418,420,424,426,430],[183,349,185],{},[183,351,188],{},[190,353,193],{"id":192},[183,355,196],{},[183,357,199],{},[183,359,360],{},[203,361],{"alt":205,"src":206},[190,363,210],{"id":209},[183,365,213],{},[215,367,368,372],{},[218,369,370,224],{},[221,371,223],{},[218,373,374,230],{},[221,375,229],{},[183,377,233,378,237],{},[221,379,236],{},[190,381,241],{"id":240},[183,383,244],{},[183,385,386],{},[203,387],{"alt":249,"src":250},[183,389,253],{},[183,391,392],{},[203,393],{"alt":258,"src":259},[190,395,263],{"id":262},[183,397,266],{},[183,399,400],{},[203,401],{"alt":271,"src":272},[183,403,275],{},[183,405,406],{},[203,407],{"alt":280,"src":281},[183,409,284],{},[183,411,412],{},[203,413],{"alt":289,"src":290},[190,415,294],{"id":293},[183,417,297],{},[183,419,300],{},[183,421,422],{},[203,423],{"alt":305,"src":306},[183,425,309],{},[183,427,428],{},[203,429],{"alt":314,"src":315},[183,431,318],{},{"title":320,"searchDepth":321,"depth":322,"links":433},[434,435,436,437,438],{"id":192,"depth":322,"text":193},{"id":209,"depth":322,"text":210},{"id":240,"depth":322,"text":241},{"id":262,"depth":322,"text":263},{"id":293,"depth":322,"text":294},[332,333,334,335,336,337],{},{"title":342,"description":343},[443,445],{"title":92,"path":93,"stem":94,"description":444,"children":-1},"Codex 第一个任务、顺序执行与并行、Skills、Plugins、Computer Use、自动化和桌面工作流。",{"title":102,"path":103,"stem":104,"description":446,"children":-1},"Codex 任务顺序执行与并行说明，帮助理解读文件、运行命令、修改文件、验证结果和汇报进度的机制，便于复核。",1785028484569]