安裝指南

為 Codex 工作區安裝 GptSkin Skill —— 一句話即可自動安裝，或按手動步驟安裝。

最快上手：一句話就夠了

不用看下面的長篇步驟。把這句話直接發給你的 Codex：

幫我安裝這個 Skill 並用它給 Codex 換個主題：https://github.com/WendongAI/gptskin-skill

Codex 會自動完成下載、安裝並套用主題，全程無需手動操作。

一句話安裝 GptSkin Skill 示意

前提只有三個：macOS 或 Windows、Codex 桌面應用、Node.js 20+（用 node -v 驗證）。

搞不定，或想了解細節？往下看手動步驟。

手動安裝（備選）

系統要求

macOS 或 Windows
Codex 桌面應用
Node.js 20+（用 node -v 驗證）

付費製作自訂主題還需要在 gptskin.best 註冊免費帳號；6 個預設主題無需帳號即可使用。

1. 安裝 Skill

GptSkin Skill 是開源的（GitHub）。將其安裝到 Codex 的 skills 目錄：

git clone https://github.com/WendongAI/gptskin-skill.git ~/.codex/skills/gptskin-theme
cd ~/.codex/skills/gptskin-theme
npm install

重啟 Codex 使其載入新 Skill。可驗證指令碼是否就位：

node ~/.codex/skills/gptskin-theme/scripts/apply-theme.mjs --help

2. 試用免費預設

無需帳號。在 Codex 中直接說：

應用 dark-void 預設主題

或直接執行指令碼：

node ~/.codex/skills/gptskin-theme/scripts/apply-theme.mjs --preset dark-void

可選預設：dark-void、sunset-glow、aurora-borealis、snow-peak、city-lights、minimal-light。

3. 自訂主題（瀏覽器安全登入）

GptSkin 只有一種付費自訂主題：圖片主題。網站負責帳號、Credits、付款與主題產物；開源 Skill 負責付費製作，並在 Codex 本地套用主題。

執行裝置登入命令：

node ~/.codex/skills/gptskin-theme/scripts/apply-theme.mjs --login

GptSkin 會開啟一個短時有效的授權頁面。登入或註冊後，核對裝置名稱並點選 Authorize Codex。全程無需複製 API Key。完成電子郵件驗證的新帳號會獲得 20 Credits 註冊獎勵，有效期 30 天。

然後附上一張圖片（最大 4 MiB，JPEG/PNG/WebP），或先讓 Codex imagegen 在本地生成圖片。Skill 會把兩種來源的圖片交給同一個付費命令：

node ~/.codex/skills/gptskin-theme/scripts/apply-theme.mjs \
  --image /absolute/path/theme.png "主題名稱" \
  --confirm-charge=20

每製作一個新的自訂圖片主題固定消耗 20 Credits；再次應用本地已儲存的主題不消耗 Credits。Skill 會在扣除 Credits 及使用本地 CDP 重啟 Codex 前請求確認。餘額不足時會開啟 GptSkin 定價頁；只有你明確完成 Creem 付款並且積分入帳後，同一個主題請求才會自動繼續。

恢復預設主題

隨時對 Codex 說：

Restore the default Codex theme

即可移除全部注入樣式和裝飾層，並正常重啟 Codex。

問題排查

桌面應用更新後主題不生效 —— 應用更新可能改變介面內部結構。先恢復預設主題，然後拉取最新 Skill（git -C ~/.codex/skills/gptskin-theme pull）再試。
node: command not found —— 安裝 Node.js 20+ 並確認已加入 PATH。
登入授權已過期或已使用 —— 重新執行 --login。授權碼 10 分鐘後過期，並且只能兌換一次。
圖片被拒絕 —— 上傳僅支援 JPEG、PNG、WebP，且不超過 4 MiB。
介面沒有任何變化 —— 確認安裝 Skill 後已重啟 Codex，且主題套用命令報告成功。
找不到 Codex 桌面應用 —— 先確認你安裝的是官方桌面版：不是 Codex CLI、不是 VS Code 擴充套件、也不是第三方便攜版。官方桌面版預設安裝到 %LOCALAPPDATA%\Programs\Codex\Codex.exe。如果裝在其他位置，可透過 CODEX_APP_PATH 環境變數手動指定（PowerShell 範例：$env:CODEX_APP_PATH='D:\Apps\Codex\Codex.exe'）。查詢路徑的兩種方法：右鍵 Codex 快捷方式 → 開啟檔案所在的位置；或在桌面版執行時，在 PowerShell 中執行 Get-Process | Where-Object { $_.Path -match 'Codex|ChatGPT' } | Select-Object -ExpandProperty Path -Unique。
Windows 報錯 0xc0000142 / "No process is on the other end of the pipe" —— 這通常說明你的 Codex 是第三方「離線安裝版 / 免安裝版」repack。這類版本無法被 Skill 重啟注入，且存在安全風險（它們經手你的 API Key 與對話內容），請從 OpenAI 官方管道安裝桌面版。自 Skill 0.3.0 起，這類路徑會被主動識別並攔截提示，不會強制殺處理程序。
CLI 與桌面版的區別 —— %LOCALAPPDATA%\OpenAI\Codex\bin\<雜湊>\codex.exe 是命令列 CLI，不是桌面應用，不能當作 CODEX_APP_PATH。桌面版是 Electron 應用，安裝在 Programs\Codex\Codex.exe（即 %LOCALAPPDATA%\Programs\Codex\Codex.exe）。

需要更多幫助？傳送郵件至 support@gptskin.best，我們會在 3 個工作日內回覆。

安裝指南

On this page