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

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