chatgpt橙皮書：從安裝到實(shí)戰(zhàn)案例的全鏈路使?指南

CHATGPT·ORANGEBOOKNON-OFFICIALGUIDE/非官方指南ChatGPT從安裝到實(shí)戰(zhàn)案例的全鏈路使用指南非官方開(kāi)源指南·持續(xù)更新版編著/BY泊舟02安裝與配置03核心功能0402安裝與配置03核心功能04標(biāo)準(zhǔn)工作流05實(shí)戰(zhàn)案例庫(kù)認(rèn)識(shí)Codexv0.2.0適合零基礎(chǔ)上手、想把Codex接入真實(shí)項(xiàng)目，2026·07以及對(duì)比Cursor/Claude2026·07ChatGPT橙皮書：從安裝到實(shí)戰(zhàn)案例的全鏈路使用指南非官方開(kāi)源指南非官方開(kāi)源指南·持續(xù)更新版寫給開(kāi)發(fā)者、獨(dú)立開(kāi)發(fā)者和AI工具重度用戶的Codex使用手冊(cè)。版本最后校驗(yàn)資料性質(zhì)v0.2.02026-07-13非官方指南，不代表OpenAI官方文檔或產(chǎn)品承諾本文以本文以2026-07-13可訪問(wèn)的ChatGPT桌面應(yīng)用、ChatGPTWork、Codex、CodexCLI、CodexIDEExtension、Sites和瀏覽器能力為參考。相關(guān)產(chǎn)品更新很快，安裝方式、模型名稱、額度、入口位置和命令參數(shù)都可能變化；涉及具體功能和價(jià)格時(shí)，請(qǐng)以O(shè)penAI官方文檔、當(dāng)前版本和你賬號(hào)實(shí)際顯示為準(zhǔn)。CCSwitch、DeepSeek等第三方工具和模型接入方案僅作為擴(kuò)展方法記錄，不屬于OpenAI官方功能。本次更新2026年7月，Codex的桌面體驗(yàn)并入新版ChatGPT桌面應(yīng)用；Codex仍作為面向軟件開(kāi)發(fā)的獨(dú)立工作入口，與Chat和Work并列存在。本版因此更新可見(jiàn)標(biāo)題，并新增以下內(nèi)容：ChatGPTWork：面向研究、分析和成品交付的工作型Agent。Sites：從提示詞或兼容項(xiàng)目創(chuàng)建、保存、部署和分享網(wǎng)站。Chrome擴(kuò)展：在用戶授權(quán)下使用現(xiàn)有ChromePro?le、登錄狀態(tài)和多標(biāo)簽頁(yè)。隨著隨著Codex桌面體驗(yàn)并入新版ChatGPT桌面應(yīng)用，本書從本版起更名為“ChatGPT橙皮書”，內(nèi)容繼續(xù)覆蓋ChatGPTWork、Codex、Sites和瀏覽器等主要工作入口。本次更新0.使用說(shuō)明0.2這份PDF適合誰(shuí)0.3閱讀路線第一篇：先搞懂Codex是什么Codex基礎(chǔ)認(rèn)知Codex的使用入口第二篇：安裝、配置與環(huán)境準(zhǔn)備安裝前準(zhǔn)備CodexApp安裝與上手（新手最為推薦，也是功能最強(qiáng)的）CodexCLI安裝與上手CodexIDEExtensionCodexWeb第三篇：核心功能詳解插件SkillMCPWork站點(diǎn)（Sites）代碼管理（Git與GitHub工作流）云端運(yùn)行記憶系統(tǒng)Chrome插件第四篇：標(biāo)準(zhǔn)工作流從需求到交付的完整鏈路Codex任務(wù)模板庫(kù)第五篇：實(shí)戰(zhàn)案例庫(kù)實(shí)戰(zhàn)案例一：制作一個(gè)寵物零食售賣的前端頁(yè)面網(wǎng)站實(shí)戰(zhàn)案例二：給寵物零食網(wǎng)站增加功能和優(yōu)化頁(yè)面實(shí)戰(zhàn)案例三：制作寵物零食的管理后臺(tái)實(shí)戰(zhàn)案例四：制作寵物零食品牌招商PPT實(shí)戰(zhàn)案例五：制作寵物零食宣傳視頻附錄A：第三方模型接入I0.使用說(shuō)明本資料為非官方指南，不代表OpenAI官方文檔。所有功能以O(shè)penAI官方文檔和Codex實(shí)際版本為準(zhǔn)。本PDF會(huì)隨著Codex更新持續(xù)維護(hù)。建議讀者優(yōu)先查看GitHub倉(cāng)庫(kù)中的最新版Markdown原稿。0.2這份PDF適合誰(shuí)完全沒(méi)用過(guò)Codex，但想系統(tǒng)上手的人。會(huì)寫代碼，但不知道怎么把Codex接入真實(shí)項(xiàng)目的人。已經(jīng)用過(guò)Cursor、ClaudeCode、ChatGPT，想比較Codex工作流的人。獨(dú)立開(kāi)發(fā)者、AI工具博主、技術(shù)團(tuán)隊(duì)負(fù)責(zé)人。想搭建AI編程工作流、知識(shí)庫(kù)和自動(dòng)化流程的人。0.3閱讀路線快速上手路線：0.使用說(shuō)明→第一篇：先搞懂Codex是什么→第二篇：安裝、配置與環(huán)境準(zhǔn)備→第四篇：標(biāo)準(zhǔn)工作流→第五篇：實(shí)戰(zhàn)案例庫(kù)開(kāi)發(fā)者核心路線：第一篇：先搞懂Codex是什么→第二篇：安裝、配置與環(huán)境準(zhǔn)備→第三篇：核心功能詳解→第四篇：標(biāo)準(zhǔn)工作流進(jìn)階擴(kuò)展路線：第三篇：核心功能詳解→第四篇：標(biāo)準(zhǔn)工作流→附錄：第三方模型接入第一篇：先搞懂Codex是什么Codex基礎(chǔ)認(rèn)知Codex到底是什么很多人第一次聽(tīng)到Codex，會(huì)下意識(shí)把它理解成“又一個(gè)AI寫代碼工具”。但如果只把Codex當(dāng)成“幫我寫代碼的ChatGPT”，你很容易低估它。Codex真正重要的地方，不是它能不能寫一個(gè)函數(shù)、補(bǔ)一段代碼、解釋一個(gè)報(bào)錯(cuò)，而是它代表了AI編程工具的一次角色變化：以前，AI是坐在你旁邊幫你補(bǔ)代碼的人。后來(lái)，AI是在編輯器里和你一起改代碼的人。現(xiàn)在，Codex更像是一個(gè)可以被交代任務(wù)的工程執(zhí)行者。它不只是回答你“這段代碼怎么寫”，而是可以進(jìn)入一個(gè)項(xiàng)目，讀取文件，理解上下文，制定計(jì)劃，修改代碼，運(yùn)行命令，檢查結(jié)果，最后把改動(dòng)整理成可以review的結(jié)果。這就是Codex和普通AI聊天工具最大的區(qū)別。五年變了四次AI編程工具的四次進(jìn)化過(guò)去幾年，AI編程工具大致經(jīng)歷了四個(gè)階段。2021年：Copilot補(bǔ)全時(shí)代。Codex這個(gè)名字第一次被大量開(kāi)發(fā)者聽(tīng)到，是因?yàn)镚itHubCopilot。那時(shí)AI主要負(fù)責(zé)代碼補(bǔ)全：你寫開(kāi)頭，它補(bǔ)后面；你寫函數(shù)名，它補(bǔ)函數(shù)體。它像一個(gè)更聰明的輸入法，能讓你寫得更快，但項(xiàng)目怎么拆、文件怎么找、測(cè)試怎么跑，仍然主要靠人完成。因、代碼優(yōu)化、接口寫法、項(xiàng)目結(jié)構(gòu)解釋。AI從輸入法變成了問(wèn)答伙伴。但它通常不在真實(shí)項(xiàng)目里，你需要復(fù)制代碼、粘貼報(bào)錯(cuò)、手動(dòng)補(bǔ)上下文，再把答案搬回項(xiàng)目。2023—2024年：Cursor項(xiàng)目協(xié)作時(shí)代。Cursor這類AI編輯器讓AI真正進(jìn)入編輯器，能看到文件、修改大多數(shù)時(shí)候仍依附在IDE里，你還需要盯著它改、判斷下一步、跑測(cè)試、整理提交。2025年：Codex工程Agent時(shí)代。Codex重新出現(xiàn)后，已經(jīng)不只是當(dāng)年負(fù)責(zé)代碼補(bǔ)全的模型，而是面向真實(shí)軟件工程任務(wù)的codingagent。它能讀項(xiàng)目、解釋代碼、修bug、加功能、補(bǔ)測(cè)試、重構(gòu)模塊、運(yùn)行命令、檢查di仟、整理PR說(shuō)明，甚至并行處理多個(gè)工程任務(wù)。一句話總結(jié)：Copilot幫你補(bǔ)代碼，ChatGPT幫你想代碼，Cursor陪你改項(xiàng)目，而Codex開(kāi)始幫你執(zhí)行工程任務(wù)。Codex能做什么WhatCodexCanDo很多人第一次用Codex，會(huì)直接問(wèn)：這些當(dāng)然可以，但還不夠準(zhǔn)確。Codex真正擅長(zhǎng)的，不是憑空生成一段代碼，而是在真實(shí)項(xiàng)目里完成一組工程任務(wù)。它可以讀項(xiàng)目、找文件、理解上下文、制定計(jì)劃、修改代碼、運(yùn)行命令、檢查結(jié)果、整理di仟，最后把任務(wù)推進(jìn)到可以review的狀態(tài)。更準(zhǔn)確地說(shuō)：Codex是一個(gè)可以進(jìn)入項(xiàng)目現(xiàn)場(chǎng)的AI工程助手。它能做的事，大致可以分成以下幾類。讀懂一個(gè)陌生項(xiàng)目使用Codex的第一步，不應(yīng)該是讓它直接寫代碼，而是讓它先讀項(xiàng)目。它可以幫你快速搞清楚：項(xiàng)目用什么技術(shù)棧。入口文件在哪里。核心模塊在哪里。測(cè)試和構(gòu)建命令是什么。哪些文件不能隨便動(dòng)。很多Codex任務(wù)失敗，不是因?yàn)樗粫?huì)寫代碼，而是因?yàn)樗€沒(méi)理解項(xiàng)目，就被要求直接動(dòng)手。解釋代碼和梳理邏輯Codex可以幫你解釋看不懂的代碼。這個(gè)函數(shù)是做什么的。這個(gè)組件為什么這樣寫。接口調(diào)用鏈路是什么。狀態(tài)從哪里來(lái)。這個(gè)bug可能和哪些文件有關(guān)。它不只是解釋單個(gè)函數(shù)，還可以結(jié)合上下文，梳理模塊關(guān)系、數(shù)據(jù)流和潛在風(fēng)險(xiǎn)。這對(duì)接手舊項(xiàng)目尤其有用。修bug和加功能Codex很適合處理邊界清楚的開(kāi)發(fā)任務(wù)。修復(fù)一個(gè)可復(fù)現(xiàn)bug。新增一個(gè)設(shè)置頁(yè)。新增一個(gè)表單校驗(yàn)。新增一個(gè)接口。新增一個(gè)導(dǎo)出按鈕。優(yōu)化一個(gè)前端頁(yè)面。但不要直接把一個(gè)大項(xiàng)目丟給它。更好的方式是把任務(wù)拆小：2.再出方案。3.只改一個(gè)模塊。4.跑測(cè)試。6.確認(rèn)沒(méi)問(wèn)題后再繼續(xù)。Codex更適合連續(xù)完成小任務(wù)，而不是一次吞下大項(xiàng)目。寫測(cè)試、做重構(gòu)Codex可以幫你補(bǔ)測(cè)試，也可以幫你重構(gòu)代碼。它可以做：補(bǔ)單元測(cè)試。補(bǔ)邊界條件。補(bǔ)異常場(chǎng)景。提取重復(fù)邏輯。拆分過(guò)長(zhǎng)函數(shù)。整理組件結(jié)構(gòu)。封裝API請(qǐng)求。但這類任務(wù)必須加邊界：不改業(yè)務(wù)邏輯。不改公共API。不引入無(wú)關(guān)依賴。不大范圍重構(gòu)。修改后必須跑測(cè)試。Codex能重構(gòu)，但你必須控制范圍。寫文檔和整理PRCodex很適合寫工程文檔。README。安裝說(shuō)明。啟動(dòng)說(shuō)明。接口文檔。環(huán)境變量說(shuō)明。項(xiàng)目結(jié)構(gòu)說(shuō)明。commitmessage。更新日志。文檔不是附屬品。在Codex工作流里，文檔本身就是上下文基礎(chǔ)設(shè)施。文檔越清楚，后續(xù)人和AI接手項(xiàng)目都會(huì)更輕松。但要提醒Codex：不要編造不存在的命令，不確定的信息要明確標(biāo)注。跑命令、看di仟、做reviewCodex和普通聊天工具最大的區(qū)別之一，是它可以在項(xiàng)目環(huán)境里運(yùn)行命令。它可以：運(yùn)行測(cè)試。運(yùn)行l(wèi)int。運(yùn)行typecheck。運(yùn)行build。查看gitstatus。搜索代碼。檢查修改結(jié)果。但命令執(zhí)行也有風(fēng)險(xiǎn)。能驗(yàn)證的，可以讓它驗(yàn)證。有風(fēng)險(xiǎn)的，必須由你批準(zhǔn)。涉及生產(chǎn)環(huán)境、數(shù)據(jù)庫(kù)、真實(shí)用戶數(shù)據(jù)的操作，不要交給它自動(dòng)執(zhí)行。什么時(shí)候適合用Codex適合Codex的任務(wù)，一般有幾個(gè)特點(diǎn)：范圍可控。上下文清楚。結(jié)果能驗(yàn)證。失敗能回滾。風(fēng)險(xiǎn)可接受。修bug。加小功能。補(bǔ)測(cè)試。寫文檔。優(yōu)化前端頁(yè)面。處理重復(fù)任務(wù)。什么時(shí)候不適合直接用Codex不建議直接讓Codex處理：生產(chǎn)數(shù)據(jù)庫(kù)。真實(shí)用戶數(shù)據(jù)。支付核心邏輯。權(quán)限和安全核心模塊。大規(guī)模架構(gòu)遷移。沒(méi)有備份的重要項(xiàng)目。沒(méi)有測(cè)試的核心業(yè)務(wù)。你自己也無(wú)法驗(yàn)收的任務(wù)。如果你判斷不了結(jié)果對(duì)不對(duì)，就不要讓Codex獨(dú)立完成。Codex可以提高效率，但不能替你做判斷。一句話總結(jié)Codex能做的事情，不只是寫代碼。它真正重要的能力是：把一個(gè)明確的軟件工程任務(wù)，從需求推進(jìn)到可review的結(jié)果。你不是讓它隨便寫點(diǎn)代碼。你是在讓它按照你的項(xiàng)目規(guī)則、上下文和驗(yàn)收標(biāo)準(zhǔn)，完成一項(xiàng)可控的工程任務(wù)。Codex與ChatGPT的區(qū)別很多人會(huì)問(wèn)：既然ChatGPT也能寫代碼，為什么還要用Codex？核心區(qū)別在于：ChatGPT更像一個(gè)顧問(wèn)，有問(wèn)題問(wèn)GPT，從它那里得到答案，然后自己去執(zhí)行。那么現(xiàn)在Codex更像是一個(gè)實(shí)習(xí)生，我們能夠真正的讓它幫我們干活，交代任務(wù)能夠完成這種。ChatGPT適合幫你想問(wèn)題。Codex適合幫你推進(jìn)任務(wù)。更合理的用法是：先用ChatGPT想清楚，再用Codex進(jìn)項(xiàng)目執(zhí)行。Codex與Cursor的區(qū)別很多人會(huì)把Codex和Cursor放在一起比較，因?yàn)樗鼈兌寄軒湍銓懘a、改代碼、理解項(xiàng)目。但它們的定位并不一樣。Cursor更像一個(gè)AI編輯器，Codex更像一個(gè)工程Agent。合理的用法是組合使用：用Cursor做日常編碼和局部修改，用Codex做任務(wù)推進(jìn)和工程交付。Cursor負(fù)責(zé)陪你寫。Codex負(fù)責(zé)幫你跑完整任務(wù)。一個(gè)偏I(xiàn)DE協(xié)作，一個(gè)偏Agent執(zhí)行。這就是它們最大的區(qū)別。Codex與ClaudeCode的區(qū)別Codex和ClaudeCode很像。都是agenticcoding工具，但兩者的側(cè)重點(diǎn)不一樣。ClaudeCode更偏終端里的長(zhǎng)期協(xié)作ClaudeCode的體驗(yàn)更像是：你打開(kāi)終端，把它放進(jìn)項(xiàng)目里，然后和它圍繞一個(gè)開(kāi)發(fā)任務(wù)持續(xù)協(xié)作。它適合：長(zhǎng)時(shí)間讀項(xiàng)目。持續(xù)追蹤一個(gè)復(fù)雜任務(wù)。在終端里邊討論邊修改。處理多步驟工程問(wèn)題。通過(guò)hooks、subagents、MCP等機(jī)制擴(kuò)展工作流。所以，ClaudeCode更像一個(gè)長(zhǎng)期待在你終端里的AI工程搭檔。它的優(yōu)勢(shì)在于命令行工作流、深度上下文協(xié)作和工程任務(wù)連續(xù)推進(jìn)。Codex更偏OpenAI生態(tài)里的多端任務(wù)執(zhí)行Codex的優(yōu)勢(shì)，不只在CLI，而在OpenAI生態(tài)里的多端聯(lián)動(dòng)。它可以通過(guò)不同入口使用：CodexCLI。CodexApp。CodexIDEExtension。CodexWeb。ChatGPT賬號(hào)體系。GitHub/PR工作流。Skills和項(xiàng)目規(guī)則。OpenAI官方文檔中，CodexCLI是本地終端里的codingagent；CodexApp則提供桌面端多線程、worktree、自動(dòng)化和Git功能；CodexSkills也可以在CLI、IDEextension和Codexapp中復(fù)用。所以，Codex更像一個(gè)接入OpenAI生態(tài)的工程任務(wù)平臺(tái)。它不只是“在終端里寫代碼”，而是可以在App、CLI、IDE、Web等多個(gè)入口之間流轉(zhuǎn)，讓你用不同方式管理、執(zhí)行和審查工程任務(wù)。怎么選如果你更喜歡終端工作流，希望AI長(zhǎng)時(shí)間待在項(xiàng)目里，和你圍繞復(fù)雜任務(wù)持續(xù)協(xié)作，ClaudeCode很適合。如果你已經(jīng)在使用ChatGPT和OpenAI生態(tài)，希望在CLI、桌面App、IDE、Web之間切換，并把任務(wù)、di仟、PR、Skills、GitHub工作流串起來(lái)，Codex會(huì)更順手。但兩者沒(méi)有絕對(duì)誰(shuí)替代誰(shuí)。最終選擇要看：上下文處理。工具鏈。價(jià)格。團(tuán)隊(duì)習(xí)慣。你自己的開(kāi)發(fā)流程。一句話總結(jié)：ClaudeCode更像終端里的長(zhǎng)期工程搭檔，Codex更像OpenAI生態(tài)里的多端工程Agent。一句話總結(jié)Codex初級(jí)用法：讓它幫你寫代碼。中級(jí)用法：讓它幫你讀項(xiàng)目、改功能、跑測(cè)試。高級(jí)用法：讓它成為你的項(xiàng)目執(zhí)行代理，配合規(guī)則、上下文、自動(dòng)化和團(tuán)隊(duì)流程工作。Codex的使用入口如果你主要做本地項(xiàng)目、網(wǎng)頁(yè)練習(xí)和日常開(kāi)發(fā)，優(yōu)先從CodexApp開(kāi)始通常就夠用；等你熟悉Git、終端和團(tuán)隊(duì)協(xié)作后，再逐步補(bǔ)CLI、IDEExtension和Web/Cloud。第二篇：安裝、配置與環(huán)境準(zhǔn)備安裝前準(zhǔn)備賬號(hào)準(zhǔn)備如果你是普通個(gè)人用戶，建議準(zhǔn)備：ChatGPT賬號(hào)能正常訪問(wèn)ChatGPT/OpenAI服務(wù)的網(wǎng)絡(luò)選擇當(dāng)前包含Codex的ChatGPT套餐；套餐名稱、額度和功能范圍會(huì)變化，請(qǐng)以官方頁(yè)面和你賬號(hào)實(shí)際顯示為準(zhǔn)。系統(tǒng)準(zhǔn)備Codex四大形態(tài)：方式適合誰(shuí)需要準(zhǔn)備CodexApp桌面版小白、想要圖形界面的人Windows或macOSCodexCLI稍微懂終端的人終端、Git、項(xiàng)目環(huán)境CodexIDEExtension插件用VSCode/Cursor/Windsurf的人編輯器+插件CodexWeb/Cloud想讓Codex遠(yuǎn)程處理GitHub項(xiàng)目的人GitHub倉(cāng)庫(kù)CodexApp支持macOS和Windows；CodexCLI支持macOS、Windows和Linux。軟件工具準(zhǔn)備安裝Codex之前，建議先準(zhǔn)備這些基礎(chǔ)工具：工具作用下載/注冊(cè)鏈接Git讓Codex能看代碼變更、生成di仟、回滾修改Git官方下載VSCode/Cursor方便查看和編輯代碼VSCode下載/Cursor下載終端Windows用PowerShell；Mac用Terminal不用下載，系統(tǒng)自帶瀏覽器登錄ChatGPT/OpenAI/GitHubChrome下載Node.js做網(wǎng)頁(yè)、前端、Next.js、Vite項(xiàng)目常用Node.js下載Python做腳本、自動(dòng)化、數(shù)據(jù)處理常用Python下載GitHub賬號(hào)如果要用CodexCloud或推送代碼，需要準(zhǔn)備GitHub注冊(cè)工具作用下載/注冊(cè)鏈接CodexAppCodex桌面版，用圖形界面管理任務(wù)和項(xiàng)目CodexApp官方頁(yè)CodexCLI在終端里使用Codex，適合真實(shí)項(xiàng)目開(kāi)發(fā)CodexCLI官方文檔Codex網(wǎng)頁(yè)版連接GitHub后，讓Codex在云端處理項(xiàng)目CodexWeb項(xiàng)目目錄準(zhǔn)備Codex不是單純聊天工具，它需要進(jìn)入一個(gè)具體項(xiàng)目目錄工作。官方入門流程也是：登錄Codex后，選擇電腦上的文件夾或Git倉(cāng)庫(kù)，再開(kāi)始第一個(gè)任務(wù)。建議你提前建一個(gè)專門練習(xí)目錄，比如：里面可以放：不要一開(kāi)始就讓Codex操作你最重要的真實(shí)項(xiàng)目。先用練習(xí)項(xiàng)目熟悉它怎么改文件、跑命令、生成結(jié)果。權(quán)限與安全準(zhǔn)備Codex可以讀取、修改文件，還能在你的項(xiàng)目目錄里運(yùn)行命令。官方對(duì)CLI的描述就是：它可以在你選擇的目錄中讀取、修改代碼，并運(yùn)行命令。所以安裝前要注意：注意點(diǎn)建議不要直接放重要文件先用測(cè)試項(xiàng)目不要把密碼/APIKey寫在代碼里用.env文件，并避免上傳操作前先Git提交方便回滾看清Codex要執(zhí)行的命令不懂的命令先問(wèn)它解釋不要給它整個(gè)C盤權(quán)限只選擇具體項(xiàng)目文件夾推薦每個(gè)項(xiàng)目先初始化Git：這樣Codex改壞了也可以回退。CodexApp安裝與上手（新手最為推薦，也是功能最強(qiáng)的）下載與安裝macOS安裝如果你使用的是Mac，先確認(rèn)自己的芯片類型。點(diǎn)擊電腦左上角的Apple圖標(biāo)，選擇「關(guān)于本機(jī)」。如果顯示的是：AppleM1/M2/M3/M4：選擇AppleSilicon版本Intel：選擇Intel版本進(jìn)入CodexApp官方頁(yè)面后，根據(jù)自己的芯片下載對(duì)應(yīng)版本。下載完成后，打開(kāi)安裝包，把Codex拖進(jìn)「應(yīng)用程序」文件夾。安裝完成后，在「應(yīng)用程序」里打開(kāi)Codex。第一次打開(kāi)時(shí)，系統(tǒng)可能會(huì)提示：「這是從互聯(lián)網(wǎng)下載的應(yīng)用，是否確認(rèn)打開(kāi)？」選擇「打開(kāi)」即可。IntelMac與AppleSilicon的區(qū)別Mac主要分兩種芯片：類型常見(jiàn)機(jī)型應(yīng)該下載AppleSiliconM1/M2/M3/M4MacAppleSilicon版本IntelMac老款I(lǐng)ntel芯片MacIntel版本最簡(jiǎn)單的判斷方法：如果寫的是AppleM系列，就是AppleSilicon。如果寫的是IntelCorei5、IntelCorei7、IntelCorei9，就是IntelMac。這個(gè)地方不要選錯(cuò)。選錯(cuò)版本可能會(huì)導(dǎo)致無(wú)法安裝、打不開(kāi)，或者運(yùn)行不穩(wěn)定。Windows安裝如果你使用的是Windows，進(jìn)入CodexApp官方頁(yè)面，選擇Windows版本。Windows版一般會(huì)跳轉(zhuǎn)到MicrosoftStore安裝。安裝步驟：1.打開(kāi)CodexApp官方頁(yè)面2.點(diǎn)擊Windows下載入口3.跳轉(zhuǎn)到MicrosoftStore4.點(diǎn)擊「獲取」或「安裝」（這里我已經(jīng)安裝過(guò)了所以顯示的是打開(kāi)）5.打開(kāi)CodexApp6.到這里CodexApp已經(jīng)安裝完成第一次打開(kāi)CodexApp選擇項(xiàng)目目錄第一次打開(kāi)CodexApp后，登錄完成，系統(tǒng)會(huì)讓你選擇一個(gè)項(xiàng)目目錄。Codex要進(jìn)入哪個(gè)文件夾工作。比如你想讓Codex幫你做一個(gè)網(wǎng)頁(yè)，就可以提前新建一個(gè)文件夾：然后在CodexApp里選擇這個(gè)文件夾。新手建議第一次選擇一個(gè)干凈的練習(xí)目錄，不要直接C盤，也不要一上來(lái)就選擇重要工作項(xiàng)目。推薦目錄結(jié)構(gòu)：選擇項(xiàng)目目錄后，Codex才知道自己應(yīng)該讀哪些文件、改哪些文件、在哪個(gè)地方運(yùn)行命令。理解項(xiàng)目列表進(jìn)入CodexApp后，左側(cè)通常會(huì)看到項(xiàng)目列表。你可以把項(xiàng)目列表理解成：你交給Codex的不同代碼文件夾。每一個(gè)項(xiàng)目，都對(duì)應(yīng)你電腦上的一個(gè)本地文件夾，或者一個(gè)Git倉(cāng)庫(kù)。如果你之前在CodexApp、CodexCLI、CodexIDEExtension里打開(kāi)過(guò)項(xiàng)目，這些項(xiàng)目也可能會(huì)出現(xiàn)在列小白要記住一點(diǎn)：項(xiàng)目列表不是聊天記錄列表，而是「代碼項(xiàng)目列表」。你點(diǎn)進(jìn)不同項(xiàng)目，Codex看到的文件范圍也不一樣。理解thread（對(duì)話）Thread可以理解成：同一個(gè)項(xiàng)目里的一個(gè)任務(wù)對(duì)話。比如你在hello-Codex這個(gè)項(xiàng)目里，可以開(kāi)多個(gè)thread：Thread2：修復(fù)按鈕點(diǎn)擊無(wú)反應(yīng)的每個(gè)thread都有自己的上下文。也就是說(shuō)，你在Thread1里讓Codex做首頁(yè)，它會(huì)圍繞這個(gè)任務(wù)持續(xù)理解和修改。你在Thread2里讓它修bug，它就圍繞另一個(gè)任務(wù)工作。小白可以簡(jiǎn)單理解：thread=公司里面的員工不要把所有事情都塞進(jìn)同一個(gè)thread。更好的做法是：一個(gè)清楚的任務(wù)，開(kāi)一個(gè)thread。這是一個(gè)thread。這是另一個(gè)thread。這樣項(xiàng)目不會(huì)亂，Codex也更容易理解任務(wù)邊界。理解任務(wù)窗口任務(wù)窗口就是你和Codex對(duì)話、安排工作的地方。你可以在這里輸入任務(wù)，比如：也可以繼續(xù)追問(wèn)：任務(wù)窗口里通常會(huì)出現(xiàn)這些內(nèi)容：作用你的任務(wù)描述告訴Codex要做什么Codex的計(jì)劃它準(zhǔn)備怎么做Codex的執(zhí)行過(guò)程它正在看文件、改文件、運(yùn)行命令Codex的總結(jié)它最后改了什么后續(xù)輸入框你可以繼續(xù)讓它修改第一次使用時(shí)，不要寫太復(fù)雜的任務(wù)。不推薦：推薦：任務(wù)越清楚，Codex越容易做好。理解reviewpaneReviewpane可以理解成：檢查Codex改了什么的地方。Codex改完文件后，你不要只看它的文字總結(jié)，而是要打開(kāi)reviewpane看實(shí)際改動(dòng)。它會(huì)告訴你：哪些文件被修改了哪些地方新增了代碼哪些地方刪除了代碼哪些改動(dòng)可以接受哪些改動(dòng)可以退回小白可以把reviewpane理解成：你不是讓Codex寫完就直接相信，而是要在這里檢查它到底交了什么作業(yè)。如果你看到某一行代碼不滿意，可以在對(duì)應(yīng)位置留下評(píng)論，讓Codex按照你的評(píng)論繼續(xù)修改。比如你可以評(píng)論：或者：理解di仟小白可以這樣理解：比如Codex原來(lái)沒(méi)有寫標(biāo)題，后來(lái)加了一行：這行就會(huì)顯示為新增。如果Codex刪除了一段舊代碼，那段就會(huì)顯示為刪除。Codex到底改了什么。不要只看最終頁(yè)面，也不要只看Codex的總結(jié)。因?yàn)镃odex有時(shí)候可能會(huì)：順手改了你沒(méi)要求改的地方刪除了某些你還需要的代碼把簡(jiǎn)單代碼改復(fù)雜修改了多個(gè)文件但沒(méi)有說(shuō)清楚所以第一次上手就要養(yǎng)成習(xí)慣：每次每次Codex完成任務(wù)后，先看diff，再?zèng)Q定要不要接受。第一次打開(kāi)后的推薦操作流程第一次打開(kāi)CodexApp，可以按這個(gè)順序操作：推薦第一個(gè)任務(wù)：這個(gè)任務(wù)足夠簡(jiǎn)單，適合用來(lái)熟悉CodexApp的基本流程。小白需要記住的幾個(gè)概念概念簡(jiǎn)單理解項(xiàng)目目錄你公司的地址項(xiàng)目列表你公司的項(xiàng)目部門thread一個(gè)項(xiàng)目部門的員工任務(wù)窗口給員工下指令的地方reviewpane檢查改動(dòng)的地方di仟新增和刪除的代碼對(duì)比CodexApp的基礎(chǔ)使用基礎(chǔ)布局可以看到CodexApp是經(jīng)典的三欄布局左側(cè)是任務(wù)列表中間是對(duì)話窗口右側(cè)是多功能區(qū)域新對(duì)話使用項(xiàng)目我們可以開(kāi)啟一個(gè)新對(duì)話來(lái)執(zhí)行一個(gè)新的任務(wù)開(kāi)啟新對(duì)話后需要選擇新對(duì)話屬于哪個(gè)項(xiàng)目當(dāng)然我們也可以直接在項(xiàng)目右側(cè)的小按鈕那里點(diǎn)擊，直接開(kāi)啟對(duì)應(yīng)項(xiàng)目的一個(gè)新對(duì)話。不使用項(xiàng)目點(diǎn)擊不使用項(xiàng)目，對(duì)應(yīng)的會(huì)話會(huì)顯示在對(duì)話里面，可以作為想問(wèn)和項(xiàng)目無(wú)關(guān)的問(wèn)題搜索后期任務(wù)對(duì)話太多了，但是只記得一些關(guān)鍵次找不到對(duì)應(yīng)的任務(wù)對(duì)話了，可以直接在搜索這里，搜關(guān)鍵詞，就會(huì)查找到對(duì)應(yīng)的任務(wù)對(duì)話了插件功能較多，后續(xù)再講功能較多，后續(xù)再講項(xiàng)目創(chuàng)建項(xiàng)目可以在Codex中直接創(chuàng)建一個(gè)新項(xiàng)目，也可以使用現(xiàn)有的項(xiàng)目創(chuàng)建或選擇好的項(xiàng)目會(huì)出現(xiàn)在項(xiàng)目欄里面，方便后續(xù)的管理threadthread是一個(gè)項(xiàng)目里的「單獨(dú)任務(wù)對(duì)話」比如你有一個(gè)項(xiàng)目叫：你可以在這個(gè)項(xiàng)目里開(kāi)多個(gè)thread：Thread代表的任務(wù)Thread1做一個(gè)首頁(yè)Thread2修復(fù)按鈕點(diǎn)擊沒(méi)反應(yīng)Thread3優(yōu)化移動(dòng)端樣式Thread4幫我寫READMEThread5檢查項(xiàng)目有沒(méi)有報(bào)錯(cuò)你可以這樣理解：Thread=這個(gè)項(xiàng)目里的一個(gè)具體為什么要有thread？因?yàn)椴煌蝿?wù)最好分開(kāi)做。如果你把“做首頁(yè)、修bug、改樣式、寫文檔”全塞進(jìn)一個(gè)對(duì)話里，Codex容易上下文混亂，你也不好檢查它到底改了什么。更好的用法是：比如你要做頁(yè)面：這是一個(gè)thread。后面你發(fā)現(xiàn)按鈕有問(wèn)題，再新開(kāi)一個(gè)thread：一句話總結(jié)：Thread就是CodexApp里的任務(wù)對(duì)話，一個(gè)thread專門處理一個(gè)具體任務(wù)。等待批準(zhǔn)在我們Codex執(zhí)行任務(wù)的時(shí)候，很多時(shí)候都會(huì)需要用戶進(jìn)行權(quán)限的批準(zhǔn)并且會(huì)在對(duì)應(yīng)的對(duì)話處提示等待批準(zhǔn)的標(biāo)簽點(diǎn)擊對(duì)應(yīng)的對(duì)話后，再點(diǎn)擊允許，Codex就會(huì)繼續(xù)進(jìn)行接下來(lái)的工作了歸檔歸檔Archive，可以理解成把一個(gè)已經(jīng)完成、暫時(shí)不用繼續(xù)處理的thread收起來(lái)。它的作用不是刪除代碼，也不是合并代碼，而是讓你的任務(wù)列表更干凈。比如你做完了這些任務(wù)：其中Thread2、Thread3已經(jīng)完成了，Thread1你也不打算用了，就可以把它們歸檔。歸檔后，它們不會(huì)繼續(xù)占據(jù)當(dāng)前任務(wù)列表的位置，你的項(xiàng)目界面會(huì)更清爽。取消歸檔，當(dāng)然你也可以在設(shè)置里面找到已歸檔對(duì)話，將其還原回來(lái)設(shè)置剩余額度在這里可以看到當(dāng)前賬號(hào)的額度、速率限制或使用情況。不同套餐、工作區(qū)、模型和版本顯示的限制可能不一樣；具體能用多久、什么時(shí)候恢復(fù)、是否能購(gòu)買額外額度，都以Codex當(dāng)前界面和官方說(shuō)明為準(zhǔn)。對(duì)話窗口權(quán)限控制沙盒（Sandbox）要知道權(quán)限控制必須先知道一個(gè)沙盒（Sandbox）的概念你可以把它理解成：Codex可以在圍欄里面干活，但不能隨便跑到圍欄外面亂動(dòng)你的電腦。因?yàn)镃odexApp不是普通聊天工具，它可以讀文件、改文件、運(yùn)行命令，所以必須有一個(gè)“圍欄”限制它能碰哪里、能不能聯(lián)網(wǎng)、能不能改項(xiàng)目外的文件。官方文檔里，Codex的sandbox模式包括read-only、workspace-write、danger-full-access這幾類，用來(lái)控制文件系統(tǒng)和網(wǎng)絡(luò)訪問(wèn)邊界。簡(jiǎn)單來(lái)說(shuō)假設(shè)你的項(xiàng)目文件夾是：D:\AI-Codex-Projects\D:\AI-Codex-Projects\如果開(kāi)啟沙盒，Codex正常只能在這個(gè)項(xiàng)目文件夾范圍內(nèi)工作，比如：但如果它想做這些事，就可能需要你批準(zhǔn)：所以：三大權(quán)限可以這樣對(duì)應(yīng)理解：你看到的選項(xiàng)和Sandbox的關(guān)系請(qǐng)求批準(zhǔn)有沙盒限制，越界操作先問(wèn)你替我審批讓系統(tǒng)幫你自動(dòng)判斷一部分審批完全訪問(wèn)權(quán)限放開(kāi)沙盒，可以在電腦上執(zhí)行任何操作，風(fēng)險(xiǎn)最高新手建議開(kāi)啟：請(qǐng)求批準(zhǔn)或自動(dòng)審批類選項(xiàng)。如果你是新手，優(yōu)先選擇不會(huì)放開(kāi)項(xiàng)目邊界的模式：讓Codex可以在當(dāng)前項(xiàng)目?jī)?nèi)工作，但遇到越界、聯(lián)網(wǎng)或高風(fēng)險(xiǎn)命令時(shí)仍然停下來(lái)讓你確認(rèn)。不同版本里權(quán)限選項(xiàng)名稱可能不同，核心原則是：不要一開(kāi)始就開(kāi)完全訪問(wèn)權(quán)限。一句話總結(jié)Sandbox沙盒就是Codex的安全圍欄。它決定Codex能不能：Model模型選擇推理強(qiáng)度可以看到推理強(qiáng)度分為了4檔，強(qiáng)度越高對(duì)應(yīng)的推理能力越強(qiáng)所花的時(shí)間和token消耗也越大選項(xiàng)簡(jiǎn)單來(lái)說(shuō)適合任務(wù)低想得少，速度快，省額度改文案、改顏色、小問(wèn)題中平衡速度和質(zhì)量普通網(wǎng)頁(yè)、簡(jiǎn)單bug、日常開(kāi)發(fā)?想得更深，更適合復(fù)雜問(wèn)題多文件修改、復(fù)雜bug、重構(gòu)最認(rèn)真、最慢、最耗很難的問(wèn)題、架構(gòu)分析、反復(fù)修不好的bug模型選擇這里可以選擇不同的模型。模型能力、可用范圍和消耗會(huì)隨賬號(hào)套餐、地區(qū)、版本和模型目錄變化。普通任務(wù)用默認(rèn)推薦模型即可；復(fù)雜任務(wù)再考慮切換更強(qiáng)模型或提高推理強(qiáng)度。速度有些模型或版本會(huì)提供標(biāo)準(zhǔn)/快速之類的服務(wù)檔位。快速模式的速度提升、額度消耗和是否可用，都以當(dāng)前界面顯示為準(zhǔn)。任務(wù)很急、額度充足時(shí)可以考慮開(kāi)啟；日常任務(wù)不需要默認(rèn)開(kāi)啟。引導(dǎo)可中途插入對(duì)話當(dāng)我們?cè)贏I執(zhí)行的過(guò)程中，發(fā)現(xiàn)AI理解錯(cuò)了我們的意思，就不應(yīng)該讓它繼續(xù)執(zhí)行了，這時(shí)候就應(yīng)該及時(shí)進(jìn)行人工引導(dǎo)如果不選擇引導(dǎo)則會(huì)排隊(duì)執(zhí)行，只有執(zhí)行完上一個(gè)任務(wù)過(guò)后，AI才會(huì)執(zhí)行你發(fā)送的下一個(gè)任務(wù)計(jì)劃模式開(kāi)啟計(jì)劃模式后，Codex就不會(huì)立即上手干活，而是會(huì)先整理出一份工作計(jì)劃，跟我們確認(rèn)了過(guò)后再開(kāi)始干活對(duì)于所有復(fù)雜任務(wù)，建議都先開(kāi)啟計(jì)劃模式，可以查漏補(bǔ)缺。多功能區(qū)注釋在多功能的右上角區(qū)域的注釋當(dāng)我們用Codex內(nèi)置的瀏覽器打開(kāi)了頁(yè)面過(guò)后，會(huì)發(fā)現(xiàn)有個(gè)注釋功能可以讓AI幫我們只修改頁(yè)面的具體部分CodexCLI安裝與上手CodexCLI是Codex的命令行版本。它適合愿意打開(kāi)終端的人使用，比如PowerShell、Terminal、iTerm、WindowsTerminal。macOS/Linux安裝macOS有兩種常見(jiàn)安裝方式。方式一：使用npm安裝先確認(rèn)電腦已經(jīng)安裝Node.js。打開(kāi)Terminal，輸入：能看到版本號(hào)，說(shuō)明Node.js和npm已經(jīng)可用。然后安裝CodexCLI：安裝完成后，檢查是否安裝成功：或者直接運(yùn)行：方式二：使用Homebrew安裝Mac用戶也可以用Homebrew：安裝后運(yùn)行：小白建議：已經(jīng)裝過(guò)Node.js，就用npm。已經(jīng)習(xí)慣Homebrew，就用brew。Windows安裝Windows用戶建議使用PowerShell或WindowsTerminal。第一步，安裝Node.js。安裝完成后，打開(kāi)PowerShell，輸入：能看到版本號(hào)，說(shuō)明安裝成功。第二步，安裝CodexCLI：第三步，檢查是否安裝成功：或者直接運(yùn)行：Windows用戶第一次使用時(shí)，建議不要在系統(tǒng)目錄里運(yùn)行Codex。不要在這些位置直接操作：建議新建一個(gè)練習(xí)目錄：D:\AI-Codex-Projects\D:\AI-Codex-Projects\第一次運(yùn)行安裝完成后，在終端輸入：第一次運(yùn)行時(shí)，Codex會(huì)提示你登錄。CodexCLI常見(jiàn)有兩種登錄方式：新手優(yōu)先推薦第一種：ChatGPT賬號(hào)登錄。方式一：使用ChatGPT賬號(hào)登錄這是最適合普通用戶和小白的方式。在終端輸入：或者：然后選擇：登錄流程大概是：方式二：使用APIKey登錄CodexCLI也支持使用OpenAIAPIKey登錄。APIKey登錄更適合開(kāi)發(fā)者、自動(dòng)化腳本、CI/CD、服務(wù)器任務(wù)等場(chǎng)景。小白可以這樣理解：如果你要用APIKey登錄，先去OpenAIPlatform創(chuàng)建APIKey。然后在終端里設(shè)置環(huán)境變量。macOS/Linux可以這樣寫：exportexportOPENAI_API_KEY="你的WindowsPowerShell可以這樣寫：登錄成功后，CodexCLI會(huì)保存登錄信息，后面再次運(yùn)行：就可以繼續(xù)使用。ChatGPT登錄和APIKey登錄有什么區(qū)別？對(duì)比ChatGPT賬號(hào)登錄APIKey登錄適合人群普通用戶、小白開(kāi)發(fā)者、自動(dòng)化、CI/CD使用額度跟ChatGPT套餐有關(guān)按OpenAIPlatformAPI計(jì)費(fèi)上手難度更簡(jiǎn)單稍復(fù)雜是否推薦小白推薦不推薦一開(kāi)始用適合本地練習(xí)適合也可以，但沒(méi)必要適合自動(dòng)化腳本一般更適合APIKey登錄注意事項(xiàng)APIKey很敏感，不能隨便泄露。不要把APIKey：如果不小心泄露了APIKey，要立刻去OpenAIPlatform刪除或重新生成。APIKey登錄雖然方便做自動(dòng)化，但它會(huì)按API使用量計(jì)費(fèi)，所以新手不要不清楚費(fèi)用規(guī)則就長(zhǎng)時(shí)間運(yùn)行任查看當(dāng)前登錄狀態(tài)你可以用下面命令查看當(dāng)前是否已經(jīng)登錄：如果需要退出登錄，可以運(yùn)行：退出后，下次再運(yùn)行CodexCLI，需要重新登錄。CLI基礎(chǔ)命令CodexCLI的命令可以分成兩類：類型使用位置作用終端命令PowerShell/Terminal里輸入啟動(dòng)、登錄、更新、診斷、管理Codex斜杠命令進(jìn)入Codex后輸入切模型、調(diào)權(quán)限、看di仟、生成規(guī)則、退出會(huì)話CLI終端命令CLI終端命令，是在PowerShell/Terminal/WindowsTerminal里輸入的命令。小白最常用終端命令命令作用簡(jiǎn)單來(lái)說(shuō)使用場(chǎng)景 codex啟動(dòng)CodexCLI打開(kāi)終端版Codex進(jìn)入項(xiàng)目后使用codexcodex--version查看版本檢查是否安裝成功安裝后第一步 codex--help查看幫助查看支持哪些命令不知道命令怎么用時(shí) codexlogin登錄Codex用ChatGPT賬號(hào)或APIKey登錄第一次使用 codexloginstatus查看登錄狀態(tài)看當(dāng)前有沒(méi)有登錄登錄異常時(shí) codexlogout退出登錄清除本機(jī)登錄狀態(tài)換賬號(hào)、公共電腦codexcodexdoctor檢查環(huán)境問(wèn)題自動(dòng)生成診斷報(bào)告啟動(dòng)失敗、登錄失敗、環(huán)境異常 codexupdate更新Codex更新CLI版本需要升級(jí)時(shí) codexapp打開(kāi)CodexApp從終端打開(kāi)桌面版想切到圖形界面時(shí)進(jìn)入項(xiàng)目相關(guān)命令命令作用示例簡(jiǎn)單來(lái)說(shuō) cd項(xiàng)目目錄進(jìn)入項(xiàng)目文件夾 cdD:\\AI-Codex-Projects\\hello-Codex先走到項(xiàng)目里面 codex在當(dāng)前目錄啟動(dòng)Codex codex讓Codex在當(dāng)前項(xiàng) 路徑指定目錄啟動(dòng)codexcodex--cdD:\\AI-Codex-Projects\\hello-Codex不用先cd，直接指定項(xiàng)目命令作用示例簡(jiǎn)單來(lái)說(shuō) codex-C項(xiàng)目路徑--cd的簡(jiǎn)寫 codex-C./hello-Codex更短寫法新手推薦最簡(jiǎn)單的方式：不要在這些地方直接運(yùn)行Codex：登錄相關(guān)命令命令作用適合場(chǎng)景 codexlogin默認(rèn)打開(kāi)瀏覽器，用ChatGPT賬號(hào)登錄小白首選 codexlogin--device-auth用設(shè)備碼登錄遠(yuǎn)程服務(wù)器、瀏覽器打不開(kāi) printenvOPENAI_API_KEY\|codexlogin--with-api-key使用APIKey登錄CI/CD codexloginstatus查看當(dāng)前登錄方式和狀態(tài)不確定是否已登錄 codexlogout刪除本機(jī)保存的登錄憑證換賬號(hào)、公共電腦WindowsPowerShell使用APIKey登錄：?jiǎn)?dòng)時(shí)直接發(fā)任務(wù)命令作用示例 codex"任務(wù)內(nèi)容"啟動(dòng)Codex，并直接發(fā)送第一條任務(wù) codex"請(qǐng)解釋這個(gè)項(xiàng)目結(jié)構(gòu)" codex-i圖片路徑"任務(wù)"附加圖片一起分析 codex-i./error.png"分析這個(gè)報(bào)錯(cuò)" codex--image圖片路徑"任務(wù)"-i的完整寫法 codex--image./ui.png"根據(jù)截圖優(yōu)化 codex--search"任務(wù)"允許使用搜索能力 codex--search"查一下這個(gè)庫(kù)的新用法"適合：新手更推薦先運(yùn)行：進(jìn)入后再輸入任務(wù)，更容易觀察執(zhí)行過(guò)程。模型、權(quán)限、沙盒相關(guān)命令命令作用簡(jiǎn)單來(lái)說(shuō)新手建議 codex--model模型名指定模型選擇AI大腦默認(rèn)即可，復(fù)雜任務(wù)再改 codex-m模型名 --model簡(jiǎn)寫更短寫法不必強(qiáng)行記 codex--sandboxread-only只讀模式只能看，盡量不改只分析項(xiàng)目時(shí)用 codex--sandboxworkspace-write當(dāng)前項(xiàng)目可讀寫能在項(xiàng)目里工作 codex--sandboxdanger-full-access完全放開(kāi)限制權(quán)限很大新手不要用 codex--ask-for-approvalon-request敏感操作先問(wèn)你請(qǐng)求批準(zhǔn)新手推薦 codex-aon-request審批模式簡(jiǎn)寫更短寫法推薦新手推薦組合：codexcodex--sandboxworkspace-write--ask-for-appro意思是：CodexCodex可以在當(dāng)前項(xiàng)目里工作，但敏不要把這個(gè)當(dāng)成省事模式：codexcodex--sandboxdan非交互式任務(wù)命令命令作用簡(jiǎn)單來(lái)說(shuō)適合場(chǎng)景 codexexec"任務(wù)"一次性執(zhí)行任務(wù)不進(jìn)入長(zhǎng)對(duì)話，跑完就結(jié)束自動(dòng)化、檢查、生成報(bào)告 codexe"任務(wù)" exec的簡(jiǎn)寫快速執(zhí)行 codexexec--cd項(xiàng)目路徑"任務(wù)"指定目錄執(zhí)行任務(wù)在某個(gè)項(xiàng)目里一次性執(zhí)?自動(dòng)化腳本codexcodexexecresume恢復(fù)exec會(huì)話接著上次非交互任務(wù)繼續(xù)自動(dòng)化任務(wù)中斷后codexcodexexecresume--last恢復(fù)最近一次exec會(huì)話接著最近任務(wù)繼續(xù)最常用恢復(fù)方式示例：小白階段優(yōu)先用：熟悉后再用codexexec。會(huì)話管理命令命令作用簡(jiǎn)單來(lái)說(shuō)使用場(chǎng)景codexcodexresume恢復(fù)之前會(huì)話接著之前的thread繼續(xù)上次沒(méi)做完codexcodexresume--last恢復(fù)最近一次會(huì)話接著最近任務(wù)繼續(xù)最常用codexcodexarchive歸檔會(huì)話把不用的任務(wù)收起來(lái)任務(wù)完成或不要了命令作用簡(jiǎn)單來(lái)說(shuō)使用場(chǎng)景codexcodexunarchive恢復(fù)歸檔會(huì)話找回被歸檔的任務(wù)歸檔后還想繼續(xù)codexcodexfork復(fù)制舊會(huì)話成新thread保留原任務(wù)，再試一個(gè)新方向多方案嘗試簡(jiǎn)單來(lái)說(shuō)：診斷、更新和維護(hù)命令命令作用什么時(shí)候用codexcodexdoctor生成診斷報(bào)告Codex啟動(dòng)異常、登錄異常、環(huán)境異常 codexupdate檢查并更新CodexCLI想升級(jí)版本時(shí) codexcompletion生成命令補(bǔ)全腳本經(jīng)常用終端的人codexcodexfeatureslist查看功能開(kāi)關(guān)排查功能是否開(kāi)啟 codexfeaturesenable功能名開(kāi)啟某個(gè)功能進(jìn)階配置 codexfeaturesdisable功能名關(guān)閉某個(gè)功能進(jìn)階配置小白最常用：其他先不用記。Cloud、MCP、插件相關(guān)命令命令作用小白是否需要codexcodexcloud在終端里瀏覽或執(zhí)行CodexCloud任務(wù)暫時(shí)不用 codexapply把CodexCloud生成的di仟應(yīng)用到本地用Cloud后再學(xué) codexmcplist查看MCP工具暫時(shí)不用 codexmcpadd添加MCPserver進(jìn)階命令作用小白是否需要 codexmcpremove刪除MCPserver進(jìn)階 codexpluginlist查看插件暫時(shí)不用 codexpluginadd安裝插件進(jìn)階 codexpluginremove刪除插件進(jìn)階小白階段先不用管這些。等你開(kāi)始用：再學(xué)習(xí)這一類命令。沙盒測(cè)試命令命令作用適合誰(shuí)codexcodexsandbox在Codex的沙盒規(guī)則下運(yùn)行命令進(jìn)階用戶 codexsandbox--cd項(xiàng)目目錄--命令指定目錄運(yùn)行沙盒命令調(diào)試權(quán)限問(wèn)題 codexexecpolicy檢查某條命令會(huì)被允許、詢問(wèn)還是阻止進(jìn)階安全配置小白階段不用學(xué)。只要記住：危險(xiǎn)命令和危險(xiǎn)參數(shù)命令/參數(shù)為什么危險(xiǎn)新手建議--sandboxdanger-full-access放開(kāi)文件和網(wǎng)絡(luò)限制不要用命令/參數(shù)為什么危險(xiǎn)新手建議--dangerously-bypass-approvals-and-sandbox跳過(guò)審批和沙盒不要用--yolo上面那個(gè)危險(xiǎn)參數(shù)的別名不要用--ask-for-approvalneverCodex操作時(shí)不再問(wèn)你新手不要用sudo可能修改系統(tǒng)級(jí)內(nèi)容不懂不要允許rm-rf可能刪除大量文件高危gitreset--hard可能丟失未保存改動(dòng)先確認(rèn)gitclean-fd可能刪除未跟蹤文件先確認(rèn)curlxxx|sh下載腳本并直接執(zhí)行高危看到這些內(nèi)容，先問(wèn)Codex：新手最推薦記住的命令排名命令為什么重要1Codex啟動(dòng)CodexCLI2 codexlogin登錄賬號(hào)3 codexloginstatus檢查登錄狀態(tài)4codexcodexdoctor排查環(huán)境問(wèn)題5 codex--version查看版本6codexcodexresume--last接著上次任務(wù)繼續(xù)7codexcodexarchive歸檔不用的任務(wù)8 codexupdate更新Codex9 codexexec"任務(wù)"一次性執(zhí)行任務(wù) codexlogout退出登錄推薦新手工作流步驟命令1cd項(xiàng)目目錄進(jìn)入項(xiàng)目文件夾步驟命令2gitstatus看當(dāng)前項(xiàng)目狀態(tài)3Codex啟動(dòng)CodexCLI4輸入任務(wù)讓Codex開(kāi)始工作5/di仟在Codex內(nèi)查看改動(dòng)6gitdi仟在Git里再檢查一次7gitadd.暫存滿意的修改8gitcommit-m"說(shuō)明"保存一個(gè)版本9 codexarchive或/quit歸檔任務(wù)或退出CLI斜杠命令它不是在外面的PowerShell/Terminal里輸入，而是在進(jìn)入Codex后，在Codex輸入框里輸入/使小白最常用命令命令作用簡(jiǎn)單來(lái)說(shuō)使用場(chǎng)景/model切換模型和推理強(qiáng)度換AI大腦和思考深度任務(wù)太難、太慢或想省額度時(shí)/permissions調(diào)整權(quán)限控制Codex能不能改文件、聯(lián)網(wǎng)、運(yùn)行命令想收緊或放寬權(quán)限時(shí)/di仟查看代碼改動(dòng)看Codex到底改了什么Codex修改文件后必看/plan進(jìn)入計(jì)劃模式先讓Codex給方案，不急著改代碼復(fù)雜任務(wù)、修bug、重構(gòu)前/init生成AGENTS.md創(chuàng)建項(xiàng)目規(guī)則文件新項(xiàng)目第一次使用Codex時(shí)/status查看當(dāng)前狀態(tài)看模型、權(quán)限、上下文、token等信息不確定當(dāng)前配置時(shí)/quit退出CodexCLI結(jié)束當(dāng)前會(huì)話任務(wù)完成后退出/exit退出CodexCLI和/quit類似任務(wù)完成后退出模型與速度相關(guān)命令作用什么時(shí)候用/model選擇模型和推理強(qiáng)度想切換GPT-5.5、mini、低/中/高推理時(shí)/fast開(kāi)啟或關(guān)閉Fast模式想讓支持的模型更快響應(yīng)時(shí)命令作用什么時(shí)候用/personality調(diào)整回答風(fēng)格想讓Codex更簡(jiǎn)潔、更解釋型或更協(xié)作時(shí)/status查看當(dāng)前模型和上下文狀態(tài)想確認(rèn)現(xiàn)在到底用的是什么模型時(shí)新手建議：權(quán)限與安全相關(guān)命令作用簡(jiǎn)單來(lái)說(shuō)建議/permissions修改權(quán)限策略控制Codex能做什么/approve批準(zhǔn)一次被自動(dòng)拒絕的操作讓被攔截的操作重試一次看懂風(fēng)險(xiǎn)后再用/sandbox-add-read-dir額外允許讀取某個(gè)目錄讓Codex能讀項(xiàng)目外指定目錄Windows特定場(chǎng)景，少?/status查看權(quán)限和可寫目錄確認(rèn)Codex當(dāng)前權(quán)限范圍改權(quán)限后檢查一下新手建議：代碼檢查與Review相關(guān)命令作用簡(jiǎn)單來(lái)說(shuō)使用場(chǎng)景/di仟查看當(dāng)前Gitdi仟看新增了什么、刪除了什么修改后必看/review讓Codexreview當(dāng)前改動(dòng)讓它檢查代碼有沒(méi)有問(wèn)題提交前檢查/copy復(fù)制最近一次Codex輸出快速?gòu)?fù)制結(jié)果復(fù)制計(jì)劃、總結(jié)、命令說(shuō)明/raw切換原始輸出模式方便復(fù)制長(zhǎng)日志或終端輸出日志很長(zhǎng)時(shí)推薦流程：會(huì)話管理相關(guān)命令作用簡(jiǎn)單來(lái)說(shuō)使用場(chǎng)景/new開(kāi)始新對(duì)話在當(dāng)前CLI里換一個(gè)新任務(wù)當(dāng)前任務(wù)結(jié)束，想開(kāi)始新任務(wù)/clear清空終端并開(kāi)始新聊天清理當(dāng)前顯示和上下文界面太亂、想重新開(kāi)始/resume恢復(fù)之前的會(huì)話接著以前的任務(wù)繼續(xù)上次任務(wù)沒(méi)做完/archive歸檔當(dāng)前會(huì)話并退出把不用的任務(wù)收起來(lái)任務(wù)完成或方案不要了/fork復(fù)制當(dāng)前會(huì)話成新thread保留原思路，另開(kāi)分支嘗試想試另一個(gè)方案/side開(kāi)一個(gè)臨時(shí)側(cè)邊對(duì)話不影響主任務(wù)地問(wèn)個(gè)小問(wèn)題想臨時(shí)確認(rèn)一個(gè)點(diǎn)/quit退出CLI結(jié)束當(dāng)前使用任務(wù)完成/exit退出CLI和/quit一樣任務(wù)完成小白區(qū)別：上下文與長(zhǎng)對(duì)話相關(guān)命令作用簡(jiǎn)單來(lái)說(shuō)使用場(chǎng)景/compact壓縮當(dāng)前對(duì)話把長(zhǎng)對(duì)話總結(jié)成重點(diǎn)對(duì)話很長(zhǎng)、上下文快滿時(shí)/status查看上下文使用情況看還有多少上下文空間任務(wù)做了很多輪后/mention附加文件或文件夾指定Codex重點(diǎn)看某個(gè)文件想讓它只看某幾個(gè)文件/ide把編輯器打開(kāi)的文件帶進(jìn)來(lái)配合VSCode/Cursor使用新手建議：項(xiàng)目規(guī)則與能力相關(guān)命令作用簡(jiǎn)單來(lái)說(shuō)使用場(chǎng)景/init生成AGENTS.md創(chuàng)建項(xiàng)目規(guī)則文件新項(xiàng)目第一次用Codex/skills瀏覽和使用Skills選擇專項(xiàng)技能做UI、寫文檔、review等專項(xiàng)任務(wù)/memories配置記憶控制Codex是否使用或生成記憶想管理長(zhǎng)期偏好時(shí)/goal設(shè)置任務(wù)目標(biāo)給Codex一個(gè)持續(xù)目標(biāo)大任務(wù)、長(zhǎng)任務(wù)/apps瀏覽可連接的應(yīng)用讓Codex使用外部App連接外部工具時(shí)/plugins管理插件查看或啟用插件能力需要插件工具時(shí)/mcp查看MCP工具看Codex能調(diào)用哪些外部工具配置MCP后檢查新手優(yōu)先掌握：其他命令可以后面再學(xué)。終端和后臺(tái)任務(wù)相關(guān)命令作用簡(jiǎn)單來(lái)說(shuō)使用場(chǎng)景/ps查看后臺(tái)終端任務(wù)看哪些命令還在跑npmdev、測(cè)試、構(gòu)建還在運(yùn)行時(shí)/stop停止后臺(tái)終端任務(wù)終止正在后臺(tái)跑的命令命令卡住或不想繼續(xù)跑/raw原始輸出模式方便復(fù)制終端日志日志很長(zhǎng)時(shí)常見(jiàn)場(chǎng)景：界面與快捷鍵相關(guān)命令作用簡(jiǎn)單來(lái)說(shuō)是否常用/theme切換代碼高亮主題改終端顯示風(fēng)格一般/statusline配置底部狀態(tài)欄顯示模型、token、Git分支等進(jìn)階/title配置終端標(biāo)題讓窗口標(biāo)題顯示項(xiàng)目信息進(jìn)階/keymap修改快捷鍵自定義操作按鍵進(jìn)階/vim開(kāi)關(guān)Vim編輯模式用Vim方式編輯輸入框會(huì)Vim的人用/debug-con?g查看配置層級(jí)排查配置為什么不生效進(jìn)階排錯(cuò)小白階段可以先不用這些。開(kāi)發(fā)者和高級(jí)功能命令作用適合誰(shuí)/experimental開(kāi)啟實(shí)驗(yàn)功能喜歡嘗鮮的用戶/hooks查看和管理生命周期hooks高級(jí)用戶、團(tuán)隊(duì)項(xiàng)目/feedback發(fā)送日志或反饋遇到問(wèn)題需要反饋時(shí)/agent切換activeagentthread使用subagent工作流的人這些不是入門必學(xué)內(nèi)容。新手知道有就行，不需要一開(kāi)始掌握。新手最推薦記住的8個(gè)排名命令為什么重要1/di?看Codex實(shí)際改了什么排名命令為什么重要2/plan復(fù)雜任務(wù)先讓它給計(jì)劃3/permissions控制權(quán)限，避免亂改4/model切換模型和推理強(qiáng)度5/status查看當(dāng)前模型、權(quán)限、上下文6/init生成項(xiàng)目規(guī)則7/compact長(zhǎng)對(duì)話壓縮重點(diǎn)8/quit退出Codex推薦新手使用流程步驟命令1/init生成項(xiàng)目規(guī)則2/permissions確認(rèn)權(quán)限不要太大3/model確認(rèn)模型和推理強(qiáng)度4/plan復(fù)雜任務(wù)先規(guī)劃5輸入任務(wù)讓Codex開(kāi)始工作6/di仟檢查代碼改動(dòng)7/review讓Codex再檢查一遍8/status查看當(dāng)前狀態(tài)和上下文9/compact對(duì)話太長(zhǎng)時(shí)壓縮/quit退出Codex一句話總結(jié)SlashCommands是CodexCLI里的快捷控制命令。新手不用全部背，先記住這幾個(gè)就夠了：CLI工作方式CodexCLI的工作方式，可以理解成一條完整流程：小白不用一開(kāi)始理解所有技術(shù)細(xì)節(jié)，只要先知道：CodexCLI不是只會(huì)聊天，它會(huì)真的進(jìn)入當(dāng)前項(xiàng)目目錄，讀文件、改文件、跑命令，然后把結(jié)果展示給你檢Codex如何讀取項(xiàng)目當(dāng)你在項(xiàng)目目錄里運(yùn)行：Codex會(huì)把當(dāng)前目錄當(dāng)成工作區(qū)。比如你在這個(gè)目錄里啟動(dòng)：D:\AI-Codex-Projects\D:\AI-Codex-Projects\Codex就會(huì)圍繞這個(gè)文件夾里的內(nèi)容工作。它可能會(huì)讀取：作用項(xiàng)目文件理解當(dāng)前代碼文件夾結(jié)構(gòu)判斷項(xiàng)目是前端、后端還是腳本項(xiàng)目package.json判斷啟動(dòng)命令、依賴、項(xiàng)目類型README.md理解項(xiàng)目說(shuō)明AGENTS.md讀取你給Codex寫的工作規(guī)則報(bào)錯(cuò)日志分析問(wèn)題原因Git狀態(tài)判斷哪些文件被改過(guò)簡(jiǎn)單來(lái)說(shuō)：所以不要在這些地方亂啟動(dòng)：推薦做法：Codex如何理解任務(wù)你輸入任務(wù)后，Codex會(huì)先判斷你想讓它做什么。比如你輸入：Codex會(huì)判斷：它會(huì)理解什么示例任務(wù)類型新建網(wǎng)頁(yè)修改范圍當(dāng)前項(xiàng)目文件可能需要文件index.html、style.css是否需要運(yùn)行命令簡(jiǎn)單HTML不一定需要是否有風(fēng)險(xiǎn)風(fēng)險(xiǎn)較低如果你輸入：Codex會(huì)判斷：它會(huì)理解什么示例任務(wù)類型排查構(gòu)建失敗可能要運(yùn)行命令npmrunbuild可能要讀文件package.json、報(bào)錯(cuò)相關(guān)文件是否需要修改代碼可能需要是否需要你批準(zhǔn)視權(quán)限設(shè)置而定小白提示：任務(wù)越清楚，Codex越穩(wěn)定。推薦寫法：1.2.3.Codex如何提出計(jì)劃復(fù)雜任務(wù)開(kāi)始前，Codex通常會(huì)先分析問(wèn)題，再提出計(jì)劃。你也可以主動(dòng)要求它先計(jì)劃：計(jì)劃通常會(huì)包含：作用它準(zhǔn)備檢查哪些文件防止亂掃項(xiàng)目它準(zhǔn)備怎么修改讓你先知道方向它可能運(yùn)行什么命令提前了解風(fēng)險(xiǎn)它預(yù)計(jì)影響哪些地方方便你判斷是否接受小白建議：尤其是這些任務(wù)，建議先計(jì)劃：Codex如何修改文件當(dāng)Codex確認(rèn)要修改文件后，它會(huì)在當(dāng)前項(xiàng)目里進(jìn)行編輯。它可能會(huì)：操作示例新建文件新建index.html修改文件修改style.css刪除代碼刪除無(wú)用代碼重命名文件調(diào)整文件名拆分文件把代碼拆成多個(gè)模塊新手要注意：Codex可能會(huì)改對(duì)，也可能會(huì)改多。所以你要養(yǎng)成習(xí)慣：你可以提前加限制：或者：這樣可以減少Codex改動(dòng)范圍過(guò)大的問(wèn)題。Codex如何運(yùn)行命令Codex不只會(huì)改文件，也可以運(yùn)行終端命令。常見(jiàn)命令包括：命令作用npminstall安裝依賴npmrundev啟動(dòng)開(kāi)發(fā)項(xiàng)目npmrunbuild檢查項(xiàng)目能否構(gòu)建npmtest運(yùn)行測(cè)試gitstatus查看Git狀態(tài)gitdi仟查看代碼改動(dòng)比如你讓它修構(gòu)建失敗，它可能會(huì)運(yùn)行：然后根據(jù)報(bào)錯(cuò)繼續(xù)修改。小白不要害怕命令，但要看懂再允許。如果你不懂，可以讓它先解釋：請(qǐng)先解釋你準(zhǔn)備運(yùn)行的命令，每條命令是干什請(qǐng)先解釋你準(zhǔn)備運(yùn)行的命令，每條命令是干什尤其看到這些命令，要謹(jǐn)慎：這些命令可能刪除文件、修改系統(tǒng)、重置代碼或執(zhí)行遠(yuǎn)程腳本。Codex如何等待用戶批準(zhǔn)CodexCLI有權(quán)限控制，不是所有操作都能直接執(zhí)行。如果Codex想做敏感操作，可能會(huì)停下來(lái)問(wèn)你。操作為什么可能需要批準(zhǔn)聯(lián)網(wǎng)安裝依賴可能下載外部代碼訪問(wèn)項(xiàng)目外文件超出當(dāng)前工作區(qū)修改外部文件可能影響其他項(xiàng)目運(yùn)行高風(fēng)險(xiǎn)命令可能刪除或覆蓋內(nèi)容使用更高權(quán)限風(fēng)險(xiǎn)更大簡(jiǎn)單來(lái)說(shuō)：如果你看不懂它要做什么，不要直接點(diǎn)允許。可以先問(wèn)：新手建議權(quán)限：Codex如何展示di仟你可以在CodexCLI里輸入：它會(huì)展示當(dāng)前改動(dòng)。簡(jiǎn)單來(lái)說(shuō)：檢查點(diǎn)你要看什么是否改了正確文件有沒(méi)有改到無(wú)關(guān)文件是否刪除重要代碼紅色刪除部分要重點(diǎn)看是否新增復(fù)雜依賴有沒(méi)有多裝不必要的包是否改動(dòng)太大小任務(wù)不要變成大重構(gòu)是否符合需求有沒(méi)有實(shí)現(xiàn)你要求的效果推薦流程：不要只看Codex的總結(jié)。真正重要的是：Codex如何處理失敗Codex執(zhí)行任務(wù)失敗很正常。常見(jiàn)失敗包括：失敗類型示例命令失敗npmrunbuild報(bào)錯(cuò)依賴缺失沒(méi)有安裝某個(gè)包代碼報(bào)錯(cuò)頁(yè)面空白、函數(shù)報(bào)錯(cuò)權(quán)限不足沒(méi)有聯(lián)網(wǎng)或文件訪問(wèn)權(quán)限理解錯(cuò)需求改的不是你想要的修改范圍過(guò)大順手改了無(wú)關(guān)文件Codex通常會(huì)根據(jù)失敗結(jié)果繼續(xù)分析。但你要注意：不要讓它無(wú)限亂試。如果它連續(xù)失敗，可以暫停它，讓它重新分析：或者：如果它改亂了，可以說(shuō)：或者自己用Git查看：再?zèng)Q定是否保留。推薦新手工作流步驟操作1cd項(xiàng)目目錄進(jìn)入正確項(xiàng)目2Codex啟動(dòng)CodexCLI3輸入任務(wù)告訴Codex要做什么4復(fù)雜任務(wù)先/plan先看方案5等Codex讀取項(xiàng)目讓它理解上下文6審批敏感操作看懂再允許7等它修改文件執(zhí)行任務(wù)步驟操作8運(yùn)行命令檢查驗(yàn)證結(jié)果9/di仟查看改動(dòng)不滿意繼續(xù)修改迭代優(yōu)化滿意后gitcommit保存版本一句話總結(jié)CodexCLI的工作方式不是“問(wèn)一句答一句”，而是一個(gè)完整的編程流程：CLI常見(jiàn)問(wèn)題CodexCLI常見(jiàn)問(wèn)題，大多數(shù)不是Codex本身壞了，而是出在這幾個(gè)地方：小白最常見(jiàn)問(wèn)題問(wèn)題常見(jiàn)原因解決方法輸入codex沒(méi)反應(yīng)Codex沒(méi)裝好，或命令沒(méi)加入環(huán)境變量先運(yùn)行codex--version檢查提示commandnotfound終端找不到Codex命令重新安裝CodexCLI，或重開(kāi)終端不知道在哪運(yùn)行Codex沒(méi)進(jìn)入項(xiàng)目目錄先cd項(xiàng)目目錄，再運(yùn)行CodexCodex讀錯(cuò)項(xiàng)目在錯(cuò)誤文件夾啟動(dòng)了退出后進(jìn)入正確項(xiàng)目目錄重新啟動(dòng)登錄失敗瀏覽器沒(méi)打開(kāi)、網(wǎng)絡(luò)異常、賬號(hào)沒(méi)登錄使用codexlogin重新登錄APIKey登錄失敗Key沒(méi)設(shè)置、Key錯(cuò)誤、環(huán)境變量沒(méi)生效重新設(shè)置環(huán)境變量后再登錄Codex一直等待可能在等你批準(zhǔn)權(quán)限看終端是否有approval提示Codex不能聯(lián)網(wǎng)沙盒或權(quán)限限制需要聯(lián)網(wǎng)時(shí)手動(dòng)批準(zhǔn)改完不知道改了什么沒(méi)看di仟在Codex里輸入/di仟改壞了怎么辦沒(méi)提前用Git保存用gitdi仟檢查，必要時(shí)revert安裝類問(wèn)題問(wèn)題原因解決方法 codex--version沒(méi)有輸出Codex沒(méi)安裝成功重新安裝CodexCLIcodexcodex:commandnotfound命令沒(méi)有加入PATH重開(kāi)終端，或重新安裝npm安裝失敗Node.js/npm沒(méi)裝好先運(yùn)行node-v和npm-vWindows安裝后找不到命令PowerShell沒(méi)刷新環(huán)境變量關(guān)閉終端，重新打開(kāi)版本太舊CodexCLI沒(méi)更新運(yùn)行codexupdate或重新安裝排查命令：小白建議：登錄類問(wèn)題問(wèn)題原因解決方法不知道有沒(méi)有登錄沒(méi)檢查登錄狀態(tài)運(yùn)行codexloginstatus瀏覽器沒(méi)有自動(dòng)打開(kāi)默認(rèn)瀏覽器異常或遠(yuǎn)程環(huán)境使用codexlogin--device-authChatGPT登錄失敗網(wǎng)絡(luò)、賬號(hào)、瀏覽器緩存問(wèn)題重新運(yùn)行codexloginAPIKey登錄失敗環(huán)境變量沒(méi)設(shè)置好檢查OPENAI_API_KEY想換賬號(hào)本機(jī)保存了舊賬號(hào)先codexlogout，再重新登錄常用命令：新手建議：項(xiàng)目目錄類問(wèn)題問(wèn)題原因解決方法Codex看不到項(xiàng)目文件沒(méi)進(jìn)入項(xiàng)目目錄先cd項(xiàng)目目錄Codex讀錯(cuò)文件在錯(cuò)誤目錄啟動(dòng)退出后重新進(jìn)入正確目錄Codex掃描了太多東西在桌面、下載目錄或C盤啟動(dòng)只在具體項(xiàng)目文件夾里啟動(dòng)不知道當(dāng)前在哪不清楚終端所在路徑Windows用cd，Mac用pwd找不到文件文件不在當(dāng)前項(xiàng)目?jī)?nèi)用/mention指定文件，或進(jìn)入正確目錄推薦方式：cdcdD:\AI-Codex-Proje不推薦：一句話：權(quán)限和沙盒類問(wèn)題問(wèn)題原因解決方法Codex提示需要批準(zhǔn)它要執(zhí)行敏感操作看懂后再允許Codex不能訪問(wèn)網(wǎng)絡(luò)沙盒默認(rèn)限制聯(lián)網(wǎng)需要時(shí)手動(dòng)批準(zhǔn)Codex不能讀取項(xiàng)目外文件超出workspace范圍不建議隨便放開(kāi)問(wèn)題原因解決方法Codex不能修改某些文件權(quán)限不足或在只讀模式檢查/permissionsCodex請(qǐng)求完全訪問(wèn)權(quán)限任務(wù)需要更大權(quán)限小白不要隨便同意推薦設(shè)置：簡(jiǎn)單來(lái)說(shuō)：workspace-writeworkspace-write=允許在當(dāng)前項(xiàng)目里工作不要隨便使用：--dangerously-bypass-approvals-and-看到不懂的權(quán)限請(qǐng)求，可以問(wèn)：請(qǐng)解釋這個(gè)操作為什么需要權(quán)限，會(huì)影響哪些文件，有沒(méi)有更安全的替代方案。請(qǐng)解釋這個(gè)操作為什么需要權(quán)限，會(huì)影響哪些文件，有沒(méi)有更安全的替代方案。命令運(yùn)行類問(wèn)題問(wèn)題原因解決方法npmrundev失敗依賴沒(méi)裝或腳本不存在先看package.jsonnpminstall失敗網(wǎng)絡(luò)、源、權(quán)限或依賴沖突讓Codex先分析錯(cuò)誤npmrunbuild失敗項(xiàng)目代碼本身有報(bào)錯(cuò)讓Codex復(fù)現(xiàn)并最小修復(fù)命令卡住不動(dòng)開(kāi)發(fā)服務(wù)器一直運(yùn)行用/ps查看后臺(tái)任務(wù)想停止命令命令一直占用終端用/stop停止后臺(tái)任務(wù)常見(jiàn)命令含義：命令含義npminstall安裝項(xiàng)目依賴命令含義npmrundev啟動(dòng)開(kāi)發(fā)環(huán)境npmrunbuild檢查項(xiàng)目能否正式構(gòu)建npmtest運(yùn)行測(cè)試gitstatus查看項(xiàng)目改動(dòng)狀態(tài)gitdi仟查看具體改動(dòng)不懂命令時(shí)，先讓Codex解釋：請(qǐng)先解釋你準(zhǔn)備運(yùn)行的命令，每條命令是干什請(qǐng)先解釋你準(zhǔn)備運(yùn)行的命令，每條命令是干什問(wèn)題原因解決方法不知道Codex改了什么沒(méi)看di仟輸入/di仟Codex修改范圍過(guò)大要求它最小改動(dòng)改了無(wú)關(guān)文件任務(wù)限制不清楚讓它撤回?zé)o關(guān)修改刪除了重要代碼沒(méi)檢查紅色刪除部分用Git恢復(fù)或讓它revert/di仟沒(méi)東西沒(méi)有文件改動(dòng)，或改動(dòng)已保存處理用gitstatus再檢查推薦檢查流程：提示詞可以這樣寫：Git相關(guān)問(wèn)題問(wèn)題原因解決方法改壞了不知道怎么恢復(fù)沒(méi)用Git保存版本以后先gitinit和commitgitstatus顯示很多文件Codex或你自己改了很多內(nèi)容不知道哪些改動(dòng)要保留沒(méi)看di仟先不要commitcommit后想回退Git基礎(chǔ)不熟先讓Codex解釋回退方案Codex改了不該改的文件任務(wù)范圍太大要求它revert無(wú)關(guān)文件推薦新手第一次項(xiàng)目先做：之后Codex每次改完：簡(jiǎn)單來(lái)說(shuō)：模型和額度類問(wèn)題問(wèn)題原因解決方法某個(gè)模型看不到套餐、地區(qū)或權(quán)限不同使用當(dāng)前可選模型任務(wù)變慢模型強(qiáng)、推理高、項(xiàng)目大降低推理或縮小任務(wù)范圍額度消耗太快高推理、多輪修改、讀大項(xiàng)目小任務(wù)用低/中推理提示達(dá)到限制當(dāng)前計(jì)劃額度用完等額度恢復(fù)或購(gòu)買額外額度APIKey消耗費(fèi)用API登錄按API使用計(jì)費(fèi)小白優(yōu)先用ChatGPT登錄省額度建議：推薦配置：Codex卡住或結(jié)果不對(duì)問(wèn)題原因解決方法Codex一直不動(dòng)等待權(quán)限、命令卡住、任務(wù)太大檢查是否有approval或/psCodex反復(fù)修不好沒(méi)找到根因讓它先總結(jié)失敗原因Codex越改越亂沒(méi)限制修改范圍暫停，要求最小改動(dòng)Codex理解錯(cuò)需求任務(wù)描述太模糊重新寫清楚目標(biāo)、要求、限制輸出太長(zhǎng)太亂對(duì)話上下文太長(zhǎng)使用/compact可以這樣叫停：如果它改偏了，可以說(shuō)：Windows常見(jiàn)問(wèn)題問(wèn)題原因解決方法PowerShell不識(shí)別Codex環(huán)境變量未刷新關(guān)閉終端重新打開(kāi)路徑帶空格報(bào)錯(cuò)路徑?jīng)]有加引號(hào)用英文路徑或加引號(hào)APIKey命令不適用Windows和Mac命令不同用PowerShell寫法問(wèn)題原因解決方法權(quán)限彈窗頻繁Windows安全限制或沙盒審批保持請(qǐng)求批準(zhǔn)即可中文路徑異常某些工具對(duì)中文路徑兼容不好項(xiàng)目路徑盡量用英文推薦Windows項(xiàng)目路徑：D:\AI-Codex-Projects\D:\AI-Codex-Projects\不推薦：原因：macOS常見(jiàn)問(wèn)題問(wèn)題原因解決方法提示權(quán)限不足文件夾權(quán)限限制換到用戶目錄下的項(xiàng)目文件夾命令找不到PATH沒(méi)生效重開(kāi)Terminalnpm權(quán)限問(wèn)題全局安裝權(quán)限問(wèn)題優(yōu)先用官方推薦安裝方式瀏覽器登錄沒(méi)跳回終端瀏覽器攔截或網(wǎng)絡(luò)問(wèn)題用deviceauth終端不熟悉路徑不知道當(dāng)前目錄推薦項(xiàng)目路徑：~/AI-Codex-Projects/hello-codex~/AI-Codex-Projects/hello-codex常用檢查命令：運(yùn)行codexdoctor排查如果你不知道問(wèn)題出在哪里，可以先運(yùn)行：它適合排查：簡(jiǎn)單來(lái)說(shuō)：遇到復(fù)雜問(wèn)題時(shí)，可以把doctor結(jié)果發(fā)給Codex，讓它幫你分析：新手通用排查流程步驟命令/操作1 codex--version檢查是否安裝成功2 codexloginstatus檢查是否登錄3pwd/cd確認(rèn)當(dāng)前項(xiàng)目目錄4gitstatus查看項(xiàng)目狀態(tài)5codexcodexdoctor檢查環(huán)境問(wèn)題6/permissions檢查權(quán)限設(shè)置7/di仟查看文件改動(dòng)8/ps查看后臺(tái)任務(wù)9/stop停止卡住的命令/compact對(duì)話太長(zhǎng)時(shí)壓縮上下文CodexIDEExtension把Codex直接裝進(jìn)你的代碼編輯器里。你不用單獨(dú)打開(kāi)CodexApp，也不用一直切到終端，而是可以在VSCode、Cursor、Windsurf這類編輯器側(cè)邊欄里直接使用Codex。怎么理解CodexIDEExtension概念簡(jiǎn)單來(lái)說(shuō)寫代碼的軟件，比如VSCode、Cursor、WindsurfCodexIDEExtension裝在編輯器里的Codex側(cè)邊欄Codex出現(xiàn)的位置，像一個(gè)聊天面板當(dāng)前文件你正在編輯器里打開(kāi)的文件選中代碼你鼠標(biāo)選中的那一段代碼上下文Codex能參考的文件、代碼、報(bào)錯(cuò)和任務(wù)說(shuō)明簡(jiǎn)單說(shuō)：CodexIDEExtension適合誰(shuí)人群是否適合適合用Cursor的人適合用Windsurf的人適合想邊看代碼邊修改的人適合想讓Codex只看當(dāng)前文件的人適合完全不想碰編輯器的人不太適合更喜歡圖形化任務(wù)管理的人更適合CodexApp更喜歡終端的人更適合CodexCLICodexIDEExtension支持哪些編輯器編輯器說(shuō)明VSCode最常見(jiàn)的新手代碼編輯器編輯器說(shuō)明VSCodeInsidersVSCode的測(cè)試版CursorAI編輯器，基于VSCodeWindsurfAI編輯器，也兼容VSCode插件體系JetBrainsIDE比如IntelliJ、PyCharm、WebStorm、Rider新手優(yōu)先推薦：CodexIDEExtension怎么安裝步驟操作1打開(kāi)VSCode/Cursor/Windsurf2進(jìn)入擴(kuò)展市場(chǎng)Extensions3搜索Codex4安裝OpenAI的Codex擴(kuò)展5安裝完成后重啟編輯器6在側(cè)邊欄找到Codex圖標(biāo)7點(diǎn)擊Codex，登錄賬號(hào)8打開(kāi)項(xiàng)目文件夾，開(kāi)始使用如果你在Cursor里找不到Codex圖標(biāo)，可能是側(cè)邊欄圖標(biāo)被折疊了。可以先檢查左側(cè)或右側(cè)活動(dòng)欄，把Codex固定出來(lái)。第一次登錄安裝完成后，CodexIDEExtension會(huì)提示你登錄。常見(jiàn)登錄方式有兩種：登錄方式適合誰(shuí)小白建議ChatGPT賬號(hào)登錄普通用戶、小白推薦APIKey登錄開(kāi)發(fā)者、自動(dòng)化、特殊場(chǎng)景不建議一開(kāi)始用小白優(yōu)先選擇：也就是用你的ChatGPT賬號(hào)登錄