CodexThemes：讓 Codex Agent 自動下載並切換主題的第三方庫

用 AI 摘要這篇文章：

ChatGPT Claude Perplexity Google Grok

CodexThemes 不是 OpenAI 官方功能，而是社群網站 codexthemes.ai 搭配一組 GitHub 上的 Apache-2.0 授權 Agent Skills（repo：codexthemes/skills，2026-07-17 建立，截至 2026-07-22 最近一次 commit 落在 2026-07-21），把 Codex 桌面端的主題「創作、查找、安裝、提交、切換、還原」六件事，各包成一個可以讓 Codex Agent 讀 SKILL.md 之後自己跑完的 Skill。本文沒有實機把整條流程跑過，所有機制描述都從官方 README 與六個 SKILL.md 原始碼整理而來，結論先講：如果你把 Codex 桌面端當工作環境（例如同時會用 Agent Battery 監看 Codex 計量），又願意接受「主題樣式靠 Codex 的 loopback 偵錯端點注入 <style>、不修改簽名應用」這個非官方機制，CodexThemes 是目前把 Codex 視覺客製化講得最透明的第三方方案；若你要的是 OpenAI 官方背書、跨版本穩定、或者 Linux 版能套，它現在都還給不了。

先把身份講清楚以免混淆。CodexThemes 的 NOTICE 檔白紙黑字寫著：Codex and OpenAI are trademarks of their respective owners. CodexThemes is an independent community project and is not endorsed by or affiliated with OpenAI. 它與 OpenAI 官方主題設定因此是兩條可並存的路線：官方設定走 Codex App 內建 UI，CodexThemes 走第三方 Agent Skill + DOM 注入。順帶一提，本篇要把這套第三方機制的邊界、風險與適合情境講清楚，讓你在交給 Agent 執行前知道它實際會做哪些事。

Pin

與 Codex 內建主題設定差在哪：兩條路線可並存

ahhhhfs 原文指出 Codex App 在 26.312 版（2026-03-12）加入了主題自訂功能，可在設定中調整基礎主題、強調色、背景色、前景色與 UI／程式碼字體。這部分 TechMoon 無法獨立核對版本號，建議你以自己 Codex 應用內的「Settings → Appearance」實際顯示為準。真正的差異在「主題怎麼被套用到 Codex 視窗」這一層：官方設定寫進應用內部，CodexThemes 則是透過第三方 .codex-theme 主題包加上一段 Agent 可執行的 Skill，把樣式注入「當前正在執行的 Codex 介面」。官方與 CodexThemes 可在同一台機器上並存。

六個 Agent Skills 各自負責什麼（不是五個）

ahhhhfs 原文把 CodexThemes 的 Skills 整理成五個，但 codexthemes/skills repo 實際上有 六個 Skill：除了原文提到的 codex-theme-creator、codex-theme-submitter、codex-theme-finder、codex-theme-installer、codex-theme-switcher，還有一個 workbuddy-theme-manager，它的任務是把 .codex-theme 包轉成騰訊 WorkBuddy 用的 .workbuddy-theme 並獨立套用；若你只看 Codex 桌面端，這個 Skill 用不到。但它在 repo 裡，代表這個專案的野心不止於 Codex 一條產品線。

Pin

六個 Skill 對應主題生命週期的六個動作。下面這份清單是從各 SKILL.md 的 frontmatter 與內文整理而來，便於你在交給 Agent 之前先核對「它聲稱會做哪些事」：

• codex-theme-creator：根據參考圖或文字描述生成主題原始檔與預覽，輸出可分享的 .codex-theme 包。它自我宣告為「唯一設計與 QA 權威」，禁止讀取或組合其他已安裝的主題 Skill，理由是避免抄襲與主題慣例混淆。
• codex-theme-finder：用 codexthemes.ai 的 themes API 搜尋公開主題庫，匿名額度內免 API key，回傳最多五個含預覽圖與詳情頁連結的候選。
• codex-theme-installer：下載指定的 .codex-theme 並解壓到 ~/.codexthemes/themes/<theme-id>/。它會校驗格式、schema 版本、theme id 一致、檔名相對安全、≤30 MB，才會寫入。
• codex-theme-submitter：把已匯出的 .codex-theme 透過 POST /api/themes/submit 上傳到社群網站。提交前強制預覽（這份預覽會變成公開畫面），並要求上傳者自行確認預覽裡沒有帳號名、repo 名、客戶程式碼等隱私內容。
• codex-theme-switcher：套用、切換、還原主題。它會在套用後量測實際渲染像素的對比度；若主題讓文字不可讀，會自動退回前一個或原生外觀，並附上失敗證據。
• workbuddy-theme-manager：獨立的騰訊 WorkBuddy 支線，擁有自己的 loopback CDP 注入與還原生命週期，與 Codex 主題不共用 runtime。

「不改 app.asar」是怎麼做到的：loopback CDP 注入樣式

這是整個專案最值得講清楚、也最容易被「第三方主題一定動手腳」的直覺誤判的地方。codex-theme-switcher/SKILL.md 與根 README 都明言：套用主題時，runtime 只透過 Codex「loopback-only（僅本機回環）的偵錯端點」插入一個自有的 <style> 元素，不修改 app.asar、不修改簽名應用包、不改 WindowsApps 目錄、不動使用者工作或驗證資料。這個設計的直接結果是「完全結束 Codex 進程再重開」就會回到原生外觀；副作用則是：當 Codex 沒有暴露偵錯端點（例如剛啟動那一次，或被完全結束過），switcher 需要你同意後用 --launch 重新啟動 Codex 並把偵錯旗標加進去。

這個機制也解釋了 README 為什麼特別標注「Microsoft Store 版本可能套不上」。Store 包出於安全考量會把 Chromium 偵錯旗標關掉，沒有偵錯端點，switcher 無從注入 <style>，這時 Skill 會直接回報限制，不會去改 WindowsApps 目錄或安裝資料夾。另一個從 SKILL.md 讀到的細節是：codex-theme-switcher 套用後會「量測實際渲染像素的可讀性」，若對比不足會自動退回，這是一個內建的失敗保險，比單純「套了就成功」的注入器穩當。本篇未實機驗證這個自動退回機制，上述描述僅依 SKILL.md 文字。

主題、Skin 與 .codex-theme 包：三種資源，安裝路徑不同

CodexThemes 網站上同時陳列兩種資源：Themes（已成型的主題包）與 Skins（僅視覺參考）。再對照 codex-theme-installer 的 SKILL.md，實際安裝路徑分成三種，這是判斷「看到喜歡的能不能一鍵套」的關鍵：

• installable 的 .codex-theme 包：codex-theme-installer 可以直接下載、解壓到 ~/.codexthemes/themes/<theme-id>/，再交給 codex-theme-switcher 套用。這是唯一能走「Agent 一鍵裝」的格式。
• zip 封存主題（installable: false）：finder 會直接告訴你「這包不能 Agent 裝」，請你到 codexthemes.ai 詳情頁登入後手動下載、手動安裝。
• Skin：只有設計參考圖，沒有可安裝包。finder 會建議你把這張圖交給 codex-theme-creator「重新創作」一個主題，產出與原圖相近但可能有差異。

這個區別很容易在瀏覽社群庫時被忽略。你看到一張很喜歡的預覽，以為「複製 prompt 給 Codex 就會裝好」，實際上若它被標為 Skin，Agent 只能用它當參考重新產一份；若它是 zip 封存，Agent 會要求你手動下載。實際比例有多少？本篇沒有爬完整主題庫做統計，這個數字請以你自己到 codexthemes.ai 瀏覽的結果為準。

主題創作的四種佈局模式：從 SKILL.md 看設計意圖

codex-theme-creator/SKILL.md 寫了四個明確的佈局模式，這是其他同類主題工具很少明文規範的部分，值得在選用前理解：

• native-background：只換背景圖與可讀性遮罩，不動其他版面。用戶明確限制「只換背景」時選此。
• native-immersive：保留原生版面配置，但協調所有語義表面（側欄、卡片、選單、composer、設定、diff、terminal），這是預設模式，當你給參考圖或指定一個視覺世界（遊戲、動漫、品牌）時就用它。
• editorial-showcase：允許在首頁放一個有界線的 hero 區塊，僅在參考圖明確需要肖像、產品或活動主視覺時選用。
• palette-only：只改語義色彩與材質，不放大面積藝術品。

佈局模式之外，creator 還要求記錄 decorDensity（minimal／balanced／rich）與 backgroundScope（僅首頁或整個 workspace）。這套契約表面上是約束 Agent，實際上是讓「我要的是哪一種主題」這件事被講起來。比起「給你一張圖，你自己看著辦」，把模式與密度講清楚，產出與期待落差的機會會小很多。

免費匿名額度與 429/402 API 配額牆

finder 與 installer 在沒有 API key 的情況下可匿名使用，但有限額。從 codex-theme-finder/SKILL.md 與 codex-theme-installer/SKILL.md 的描述，當伺服器回 429 或 402 時，指令會停下來、附上 Retry-After，並引導你到 codexthemes.ai/settings/apikeys 建立個人 API key（環境變數 CODEXTHEMES_API_KEY 或 ~/.codexthemes/credentials.json）以取得較高限額。因此 CodexThemes 的搜尋與下載有額度限制：官方把匿名額度與付費/註冊額度拆開，當匿名額度用完時，你會被推去申請 key。

實際免費額度多少、付費方案怎麼計價？截至 2026-07-22，CodexThemes 沒有公開的定價頁可供獨立核對，SKILL.md 也只說「higher limits」。若你打算密集使用，建議直接到官網 settings/apikeys 頁對照當前方案；本篇不寫死任何數字以免過期。

安全面：把第三方 SKILL.md 交給 Codex Agent 執行前要注意什麼

這是 CodexThemes 與一般「下載主題包自己手動裝」最大的差別：它的安裝流程是讓 Codex Agent 讀第三方 SKILL.md、下載主題檔、執行本地 Node 命令（npx tsx scripts/*.ts）。你實際上是把「在本機跑程式碼」的權限交出去，對象是 codexthemes.ai 這個第三方社群站與它背後的提交者。若你平常已經會用 AiMaMi 這類第三方桌面面板把 Codex 對話、MCP 與模型路由收進同一個視窗管理，那麼對「Codex 桌面端 + 第三方工具」這個組合並不陌生；差別在於主題 Skill 動到的是視覺層、不碰資料層，但授權邏輯與 AiMaMi 那種資料層工具是同一套。ahhhhfs 原文的編輯註也明言「未在生產設備中實測相關 Skills」。

幾個降低風險的具體做法。先把 SKILL.md 讀過一遍。這個 repo 的優點是六個 SKILL.md 全部公開在 GitHub 上，你可以在交給 Agent 之前自己讀過一遍，看它宣告要呼叫哪些端點、寫哪些路徑。codex-theme-installer 明文規範「校驗 schema、拒絕覆寫非空目錄、≤30 MB」，codex-theme-switcher 明文規範「不修改 app.asar 與 WindowsApps」，這些是可核對的承諾。另一個重點是不要在工作裝置上盲目批准。若電腦裡有公司程式碼、客戶資料、敏感對話，建議先在隔離環境或個人裝置上試走一次；這也是你在評估 AI coding plan 時會用到的同一條合規紅線：程式碼與業務脈絡能不能進第三方雲端，決定了你能不能放心讓 Agent 跑這類 Skill。還要留意提交者上傳的主題包。codex-theme-submitter 會要求上傳者確認版權與隱私（預覽會變成公開畫面），但這個確認是上傳者端的，下載端沒有強制審核，因此主題包內的圖像版權與資料來源仍要自行判斷。

誰適合用、誰不該用：三條決策軸

• 個人開發機且願意讀 SKILL.md → 適合。CodexThemes 的 README/SKILL.md 全文公開，可核對性比一般主題下載站高。
• 公司配發裝置、有合規或客戶資料 → 不建議。Agent 讀第三方 Skill + 跑 Node 命令的模型，在合規環境裡屬於不該貿然批准的行為。
• 需要長期穩定、跨 Codex 版本不破圖 → 不適合。README 明言 Codex 更新後主題可能破圖，要等 Skill 跟版，這不是「裝一次用 forever」的工具。
• 使用 Microsoft Store 版 Codex → 大概率套不上。Store 包關閉偵錯旗標，switcher 無從注入。
• Linux 桌面用戶 → 不支援。README 只列 macOS 與 Windows。

限制與風險：誠實列清楚

• 非官方：NOTICE 明示與 OpenAI 無官方關係。Codex 更新方向、API 變更，CodexThemes 都只能事後跟版。
• DOM 注入依賴：主題能動是靠 Codex 桌面端目前還保留 Chromium 偵錯旗標與 DOM 結構，OpenAI 若在未來版本關閉這個視窗，整個機制會失效。
• Codex 更新後破圖：當 UI 結構改變，codex-theme-switcher 的 status 命令可能回 partial 或 inactive，需等社群重新調整主題或 Skill。
• 第三方信任鏈：你信任 對象是 codexthemes.ai 與上傳者，不是 OpenAI。Skills 程式碼本身走 Apache-2.0，但主題包內的圖像版權由上傳者宣告。
• 配額與付費牆：匿名額度有限，429/402 後需建立 API key；定價未公開，需到官網核對。
• 本篇未實測：所有機制描述依官方 README 與 SKILL.md 文字，未在 Codex 桌面端實機走完創作/安裝/切換/還原流程。實際套用感受、破圖頻率、可讀性 gate 是否如宣告運作，請以你自己本機測試為準。

結論：把 CodexThemes 當「可讀碼的第三方主題實驗場」

CodexThemes 的價值在於它把一套本來黑盒的主題注入機制，用 Apache-2.0 授權的 Skill 程式碼與六份 SKILL.md 全部攤開來。你能讀、能審、能自己決定要不要交給 Agent 跑，這個透明度本身就是它與「下載一個 zip 自己想辦法」的最大差別，與 awesome-gpt-image-2 這類「把 prompt 結構化成可重用模板」的 Apache-2.0 開源資源庫是同一類型的社群資產。在個人開發機上，它值得花一個下午摸一遍；在合規環境或追求「裝了就別再動」的場景，目前都不是好選擇。把它當「可讀碼的第三方主題實驗場」、而非拿來直接取代 OpenAI 官方主題設定，期待會比較對焦。

常見問題

CodexThemes 是 OpenAI 官方專案嗎？

不是。CodexThemes repo 的 NOTICE 檔明文寫「CodexThemes is an independent community project and is not endorsed by or affiliated with OpenAI」。它與 OpenAI Codex 是並存關係，不是官方授權或維護。

它會改到 Codex 應用本身檔案嗎？

依官方 README 與 codex-theme-switcher/SKILL.md，套用主題只透過 Codex 的 loopback 偵錯端點注入 <style>，不修改 app.asar、WindowsApps、使用者工作或驗證資料。完全結束 Codex 進程再重開，會回到原生外觀。本篇未實機驗證此行為，描述僅依官方文件。

看到喜歡的主題為什麼 Agent 說不能裝？

codexthemes.ai 上的資源分三類：.codex-theme 包可 Agent 一鍵裝；zip 封存主題需登入網站手動下載；Skin 僅供 codex-theme-creator 當參考重新產生主題，不能直接套用。

Linux 或 Microsoft Store 版的 Codex 能用嗎？

Linux 不在支援範圍，README 僅列 macOS 與 Windows。部分 Microsoft Store 版本會把 Chromium 偵錯旗標關閉，沒有 loopback 端點可注入樣式，這種版本套不上主題，Skill 會直接回報限制。

免費額度用完了怎麼辦？

當伺服器回 429 或 402，finder/installer 會引導你到 codexthemes.ai/settings/apikeys 建立個人 API key，並透過環境變數 CODEXTHEMES_API_KEY 或 ~/.codexthemes/credentials.json 配置，以取得較高限額。實際額度與計價請以官網當期方案為準。