Cmd. /theme
Claude Code 색상 테마를 전환하고 custom theme을 만드는 명령
핵심 요약
/theme은 색상 테마를 전환하며auto, light/dark, daltonized(색각 보정), ANSI, custom theme을 제공합니다.- custom theme(
New custom theme…,~/.claude/themes/, plugin 테마)은 Claude Code v2.1.118 이상에서만 동작합니다. - custom theme은
name·base·overrides세 필드로 된 JSON 파일이며, 잘못된 토큰·색상 값은 무시하므로 렌더링이 깨지지 않습니다. - plugin 제공 테마는 read-only이며
Ctrl+E로~/.claude/themes/에 사본을 복사해 편집합니다.
명령어 원본 선언
/theme공식 설명 요약
/theme은 Claude Code의 색상 테마(color theme)를 전환하는 명령입니다. 공식 문서가 설명하는 선택지는 다음과 같습니다.
auto: 터미널의 light/dark 배경을 감지해 자동으로 맞춥니다. 터미널이 OS 외형(appearance) 변화를 따라가면 테마도 함께 따라갑니다.- light / dark variant: 밝은 테마와 어두운 테마 변형.
- colorblind-accessible (daltonized) 테마: 색각 이상 사용자를 위한 보정 테마.
- ANSI 테마: 터미널 자체의 색상 팔레트(color palette)를 사용하는 테마.
- custom theme:
~/.claude/themes/의 사용자 정의 테마와 설치된 plugin이 제공하는 테마.
목록 끝의 New custom theme… 를 선택하면 대화형으로 새 테마를 만듭니다. 참고로 Claude Code는 터미널 애플리케이션 자체의 색상 스킴은 건드리지 않으니, 그 부분은 터미널 앱에서 설정해야 합니다.
최소 지원 버전
/theme명령 자체에 명시된 최소 버전은 공식 문서에 별도로 기재되어 있지 않습니다.- custom theme(
~/.claude/themes/또는 plugin 제공 테마, New custom theme… 흐름)은 공식 문서가 Claude Code v2.1.118 이상을 요구한다고 명시합니다.
사용법
# 테마 선택기 열기 (built-in 프리셋 + 사용자/플러그인 custom theme 목록)
/theme
# /config 의 theme picker 로도 동일하게 전환 가능
/configcustom theme을 다룰 때:
- 목록에서 New custom theme… 를 선택하면 이름을 짓고 색상 토큰(color token)을 하나씩 골라 덮어쓰는 방식으로 새 테마를 만듭니다.
- custom theme이 강조된 상태에서
Ctrl+E를 누르면 해당 테마를 편집합니다. (plugin이 제공하는 테마는 read-only이며,Ctrl+E는 그 테마를~/.claude/themes/로 복사해 사본을 편집하게 합니다.)
custom theme 파일 구조
각 custom theme은 ~/.claude/themes/의 JSON 파일입니다. .json 확장자를 뺀 파일명이 테마 slug이며, 그 테마를 선택하면 설정에 custom:<slug>가 저장됩니다. plugin 제공 테마를 선택하면 custom:<plugin-name>:<slug> 형식으로 저장됩니다. 파일에는 다음 세 개의 선택 필드를 둘 수 있습니다.
| 필드 | 타입 | 설명 |
|---|---|---|
name | string | /theme에 표시되는 라벨. 기본값은 파일명 slug. |
base | string | 시작점이 되는 built-in 프리셋: dark, light, dark-daltonized, light-daltonized, dark-ansi, light-ansi. 기본값은 dark. |
overrides | object | 색상 토큰 이름 → 색상 값 맵. 여기에 없는 토큰은 base 프리셋 값을 그대로 사용. |
색상 값은 #rrggbb, #rgb, rgb(r,g,b), ansi256(n), ansi:<name>(16개 표준 ANSI 색상 이름, 예: red, cyanBright)를 허용합니다. 알 수 없는 토큰과 잘못된 색상 값은 무시되므로 오타가 렌더링을 깨뜨리지 않습니다.
// ~/.claude/themes/dracula.json
{
"name": "Dracula",
"base": "dark",
"overrides": {
"claude": "#bd93f9",
"error": "#ff5555",
"success": "#50fa7b"
}
}Claude Code는 ~/.claude/themes/를 감시하므로 파일을 수정하면 재시작 없이 실행 중인 세션에 즉시 반영됩니다.
좋은 사용 예
- 터미널 배경에 맞춰
autotheme 선택 (OS 외형 변화 자동 추종) - 팀 데모용으로 가독성 높은 dark/light theme 고정
- 색각 이상 사용자를 위해 daltonized theme 적용
- plugin으로 배포한 조직 theme 검증
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/theme | 전체 색상 theme 관리 + custom theme 생성 | 장기 UI 환경 설정 |
/color | 현재 세션의 prompt bar 색상만 설정 (테마 아님) | 세션 구분/임시 강조 |
/config | Settings UI 진입점 (theme picker 포함, alias /settings) | theme 외 일반 설정까지 조정 |
/color [color\|default]는 현재 세션의 prompt bar 색상만 바꾸며red,blue,green,yellow,purple,orange,pink,cyan을 지원합니다. 인자 없이 실행하면 무작위 색을 고르고,default로 초기화합니다. (Remote Control 연결 시 색상이 claude.ai/code로 동기화됩니다.)
활용 사례
- 프로덕션 관련 세션은 고대비 theme으로 운영
- pair programming 환경에서 화면 공유에 맞는 theme 선택
- 색각 이상 동료를 배려한 daltonized theme 표준화
- plugin 배포 전 theme manifest 검증
주의사항
- custom theme(
New custom theme…,~/.claude/themes/, plugin 테마)은 Claude Code v2.1.118 이상에서만 동작합니다. - plugin 테마는 read-only입니다. 수정하려면
Ctrl+E로~/.claude/themes/에 복사한 사본을 편집해야 합니다. - plugin manifest에서
themes는 experimental component로 분류됩니다. 공식 문서는 top-level 선언도 아직 동작하지만claude plugin validate가 warning을 내며, 향후 릴리스에서는experimental.themes로 선언하도록 요구할 예정이라고 설명합니다. - Claude Code는 터미널 앱 자체의 색상 스킴을 제어하지 않습니다.
출처
- Commands: https://code.claude.com/docs/en/commands
- Configure your terminal (Match the color theme / Create a custom theme): https://code.claude.com/docs/en/terminal-config
- Plugins reference (Themes): https://code.claude.com/docs/en/plugins-reference