---
title: "clawd-spinner"
url: "https://claudemods.dev/zh-tw/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: "zh-tw"
content_locale: "zh-tw"
---

# clawd-spinner

clawd-spinner：Claude 工作時，Clawd 會在 spinner 文字上方演出對應動作：Sautéing 時做菜，Vibing 時跳舞，pacin

## Description

# clawd-spinner

一個 Claude Code mod：Claude 工作時，Clawd 會在 spinner 那行上方演出 spinner 文字。

**它不會耗用你的用量。** 每個場景都由程式碼在本機繪製：沒有模型呼叫、沒有 token，也沒有網路。你的用量留給真正重要的事情。

- Claude Code 的 189 個 spinner 文字各有自己的場景：*Baking* 會把麵包滑進烤箱，*Beaming* 會被 UFO 拉起來，*Gitifying* 會畫提交圖，*Honking* 會按喇叭。
- Claude Code 之後新增的文字會回退到 11 個通用動作之一（做菜、思考、跳舞、建造……）。
- 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()`，它透過詞幹清單比對（`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 key 都能使用；短格式 `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.
