Claude Codeの画面の見方を押さえる — ターミナルUIの各要素を読み取る方法

黒い画面は 3つの部屋だけ

「画面が動かない…フリーズした?」——その時、Claude Codeはたいていファイルを読み込んでいます。ターミナル画面は謎の文字に埋もれているように見えますが、「入力域」「ツール実行域」「結果表示域」の3つに区切ると、何が起きているかが読めるようになります。Windows環境でこの3つの地図を押さえるだけで、黒い画面への戸惑いはぐっと減ります。

目次

この記事でやること

Claude Codeのターミナル画面に表示される要素を、「入力域」「ツール実行域」「結果表示域」の3つに分けて整理します。この3つさえ見分けられれば、黒い画面で何が起きているかが読み取れます。

画面に文字が次々と流れて、「フリーズした?」「壊れた?」と焦ったことはありませんか? 実はその流れている文字のほとんどは、Claude Codeが仕事をしている証拠です。どこを見れば安心できるか、順番に確かめていきます。

Windows 10/11環境でClaude Codeを動かしている前提で進めます。

使う前に押さえておく前提

次の3点が揃っていれば大丈夫です。

  • Windows 10 または 11 が動いているパソコン
  • Claude Codeがインストール済み(まだならインストール記事を先にどうぞ)
  • Windows Terminal または VS Codeの統合ターミナル

一度でもClaude Codeを動かしたことがあれば、そのまま進んでOKです。

まずはこの3つの領域だけ覚えよう

ターミナル画面は迷路のように見えますが、実は3つの部屋しかありません。

┌─────────────────────────────────────┐
│  [結果表示域]                         │
│  Claude Codeの回答やコードがここに    │
│  表示される                          │
│─────────────────────────────────────│
│  [ツール実行域]                       │
│  ファイル読み込みやコマンド実行の     │
│  進行状況がここに表示される           │
│─────────────────────────────────────│
│  > [入力域] ← ここに指示を書く       │
│  カーソルが点滅している場所           │
└─────────────────────────────────────┘

上が「結果が出る場所」、真ん中が「仕事中の表示」、下が「指示を書き込む場所」です。この3つです。

よくある誤解が「全部出力だから自分ができることはない」と思い込むこと。でも、下にある入力域に文字を打ち込めば、Claude Codeはそれを読んで動き出します。操作するのは基本的にこの一番下の領域だけです。

残りの2つ(ツール実行域・結果表示域)は、Claude Codeが勝手に使う領域です。「何をしているか」「結果は何か」をこの2つから読み取る——それがこの記事の目標です。

どこに書き込めばいい? — 入力域の見方

入力域は、画面の一番下にあります。> 記号の後にカーソルが点滅している場所が入力位置です。

> ここにカーソルが点滅していたら入力できる状態

ここに「こんにちは」と打ち込んで Enterキーを押すと、Claude Codeにメッセージが送られます。これだけで会話が始まります。

入力域か出力域か、見分けるコツ

カーソルが点滅していて文字が打てるなら「入力域」です。逆に、文字が打てない(何も入力されない)場所は出力域です。

初心者によくあるのが、「画面の途中にあるプロンプト記号を見つけてそこに何か打とうとする」ケース。上の方に表示されている >$ は、Claude Codeが実行したコマンドの出力の一部です。入力できるのは一番下の行だけ。

迷ったら、一度画面の一番下までスクロールしてみてください。点滅するカーソルが見つかれば、そこが入力域です。

画面が動かない — ツール実行中の表示を読む

Claude Codeに指示を送った後、画面が数秒〜数十秒動かなくなることがあります。「フリーズした?」と不安になる瞬間ですが、たいていは正常な処理中の画面です。

ファイル読み込み中の表示

⏺ Read file: src/main.py

このように ReadRead file という表示が出たら、Claude Codeがファイルの中身を読んでいる最中です。プロジェクトのファイル数が多いと、この表示が何度も連続して出ます。

コマンド実行中の表示

⏺ Bash command: npm test

BashBash command という表示は、Claude Codeがコマンドを実行している合図です。テストの実行やビルドなど、時間のかかる処理が走っている可能性があります。

「動かない」の見分け方

正常な待機:画面に や読み込み中の表示が出ていて、数十秒以内に次の表示が進む。

応答なしの可能性:何も表示されないまま1分以上経過し、Enterキーを押しても反応がない。この場合は Esc キーを押して中断を試みてください(環境によっては反応しないことがあり、その場合はCtrl+Cも試してみてください)。

Claude Codeが動いている間、画面は沈黙します。最初は「壊れた?」と思いますが、実は一生懸命仕事をしている証拠です。表示が出ているうちは問題ありません。

色でわかる変更内容 — diffの読み方

Claude Codeがコードを書き換えた時、画面に色付きの行が表示されます。これが「diff(差分)」です。色のルールは信号機と同じで、直感的に読めます。

色の意味

  • 緑色の行(先頭に +:追加された行。新しいコードが書き足された
  • 赤色の行(先頭に -:削除された行。古いコードが消された
- console.log("Hello world");       ← 赤色:削除された行
+ console.log("Hello, Claude!");    ← 緑色:追加された行

この例では、「Hello world」が「Hello, Claude!」に書き換えられたことが分かります。

diffが出たら確認する3つのポイント

  1. ファイルパスと行番号:画面上部に --- a/src/main.py のような表示があります。どのファイルの何行目付近が変更されたかを確認します
  2. 赤い行(削除)の内容:消されたコードが意図通りかを見ます。必要なコードが誤って削除されていないかが一番のチェックポイントです
  3. 緑の行(追加)の内容:新しく書き足されたコードが期待通りかを見ます

中でも赤い行(削除された行)の確認が一番大事です。追加はされても、必要なものが消えていると後で困ります。diffが出たら、まず赤い行を確認する習慣をつけてみてください。

赤と黄色のメッセージ — どっちが深刻?

Claude Codeを使っていると、赤い文字や黄色い文字のメッセージに出くわすことがあります。色で深刻度がだいたい分かります。

エラーメッセージ(赤色)

Error: Cannot find module 'express'

赤い文字で ErrorFailed が含まれている場合は、何かが失敗しています。ただし、すべてのエラーが深刻というわけではありません。

  • 無視していいエラー:警告に近いもの。例えば「ファイルが見つかりませんでしたが、別の方法で代用しました」のようなメッセージは、Claude Codeが自力で回避済みです
  • 要対処のエラー:処理が止まってしまい、Claude Codeが先に進めない状態。例えば「権限がありません」や「接続できません」など

警告メッセージ(黄色)

Warning: Deprecated API usage detected

黄色い文字で Warning が出ている場合は、「要注意」のサインです。今すぐ壊れることはありませんが、将来のバージョンで問題になる可能性があります。

警告は悪いことのように思えますが、実は親切な案内板です。「ここ注意してね」と教えてくれているので、赤いエラーほど急いで対処する必要はありません。

深刻かどうかの判断基準

ざっくり言うと、赤+処理が止まったら要対応、赤+処理が続いているなら一旦様子見、黄色ならメモしておく程度でOKです。判断に迷ったら、エラーメッセージをそのままコピーしてClaude Codeに「このエラーはどういう意味?」と聞いてみてください。

5つの画面パターン — 実際にどう見えるか

ここまでの知識をまとめて、よくある5つの画面パターンを押さえておきましょう。

パターン1:Claude Codeに依頼した直後

> バグを修正して

Claude Codeが依頼を受け取りました...

入力域に指示を書き込んでEnterを押した直後。まだ何も始まっていません。この状態で数秒待つと、ツール実行域に表示が出始めます。

パターン2:ファイルを読み込んでいる最中

⏺ Read file: src/app.py
⏺ Read file: src/utils.py
⏺ Read file: tests/test_app.py

Read が連続して表示されるパターンです。Claude Codeが関連するファイルを次々と読み込んでいます。ファイルが多いとこの表示が長く続きますが、問題ありません。

パターン3:コードを書き換えている最中

⏺ Edit file: src/app.py

- old_function()        ← 赤色
+ new_function()         ← 緑色

diff表示が出るパターンです。先ほど説明した緑と赤のルールで変更内容を確認します。この時、赤い行(削除)が意図通りかを最初にチェックしてください。

パターン4:処理が完了して回答が表示された

バグの原因は src/app.py の42行目にありました。
変数名のタイポを修正しました。変更内容を確認してください。

Claude Codeからのメッセージが結果表示域に表示されます。ここまで来たら一連の処理は完了です。

パターン5:エラーが発生した時

Error: Permission denied - /root/config.json

赤いエラーメッセージが表示されるパターンです。先ほどの基準で深刻度を判断し、必要ならメッセージをコピーしてClaude Codeに相談します。


5つ並べましたが、最初に覚えるべきはパターン1(依頼直後)とパターン4(完了)だけです。残りの3つは、実際に遭遇した時にこの記事を見返せばOKです。

自分の環境で確認してみる

試しにClaude Codeを開いて、適当なメッセージを送ってみてください。画面のどこが「入力域」で、どこが「ツール実行域」で、どこが「結果表示域」か——3つの領域が見分けられたら、この記事の目標は達成です。

ここまで読んできて一番大事なことを一つだけ再強調しておきます。diffが出たら、まず赤い行を確認する——この習慣をつけるだけで、Claude Codeとの作業はずっと安心できます。

次のステップとして、実際にClaude Codeに簡単なコード変更を依頼して、diffの緑と赤を自分の目で確かめてみてください。画面の地図を持っていれば、黒い画面はもう怖くありません。

目次