---
title: "clawd-spinner"
url: "https://claudemods.dev/ko/builds/clawd-spinner-ed9d3d"
source: "https://github.com/saiharsha03/clawd-spinner"
source_type: "github"
repo: "https://github.com/saiharsha03/clawd-spinner"
author: "saiharsha03"
author_handle: "saiharsha03"
stars: 3
category: "사용량 및 비용"
categories: ["cost"]
tags: ["Claude Code", "mod"]
permission_level: 0
scan_complete: true
install: "claude plugin marketplace add saiharsha03/clawd-spinner\nclaude plugin install clawd-spinner@clawd-spinner"
added: "2026-10-03T12:01:43.266Z"
updated: "2026-10-03T08:15:44Z"
locale: "ko"
content_locale: "ko"
---

# clawd-spinner

clawd-spinner: Claude가 작업하는 동안 Clawd가 spinner 단어를 위에서 연기합니다. Sautéing에서는 요리하고 Vibing에서는 춤추며 pacin

## Description

# clawd-spinner

Claude Code mod입니다. Claude가 작업하는 동안 Clawd가 spinner 줄 위에서 spinner 단어를 연기합니다.

**사용량을 전혀 쓰지 않습니다.** 모든 장면은 코드로 로컬에서 그립니다. 모델 호출도, 토큰도, 네트워크도 없습니다. 사용량은 중요한 일에 쓸 수 있습니다.

- Claude Code의 spinner 단어 189개에는 각각 고유한 장면이 있습니다. *Baking*에서는 빵을 오븐에 밀어 넣고, *Beaming*에서는 UFO가 들어 올리며, *Gitifying*에서는 커밋 그래프를 그리고, *Honking*에서는 경적을 울립니다.
- 나중에 Claude Code가 추가하는 단어는 11가지 일반 동작(요리, 생각, 춤, 만들기 등) 중 하나로 대체됩니다.
- Clawd는 머리 옆 말풍선으로 자신이 하는 일을 이야기합니다. 말풍선은 장면 속에서 Clawd를 따라가며 글자가 하나씩 나타납니다. 《Project Hail Mary》의 Rocky처럼 말합니다. 질문은 끝에 ", question?"가 붙고, 같은 말을 3번 하면 강한 의미가 되며("Hot hot hot."), 짧은 단어는 빠집니다.
- 단어마다 전용 대사가 10줄씩 있고 총 1,890줄이며, 어떤 두 단어도 같은 줄을 공유하지 않습니다. *Baking*: "Oven very hot. Clawd wait." *Gitifying*: "Merge conflict, question? Ugh." 10초마다 다음 줄로 넘어가고 턴마다 시작 위치가 달라집니다. 한 번도 본 적 없는 단어에는 그 단어를 중심으로 스무 줄을 만듭니다("Big word. Small Clawd. Defenestrating!").
- 조용히 하고 싶다면 `/clawd-talk`로 말풍선을 끌 수 있고 다시 켤 수도 있습니다. `/clawd-talk off` 또는 `/clawd-talk on`으로 설정합니다. 선택은 세션 사이에 기억됩니다.

## 단어가 장면을 고르는 방식

Claude Code는 턴마다 무작위 spinner 단어를 고릅니다. `hooks/frame.ts`가 `hooks/scenes/`에서 단어를 찾습니다(단어마다 장면 하나). 모르는 단어는 `hooks/acts.ts`의 `actFor()`로 넘어가 stem 목록(`saut|whisk|brew…` → 요리 등)과 대조합니다.

대사는 `hooks/lines.ts`에 단어를 키로 저장되어 있습니다. `hooks/rocky.ts`가 하나를 고르고, 본 적 없는 단어에는 스무 줄을 준비합니다. `hooks/frame.ts`의 `bubble()`은 `clawd()`가 마지막으로 Clawd를 배치한 위치에 말풍선을 그립니다.

## 설치

```
/plugin marketplace add https://github.com/saiharsha03/clawd-spinner.git
/plugin install clawd-spinner@clawd-spinner
```

그다음 `/reload-plugins`를 실행하거나 Claude Code를 다시 시작하세요. 이 HTTPS 링크는 GitHub SSH 키가 있어도 없어도 작동합니다. 짧은 형식인 `saiharsha03/clawd-spinner`는 먼저 SSH를 시도할 수 있습니다. clone한 디렉터리에서는 `claude --plugin-dir ./clawd-spinner`로 실행할 수도 있습니다.

업데이트하려면 `/plugin marketplace update clawd-spinner`를 실행한 뒤 `/plugin update clawd-spinner@clawd-spinner`를 실행합니다.

Claude Code 2.1.287 이상(mods는 이 버전부터 기본 활성화)이 필요합니다. 터미널 전용이며 창 너비가 최소 54열이어야 합니다.

## Install

```
claude plugin marketplace add saiharsha03/clawd-spinner
claude plugin install clawd-spinner@clawd-spinner
```

## Original README

# clawd-spinner

A Claude Code mod: while Claude works, Clawd acts out the spinner word above the spinner line.

**It won't use any of your usage.** Every scene is drawn locally from code: no model calls, no tokens,
no network. Your usage goes to the things that matter.

- Every one of Claude Code's 189 spinner words has its own scene: *Baking* slides bread into an oven,
  *Beaming* gets pulled up by a UFO, *Gitifying* draws a commit graph, *Honking* honks.
- A word a later Claude Code adds falls back to one of 11 general acts (cook, think, dance, build, …).
- Clawd talks about what he's doing, in a speech bubble beside his head that follows him around the
  scene and types itself out. He talks like Rocky from *Project Hail Mary*: a question ends in
  ", question?", a word said three times means a lot ("Hot hot hot."), and small words get dropped.
- Every word has ten lines of its own, 1,890 in all, and no two words share a line. *Baking*:
  "Oven very hot. Clawd wait." *Gitifying*: "Merge conflict, question? Ugh." He moves on to the next
  line every 10 seconds, starting somewhere different each turn. A word he has never seen gets
  twenty lines built around it ("Big word. Small Clawd. Defenestrating!").
- Rather have him quiet? `/clawd-talk` turns his speech bubble off (and on again); `/clawd-talk off`
  or `/clawd-talk on` sets it. The choice is remembered across sessions.

## How a word picks its scene

Claude Code picks a random spinner word each turn. `hooks/frame.ts` looks the word up in
`hooks/scenes/` (one scene per word); an unknown word goes to `actFor()` in `hooks/acts.ts`, which
matches stem lists (`saut|whisk|brew…` → cook, …).

His lines are in `hooks/lines.ts` (keyed by the word); `hooks/rocky.ts` picks one and holds the
twenty for unseen words; `bubble()` in `hooks/frame.ts` draws it where `clawd()` last put him.

## Install

```
/plugin marketplace add https://github.com/saiharsha03/clawd-spinner.git
/plugin install clawd-spinner@clawd-spinner
```

Then `/reload-plugins` (or restart Claude Code). The HTTPS link works with or without SSH keys for
GitHub; the short form `saiharsha03/clawd-spinner` may try SSH first. Or from a clone:
`claude --plugin-dir ./clawd-spinner`.

To update: `/plugin marketplace update clawd-spinner`, then `/plugin update clawd-spinner@clawd-spinner`.

Needs Claude Code 2.1.287 or newer (mods are on by default from there). Terminal only, in a window at
least 54 columns wide; narrower, the stock spinner shows. On Windows, a "Filename too long" error
while adding the marketplace goes away after `git config --global core.longpaths true`.

## What the hooks do

`hooks/register.tsx` hooks five events and only reads them; it never changes what they carry:

- `session.start`: in an interactive session, reads whether his speech is on, registers `/clawd-talk`,
  and starts a timer that repaints the animation about 12 times a second.
- `command.run` for `/clawd-talk`: turns his speech bubble off or on and remembers the choice.
- `turn.start`: notes when the turn began, so the scene's clock starts at 0 (a subagent's turn doesn't restart it).
- `turn.complete`: stops the animation when the main turn ends.
- `ui.render` on the `Spinner` component: draws Clawd, and his speech bubble, above the spinner line. Below 54 columns, or outside
  the terminal, it hands the spinner back to Claude Code unchanged.

## Privacy: what data it sends

None. The mod reads only the spinner word and the turn's elapsed time that Claude Code hands it,
and draws in the terminal. Every line Clawd says is written into the mod; none is generated. It makes no network requests, no model calls, reads and writes no files,
and stores one thing: whether you turned his speech off (`talk`, in Claude Code's own plugin store). There is no remote server, so there is no privacy policy to link.

## Develop

```
claude plugin validate .
claude plugin test .
npx tsx scripts/preview.ts preview.png Baking Beaming   # PNG contact sheet
```

`/plugin-types .claude-plugin/types` regenerates the editor typings (git-ignored).

## Credits

Spinner word list: [shanraisshan/claude-code-best-practice](https://github.com/shanraisshan/claude-code-best-practice)
(`reports/claude-spinner-verbs-and-tips.md`). Clawd is Anthropic's mascot; this is an unofficial fan mod.

MIT licensed.
