安装指南

最快上手：一句话就够了

不用看下面的长篇步骤。把这句话直接发给你的 Codex：

帮我安装这个 Skill 并用它给 Codex 换个主题：https://github.com/WendongAI/gptskin-skill

Codex 会自动完成下载、安装并应用主题，全程无需手动操作。

前提只有三个：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. 自定义主题（API Key）

GptSkin 只有一种付费自定义主题：图片主题。网站负责账号、Credits、API Key 与主题产物；开源 Skill 负责付费制作，并在 Codex 本地应用主题。

1. 在 gptskin.best 注册——注册即赠送 Credits（30 天有效）。
2. 在控制台复制你的 API Key。
3. 为 Skill 配置密钥：

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

然后附上一张图片（最大 4 MiB，JPEG/PNG/WebP），或先让 Codex imagegen 在本地生成图片。Skill 会把两种来源的图片交给同一个付费命令：

node ~/.codex/skills/gptskin-theme/scripts/apply-theme.mjs --image /absolute/path/theme.png "主题名称"

每制作一个新的自定义图片主题固定消耗 20 Credits；再次应用本地已保存的主题不消耗 Credits。Skill 应在扣除 Credits 及使用本地 CDP 重启 Codex 前请求确认。

恢复默认主题

随时对 Codex 说：

Restore the default Codex theme

即可移除全部注入样式和装饰层，并正常重启 Codex。

问题排查

• 桌面应用更新后主题不生效 —— 应用更新可能改变界面内部结构。先恢复默认主题，然后拉取最新 Skill（git -C ~/.codex/skills/gptskin-theme pull）再试。
• node: command not found —— 安装 Node.js 20+ 并确认已加入 PATH。
• "Invalid API Key" —— 在 gptskin.best 控制台核对密钥后重新运行 --key。
• 图片被拒绝 —— 上传仅支持 JPEG、PNG、WebP，且不超过 4 MiB。
• 界面没有任何变化 —— 确认安装 Skill 后已重启 Codex，且主题应用命令报告成功。

需要更多帮助？发送邮件至 support@gptskin.best，我们会在 3 个工作日内回复。