Claude Code 桌面主题是什么,如何工作
更新于 2026-11-15
Claude Code 桌面主题是一个 mod,也就是在 Claude Code 内部运行 JavaScript 或 TypeScript 代码的插件。主题 mod 在会话开始时调用 $.theme.set,调用里可以带两样东西:
- Claude 桌面应用 Code 标签页的颜色
- 由桌面应用或移动应用绘制在对话后面的背景
主题能改什么,不能改什么
背景需要 Claude Code 2.1.319 或更高版本。Code 标签页的颜色需要 2.1.324 或更高版本。
终端不绘制背景,终端里的 Claude Code 保持自己的配色。要给终端界面换色,请使用 CLI 主题。
一个会话只有一个主题。任何 mod 调用 $.theme.set 或 $.theme.clear() 时,之前设置的颜色和背景都会被移除。请一次只安装一个主题 mod。
代码大致是什么样
下面是背景 mod 的基本结构,改写自官方示例,需要 Claude Code 2.1.323 或更高版本:
export function register(on) {
on("session.start", async ($, e, next) => {
await $.theme.set({
backdrop: { scene: "night-sky" },
overrideColorScheme: "dark",
});
return next(e);
});
}
还需要另一个 hook 来绘制这个场景。完整示例见 mods 文档,颜色部分见更改桌面应用的颜色。
为什么主题需要审核
主题是 mod,能力不限于绘制。它以与 Claude Code 相同的权限运行,不在沙盒里。只负责绘制的主题不应该需要网络、你的文件或其他程序,所以 ThemeCC 会列出每个主题实际用到的权限。
ThemeCC 上的每个桌面主题都固定在某一个 commit,并显示它声明的权限。页面会标明维护者是否阅读过源码。详见安装 Claude Code mod 主题安全吗?。