Skip to content

Codex CLI 主題 vs Codex 桌面版主題:你要找的到底是哪一個?

2026/07/24

你搜尋「codex theme」,然後掉進了一個令人困惑的地方:一半的搜尋結果在講終端命令,另一半展示的是精緻桌面應用的截圖,沒有任何一篇解釋兩者的區別。原因很簡單:「Codex」是三個不同的產品,每個產品的主題機制完全不同。 本文先用一分鐘幫你分清它們,再講清每個產品到底能做什麼——所有結論都附官方文件和 GitHub issue 原文連結。

先坦白:本文由 GptSkin 團隊釋出。GptSkin 只服務 Codex 桌面應用——不支援 CLI——我們會把這條邊界講得很清楚,因為裝錯工具對誰都沒好處。

一分鐘辨別:你用的是哪個 Codex?

  • Codex CLI——執行在終端裡的文本介面(TUI)agent。在 shell 裡輸入 codex 啟動,一切都發生在終端視窗內。
  • Codex 桌面應用——macOS 和 Windows 上的獨立圖形應用,有對話面板、設定視窗和滑鼠操作。
  • Codex VS Code 擴充套件——以擴充套件面板的形式住在 VS Code 裡的 Codex。

如果別人告訴你「直接執行 /theme 就行」,而你在介面上根本找不到命令列入口,那你用的是桌面應用。如果某篇部落格展示了漂亮的圖片背景,而你日常泡在終端裡,那張截圖就不是在 CLI 裡拍的。同一個品牌,不同的產品,主題機制零重疊。

Codex CLI 主題:只管語法高亮,別的都不管

在 CLI 裡,官方的說法狹窄而明確。/theme 斜槓命令在文件裡只有一項職責:"Choose a syntax-highlighting theme."(選擇語法高亮主題。)它改變的是對話記錄裡 Markdown 程式碼塊和 diff 的著色——而不是它們周圍的介面。

用 .tmTheme 自訂 CLI 語法高亮

按照 CLI 自訂文件,你可以用 TextMate 主題檔案突破內建選項:

  1. 準備一個 .tmTheme 檔案——TextMate 和 VS Code 生態裡有成千上萬個。
  2. 把它放進 $CODEX_HOME/themes(大多數機器上是 ~/.codex/themes)。
  3. /theme 選中它,或在設定檔案裡透過 tui.theme 欄位持久化設定(見 config 參考)。

這就是官方 CLI 主題能力的全部。

CLI 做不到的:改自己的介面顏色

TUI 自身的顏色——提示符、邊框、狀態列、背景——官方不可自訂。而且這不是什麼冷門缺陷,它是 Codex issue tracker 裡討論最多的限制之一:

如果你想要的是重改 CLI 介面顏色,今天誠實的答案是:關注上面這些 issue,並且對任何聲稱能幹淨做到這點的工具保持警惕。GptSkin 不做 CLI 主題——我們只服務桌面應用。與其讓你裝錯東西,我們寧願把話說明白。

Codex 桌面版主題:真正的介面自訂(只差一件事)

桌面應用才是主題真正玩得起來的地方。自 2026 年 3 月 12 日起,官方應用在 Settings → Appearance 內建了主題功能(見官方 changelog):

  • 可選的基礎主題
  • 獨立調整的強調色、背景色、前景色
  • 字型選擇,
  • 主題分享——可以匯出設定,也可以匯入別人的。

純色、字型級別的自訂,原生設定已經真正夠用了——零安裝、官方支援。

Settings → Appearance 唯一做不到的,是把一張真實的圖片鋪在工作區背後。這個空白正是第三方工具的位置。開源方案中 star 數最高的是 Dream Skin,再有就是我們自己的 GptSkin——透過開源 Skill 在本地應用圖片主題:

  • 6 個免費預設,無需帳號——比如適合深夜工作的 Dark Void,或適合明亮房間的 Minimal Light。先按安裝指南裝一次 Skill(支援 macOS 與 Windows,需要 Node.js 20+),之後應用任何預設只需一條命令:
node ~/.codex/skills/gptskin-theme/scripts/apply-theme.mjs --preset dark-void
  • 自訂圖片主題:把你自己的照片或畫作變成工作區背景,每個新主題 20 Credits(一次性儲值包,不是訂閱);再次套用已儲存的主題免費。
  • 一鍵恢復:對 Codex 說 Restore the default Codex theme,所有注入都會被移除。

VS Code 擴充套件版呢?

一句話:Codex VS Code 擴充套件跟隨 VS Code 自己的主題機制。如果那是你的環境,按 VS Code 的方式換主題就行——這不是本文(也不是 GptSkin)的重點。

決策表:你想要什麼 → 去哪裡

你真正想要的去哪裡
終端裡更好看的程式碼塊和 diffCLI:/theme,或把 .tmTheme 放進 $CODEX_HOME/themes
重改 CLI 自身介面顏色(提示符、邊框、背景)官方暫不支援——關注 issue #1618
桌面應用的純色與字型自訂內建功能:Settings → Appearance
桌面應用的圖片背景第三方:GptSkin(見 showcases)或 Dream Skin
VS Code 裡的 Codex 換主題VS Code 自己的主題設定

FAQ

/theme 能改 CLI 的介面顏色嗎?

不能。/theme 只負責選擇 Markdown 程式碼塊和 diff 的語法高亮主題——這就是它官方文件字面上的全部內容。TUI 自身的顏色官方不可自訂;這方面的社群需求記錄在 issue #1618

CLI 主題和桌面版主題通用嗎?

不通用。它們是不同產品裡兩套獨立的機制。.tmTheme 檔案隻影響 CLI 的語法高亮;桌面應用的 Settings → Appearance 和 GptSkin 這類圖片主題只作用於桌面介面。

.tmTheme 檔案在 Codex CLI 裡怎麼用?

把檔案放進 $CODEX_HOME/themes(通常是 ~/.codex/themes),然後用 /theme 命令選中它,或在設定裡設定 tui.theme 欄位——兩者分別見自訂文件config 參考。記住:它只改語法高亮,不改 TUI 本身。

Codex 桌面應用能用我自己的圖片做背景嗎?

原生不行——Settings → Appearance 只覆蓋顏色和字型,不支援圖片。第三方工具填補了這個空白:GptSkin 可以把你的圖片構建成主題,每個 20 Credits(另有 6 個免費預設),由開源 Skill 在本地應用,支援一鍵恢復。安裝步驟見安裝指南

GptSkin 支援 CLI 或 VS Code 擴充套件嗎?

不支援——GptSkin 只服務 macOS 和 Windows 上的 Codex 桌面應用,不碰 CLI 的 TUI,也不碰 VS Code 擴充套件。如果那是你的環境,上面的決策表會告訴你正確的選項。

總結

「codex theme」是個有歧義的搜尋詞,因為 Codex 是三個產品、三套主題故事:CLI 管語法高亮,桌面應用原生改介面,圖片背景則是第三方的活兒。如果桌面應用是你的主戰場,而你想要一張別人沒有的背景,先從一個免費預設開始——再到 showcases 看看其他 Codex 使用者都在用什麼。

GptSkin 是獨立產品,與 OpenAI 無隸屬、背書或官方關聯。「ChatGPT」和「Codex」是 OpenAI 的商標,此處僅用於說明相容性。

GptSkin Team

GptSkin Team