スピナーって何?Claude Codeの「考え中」表示

スピナーは「いま作業中です」のサイン

Claude Codeにお願いごとをすると、答えが返ってくるまでの間、ターミナルの中でくるくると回るような記号や、点滅するマークが表示されます。これがスピナーです。名前のとおり「spin(回る)」から来ていて、処理が進行中であることを知らせるためのインジケーターですね。

身近な例えでいうと、エレベーターのボタンを押したあとに光るランプみたいなものです。ランプが光っていれば「押せてる、いま来てる途中だ」と分かるので、何度も連打しなくて済みます。逆にランプが何も光らなかったら、押せたのか押せてないのか分からなくて不安になりますよね。スピナーもそれと同じで、「入力はちゃんと受け付けたし、いま内部で作業しています」という合図を送り続けてくれています。

なぜCUIツールにスピナーが必要なのか

ブラウザで動くWebサービスなら、ローディングのアニメーションが出たり、ボタンがグレーアウトしたり、画面の見た目でいろいろ状態を伝えられます。でもターミナルは基本的に文字しか出せません。何も出力がない黒い画面をじっと見ていると、動いているのか、それとも固まってしまったのか、判断がつかないんです。

正直、自分も最初にCLIツールを使い始めたころは「反応がない=エラーで止まった」と勘違いして、まだ処理中なのにCtrl+Cで強制終了してしまったことが何度かあります。スピナーは、この「無音の不安」を埋めるためにあります。回り続けている限り、少なくともプロセスは生きていると分かる。それだけで待つ心の余裕がぜんぜん違います。

スピナーが出ている間、ユーザーは何をすればいい?

基本的には待つだけです。特に何か操作をする必要はありません。ただ、いくつか知っておくと落ち着いて付き合えるポイントがあります。

• スピナーが回っている=処理が進行中。焦って同じ指示を送り直す必要はない
• 止めたいときは、ターミナルの一般的な中断操作(Ctrl+Cなど)で処理をキャンセルできる
• 回り続けている時間が長い場合、単に扱っている作業量が多いだけということもある

特に、大きなコードベースを読み込ませたり、複数のファイルにまたがる修正を頼んだりすると、返答が返るまでにそれなりの時間がかかります。そういうときスピナーは「まだ諦めてないよ」というメッセージでもあるわけです。

「なんとなく回ってるだけ」ではない

スピナーはただの飾りに見えて、実は使い勝手を左右する地味に重要なパーツです。ソフトウェアの世界では昔から「1秒以上かかる処理には何らかの進行表示を出すべき」といった経験則が語られてきました。人は待たされること自体よりも、あとどれくらい待つのか分からないことにストレスを感じるからです。

似たような表示との違い

進行状況を伝える表示にはいくつか種類があって、それぞれ役割が違います。混同しやすいので、ざっくり整理しておきます。

表示	伝えること	向いている場面
スピナー	処理中であること(残り時間は不明)	完了までの時間が読めない処理
プログレスバー	全体のうちどこまで進んだか	ファイル数など総量が分かっている処理
ログ出力	いま何をしているかの具体的な中身	途中経過を追いたい処理

Claude Codeのように「どれくらいの分量を読んで、どれくらい考えるか」が事前に確定しない処理では、パーセンテージを出しようがありません。だからスピナーという形が選ばれるわけです。

覚えておくと得なこと

スピナーが見えたら、いったん手を止めてコーヒーでも淹れてくるくらいの気持ちでいるのがちょうどいいと思います。逆に、待っている間に別の指示を打ち込んでおきたくなる気持ちも分かるんですが、まずは一つの応答が返ってきてから次に進むほうが、結果的に会話の流れが崩れにくいです。

ターミナルの黒い画面で回っている小さな記号は、地味だけど「対話がちゃんと成立している」ことの証拠。そう思って眺めると、待ち時間も少しだけ気楽になります。