Cmd. /theme
Claude Code 색상 테마를 전환하고 custom theme을 만드는 명령
핵심 요약
- 내장·custom theme 선택
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
내장·custom theme 선택
/theme사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/theme# 테마 선택기 열기 (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은 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는 터미널 애플리케이션 자체의 색상 스킴은 건드리지 않으니, 그 부분은 터미널 앱에서 설정해야 합니다.
주의사항
- 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는 터미널 앱 자체의 색상 스킴을 제어하지 않습니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록