Anthropic 공식 개발자 계정 @ClaudeDevs가 X에 Claude Code 데스크톱의 커스텀 테마 기능을 소개했습니다. 발표 원문은 다음과 같습니다.
You can now build custom themes for Claude Code on desktop with mods! Change the colors, add an animated background, and make it your own. Just tell Claude how you want it to look, or get started quickly with the theme-examples plugin. We'd love to see what you make!
발표 내용 풀이
핵심은 세 가지입니다. 첫째, Claude Code 데스크톱에서 mods(모드)로 커스텀 테마를 만들 수 있습니다. 둘째, 색상을 바꾸고 애니메이션 배경을 추가할 수 있습니다. 셋째, 원하는 모양을 Claude에게 말로 설명하거나, theme-examples 플러그인으로 빠르게 시작할 수 있습니다.
공식 자료에 따르면 theme-examples 플러그인은 데스크톱 창 뒤에 깔리는 20개의 장면(scene)을 제공합니다. 위에서 내려다본 석호, 밤의 산호초, 잉어 연못, 하프톤 일출, 펜 플로터 조수, 종이 정원, 출발 안내판, 점자 점으로 그린 별밭 등이 예로 나옵니다. 각 장면은 밝은 창용 또는 어두운 창용으로 그려졌고 애니메이션이 적용됩니다.
사용자에게 갖는 의미
작업 환경의 겉모습을 프로젝트별 또는 세션별로 바꿀 수 있게 됩니다. 이 플러그인은 데스크톱 창의 배경(backdrop)을 플러그인이 어떻게 다룰 수 있는지 보여 주는 예제이기도 하며, 공식 자료는 읽고, 복사하고, 바꿔 보라고 안내합니다. 직접 테마를 만들려는 사용자에게는 출발점이 됩니다.
어떻게 활용할 수 있나요
시작 조건
- 대상 플랫폼 — Claude Code 데스크톱입니다.
- 필요한 것 — 모드의 배경을 채팅 뒤에 그려 주는 버전의 Claude Desktop이 필요합니다. 아직 배경을 그린다고 알린 창이 없으면 명령은 모두 응답하지만, 이 창이 테마를 아직 그리지 못할 수 있다는 안내가 덧붙습니다. 프로젝트에 적용한 테마는 그래도 저장됩니다.
- 이전 버전 주의 — 이전에 desktop-themes라는 이름으로 설치한 사본이 있다면 먼저 끄라고 안내합니다. 두 플러그인이 같은 명령 이름 두 개를 요구하며, 그때 고른 테마는 넘어오지 않습니다.
실행 절차 (공식 명령 그대로)
/custom-theme
/custom-theme list
/custom-theme <name>
/custom-theme <name> session
/custom-theme off
/custom-theme off session
/fireworks
/fireworks auto off
/fireworks auto on- /custom-theme — 모든 테마를 창 종류별로 묶어 미리보기 버튼과 함께 카드로 보여 줍니다.
- /custom-theme list — 20개 테마 이름을 창 종류별로 나열합니다.
- /custom-theme <name> — 이 프로젝트에 테마를 적용합니다. 자체 선택이 없는 같은 프로젝트의 다른 열린 세션은 다음 턴에 이 테마를 따릅니다. 이름은 목록에 나온 형태나 제목으로, 대소문자 구분 없이 입력할 수 있습니다.
- /custom-theme <name> session — 이 세션에만 적용합니다.
- /custom-theme off — 프로젝트의 테마를 해제합니다.
- /custom-theme off session — 이 세션의 선택만 해제하며 프로젝트 테마는 유지됩니다.
- /fireworks — 테마 위에 짧은 불꽃놀이를 띄웁니다. Claude가 merged라고 말할 때도 한 번 터지며, 한 번에 하나씩만 실행됩니다. /fireworks auto off로 이 자동 실행을 끄고 /fireworks auto on으로 다시 켭니다.
누가 무엇에 쓰나
- 작업 공간을 꾸미려는 사용자 — 프로젝트마다 다른 장면을 지정해 구분할 수 있습니다.
- 직접 만들려는 사용자 — 공식 자료는 이 플러그인을 읽고 복사하고 바꿔 볼 수 있는 예제로 안내합니다. 직접 테마를 만드는 구체적 절차는 공식 자료에서 확인이 필요합니다.
주의점
- 밝은 창과 어두운 창 — 테마마다 대상 창 종류가 정해져 있고, 20개 중 8개는 두 종류가 모두 있습니다. 창이 테마의 종류를 따르는지는 앱과 버전에 달려 있습니다. 앱이 사용자 설정을 유지한다면 맞는 테마를 고르거나 Settings, General, Appearance에서 설정을 바꾸라고 안내합니다.
- 움직임 줄이기 — 시스템이 동작 줄이기를 요청하면 모든 장면이 정지한 그림으로 머물고 불꽃놀이의 폭죽도 숨겨집니다. GPU 가속 없이 그리는 앱에서는 장면의 움직임이 멈춥니다.
- 알려진 한계 — 장면 일부가 채팅 글자, 사이드바, 세션 레일 아래에 놓이며 어떻게 보이는지는 측정되지 않았습니다. 새 세션과 /clear 뒤에는 메시지를 보내기 전까지 테마가 보이지 않고, 보관 세션을 다시 열었을 때도 처음에는 보이지 않습니다. 다른 배경 모드가 설치되어 있으면 미리보기나 불꽃놀이 뒤에 맨 창이 남을 수 있습니다. SSH나 WSL 같은 다른 환경의 세션은 저장된 테마를 공유하지 않습니다.
- 개인정보 — 공식 자료에 따르면 이 플러그인은 Claude의 말에서 merged라는 단어만 확인하고 내용은 보관하지 않으며, 프롬프트 텍스트를 읽지 않고 어디로도 전송하지 않습니다. 선택한 테마 이름은 프로젝트 폴더 경로별로 저장되고, 자체 선택이 있는 세션은 가장 최근 200개까지 보관됩니다.
추가로 확인할 점
- mods 기능 전체의 제공 범위와 개발 방법은 이번 공식 발표 문구에 자세히 담기지 않았습니다.
- 어떤 Claude Desktop 버전부터 모드 배경이 그려지는지는 확인한 자료에 구체적으로 나와 있지 않습니다.
- 제가 확인한 공식 자료는 일부만 포함하고 있어, 한계 항목의 뒷부분은 확인하지 못했습니다.
최신 상태와 자세한 내용은 Anthropic 공식 채널에서 확인하시기 바랍니다.