Claude Code が「動かない」「止まらない」と感じる場面は、原因がだいたい数パターンに収束する。公式の troubleshooting ドキュメントと日々の運用から、症状別に最初に試す手順を一枚にまとめた。慌ててターミナルを閉じる前に、まず「止め方」を正確に押さえておきたい。
まず「止める」を正しく覚える
| やりたいこと | 操作 | |---|---| | 生成・実行を中断 | `Esc`（実行中のツール呼び出しはキャンセルされ、次の指示待ちに戻る） | | セッションを終了 | `exit` または `Ctrl+D` | | 反応がなくフリーズ | `Ctrl+C`。戻らなければターミナルを閉じて `claude --resume` で復帰 | | 会話履歴だけ消す | `/clear`（ファイルや git の状態には触れない） |
`Esc` は「全部やり直し」ではない。実行中の操作だけ止めて、それまでの文脈は保持されるので、方向修正の指示をそのまま続けられる。
起動・ログインで止まる
**`command not found: claude`** npm のグローバル bin が PATH に入っていない。`npm config get prefix` で確認し、その下の `bin` を PATH に追加する。ネイティブインストーラ版なら入れ直しが早い。
**ログインループ / 403 / "organization disabled"** `/logout` してから `claude` で再ログインする。組織アカウントの場合は権限とシート割り当てを確認する。
**ブラウザが開かない（SSH・WSL・リモート開発）** ログイン画面に表示される URL を `c` キーでコピーし、手元のブラウザに貼って認証する。ここで詰まる人が一番多い。
**Node のバージョン** npm 版は Node.js 18 以上が必須。古いと起動時に落ちる。
「途中で固まった」の正体はコンパクション
長時間セッションで急に遅くなる、同じ要約を繰り返すように見える——こういうときは自動コンパクションのスラッシングを疑う。コンテキストが満杯に近く、要約しても直後にまた埋まってしまう状態だ。
/compact focus on 認証リファクタの残タスクのように圧縮対象を絞ると安定する。重い調査はサブエージェントに逃がし、main セッションのコンテキストを汚さないのも効く。
セッションを失わずに復帰する
無料でアカウント作成
CCHub は Claude Code 開発者のための日本語コミュニティです。