/theme 深度核查 v2.1.195 · 已交叉核查 · Claude Code

本页目录13

Slash 命令看官方文档

更改终端配色主题和样式

深度使用指南

最近核查 2026-06-27

· 来源 2 个

code.claude.comConfigure your terminal for Claude Code — code.claude.com
code.claude.comCommands — code.claude.com

· 含官方文档· v2.1.195已交叉核查

它到底是什么

/theme 是 Claude Code 的交互式主题选择命令,打开一个实时预览选择器,让你在预设配色方案和自定义主题之间切换。选择结果全局保存在 ~/.claude/,对所有项目生效。

注意:Claude Code 只控制自身 UI 的配色,不修改终端本身的颜色方案(终端颜色由终端应用程序负责)。

怎么触发 / 怎么使用

1. 直接打开交互式选择器

在任意会话中输入:

/theme

选择器立即出现,光标移到哪个主题,Claude Code 就实时预览该主题(官方:交互编辑器 "shows the same tokens with a live preview")。确认保存 / 取消还原的具体快捷键以你实际使用的版本为准。

2. 通过 `/config` 进入

/config 内置了同一个主题选择器入口,效果与 /theme 完全相同。

内置主题一览

值	说明
`auto`	自动检测终端背景明暗,跟随 OS 外观切换
`dark`	深色主题(默认)
`light`	浅色主题
`dark-daltonized`	深色 + 色盲友好(针对红绿色盲优化)
`light-daltonized`	浅色 + 色盲友好
`dark-ansi`	深色,仅使用 16 种标准 ANSI 颜色
`light-ansi`	浅色,仅使用 16 种标准 ANSI 颜色

auto 会自动检测终端的浅色或深色背景来判断深浅(官方文档:"detects your terminal's light or dark background")。

自定义主题

需要 Claude Code v2.1.118 或更新版本。

在 /theme 选择器底部选择 New custom theme… 可交互式创建主题:命名后逐个挑选颜色 token 覆盖。选中已有自定义主题时按 Ctrl+E 进入编辑。

每个自定义主题是 ~/.claude/themes/ 目录下的一个 JSON 文件,文件名(去掉 .json)即为 slug。选中自定义主题后,配置中存储的格式为 custom:<slug>。

自定义主题文件格式

{
  "name": "Dracula",
  "base": "dark",
  "overrides": {
    "claude": "#bd93f9",
    "error": "#ff5555",
    "success": "#50fa7b"
  }
}

字段	类型	说明
`name`	string	选择器中显示的名称,默认为文件名 slug
`base`	string	继承的内置预设,默认为 `dark`
`overrides`	object	颜色 token 到颜色值的映射

颜色值格式支持:#rrggbb、#rgb、rgb(r,g,b)、ansi256(n)、ansi:<name>(如 red、cyanBright)。

可覆盖的 color token 分类(精选)

分类	代表 token
品牌与文字	`claude`、`text`、`inactive`、`subtle`、`suggestion`
状态色	`success`、`error`、`warning`
输入框与模式	`promptBorder`、`planMode`、`autoAccept`、`bashBorder`
Diff 渲染	`diffAdded`、`diffRemoved`、`diffAddedWord`、`diffRemovedWord`
全屏模式	`userMessageBackground`、`selectionBg`
使用量计量	`rate_limit_fill`、`rate_limit_empty`

部分 token 还有配对的 shimmer 变体(官方:"Several tokens have a paired shimmer variant"),控制 spinner 动画渐变的高亮色,共 6 对:claude/claudeShimmer、warning/warningShimmer、permission/permissionShimmer、promptBorder/promptBorderShimmer、inactive/inactiveShimmer、fastMode/fastModeShimmer。子 agent 颜色使用 <color>_FOR_SUBAGENTS_ONLY 格式(color 取值:red / blue / green / yellow / purple / orange / pink / cyan)。

Claude Code 监听 ~/.claude/themes/ 目录,文件变动后无需重启即自动生效。

保存 / 配置

主题偏好全局保存在 ~/.claude/(内置主题存储值名,自定义主题存储 custom:<slug>),不支持按项目单独设置。

跟同类"外观"原语对比

/theme 调的是配色,容易和改字体/键位的终端设置、改底部信息行的 /statusline 混淆。它们各管一处:

命令	改什么	配置位置	备注
`/theme`	整体配色主题(含色盲友好与 ANSI-only 变体)	`settings.json` 的 `theme` / 自定义主题文件	自定义主题需 v2.1.118+
`/statusline`	终端底部状态行内容	`settings.json` 的 `statusLine`(指向脚本)	内容由脚本决定,非配色
终端自身配置 / `/vim`	字体、键位、编辑模式	终端配置 / `editorMode`	不影响 Claude Code 配色

记忆法:颜色用 /theme,底部信息用 /statusline,字体/键位归终端或 /vim。受限终端只支持 16 色时选 dark-ansi / light-ansi,色盲用户选 *-daltonized 变体。

经典使用场景

在白天/夜间切换工作环境时,用 auto 让主题跟随 OS 系统外观自动切换
在使用兼容性较差的老终端(如某些嵌入式或 SSH 环境)时,切换到 dark-ansi / light-ansi 以避免颜色渲染异常
色觉差异用户选择 dark-daltonized / light-daltonized 获得更易区分的配色
为团队或插件发布一致品牌配色时,将自定义主题文件纳入版本控制并通过 plugin 分发

常见坑

混淆"UI 主题"和"终端配色":官方文档明确说明 Claude Code 不控制终端本身的颜色方案。如果终端背景颜色不对,要去终端应用的设置里改,/theme 改不了。
自定义主题 token 错误被静默忽略:官方文档注明"Unknown tokens and invalid color values are ignored",拼错的 token 名或不合法的颜色值不会报错,只会无声无息地使用 base 预设的值。调试时要逐个 token 验证。
v2.1.118 版本要求:自定义主题功能需要 v2.1.118 及以上版本,旧版本中 /theme 选择器里不会出现 New custom theme… 入口。
auto 模式依赖终端背景检测:如果终端无法被正确识别浅色/深色背景,auto 检测可能失败,此时建议手动选择 dark 或 light。

来源

全网调研整理

典型场景

终端背景为浅色时，切换 light/light-ansi 主题防止文字与背景混淆
存在红绿色觉障碍时，选用 daltonized 系主题，改用蓝黄色对比替代红绿
使用老旧终端（不支持 24-bit 真彩色）时，选 dark-ansi/light-ansi 只用 16 色 ANSI 调色板
在 macOS 开启深色/浅色自动切换时，选 auto 模式让 Claude Code 跟随系统外观实时变换
团队成员间共享统一视觉风格时，将自定义主题 JSON 纳入项目 dotfiles 分发

实用技巧

在交互选择器中上下移动光标即可实时预览主题效果，按 Esc 取消并回滚，无需确认
也可通过 `/config` 的主题选择器入口切换主题，效果与 `/theme` 相同
启动时传入命令自动设置：`claude "/color yellow"` 并写成 shell alias，实现多窗口按项目着色
自定义主题存为 `~/.claude/themes/<slug>.json`，运行中修改文件会被热重载，无需重启
子 agent 颜色用 `<color>_FOR_SUBAGENTS_ONLY` token 单独控制，不影响主界面配色
自定义主题中 `shimmer` 配对 token（如 `claudeShimmer`）控制 spinner 动画渐变色，需与基础色搭配

常见坑

Apple Terminal 对 24-bit RGB 支持差，Claude Code 会自动降级到 256 色，推荐改用 iTerm2/Ghostty/Kitty
`/theme` 修改的是全局配色方案，`/color` 修改的仅是当前 session 的 agent 标识色，两者不可混淆
自定义主题需要 Claude Code v2.1.118 或更高版本，旧版本 `/theme` 列表中不会出现「新建自定义主题」选项

来源

最早记录ⓘ

≤v2.0.73

变化时间线(按版本倒序)

修复v2.1.147· 2026/05/22 · 2026/05/22

修复 Esc 键不响应的问题

改进v2.1.118· 2026/04/23 · 2026/04/23

现在可从 /theme 创建和切换命名的自定义主题，或手动编辑 ~/.claude/themes/ 中的 JSON 文件

改进v2.1.111· 2026/04/16 · 2026/04/16

新增 Auto (match terminal) 选项

改进v2.0.74· 2025/12/20 · 2025/12/20

添加 ctrl+t 快捷键切换语法高亮，改进主题选择器 UI

改进v2.0.73· 2025/12/19 · 2025/12/19

改进了命令以直接打开主题选择器

本页目录13

Slash 命令看官方文档

更改终端配色主题和样式

深度使用指南

最近核查 2026-06-27

· 来源 2 个

code.claude.comConfigure your terminal for Claude Code — code.claude.com
code.claude.comCommands — code.claude.com

· 含官方文档· v2.1.195已交叉核查

它到底是什么

注意:Claude Code 只控制自身 UI 的配色,不修改终端本身的颜色方案(终端颜色由终端应用程序负责)。

怎么触发 / 怎么使用

1. 直接打开交互式选择器

在任意会话中输入:

/theme

2. 通过 `/config` 进入

/config 内置了同一个主题选择器入口,效果与 /theme 完全相同。

内置主题一览

值	说明
`auto`	自动检测终端背景明暗,跟随 OS 外观切换
`dark`	深色主题(默认)
`light`	浅色主题
`dark-daltonized`	深色 + 色盲友好(针对红绿色盲优化)
`light-daltonized`	浅色 + 色盲友好
`dark-ansi`	深色,仅使用 16 种标准 ANSI 颜色
`light-ansi`	浅色,仅使用 16 种标准 ANSI 颜色

auto 会自动检测终端的浅色或深色背景来判断深浅(官方文档:"detects your terminal's light or dark background")。

自定义主题

需要 Claude Code v2.1.118 或更新版本。

在 /theme 选择器底部选择 New custom theme… 可交互式创建主题:命名后逐个挑选颜色 token 覆盖。选中已有自定义主题时按 Ctrl+E 进入编辑。

每个自定义主题是 ~/.claude/themes/ 目录下的一个 JSON 文件,文件名(去掉 .json)即为 slug。选中自定义主题后,配置中存储的格式为 custom:<slug>。

自定义主题文件格式

{
  "name": "Dracula",
  "base": "dark",
  "overrides": {
    "claude": "#bd93f9",
    "error": "#ff5555",
    "success": "#50fa7b"
  }
}

字段	类型	说明
`name`	string	选择器中显示的名称,默认为文件名 slug
`base`	string	继承的内置预设,默认为 `dark`
`overrides`	object	颜色 token 到颜色值的映射

颜色值格式支持:#rrggbb、#rgb、rgb(r,g,b)、ansi256(n)、ansi:<name>(如 red、cyanBright)。

可覆盖的 color token 分类(精选)

分类	代表 token
品牌与文字	`claude`、`text`、`inactive`、`subtle`、`suggestion`
状态色	`success`、`error`、`warning`
输入框与模式	`promptBorder`、`planMode`、`autoAccept`、`bashBorder`
Diff 渲染	`diffAdded`、`diffRemoved`、`diffAddedWord`、`diffRemovedWord`
全屏模式	`userMessageBackground`、`selectionBg`
使用量计量	`rate_limit_fill`、`rate_limit_empty`

Claude Code 监听 ~/.claude/themes/ 目录,文件变动后无需重启即自动生效。

保存 / 配置

主题偏好全局保存在 ~/.claude/(内置主题存储值名,自定义主题存储 custom:<slug>),不支持按项目单独设置。

跟同类"外观"原语对比

/theme 调的是配色,容易和改字体/键位的终端设置、改底部信息行的 /statusline 混淆。它们各管一处:

命令	改什么	配置位置	备注
`/theme`	整体配色主题(含色盲友好与 ANSI-only 变体)	`settings.json` 的 `theme` / 自定义主题文件	自定义主题需 v2.1.118+
`/statusline`	终端底部状态行内容	`settings.json` 的 `statusLine`(指向脚本)	内容由脚本决定,非配色
终端自身配置 / `/vim`	字体、键位、编辑模式	终端配置 / `editorMode`	不影响 Claude Code 配色

经典使用场景

在白天/夜间切换工作环境时,用 auto 让主题跟随 OS 系统外观自动切换
在使用兼容性较差的老终端(如某些嵌入式或 SSH 环境)时,切换到 dark-ansi / light-ansi 以避免颜色渲染异常
色觉差异用户选择 dark-daltonized / light-daltonized 获得更易区分的配色
为团队或插件发布一致品牌配色时,将自定义主题文件纳入版本控制并通过 plugin 分发

常见坑

混淆"UI 主题"和"终端配色":官方文档明确说明 Claude Code 不控制终端本身的颜色方案。如果终端背景颜色不对,要去终端应用的设置里改,/theme 改不了。
自定义主题 token 错误被静默忽略:官方文档注明"Unknown tokens and invalid color values are ignored",拼错的 token 名或不合法的颜色值不会报错,只会无声无息地使用 base 预设的值。调试时要逐个 token 验证。
v2.1.118 版本要求:自定义主题功能需要 v2.1.118 及以上版本,旧版本中 /theme 选择器里不会出现 New custom theme… 入口。
auto 模式依赖终端背景检测:如果终端无法被正确识别浅色/深色背景,auto 检测可能失败,此时建议手动选择 dark 或 light。

来源

全网调研整理

典型场景

终端背景为浅色时，切换 light/light-ansi 主题防止文字与背景混淆
存在红绿色觉障碍时，选用 daltonized 系主题，改用蓝黄色对比替代红绿
使用老旧终端（不支持 24-bit 真彩色）时，选 dark-ansi/light-ansi 只用 16 色 ANSI 调色板
在 macOS 开启深色/浅色自动切换时，选 auto 模式让 Claude Code 跟随系统外观实时变换
团队成员间共享统一视觉风格时，将自定义主题 JSON 纳入项目 dotfiles 分发

实用技巧

在交互选择器中上下移动光标即可实时预览主题效果，按 Esc 取消并回滚，无需确认
也可通过 `/config` 的主题选择器入口切换主题，效果与 `/theme` 相同
启动时传入命令自动设置：`claude "/color yellow"` 并写成 shell alias，实现多窗口按项目着色
自定义主题存为 `~/.claude/themes/<slug>.json`，运行中修改文件会被热重载，无需重启
子 agent 颜色用 `<color>_FOR_SUBAGENTS_ONLY` token 单独控制，不影响主界面配色
自定义主题中 `shimmer` 配对 token（如 `claudeShimmer`）控制 spinner 动画渐变色，需与基础色搭配

常见坑

Apple Terminal 对 24-bit RGB 支持差，Claude Code 会自动降级到 256 色，推荐改用 iTerm2/Ghostty/Kitty
`/theme` 修改的是全局配色方案，`/color` 修改的仅是当前 session 的 agent 标识色，两者不可混淆
自定义主题需要 Claude Code v2.1.118 或更高版本，旧版本 `/theme` 列表中不会出现「新建自定义主题」选项

来源

最早记录ⓘ

≤v2.0.73

变化时间线(按版本倒序)

修复v2.1.147· 2026/05/22 · 2026/05/22

修复 Esc 键不响应的问题

改进v2.1.118· 2026/04/23 · 2026/04/23

现在可从 /theme 创建和切换命名的自定义主题，或手动编辑 ~/.claude/themes/ 中的 JSON 文件

改进v2.1.111· 2026/04/16 · 2026/04/16

新增 Auto (match terminal) 选项

改进v2.0.74· 2025/12/20 · 2025/12/20

添加 ctrl+t 快捷键切换语法高亮，改进主题选择器 UI

改进v2.0.73· 2025/12/19 · 2025/12/19

改进了命令以直接打开主题选择器

深度使用指南

它到底是什么

怎么触发 / 怎么使用

1. 直接打开交互式选择器

2. 通过 /config 进入

内置主题一览

自定义主题

自定义主题文件格式

可覆盖的 color token 分类(精选)

保存 / 配置

跟同类"外观"原语对比

经典使用场景

常见坑

来源

全网调研整理

变化时间线(按版本倒序)

深度使用指南

它到底是什么

怎么触发 / 怎么使用

1. 直接打开交互式选择器

2. 通过 /config 进入

内置主题一览

自定义主题

自定义主题文件格式

可覆盖的 color token 分类(精选)

保存 / 配置

跟同类"外观"原语对比

经典使用场景

常见坑

来源

全网调研整理

变化时间线(按版本倒序)

2. 通过 `/config` 进入

2. 通过 `/config` 进入