본문으로 건너뛰기

© 2026 Molayo

Qiita헤드라인2026. 06. 30. 14:31

Claude Code의 「〜ing...」 스피너 메시지 완전 정리 및 커스터마이징 방법

요약

Claude Code의 터미널 스피너 메시지인 'spinnerVerbs'의 작동 원리와 커스터마이징 방법을 설명합니다. 사용자는 설정 파일을 직접 수정하거나 Claude에게 요청하여 스피너 동사를 원하는 테마로 교체할 수 있습니다.

핵심 포인트

  • 스피너 동사는 Claude의 에이전트 루프 단계별로 무작위 표시됨
  • settings.json의 spinnerVerbs 설정을 통해 replace 또는 append 모드 지원
  • Claude Code에게 직접 명령하여 테마별 동사 리스트 자동 생성 가능
  • 2,500개 이상의 다양한 테마 컬렉션 활용 가능

Claude Code를 사용하다 보면, 처리 중에 터미널의 스피너(spinner)에 다음과 같은 메시지가 표시되는 것을 발견하신 분들이 많을 것입니다.

⠋ Considering...
⠙ Crafting...
⠹ Architecting...

이것들은 spinnerVerbs (스피너 동사)라고 불리는 기능으로, Claude가 사고하거나 도구(tool)를 실행하는 동안 무작위로 선택된 동사가 표시되는 구조입니다. 기본적으로 185개의 동사가 준비되어 있으며, ~/.claude/settings.json에서 자유롭게 커스터마이징할 수 있습니다.

이 기사에서는 기본 ~ing... 메시지 목록과 오리지널 테마로 교체하는 방법을 정리합니다.

항목버전
Claude Code최신 버전 (2026년 6월 시점)
...
Claude Code v2.1.42 시점의 전체 185개 단어입니다. 알파벳 순으로 게재하고 있습니다.
동사일본어 번역동사일본어 번역
Accomplishing달성 중Actioning실행 중
...
포인트: 이 동사들은 Claude가 도구를 호출할 때마다 무작위로 선택됩니다. Flibbertigibbeting이나 Prestidigitating 등 무심코 웃음이 터지는 단어도 포함되어 있어, 장시간 작업 중의 단조로움을 완화하려는 의도가 담겨 있습니다.

스피너는 Claude Code의 에이전트 루프 (Agent Loop) (Gather Context → Take Action → Verify Results)의 각 페이스에서 표시됩니다.

페이스대응하는 도구 예시표시 타이밍
컨텍스트 수집Read, Glob, Grep파일 읽기·검색 중
액션 실행Edit, Write, Bash파일 편집·명령 실행 중
결과 확인Bash (테스트 실행)테스트·검증 중
Web 조작WebSearch, WebFetch검색·페이지 취득 중
서브 에이전트Agent별도 컨텍스트에서의 처리 중

~/.claude/settings.jsonspinnerVerbs 블록을 추가하기만 하면 됩니다.

모드동작
replace기본 185개 단어를 모두 교체
append기본 단어에 추가
{
"spinnerVerbs": {
"mode": "replace",
...
{
"spinnerVerbs": {
"mode": "replace",
...
{
"spinnerVerbs": {
"mode": "append",
...

~/.claude/settings.json을 연다 -
spinnerVerbs 블록을 추가한다 - Claude Code를 재시작한다

이상이면 다음 처리부터 커스텀 동사가 표시됩니다.

설정 파일을 직접 편집하지 않고도 Claude Code 자신에게 부탁하는 방법도 있습니다.

스피너 동사를 프로그래밍 용어 테마로 변경해 주세요.
~/.claude/settings.json을 직접 업데이트해 주세요.

이렇게 지시하면 Claude Code가 테마에 맞는 동사 리스트를 생성하여 settings.json에 써줍니다.

자원봉사자들이 작성한 2,500개 이상의 스피너 동사 컬렉션이 공개되어 있습니다. 98개의 테마 카테고리로 분류되어 있어 그대로 사용할 수 있습니다.

항목내용
기능명spinnerVerbs
...replace (전체 교체) / append (추가)
반영 방법Claude Code를 재시작

작은 커스터마이징이지만, 장시간 작업 중에 「Baking...」이나 「Noodling...」 같은 의외의 동사가 나오면 조금 즐거워집니다. 꼭 자신만의 테마로 시도해 보세요.

  • Claude Code의 작동 방식 - Claude Code Docs
  • 도구 참조 (Tools reference) - Claude Code Docs
  • 내가 Claude Code의 사고 표시기(Thinking Indicator)를 원피스 어드벤처로 바꾼 방법
  • claude-code-spinner-verbs (GitHub)

이 기사가 도움이 되었다면, 꼭 좋아요 ❤️ 를 부탁드립니다!

또한, 앞으로도 Claude Code나 AI 개발 도구에 관한 기사를 계속해서 게시할 예정이니, 팔로우 도 기다리고 있겠습니다 🙏

AI 자동 생성 콘텐츠

본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0