Hub Codex CLI 完整教學

附錄 C

官方文件與資源地圖

這份附錄是一張「上哪查最準」的地圖。

把它想成一本旅遊書最後那幾頁的「實用資訊」：你已經學完前面所有招式，但 Codex CLI 更新很快（常常幾天就出一版），總有一天你會想知道「這個旗標現在還在嗎？」「最新版幾號？」「官方怎麼說？」。這時候，與其相信網路上來路不明的舊教學，不如直接回到官方源頭自己查一眼。

這附錄幫你做三件事：

  • 把所有官方文件連結整理成清單，一頁找得到你要的那頁；
  • 教你一個關鍵觀念：CLI 的版本號要去 GitHub releases 看，不是看官方文件網站的 changelog；
  • 列一張「本書寫作時還沒被官方逐字坐實、建議你實機核對」的清單，讓你知道哪些細節要親自再確認一次。

小提醒

這附錄不是拿來「從頭讀到尾」的，是拿來「需要時翻一下」的。先掃一眼有哪些區塊，真的要查時再回來。

C.1 官方來源在哪裡（兩個主站）

Codex 的官方資訊，主要散在兩個地方。先搞懂這兩個各管什麼，你就不會在錯的地方找錯的東西。

來源 網址 管什麼 你什麼時候來這
OpenAI 開發者文件站 developers.openai.com/codex 功能說明、指令旗標、設定鍵、教學 想知道「某指令怎麼用」「某設定鍵是什麼」
GitHub 原始碼 repo github.com/openai/codex 原始碼、版本號（releases）、issue 回報 想知道「最新版幾號」「我遇到的 bug 別人有沒有遇過」

兩個都是官方、都可信，只是分工不同：

  • 想學「怎麼用」→ 去開發者文件站（developers.openai.com）。
  • 想知道「現在是哪一版、改了什麼」→ 去 GitHub releases（下一節專門講）。

重要提醒

網路上很多第三方部落格、論壇文章也在教 Codex CLI，但它們規格不一定跟得上官方（Codex 幾天一版，旗標和設定鍵會變）。本書的原則是：逐字的指令、旗標、設定鍵，一律以官方頁面 + 你實機 codex --help 的輸出為最終真相。 第三方資料只當輔助參考。

C.2 版本號真相：看 GitHub releases，不是 changelog

這一節是整個附錄最重要的觀念，新手很容易在這裡被誤導，所以單獨講。

你可能會直覺地以為：「想知道 Codex CLI 最新版本，去官方文件站的 changelog 看就好啦？」——不對。

問題出在這：

  • 開發者文件站的 Codex changelog 是按日期、涵蓋整條 Codex 產品線（CLI、cloud、IDE、桌面 app 全混在一起）的更新紀錄。它不會列出「CLI 0.140.0」這種版本號條目。
  • 真正帶版本號的 CLI 釋出紀錄，在 GitHub releases：github.com/openai/codex/releases，每一版的 tag 長得像 rust-vX.Y.Z。
你想知道 該去哪 為什麼
CLI 最新版號是多少 GitHub releases 版本號真相在這（tag rust-vX.Y.Z）
這版改了哪些功能（跨產品線） 開發者站 changelog 按日期列，含 CLI/cloud/IDE
我現在裝的是哪一版 終端機跑 codex --version 看自己本機實際版本（以實機為準）

舉個本書寫作時的實例：本書對照的版本是 Codex CLI 0.140.0（2026-06-15 釋出）——這個版本號就是從 GitHub releases 查到的，而不是從開發者站 changelog。

超實用小技巧

想一眼確認自己本機裝的版本，直接在終端機打：

codex --version

想知道有沒有新版，跑 codex update（它會自己檢查並套用更新）。詳見第 2 章。

重要提醒

如果你看到某篇文章說「Codex CLI 最新版是 0.xxx」，先確認它是不是引用 GitHub releases。引用「開發者站 changelog 的日期」當版本號，是常見的混淆——那頁根本沒有 CLI 版本號條目。

C.3 官方文件全頁清單（依主題分類）

這是本書所有官方依據的總連結清單，照「你想學什麼」分好類，需要時直接點。每一塊也標了「本書對應第幾章」，方便你回頭複習。

入門 / 安裝 / 登入（對應第 0~3 章）

指令與旗標逐字參考（對應第 4、6 章與附錄 A）

進階小知識

Codex CLI 有一套「功能旗標（feature flags）」系統，有些指令（像 /undo）預設關著，要先用 codex features list 看清單、codex features enable <名稱> 打開。這套機制的權威說明在上面的 CLI Features 頁；但每個旗標的確切名稱與預設值會變，一律以實機 codex features list 的輸出為準。詳見第 6 章、第 9 章。

設定檔 config.toml（對應第 8、13 章）

模型 / 安全 / 記憶（對應第 4、5、6 章）

進階 / 自動化 / 雲端 / 整合（對應第 9~12 章）

進階讀者導引

想深挖冷門旗標、RUST_LOG 分級除錯、功能旗標、codex doctor、用量/成本追蹤的（對應第 6、9 章），官方主要依據集中在這四頁：CLI reference（旗標/子命令逐字）、CLI Features（功能旗標、快捷鍵）、環境變數（RUST_LOG 等）、changelog（新功能版號）。⚠️ 這些頁更新很快，逐字內容一律以實機 codex --help / codex features list 為最終真相。

定價 / 用量（對應第 13 章）

GitHub（原始碼、版本號、issue）

小技巧

開發者站還有一個「全文彙整」頁 developers.openai.com/codex/llms-full.txt，把整站文字塞在一頁。當你想用瀏覽器的「在頁面內搜尋」（Ctrl + F / Cmd + F）一次撈某個關鍵字時很好用，但它很長，不適合從頭讀。

C.4 遇到問題、想回報 bug，去哪裡

如果你不是要查功能，而是踩到雷想找解法、或想回報問題，路線不太一樣：

你的情況 去哪 怎麼用
程式出怪錯誤，想先自救 終端機跑 codex doctor 先做本機健檢（詳見第 13 章）
想看別人有沒有遇過同樣 bug GitHub issues 用關鍵字搜尋既有 issue
確定是新 bug，想回報 GitHub issues 開新 issue，附 codex doctor 輸出
登入 / 帳號 / 方案問題 OpenAI 說明中心 help.openai.com 帳號與訂閱相關

本書第 13 章引用過幾個真實的 GitHub issue 當佐證（例如 ZDR 零資料保留錯誤、WSL 登入失敗），它們也是你搜尋同類問題的好起點：

回報 bug 的好習慣

開 issue 前先跑 codex doctor（或 codex doctor --json），把輸出附在 issue 裡，維護者一眼就能看懂你的環境，解決更快。詳見第 13 章。

C.5 本書寫作時「建議你實機再核對」的清單

這一節很誠實，也很重要。

Codex CLI 更新極快，本書寫作時（2026-06-17，對照 0.140.0 版），有些細節官方還沒逐字寫死、或不同官方頁面說法不完全一致。本書遇到這類情況，都用了保守寫法並提醒你「以實機為準」。這裡把它們集中列成一張清單，讓你心裡有底：看到這些，別當成鐵板釘釘，自己用 codex --help / /model / /help 再確認一次。

主題 為什麼要再確認 怎麼親自核對
CLI 預設模型代號 官方說「大多數任務從 gpt-5.5 開始」，但「哪一版起變成預設」是社群整理；模型字串幾乎每月變 TUI 內打 /model 看實際清單
模型清單會汰換 寫作時現役為 gpt-5.5/gpt-5.4/gpt-5.4-mini 等；gpt-5-codex 是 2025-09 歷史首發，已非現役選項；舊型會被棄用 /model 或 models 頁
少數新 slash 指令 /usage、/import、/delete、codex delete 在 0.140.0 釋出紀錄已證，但官方指令表可能還沒同步；/rename 無官方佐證 TUI 打 /help、終端 codex --help
--oss 本地模型細節 oss_provider 兩官方頁說法不一致；預設模型 gpt-oss:20b 為社群來源 codex --help + 實機試
disable_response_storage（ZDR） 非官方 config-reference 收錄的鍵，且有人回報新版失效 ZDR 使用者務必實機驗（見第 13 章）
project_doc_max_bytes 上限 官方當前仍寫 32 KiB，有第三方稱新版調整 config-reference
Subagents / Hooks 主要來自第三方遷移文章，官方獨立規格頁尚未逐字全核（附錄 B 已標「待實機確認」） 實機 + 官方頁雙確認
精確定價數字 credits 換算美元、weekly limit、Free/Go 的 rate limit 等官方未完整公開 定價頁 + CLI 內 /status、/usage
少數平台細節 WSL1 終止支援的確切版本、network_proxy.socks_url 的 scheme、OPENAI_API_KEY 是否仍被直接讀取 GitHub releases / 實機
功能旗標的名稱與預設 undo、unified_exec、shell_snapshot、memories 等旗標的 stage / 預設值，官方未逐字全列（部分來自 deepwiki 導讀）；名稱會隨版本變 codex features list（實機） + CLI Features 頁
隱藏 / 實驗性子命令 codex debug models、codex execpolicy、codex sandbox、codex app-server 等標 Experimental，行為可能變，別寫死進腳本 codex <子命令> --help（實機） + CLI reference
RUST_LOG_FORMAT 官方環境變數頁未列此變數；json / compact 為社群實證 實機試 + 環境變數頁
profile 設定的寫法 profile 為獨立檔 ~/.codex/<名稱>.config.toml（top-level key）；舊版內嵌表 [profiles.名稱] 語法已不支援，網路舊教學常照抄 進階設定頁 + 實機 codex --profile <名稱>

重要提醒（本書最核心的一句話）

任何逐字的指令、旗標、設定鍵、模型名稱，實機上一律以下面三個輸出為最終真相——它們永遠比任何教學書（包括本書）更新：

codex --help              # 全域指令與旗標
codex <子命令> --help     # 例：codex exec --help、codex login --help
codex doctor              # 本機環境健檢

TUI（互動模式）裡則用 /help 看可用的 slash 指令、用 /model 看可選模型。

C.6 一分鐘「我該查哪裡」速查

最後，把整個附錄濃縮成一張「遇到問題、直覺反應該翻哪」的速查表，釘在心裡就夠：

我想知道… 第一站
某指令 / 旗標怎麼用 codex --help（最準）；查不到再看 CLI reference
TUI 裡有哪些 / 指令 TUI 內打 /help；或看 slash 指令頁
某個 config 設定鍵叫什麼 config-reference
現在最新是哪一版 GitHub releases（tag rust-vX.Y.Z）；本機 codex --version
有哪些可用模型 TUI 打 /model；或 models 頁
程式出錯怎麼自救 先 codex doctor（見第 13 章）
別人有沒有遇過同 bug GitHub issues
我的額度還剩多少 CLI 內 /status、/usage（見第 13 章）

收尾一句話

記住兩條黃金法則就好——「學功能上開發者站，查版本去 GitHub releases」，以及「實機 --help 永遠贏過任何文件」。有這兩條，就算 Codex 再怎麼更新，你都查得到最準的答案。

官方參考

Codex 開發者文件站、GitHub openai/codex、GitHub releases（版本號真相）、Changelog（產品線更新）