[{"data":1,"prerenderedAt":592},["ShallowReactive",2],{"navigation":3,"layout-toc-\u002Fcodex\u002Fcli\u002Fcli-installation":176,"page-\u002Fcodex\u002Fcli\u002Fcli-installation":429,"\u002Fcodex\u002Fcli\u002Fcli-installation-surround":587},[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":76,"author":178,"body":179,"description":411,"extension":412,"keywords":413,"links":422,"meta":423,"navigation":424,"path":77,"seo":425,"sources":422,"stem":78,"updatedAt":422,"__hash__":428},"docs\u002F1.codex\u002F3.cli\u002F01.cli-installation.md","Codex Guide 编辑",{"type":180,"value":181,"toc":404},"minimark",[182,186,194,210,215,218,251,254,273,276,294,298,301,312,315,323,329,332,335,348,351,360,366,369,378,384,389,392,397,400],[183,184,185],"p",{},"Codex CLI 是运行在本地终端里的 Codex 形态，适合习惯命令行、需要在已有项目里快速读代码、改文件、运行测试的开发者。如果你搜索的是 Codex CLI 下载或 Codex CLI Windows 安装，这一页主要说明官方命令行安装路径。",[183,187,188,189,193],{},"如果你不想手动运行命令，更适合先看：",[190,191,192],"a",{"href":25},"Codex Windows 安装包下载与一键安装","。",[183,195,196,197,203,204,209],{},"::: tip 来源核对\n安装命令以 ",[190,198,202],{"href":199,"rel":200},"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fcodex",[201],"nofollow","openai\u002Fcodex GitHub README"," 和 ",[190,205,208],{"href":206,"rel":207},"https:\u002F\u002Fdevelopers.openai.com\u002Fcodex\u002Fcli\u002F",[201],"OpenAI Codex CLI 文档"," 为准。本文记录的是 2026-05-29 核对到的常用方式。\n:::",[211,212,214],"h2",{"id":213},"macos-linux-安装","macOS \u002F Linux 安装",[183,216,217],{},"官方提供了安装脚本：",[219,220,225],"pre",{"className":221,"code":222,"language":223,"meta":224,"style":224},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -fsSL https:\u002F\u002Fchatgpt.com\u002Fcodex\u002Finstall.sh | sh\n","bash","",[226,227,228],"code",{"__ignoreMap":224},[229,230,233,237,241,244,248],"span",{"class":231,"line":232},"line",1,[229,234,236],{"class":235},"sBMFI","curl",[229,238,240],{"class":239},"sfazB"," -fsSL",[229,242,243],{"class":239}," https:\u002F\u002Fchatgpt.com\u002Fcodex\u002Finstall.sh",[229,245,247],{"class":246},"sMK4o"," |",[229,249,250],{"class":235}," sh\n",[183,252,253],{},"如果你更习惯包管理器，也可以使用 npm：",[219,255,257],{"className":221,"code":256,"language":223,"meta":224,"style":224},"npm install -g @openai\u002Fcodex\n",[226,258,259],{"__ignoreMap":224},[229,260,261,264,267,270],{"class":231,"line":232},[229,262,263],{"class":235},"npm",[229,265,266],{"class":239}," install",[229,268,269],{"class":239}," -g",[229,271,272],{"class":239}," @openai\u002Fcodex\n",[183,274,275],{},"macOS 用户也可以使用 Homebrew：",[219,277,279],{"className":221,"code":278,"language":223,"meta":224,"style":224},"brew install --cask codex\n",[226,280,281],{"__ignoreMap":224},[229,282,283,286,288,291],{"class":231,"line":232},[229,284,285],{"class":235},"brew",[229,287,266],{"class":239},[229,289,290],{"class":239}," --cask",[229,292,293],{"class":239}," codex\n",[211,295,297],{"id":296},"windows-安装","Windows 安装",[183,299,300],{},"Windows 可以在 PowerShell 中运行官方安装脚本：",[219,302,306],{"className":303,"code":304,"language":305,"meta":224,"style":224},"language-powershell shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","powershell -ExecutionPolicy ByPass -c \"irm https:\u002F\u002Fchatgpt.com\u002Fcodex\u002Finstall.ps1 | iex\"\n","powershell",[226,307,308],{"__ignoreMap":224},[229,309,310],{"class":231,"line":232},[229,311,304],{},[183,313,314],{},"如果你的机器已经安装 Node.js，也可以使用 npm：",[219,316,317],{"className":303,"code":256,"language":305,"meta":224,"style":224},[226,318,319],{"__ignoreMap":224},[229,320,321],{"class":231,"line":232},[229,322,256],{},[183,324,325,326,193],{},"如果你只是想下载图形化安装包，而不是自己运行 PowerShell 或 npm，可以改用 ",[190,327,328],{"href":25},"Code8 Manager 一键安装",[211,330,331],{"id":331},"安装后验证",[183,333,334],{},"安装完成后，打开新的终端窗口，运行：",[219,336,338],{"className":221,"code":337,"language":223,"meta":224,"style":224},"codex --version\n",[226,339,340],{"__ignoreMap":224},[229,341,342,345],{"class":231,"line":232},[229,343,344],{"class":235},"codex",[229,346,347],{"class":239}," --version\n",[183,349,350],{},"如果可以看到版本号，说明命令已经加入系统路径。接下来可以运行：",[219,352,354],{"className":221,"code":353,"language":223,"meta":224,"style":224},"codex\n",[226,355,356],{"__ignoreMap":224},[229,357,358],{"class":231,"line":232},[229,359,353],{"class":235},[183,361,362,363,193],{},"首次运行会进入登录或认证流程。下一步参考：",[190,364,365],{"href":81},"Codex CLI 首次运行",[211,367,368],{"id":368},"常见问题",[183,370,371],{},[372,373,374,375,377],"strong",{},"提示找不到 ",[226,376,344],{}," 命令怎么办？",[183,379,380,381,193],{},"先关闭并重新打开终端。如果仍然找不到，检查安装目录是否已经加入 ",[226,382,383],{},"PATH",[183,385,386],{},[372,387,388],{},"npm 安装失败怎么办？",[183,390,391],{},"检查 Node.js 和 npm 是否可用，或切换为官方安装脚本。公司网络环境下可能需要配置代理。",[183,393,394],{},[372,395,396],{},"桌面 App 和 CLI 都要装吗？",[183,398,399],{},"不一定。桌面 App 更适合图形化操作，CLI 更适合终端工作流。两者可以同时安装。",[401,402,403],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}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);}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}",{"title":224,"searchDepth":232,"depth":405,"links":406},2,[407,408,409,410],{"id":213,"depth":405,"text":214},{"id":296,"depth":405,"text":297},{"id":331,"depth":405,"text":331},{"id":368,"depth":405,"text":368},"Codex CLI 下载与安装教程，说明 Windows、macOS、Linux、npm、Homebrew 等安装方式和安装后验证。","md",[414,415,416,417,418,419,420,421],"Codex CLI 下载","Codex CLI 安装","Codex CLI Windows 安装","Codex CLI 教程","OpenAI Codex CLI","npm install @openai\u002Fcodex","brew install codex","Codex 命令行",null,{},true,{"title":426,"description":427},"Codex CLI 下载与安装教程：Windows、macOS、Linux","Codex CLI 下载和安装教程，覆盖官方安装脚本、npm、Homebrew、Windows PowerShell 安装方式，以及安装后的版本验证。","-lwKPthdxhF8oL822EBFL9lSrZBtP6wCrY_NSR9hMCE",{"id":177,"title":76,"author":178,"body":430,"description":411,"extension":412,"keywords":584,"links":422,"meta":585,"navigation":424,"path":77,"seo":586,"sources":422,"stem":78,"updatedAt":422,"__hash__":428},{"type":180,"value":431,"toc":578},[432,434,438,446,448,450,466,468,482,484,498,500,502,510,512,520,524,526,528,538,540,548,552,554,560,564,568,570,574,576],[183,433,185],{},[183,435,188,436,193],{},[190,437,192],{"href":25},[183,439,196,440,203,443,209],{},[190,441,202],{"href":199,"rel":442},[201],[190,444,208],{"href":206,"rel":445},[201],[211,447,214],{"id":213},[183,449,217],{},[219,451,452],{"className":221,"code":222,"language":223,"meta":224,"style":224},[226,453,454],{"__ignoreMap":224},[229,455,456,458,460,462,464],{"class":231,"line":232},[229,457,236],{"class":235},[229,459,240],{"class":239},[229,461,243],{"class":239},[229,463,247],{"class":246},[229,465,250],{"class":235},[183,467,253],{},[219,469,470],{"className":221,"code":256,"language":223,"meta":224,"style":224},[226,471,472],{"__ignoreMap":224},[229,473,474,476,478,480],{"class":231,"line":232},[229,475,263],{"class":235},[229,477,266],{"class":239},[229,479,269],{"class":239},[229,481,272],{"class":239},[183,483,275],{},[219,485,486],{"className":221,"code":278,"language":223,"meta":224,"style":224},[226,487,488],{"__ignoreMap":224},[229,489,490,492,494,496],{"class":231,"line":232},[229,491,285],{"class":235},[229,493,266],{"class":239},[229,495,290],{"class":239},[229,497,293],{"class":239},[211,499,297],{"id":296},[183,501,300],{},[219,503,504],{"className":303,"code":304,"language":305,"meta":224,"style":224},[226,505,506],{"__ignoreMap":224},[229,507,508],{"class":231,"line":232},[229,509,304],{},[183,511,314],{},[219,513,514],{"className":303,"code":256,"language":305,"meta":224,"style":224},[226,515,516],{"__ignoreMap":224},[229,517,518],{"class":231,"line":232},[229,519,256],{},[183,521,325,522,193],{},[190,523,328],{"href":25},[211,525,331],{"id":331},[183,527,334],{},[219,529,530],{"className":221,"code":337,"language":223,"meta":224,"style":224},[226,531,532],{"__ignoreMap":224},[229,533,534,536],{"class":231,"line":232},[229,535,344],{"class":235},[229,537,347],{"class":239},[183,539,350],{},[219,541,542],{"className":221,"code":353,"language":223,"meta":224,"style":224},[226,543,544],{"__ignoreMap":224},[229,545,546],{"class":231,"line":232},[229,547,353],{"class":235},[183,549,362,550,193],{},[190,551,365],{"href":81},[211,553,368],{"id":368},[183,555,556],{},[372,557,374,558,377],{},[226,559,344],{},[183,561,380,562,193],{},[226,563,383],{},[183,565,566],{},[372,567,388],{},[183,569,391],{},[183,571,572],{},[372,573,396],{},[183,575,399],{},[401,577,403],{},{"title":224,"searchDepth":232,"depth":405,"links":579},[580,581,582,583],{"id":213,"depth":405,"text":214},{"id":296,"depth":405,"text":297},{"id":331,"depth":405,"text":331},{"id":368,"depth":405,"text":368},[414,415,416,417,418,419,420,421],{},{"title":426,"description":427},[588,590],{"title":70,"path":71,"stem":72,"description":589,"children":-1},"Codex CLI 安装、首次运行、VS Code 与 IDE 使用，以及 AGENTS.md 项目规则配置。",{"title":80,"path":81,"stem":82,"description":591,"children":-1},"Codex CLI 首次运行教程，说明登录、API Key 配置、工作目录、第一条命令和 config.toml \u002F auth.json 验证。",1785028484557]