你搜索「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 主题文件突破内置选项：
- 准备一个
.tmTheme文件——TextMate 和 VS Code 生态里有成千上万个。 - 把它放进
$CODEX_HOME/themes（大多数机器上是~/.codex/themes）。 - 用
/theme选中它，或在配置文件里通过tui.theme字段持久化设置（见 config 参考）。
这就是官方 CLI 主题能力的全部。
CLI 做不到的：改自己的界面颜色
TUI 自身的颜色——提示符、边框、状态栏、背景——官方不可定制。而且这不是什么冷门缺陷，它是 Codex issue tracker 里讨论最多的限制之一：
- Issue #1618 请求开放 TUI 颜色控制，已有 31 条评论。
- Issue #2020 反馈在浅色终端背景下提示符几乎看不见。
- Issue #6531 请求高对比度预设；issue #21130 请求语义化配色。
如果你想要的是重改 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）的重点。
决策表：你想要什么 → 去哪里
| 你真正想要的 | 去哪里 |
|---|---|
| 终端里更好看的代码块和 diff | CLI：/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 的商标，此处仅用于说明兼容性。
