[{"data":1,"prerenderedAt":738},["ShallowReactive",2],{"navigation":3,"layout-toc-\u002Fcodex\u002Fconfig\u002Ftroubleshooting":176,"page-\u002Fcodex\u002Fconfig\u002Ftroubleshooting":518,"\u002Fcodex\u002Fconfig\u002Ftroubleshooting-surround":733},[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":136,"author":178,"body":179,"description":490,"extension":491,"keywords":492,"links":511,"meta":512,"navigation":513,"path":137,"seo":514,"sources":511,"stem":138,"updatedAt":511,"__hash__":517},"docs\u002F1.codex\u002F5.config\u002F03.troubleshooting.md","Codex Guide 编辑",{"type":180,"value":181,"toc":475},"minimark",[182,186,190,193,209,217,220,223,240,245,248,251,256,260,263,278,281,284,298,303,306,309,323,327,330,354,360,365,368,371,381,384,390,400,405,409,416,438,443,446,449,452,455,469],[183,184,185],"p",{},"遇到问题时，不要一上来重装。先按问题类型缩小范围：安装状态、账号、密钥、配置、网络、权限、项目本身。",[187,188,189],"h2",{"id":189},"无法启动",[183,191,192],{},"如果 Codex 无法启动，先检查：",[194,195,196,200,203,206],"ol",{},[197,198,199],"li",{},"Code8 Manager 是否显示 Codex 已安装或已是最新",[197,201,202],{},"启动按钮是否可点击",[197,204,205],{},"是否刚刚更新过 Codex，需要重新打开 Manager",[197,207,208],{},"安装路径是否仍然存在",[183,210,211,212,216],{},"如果还没有安装，先回到：",[213,214,215],"a",{"href":17},"Codex 下载一键安装教程","。",[187,218,219],{"id":219},"安装失败或进度不动",[183,221,222],{},"如果 Codex 安装失败、安装进度不动，先检查：",[194,224,225,228,231,234,237],{},[197,226,227],{},"Manager 是否还能正常联网",[197,229,230],{},"Windows 安装路径是否可写",[197,232,233],{},"杀毒软件是否拦截安装程序",[197,235,236],{},"是否重复打开了多个安装窗口",[197,238,239],{},"电脑是否需要重启后再安装",[183,241,242,243,216],{},"如果你只是缺少 Windows 安装入口，先重新下载：",[213,244,24],{"href":25},[187,246,247],{"id":247},"插件安装失败或不可用",[183,249,250],{},"先确认当前客户端支持 Plugins，然后检查插件是否安装、其中的连接器或 MCP 服务是否完成授权。安装新插件后要新建任务，旧任务可能不会刷新能力目录。",[183,252,253,254,216],{},"详细步骤参考：",[213,255,106],{"href":107},[187,257,259],{"id":258},"computer-use-或-windows-sandbox-报错","Computer Use 或 Windows sandbox 报错",[183,261,262],{},"先区分两层：Computer Use 负责可见桌面应用操作，Windows sandbox 负责文件、命令和网络边界。",[264,265,266,272],"ul",{},[197,267,268,269],{},"找不到插件、server 未启用、应用未授权：看 ",[213,270,271],{"href":119},"Computer Use Windows 教程",[197,273,274,275],{},"sandbox setup、权限拒绝、找不到模块：看 ",[213,276,277],{"href":149},"Windows 原生沙箱报错修复",[187,279,280],{"id":280},"打不开或打开后空白",[183,282,283],{},"如果 Codex 打不开、内置浏览器打不开，优先判断是应用启动问题还是网络页面问题：",[194,285,286,289,292,295],{},[197,287,288],{},"Manager 首页是否能看到 Codex 状态",[197,290,291],{},"点击启动后是否出现窗口",[197,293,294],{},"是否能在浏览器打开 ChatGPT \u002F OpenAI 相关页面",[197,296,297],{},"是否配置了系统代理但没有排除本地地址",[183,299,300,301,216],{},"如果是中文界面或语言设置问题，参考：",[213,302,66],{"href":67},[187,304,305],{"id":305},"无法登录",[183,307,308],{},"优先检查：",[194,310,311,314,317,320],{},[197,312,313],{},"当前网络是否能正常访问 ChatGPT \u002F OpenAI",[197,315,316],{},"代理节点是否稳定",[197,318,319],{},"账号是否有可用套餐或权限",[197,321,322],{},"是否可以在浏览器中正常打开 Codex 入口",[187,324,326],{"id":325},"api-key-无效","API Key 无效",[183,328,329],{},"如果使用 Code8 API Key，检查：",[194,331,332,339,345,348,351],{},[197,333,334,338],{},[335,336,337],"code",{},"auth.json"," 是否是合法 JSON",[197,340,341,344],{},[335,342,343],{},"OPENAI_API_KEY"," 是否完整",[197,346,347],{},"API Key 前后是否有多余空格",[197,349,350],{},"Code8 账号余额是否充足",[197,352,353],{},"是否已经重启 Codex",[183,355,356,357,216],{},"配置方式参考：",[213,358,359],{"href":29},"Codex API Key 获取与配置",[183,361,362,363,216],{},"更完整的获取和保存流程参考：",[213,364,28],{"href":29},[187,366,367],{"id":367},"配置不生效",[183,369,370],{},"常见原因是文件路径不对。Windows 通常是：",[372,373,379],"pre",{"className":374,"code":376,"language":377,"meta":378},[375],"language-text","%userprofile%\\.codex\\config.toml\n%userprofile%\\.codex\\auth.json\n","text","",[335,380,376],{"__ignoreMap":378},[183,382,383],{},"macOS \u002F Linux 通常是：",[372,385,388],{"className":386,"code":387,"language":377,"meta":378},[375],"~\u002F.codex\u002Fconfig.toml\n~\u002F.codex\u002Fauth.json\n",[335,389,387],{"__ignoreMap":378},[183,391,392,393,396,397,399],{},"还要注意项目级配置可能覆盖用户级配置。修改 ",[335,394,395],{},"config.toml"," 或 ",[335,398,337],{}," 后，建议重新启动终端、Codex CLI 或桌面应用。",[183,401,402,403,216],{},"配置文件细节参考：",[213,404,144],{"href":145},[187,406,408],{"id":407},"第三方-api-或中转不通","第三方 API 或中转不通",[183,410,411,412,415],{},"如果你使用的是第三方 API、中转 API、DeepSeek 或自定义 ",[335,413,414],{},"openai_base_url","，优先检查：",[194,417,418,426,429,432,435],{},[197,419,420,422,423],{},[335,421,414],{}," 是否包含正确的 ",[335,424,425],{},"\u002Fv1",[197,427,428],{},"API Key 是否属于同一个服务商",[197,430,431],{},"模型名称是否被该服务商支持",[197,433,434],{},"代理配置是否只影响外网，不影响本地地址",[197,436,437],{},"修改配置后是否已经重启 Codex",[183,439,440,441,216],{},"完整配置思路参考：",[213,442,140],{"href":141},[187,444,445],{"id":445},"命令执行失败",[183,447,448],{},"先让 Codex 解释它要运行的命令，再确认是否允许。遇到依赖安装、网络访问、删除文件、部署命令时尤其要谨慎。",[187,450,451],{"id":451},"任务结果不理想",[183,453,454],{},"可以把任务拆小：",[194,456,457,460,463,466],{},[197,458,459],{},"先让 Codex 读代码并总结",[197,461,462],{},"再让它提出修改计划",[197,464,465],{},"然后只改一个模块",[197,467,468],{},"最后运行验证命令",[183,470,471,472,216],{},"更多任务习惯参考：",[213,473,474],{"href":99},"用 Codex 完成第一个任务",{"title":378,"searchDepth":476,"depth":477,"links":478},1,2,[479,480,481,482,483,484,485,486,487,488,489],{"id":189,"depth":477,"text":189},{"id":219,"depth":477,"text":219},{"id":247,"depth":477,"text":247},{"id":258,"depth":477,"text":259},{"id":280,"depth":477,"text":280},{"id":305,"depth":477,"text":305},{"id":325,"depth":477,"text":326},{"id":367,"depth":477,"text":367},{"id":407,"depth":477,"text":408},{"id":445,"depth":477,"text":445},{"id":451,"depth":477,"text":451},"Codex 常见问题与排错指南，覆盖无法启动、登录失败、API Key 无效、配置不生效、网络错误、余额不足和构建失败。","md",[493,494,495,496,497,498,499,500,501,502,503,504,505,506,507,508,509,510],"Codex 常见问题","Codex 排错","Codex 无法启动","Codex 打不开","Codex 安装失败","Codex 安装进度不动","Codex 下载失败","Codex 插件安装失败","Codex Computer Use 不可用","Codex Windows sandbox failed","Codex 无法登录","Codex API Key 无效","Codex 配置不生效","Codex openai_base_url","Codex config.toml proxy","Codex auth.json 配置","Codex 网络错误","Codex 中文设置无效",null,{},true,{"title":515,"description":516},"Codex 常见问题与排错指南","Codex 排错指南，覆盖无法启动、无法登录、API Key 无效、config.toml 不生效、网络错误、余额不足、命令失败和构建失败。","snBIpCtfk5LdwwL1xQ6R3cPtIvnWYtuheDB-D0WFFA0",{"id":177,"title":136,"author":178,"body":519,"description":490,"extension":491,"keywords":730,"links":511,"meta":731,"navigation":513,"path":137,"seo":732,"sources":511,"stem":138,"updatedAt":511,"__hash__":517},{"type":180,"value":520,"toc":717},[521,523,525,527,537,541,543,545,557,561,563,565,569,571,573,583,585,587,597,601,603,605,615,617,619,635,639,643,645,647,652,654,659,665,669,671,675,691,695,697,699,701,703,713],[183,522,185],{},[187,524,189],{"id":189},[183,526,192],{},[194,528,529,531,533,535],{},[197,530,199],{},[197,532,202],{},[197,534,205],{},[197,536,208],{},[183,538,211,539,216],{},[213,540,215],{"href":17},[187,542,219],{"id":219},[183,544,222],{},[194,546,547,549,551,553,555],{},[197,548,227],{},[197,550,230],{},[197,552,233],{},[197,554,236],{},[197,556,239],{},[183,558,242,559,216],{},[213,560,24],{"href":25},[187,562,247],{"id":247},[183,564,250],{},[183,566,253,567,216],{},[213,568,106],{"href":107},[187,570,259],{"id":258},[183,572,262],{},[264,574,575,579],{},[197,576,268,577],{},[213,578,271],{"href":119},[197,580,274,581],{},[213,582,277],{"href":149},[187,584,280],{"id":280},[183,586,283],{},[194,588,589,591,593,595],{},[197,590,288],{},[197,592,291],{},[197,594,294],{},[197,596,297],{},[183,598,300,599,216],{},[213,600,66],{"href":67},[187,602,305],{"id":305},[183,604,308],{},[194,606,607,609,611,613],{},[197,608,313],{},[197,610,316],{},[197,612,319],{},[197,614,322],{},[187,616,326],{"id":325},[183,618,329],{},[194,620,621,625,629,631,633],{},[197,622,623,338],{},[335,624,337],{},[197,626,627,344],{},[335,628,343],{},[197,630,347],{},[197,632,350],{},[197,634,353],{},[183,636,356,637,216],{},[213,638,359],{"href":29},[183,640,362,641,216],{},[213,642,28],{"href":29},[187,644,367],{"id":367},[183,646,370],{},[372,648,650],{"className":649,"code":376,"language":377,"meta":378},[375],[335,651,376],{"__ignoreMap":378},[183,653,383],{},[372,655,657],{"className":656,"code":387,"language":377,"meta":378},[375],[335,658,387],{"__ignoreMap":378},[183,660,392,661,396,663,399],{},[335,662,395],{},[335,664,337],{},[183,666,402,667,216],{},[213,668,144],{"href":145},[187,670,408],{"id":407},[183,672,411,673,415],{},[335,674,414],{},[194,676,677,683,685,687,689],{},[197,678,679,422,681],{},[335,680,414],{},[335,682,425],{},[197,684,428],{},[197,686,431],{},[197,688,434],{},[197,690,437],{},[183,692,440,693,216],{},[213,694,140],{"href":141},[187,696,445],{"id":445},[183,698,448],{},[187,700,451],{"id":451},[183,702,454],{},[194,704,705,707,709,711],{},[197,706,459],{},[197,708,462],{},[197,710,465],{},[197,712,468],{},[183,714,471,715,216],{},[213,716,474],{"href":99},{"title":378,"searchDepth":476,"depth":477,"links":718},[719,720,721,722,723,724,725,726,727,728,729],{"id":189,"depth":477,"text":189},{"id":219,"depth":477,"text":219},{"id":247,"depth":477,"text":247},{"id":258,"depth":477,"text":259},{"id":280,"depth":477,"text":280},{"id":305,"depth":477,"text":305},{"id":325,"depth":477,"text":326},{"id":367,"depth":477,"text":367},{"id":407,"depth":477,"text":408},{"id":445,"depth":477,"text":445},{"id":451,"depth":477,"text":451},[493,494,495,496,497,498,499,500,501,502,503,504,505,506,507,508,509,510],{},{"title":515,"description":516},[734,736],{"title":132,"path":133,"stem":134,"description":735,"children":-1},"Codex 沙箱与审批模式说明，帮助理解文件权限、命令审批、网络访问和高风险操作的控制方式。",{"title":140,"path":141,"stem":142,"description":737,"children":-1},"Codex 第三方 API、中转 API、openai_base_url 和 API Key 配置教程，说明如何通过 Code8 或兼容接口让 Codex 正常调用。",1785028484562]