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

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

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

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

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

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

{
"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개의 테마 카테고리로 분류되어 있어 그대로 사용할 수 있습니다.

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

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

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

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