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

「画面が動かない…フリーズした？」——その時、Claude Codeはファイルを読んだり、コマンドを実行したり、応答を組み立てたりしていることが多いです。ターミナル画面は謎の文字に埋もれているように見えますが、この記事では便宜上「入力域」「ツール実行域」「結果表示域」と呼ぶ3つの区画に分けて見ると、何が起きているかが読めるようになります。Windows環境でこの3つの見分け方を押さえるだけで、黒い画面への戸惑いはぐっと減ります。

この記事でやること

Claude Codeのターミナル画面に表示される要素を、この記事内での説明用語として「入力域」「ツール実行域」「結果表示域」の3つに分けて整理します。これらは公式のUI名称ではなく、この記事での便宜的な呼び方です。3つの見分け方ができると、黒い画面で何が起きているかが読み取れます。

画面に文字が次々と流れて、「フリーズした？」「壊れた？」と焦ったことはありませんか？多くの場合、その流れている文字はClaude Codeが処理を進めていることを示しています。どこを見れば安心できるか、順番に確かめていきます。

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

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

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

Windows 10 または 11 が動いているパソコン
Claude Codeがインストール済み（まだならインストール記事を先にどうぞ）
ターミナル環境 — PowerShellやコマンドプロンプトでも動きますが、見やすさの点で 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

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

コマンド実行中の表示

⏺ Bash command: npm test

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

「動かない」の見分け方

正常な待機：画面にツール実行の表示（⏺ など）が出ていて、しばらくすると次の表示に進む。ログが少しずつ増えていれば、処理は動いています。

応答なしの可能性：表示が一切更新されず、しばらく待っても変化がない状態。ツール実行のログも増えないまま止まっているように見える場合は、Esc キーで中断を試みてください（環境によっては効かないことがあり、その場合は Ctrl+C も試してください）。どちらも効かないときは、ターミナルを閉じて開き直すこともできます。

Claude Codeが動いている間、画面が静かな時間があります。ただ、ツール実行の表示やログ更新が続いているなら、処理は進んでいることが多いです。困ったときは /help でヘルプを確認するか、/status で現在の状態をチェックしてみてください。

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

Claude Codeがコードを書き換えた時、画面に色付きの行が表示されることがあります。これが「diff（差分）」です。多くの環境では信号機と同じような色の使い分けがされるため直感的に読めますが、端末のテーマや設定によって色が異なる場合があります。

色の意味

緑色の行（先頭に +）：追加された行。新しいコードが書き足された
赤色の行（先頭に -）：削除された行。古いコードが消された

※ 色は端末テーマにより異なるため、色だけで判断せず + と - の記号も確認してください。

- console.log("Hello world");       ← 赤色で表示されることが多い：削除された行
+ console.log("Hello, Claude!");    ← 緑色で表示されることが多い：追加された行

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

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

ファイルパスや変更箇所の見出し：画面上部に変更対象のファイルパスが表示されることが多いです（例：--- a/src/main.py のような形式。表示内容や形式はバージョンや設定によって異なります）。どのファイルが変更されたかの目安になります
赤い行（削除）の内容：消されたコードが意図通りかを見ます。必要なコードが誤って削除されていないかが重要なチェックポイントです
緑の行（追加）の内容：新しく書き足されたコードが期待通りかを見ます

削除された行（赤）と追加された行（緑）の両方を確認する習慣をつけてみてください。追加だけを見て削除を見落とすと、必要なコードが消えていることに気づかないことがあります。

編集ツールとコマンド実行の違い

Claude Codeによる変更には、主に2つの経路があります。巻き戻しのしやすさが違うので覚えておくと安心です。

編集ツールによる変更（Edit や Write といった表示になることが多い）：Claude Codeが直接ファイルを書き換える操作です。変更内容がdiffとして1行ずつ表示されるため、何が変わったかを確認しやすいです。この経路の変更は、Claude Codeの /rewind コマンドで前の状態に戻せるため、安心感があります
コマンド実行による変更（Bash といった表示になることが多い）：npm install のようなコマンド経由でファイルが追加・変更されるケースです。diffが表示されないことがあり、変更の全容をつかみにくい面があります。また、/rewind ではコマンドの実行結果までは戻せないため、重要な操作の前には「実行する前に内容を確認させて」と伝えておくと安心です。Gitなどのバージョン管理を使っている場合は、そちらでも変更を追えるので心強いです

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

Claude Codeを使っていると、赤い文字や黄色い文字のメッセージに出くわすことがあります。多くの環境では色で深刻度の目安がつきますが、色だけで判断せず、Error Warning Failed などの語句も合わせて確認してください。

エラーメッセージ

Error: Cannot find module 'express'

Error や Failed といった語句を含むメッセージは、何かが失敗したことを示しています（多くの環境で赤く表示されます）。ただし、すべてのエラーが深刻というわけではありません。

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

警告メッセージ

Warning: Deprecated API usage detected

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

警告は「ここ注意してね」という案内なので、エラーより急いで対処する必要はありません。

深刻かどうかの判断基準

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

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

ここまでの知識をまとめて、よくある5つの画面パターンを押さえておきましょう。表示は環境やバージョンによって異なるため、あくまで一例として見てください。

パターン1：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の追加と削除を自分の目で確かめてみてください。画面の読み方を知っていれば、黒い画面も怖がる必要はありません。

基本画面に慣れたら、次に試す機能はClaude Codeの目的別ロードマップから選べます。