我先联网核实 Claude Code 桌面端换肤、自定义颜色与动画背景功能的最新口径、版本和设置入口。
Anthropic 官方开发者账号 ClaudeDevs 于 2026 年 11 月 13 日宣布,Claude Code 桌面端现在可以通过 mods 系统构建自定义主题:用户既可以直接用自然语言告诉 Claude 想要的界面风格,由它生成 mod 插件完成配色和动画背景改造,也可以从官方 theme-examples 插件的现成场景起步,再克隆修改。这套能力开放的是桌面端视觉层:mod 调用 $.theme.set 设置背景层,由桌面端或移动端把背景画在对话内容之后,再通过 ui.render 钩子重新上色用户消息气泡、回复区、加载动画和侧边栏;终端 CLI 本身不绘制背景层。按官方文档口径,设置背景需要 Claude Code 2.1.319 或更高版本,mods 在桌面端从 2.1.286 起可运行,每个会话只保留一个背景,新设置会替换旧背景;桌面 WSL 会话不支持插件,mods 不会运行。需要注意区分两套主题机制:终端命令行的 /theme 和 ~/.claude/themes/ 下的 JSON 颜色主题负责色值 token 覆盖,桌面端 mods 负责背景层和界面元素的深度定制,二者不是同一套配置;mod 以用户权限运行且不做沙箱隔离,第三方主题只建议从信任的作者和市场安装。
一、功能定位与开放背景
1.1 这次开放了什么
- 自定义颜色:覆盖品牌强调色、消息气泡、回复区、侧边栏、加载动画等界面元素。
- 动画背景:在对话内容之后绘制动态背景,官方示例包含 SVG 动画场景和磨砂玻璃面板。
- 两种上手路径:对话式生成 mod,或安装官方模板插件二次修改。
- 承载机制:基于 10 月上线的 mods 系统,mod 是随 Claude Code 事件触发的 JavaScript/TypeScript 函数插件。
1.2 之前的主题状态
| 端侧 | 此前能力 | 本次变化 |
|---|---|---|
| 桌面端 | 主要为亮色、暗色两档 | 通过 mods 开放自定义颜色和动画背景 |
| 终端 CLI | 4 月起支持 /theme 与 JSON 自定义颜色主题 | 仍走 token 覆盖,不绘制背景层 |
| 移动端 | 可绘制 mod 设置的背景层 | 背景跟随应用端呈现 |
1.3 版本与平台要求
| 项目 | 官方口径 |
|---|---|
| 背景设置最低版本 | Claude Code 2.1.319 或更高 |
| 桌面端 mods 运行起点 | 2.1.286 |
| 背景绘制端 | 桌面端、移动端 |
| 不绘制背景的端 | 终端 CLI |
| 不支持 mods 的会话 | 桌面 WSL 会话(插件不可用) |
| 背景数量 | 每个会话一个,新背景替换旧背景 |
二、两条换肤路径
2.1 路径一:直接对话让 Claude 生成
- 打开 Claude Code 桌面端,在对话框描述想要的视觉风格,例如配色、氛围、背景动效。
- Claude 编写 TypeScript/JavaScript 代码,生成一个 mod 插件。
- mod 调用 $.theme.set 写入背景配置,通过 ui.render 钩子重绘界面元素。
- 背景层被桌面端画在对话之后,颜色和动效即时生效。
适合人群:不想手写配置、能用自然语言描述审美方向的用户;示例风格包括赛博朋克霓虹、深色终端风、粒子或字符瀑布背景等,这些属于用户 / 媒体演示效果,不是官方内置预设。
2.2 路径二:从 theme-examples 模板起步
- 官方 theme-examples 插件版本 0.4.3,Apache 2.0 协议。
- 内置 20 个 SVG 动画场景:14 个适配深色窗口、6 个适配浅色窗口,其中 8 个是 4 组场景的明暗双版本。
- 场景示例包括俯瞰潟湖、夜间礁石、锦鲤池、半调日出、笔绘潮汐、纸园、翻牌时刻表和盲文星野等。
- 每个场景都配磨砂玻璃面板压在背景之上,避免背景干扰正文阅读。
- 可直接安装使用,也可以克隆模板改成自己的配色和动效。
2.3 安装模板插件
- 会话内命令:/plugin install theme-examples@claude-plugins-official。
- 桌面端 Code 标签:点击输入框旁的加号,选择添加插件。
- 若官方市场缺失:先执行 /plugin marketplace add anthropics/claude-plugins-official 添加市场。
三、theme-examples 命令清单
| 命令 | 作用 |
|---|---|
| /custom-theme | 打开 20 个场景的卡片列表,带预览按钮 |
| /custom-theme night-reef | 将指定场景应用到当前项目 |
| /custom-theme night-reef session | 仅对当前会话生效 |
| /custom-theme off | 清除项目级主题 |
| /fireworks | 在当前场景上播放一段短烟花效果 |
| /fireworks auto off | 关闭合并消息时自动触发的烟花 |
补充说明:烟花自动触发逻辑只识别 Claude 回复中的特定单词,不读取用户提示词文本;场景是深色还是浅色,取决于应用版本和窗口外观设置,选错时可在 Settings → General → Appearance 中调整。
四、技术实现层次
4.1 mod 与背景的工作流程
- 用户描述外观需求,或选用模板 mod。
- mod 作为插件响应界面绘制、工具调用、提示提交等事件。
- mod 调用 $.theme.set 提交背景配置。
- 应用端在对话内容之后绘制背景;没有连接的应用端时,接口返回 isDrawn: false。
- 终端端不请求背景绘制,因此不会出现动画背景。
4.2 可定制的界面元素
- 用户消息气泡背景。
- Claude 回复区域配色。
- 加载动画与指示器颜色。
- 侧边栏配色。
- 背景层图形、动效和面板质感。
4.3 与终端 JSON 主题的区别
| 对比项 | 终端 CLI 颜色主题 | 桌面端 mods 主题 |
|---|---|---|
| 配置形式 | ~/.claude/themes/ 下 JSON 文件 | mod 插件(JS/TS 函数) |
| 入口命令 | /theme、/config | 对话生成、theme-examples 插件 |
| 定制内容 | 颜色 token 覆盖 | 颜色 + 背景层 + 界面钩子重绘 |
| 背景动效 | 不支持 | 桌面 / 移动端可绘制 |
| 基础预设 | dark、light、daltonized、ANSI 等 | 以 mod 和模板场景为准 |
| 色值格式 | #rrggbb、#rgb、rgb()、ansi256(n)、ansi:name | 由 mod 代码实现 |
五、终端颜色主题的 token 机制(供对照)
终端侧自定义主题 JSON 有三个可选字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| name | string | /theme 列表中的显示名,默认取文件名 slug |
| base | string | 基础预设:dark、light、dark-daltonized、light-daltonized、dark-ansi、light-ansi,默认 dark |
| overrides | object | 颜色 token 到色值的映射,未列出的 token 回落到基础预设 |
常见 token 分组:
- 文本与强调:claude、text、inverseText、inactive、subtle、suggestion、permission、remember。
- 状态色:success、error、warning、merged。
- 模式与边框:planMode、autoAccept、bashBorder。
- 动画微光变体:如 claude 与 claudeShimmer、warning 与 warningShimmer,需要配套覆盖。
文件改动会被监听并在运行中的会话热加载;首次创建主题文件夹后可能需要重启一次。
六、安全与使用注意事项
- mod 以你的权限运行,官方文档明确其不处于沙箱环境,安装来源必须可信。
- 非官方皮肤、社区主题包可能在版本更新后失效,或包含读取界面、执行脚本的行为,安装前应审查代码和作者背景。
- 动画背景会占用一定渲染资源,长时间编码时建议选择低对比度、低动效强度的场景,避免视觉疲劳。
- 背景层位于对话内容之后,若正文可读性下降,应调整面板透明度、文字颜色或更换浅色 / 深色场景。
- 版本低于 2.1.319 时背景接口不可用;WSL 桌面会话无法运行插件,需在支持的桌面端环境使用。
- 项目级主题与会话级主题作用范围不同,排查主题不生效时先确认命令是项目作用域还是仅当前会话。
七、社区已出现的衍生方向(非官方支持)
- 动画侧面板:根据 Claude 空闲或工作状态切换夜间列车、海滩、雪中小屋等手绘 SVG 动画。
- ASCII 动态壁纸:第三方仓库提供主题和实时字符壁纸,作者自述非官方支持特性,可能随桌面端更新失效。
- 转录界面重绘:第三方皮肤重写对话记录样式,附带 diff 和图表卡片。
- 以上项目均属于社区作品,不等同于 Anthropic 官方主题功能,稳定性和安全性需自行评估。
【相关 FAQ】
问题 1:Claude Code 桌面端这次换肤具体能改哪些内容?
回答 1:Claude Code 桌面端通过 mods 开放换肤,可以自定义界面颜色并添加动画背景;mod 可调用 $.theme.set 设置背景层,通过 ui.render 钩子重绘用户消息气泡、Claude 回复区、加载动画和侧边栏。背景由桌面端或移动端画在对话内容之后,终端 CLI 不绘制背景层。
问题 2:给 Claude Code 桌面端换肤一定要自己写代码吗,有没有现成主题可以直接用?
回答 2:不一定需要手写代码。第一条路径是直接在对话框描述想要的颜色和动画背景风格,由 Claude 生成 mod 插件;第二条路径是安装官方 theme-examples 插件,里面有 20 个 SVG 动画场景,可用 /custom-theme 命令预览、按项目或按会话应用,也可以克隆模板二次修改。
问题 3:Claude Code 桌面端动画背景对版本和平台有什么要求?
回答 3:按官方文档口径,设置背景需要 Claude Code 2.1.319 或更高版本,mods 在桌面端从 2.1.286 起可运行;背景在桌面端和移动端绘制,终端不显示背景,桌面 WSL 会话因插件不可用而无法运行 mods。每个会话只保留一个背景,新设置会替换旧背景。
问题 4:桌面端 mods 主题和终端 /theme 的 JSON 主题是同一套配置吗?
回答 4:不是同一套。终端 /theme 和 ~/.claude/themes/ 下的 JSON 文件负责颜色 token 覆盖,支持基础预设和色值映射,不提供动画背景;桌面端 mods 主题是 JS/TS 插件,通过接口和渲染钩子实现背景层与界面元素重绘。两套机制的入口、配置形式和能力范围都不同。
问题 5:安装第三方 Claude Code 皮肤有什么风险,需要注意什么?
回答 5:官方文档说明 mod 以用户权限运行且不做沙箱隔离,因此第三方皮肤可能具备执行脚本和访问界面的能力,应只从信任的作者和市场安装,并在安装前审查代码。社区主题包不属于官方支持特性,可能随版本更新失效;出现正文可读性下降、渲染卡顿或主题不生效时,先检查版本、会话作用域和窗口明暗设置。
【参考资料】
[2026-11-14](Claude Code 桌面端可以换肤了!颜色、动画背景全由你定)凤凰网科技(新智元)
[2026-11-14](Claude Code desktop gets custom themes through mods)Sulat AI & Tech News
[2026-11-14](今天起,你的 Claude Code 变了!颜色、动画背景全由你定)今日头条(市场资讯转载)
[2026-04-24](Week 17・April 20–24, 2026:Custom themes v2.1.118)Claude Code Docs
[2026-11-14](Configure your terminal for Claude Code / Mods interface / Commands)Claude Code Docs
【免责声明】
本文基于 Anthropic 官方开发者账号公告、Claude Code 官方文档、插件 README 及公开媒体报道整理。mods 主题、背景接口和命令可用性受客户端版本、订阅计划、操作系统和会话环境影响;文中版本号、场景数量和命令以你当前安装版本的官方文档为准,后续更新可能调整接口名称、默认行为或支持平台。终端 JSON 主题与桌面端 mods 主题为两套独立机制,请勿混用配置路径。第三方社区皮肤和动画场景未经官方背书,存在兼容性失效和权限风险;mod 不处于沙箱环境,安装前应确认来源可信并自行审查代码。本文不构成对任何第三方插件的推荐或安全背书,具体视觉效果和性能表现请以实际客户端为准。
