Codex 深度解析|模型版次、斜線指令、必做設定與實戰提示詞
從 GPT-6.2 Sol、Astra、Terra、Luna 到推理等級與 CLI 版本,整理 Codex 常用指令、專案設定,以及生成圖片和製作網頁的提示詞。
用 Codex 修改既有專案,一般先選 GPT-6.2 Sol,給它工作目錄、任務邊界和驗收方式。跨模組重構再考慮 Astra。畫面、截圖或桌面操作是主要難點時,可試 Terra。CLI 裡輸入 /model 看可選模型,/status 確認目前生效的設定。這篇以 CLI 為主,桌面版和 IDE 擴充的入口會另行標明。OpenAI 模型選擇
同一個畫面上的版本號各代表什麼?
| 看到的標示 | 代表什麼 | 在哪裡確認 |
|---|---|---|
| Codex CLI 0.166.0 | 終端機客戶端版本,關係到指令、介面與工具整合 | codex --version |
| GPT-6、GPT-6.1、GPT-6.2 | 模型世代或版次。每代可能有不同型號 | /model |
| Sol、Astra、Terra、Luna | 模型型號,對應不同的速度、複雜度或視覺任務取向 | /model 與官方模型指南 |
| Low、Medium、High、Extra high | 推理投入程度,同一模型可有多個檔位 | /model 或 /status |
| Fast | 有支援時可切換的服務層級 | /fast、模型選單、帳號用量 |
| CLI、IDE、桌面或 Cloud | 執行環境。檔案存取、工具與工作階段會依介面和授權而異 | 各介面的文件與目前工作階段 |
低推理適合拚字、小幅修正和格式轉換。中等可用於一般缺陷修復。較高推理較適合需要跨檔推理、反覆測試和整理取捨的工作。設定值可能包含 low、medium、high、xhigh、max、ultra,實際選項取決於模型與客戶端。提高推理等級和切換 Fast 是兩個獨立的選擇。Codex 設定參考 · 模型選擇指南
模型怎麼選?
| 模型 | 優先使用情境 | 具體工作 |
|---|---|---|
| GPT-6.2 Sol | 日常開發與多步修改 | 追一個錯誤、修改現有功能、加上驗收 |
| GPT-6.2 Astra | 需要取捨及驗證的複雜工程 | 跨服務資料契約調整、分階段遷移 |
| GPT-6.1 Terra | 畫面、截圖與桌面互動 | 找出響應式版面錯位、檢查畫面流程 |
| GPT-6 Luna | 範圍清楚、重複性高的工作 | 小改字串、擷取欄位、批次整理 |
| GPT-6.1 Sol、GPT-6.2 Terra 等其他型號 | 以實際可選的型號與用途為準 | 先用一件可驗收的小任務比較結果 |
| GPT-5.6 Sol、Terra、Luna 與較早代型號 | 若選單仍提供,可用於既有工作流程比較 | 以同一份工作規格及測試重驗 |
官方入門建議集中在表中前四個型號。看到其他代次時,可先辨認模型世代和型號,再依自己的任務比較成功率、時間、修改範圍、工具可用性。模型清單、快照和 API 模型 ID 有各自的發布節奏,實際可選範圍以所在工作區為準。官方模型選擇 · API 模型總表
輸入斜線有哪些功能?
以下是 Codex CLI 互動介面指令,打 / 可搜尋目前版本提供的項目。執行中的對話可以用 Tab 把支援的斜線指令排入下一輪。Codex CLI 斜線指令
| 使用時機 | 指令 | 功能 |
|---|---|---|
| 開始工作 | /pwd、/cwd、/cd |
查看目前目錄,或在閒置主對話切換工作目錄 |
| 確認環境 | /status、/usage |
查看模型、權限、上下文或用量資訊 |
| 調整模型 | /model、/fast |
選型號與推理等級,或切換可用的 Fast 層級 |
| 先規劃 | /plan、/goal |
進入規劃模式,或建立、查看、暫停、繼續長任務目標 |
| 控制權限 | /permissions、/debug-config |
調整核准與存取方式,或檢查設定來源與限制 |
| 對準檔案 | /mention、/ide |
附加檔案,或加入已連接 IDE 的上下文 |
| 重複使用 | /init、/skills、/presets |
建立專案指示草稿、尋找技能、保存常用操作 |
| 連接工具 | /mcp、/apps、/plugins、/hooks |
查 MCP,選用連接器、外掛或檢視生命週期掛鉤 |
| 檢查交付 | /diff、/review |
檢查工作樹變更,或要求獨立程式碼審查 |
| 管理背景工作 | /ps、/stop |
查看背景終端機,或停止本會話的背景終端工作 |
| 整理長對話 | /compact、/recap、/copy、/export |
壓縮上下文、取得摘要、複製結果或匯出逐字稿 |
| 切換對話 | /new、/clear、/resume、/fork、/side |
開新對話、清理畫面並開新對話、恢復歷史或分支討論 |
| 隔離改動 | /worktree |
在獨立 Git worktree 工作 |
| 應用差異 | /app、/agents、/subagents |
延續到桌面或查看可用的代理工作 |
| 終端個人化 | /config、/keymap、/theme、/statusline、/vim |
調整顯示、快捷鍵和編輯方式 |
/review 適合在驗收前檢視差異,測試、型別檢查和使用者流程仍要另外執行。工作途中要另外追查一個想法,可以用 /side 或 /fork;需要保留原始改動時,優先在 Git 分支或 worktree 分開操作。
第一次進專案的設定
- 從專案根目錄啟動,先確認版本、目錄、工作樹和權限。只讀探索可從 Read Only 開始,需要編輯時再開放工作區。
- 把團隊約定寫進
AGENTS.md。列出實際安裝、測試、格式化指令,哪些目錄是生成檔,以及發送郵件、寫正式資料或公開部署需要哪些授權。 - 把個人預設放在
~/.codex/config.toml,信任的專案可以使用.codex/config.toml。先用/model確認型號,再記下需要長期使用的預設。 - 外部連接器先小範圍試讀,以
/mcp檢查可用工具。固定流程可整理為技能,用提示詞說清楚本次使用哪一個。 - 先談好如何驗收。把完成條件寫成可執行的測試、頁面操作或明確的輸出格式。
# ~/.codex/config.toml
model_reasoning_effort = "medium"
sandbox_mode = "workspace-write"
approval_policy = "on-request"
範例適合可信任的本機專案。管理員可能設定更嚴格的權限或鎖定某些選項,用 /status 和 /debug-config 查生效結果。CLI 裡的 /config 也用於終端偏好設定。基本設定 · AGENTS.md 指南
生成圖片的提示詞
桌面版有圖片生成入口。CLI 或 IDE 若所在環境有圖片生成工具或適用技能,可以明確指定使用它;先確認所用介面的功能和圖片保存位置。模型能讀圖片與工具能輸出圖片,是兩項都要確認的能力。Codex 圖片生成
替「週末活動地圖」生成一張 1200×630 分享封面。
參考圖 A 決定角色臉型和髮色,B 與 C 分別決定貓、狗玩偶外觀。
淺薄荷底、深綠標題、細金定位點,人物和兩個玩偶放右側。
保持自然人體比例,雙腳著地。玩偶各保留四肢和一條尾巴。
左側留足空白。輸出無字底圖,標題另透過排版工具加入。
交付可預覽的圖檔,先核對角色、裁切與縮圖,再決定是否上傳。
文字容易變形時,分開產圖和排字。生成整組封面可先做一張母版,再每三張檢查一次。局部重做時指出可修改區域,例如只改手勢或鞋子,並附上正確參考。
網頁專案提示詞
在現有網站新增「本週活動」列表頁,先讀 AGENTS.md 和目前活動列表。
沿用專案路由、元件及色票,資料接既有 API。
使用者可切換本週和平日,空清單有清楚提示。手機版單欄。
做完跑現有測試與型別檢查,用 390px 與 1440px 查看實際畫面。
驗收:鍵盤可操作、選項切換更新結果、載入失敗有重試入口。
交付修改檔案和驗證結果。部署和對外通知等我另行確認。
現有網站先給一個可參考的頁面,並指出哪些行為要沿用。新專案則先說明使用者要完成的任務、必要頁面與資料來源。想讓建議更精準,可要求 Codex 先讀兩個既有元件,再提出最小的實作範圍。Codex 工作方式