Claude Code 桌面版自訂主題：換背景與排查未顯示
驗證於
本文目錄
在 Claude Desktop 的 Code 分頁裝好官方 theme-examples 後，可以用 /custom-theme 預覽或套用背景。第一次先在本機新對話選 session，確認那個視窗畫得出來，再套用到整個專案。這也能把「主題已存」和「應用程式成功繪製」兩件事分開驗收。
先在一個 session 預覽和還原
在 Code 對話中安裝官方市集的 theme-examples@claude-plugins-official。如果舊版 desktop-themes 還開著，先關掉它，兩個外掛都宣告相同的指令名稱。先從 /custom-theme list 找到符合目前淺色或深色視窗的名稱。官方外掛 README
| 指令 | 驗收方式 |
|---|---|
/custom-theme | 開啟主題卡片，先用預覽確認視窗能畫出背景 |
/custom-theme <名稱> session | 只改目前對話，再到同專案另一個對話檢查 |
/custom-theme <名稱> | 設為專案主題，另一個未獨立選主題的對話在下個 turn 套用 |
/custom-theme off session | 清掉當前對話的主題，不改專案選擇 |
/custom-theme off | 清除專案主題 |
指令有回覆，背景還是空白
先在 Desktop 的 Code 分頁確認實際 Claude Code 版本。寫背景 mod 時，$.theme.set／$.theme.clear() 從 2.1.319 起提供。官方目前的 backdrop.scene 範例需要 2.1.323 以上，Code 分頁配色則從 2.1.324 起支援。終端機不繪製背景，單看 CLI 安裝方式 或版本不足以判斷桌面視窗。Mods 介面文件
外掛的指令仍可能在不繪製背景的視窗正常回覆，專案主題也照樣儲存。官方目前列出 cloud session 可執行載入的 mod hooks，但無法繪製介面。回到本機 Code 對話再測背景。Mods 執行環境
自己寫 mod 時，記錄 $.theme.set 回傳的 isDrawn 和 reason，用同一個本機 session 判斷。若圖案有出現但停在靜態畫面，檢查系統的減少動態效果設定和 GPU 加速。若第二個 mod 一啟用，配色或背景就消失，先單獨測試原本的 mod。每個 session 只有一組主題，自訂模組要在同一次 $.theme.set 傳入 colors 和 backdrop。
安裝第三方主題時，把它當作可執行的外掛審查。Mods API 包含檔案、程序與 HTTP 能力，如果作者說功能只有換顏色，先核對 hook 入口及它實際使用的 API。Mods API 參考
參考資料：