まず最初に — 自動診断コマンドを走らせる

個別の症状を調べる前に、まず公式の自動診断を使います。Claude Codeの画面内で /doctor と入力すると、インストール状態・設定・拡張機能・コンテキスト使用量を自動チェックし、見つかった問題には修正案を提示してくれます（確認してから適用する形式なので勝手に変更はされません）。

  • Claude Codeが起動できるとき → 画面内で /doctor を実行
  • Claude Codeがそもそも起動しないとき → ターミナルで claude doctor を実行
  • 外部ツール連携（MCP）の不調が疑わしいとき → /mcp で接続状態を確認

これで原因が特定できればそのまま解決です。特定できない場合に、以下の症状別の切り分けに進みます。

「command not found: claude」— インストールしたのに動かない

インストール直後の定番トラブルです。原因のほとんどは、インストール先のフォルダがシェルの検索経路（PATH）に入っていないことです。Claude Codeは ~/.local/bin/claude（Windowsは %USERPROFILE%\.local\bin）に配置されるため、ここをPATHに追加してターミナルを開き直すと解決します。

macOS（zsh）でPATHを追加する例
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
claude --version

もう1つの定番原因がインストールの重複です。過去にnpm経由で入れたものと新しい公式インストーラー版が共存していると、古い方が呼ばれて不可解な挙動になります。which -a claude で複数の場所が表示されたら、公式推奨のネイティブ版（~/.local/bin/claude）だけを残して他を削除します。なお、VS Code拡張だけを入れた場合、ターミナル用の claude コマンドは別途インストールが必要です。インストール手順そのものはClaude Codeの始め方で解説しています。

ログイン・認証できない

「OAuth error」「403 Forbidden」やログイン画面のループは、認証まわりのトラブルです。切り分けの順序は次のとおりです。

  1. 1/login でいったんログインし直す。ブラウザ側で別のアカウントに切り替わっていた、が意外と多い
  2. 2会社のネットワークで発生する場合は、プロキシやファイアウォールが通信を遮断していないか情報システム部門に確認する（プロキシ環境では HTTPS_PROXY の設定が必要）
  3. 3組織アカウントの場合、管理者側でClaude Codeの利用が許可されていない可能性を確認する
  4. 4上記で解決しない4xx・5xx系のエラーは公式のエラーリファレンスに対応表があるため、エラーメッセージの文言で照合する

「529 Overloaded」は自分のせいではない

API Error: 529（Overloaded）や500系のエラーは、Anthropic側のサーバーが一時的に混雑しているサインです。設定をいじる必要はなく、少し待ってから再試行すれば解消します。

動作が遅い・重い

「最初は快適だったのに、だんだん重くなってきた」場合、原因は大きく3つに分かれます。

表は横にスクロールできます →

原因症状の特徴対処
会話が長くなりすぎた同じセッションを長く使うほど遅い/compact で会話を圧縮する。大きな作業の区切りで再起動する
拡張機能の影響特定の環境だけ重いclaude --safe-mode で拡張を全部切って起動し、軽くなるなら追加した拡張・連携を1つずつ疑う
作業フォルダが大きすぎるファイル検索のたびに待たされるビルド生成物などの大きなフォルダを .gitignore に追加して検索対象から外す

また、WindowsのWSL環境では、プロジェクトをWindows側のフォルダ（/mnt/c/ 配下）に置いていると読み書きが大幅に遅くなることが公式に案内されています。Linux側（/home/ 配下）へ移すか、ネイティブのWindows版を使うのが対処です。Windows環境の構成はClaude CodeをWindowsで使う方法で詳しく扱っています。なお「遅い」ではなく「急に止まった・応答しなくなった」場合は、故障ではなく使用量の上限に達した可能性が高いため、Claude Codeの制限の仕組みを確認してください。

フリーズした・固まった — 会話は消えない

応答しなくなったら、まず Ctrl+C で実行中の処理をキャンセルします。それでも反応がなければターミナルごと閉じて再起動します。このとき覚えておきたいのは、再起動しても会話は消えないことです。同じフォルダで claude --resume を実行すれば、直前のセッションを選んで続きから再開できます。「固まったら躊躇なく再起動してよい」と知っているだけで、トラブル時の心理的コストが大きく下がります。

文字化け・表示崩れ

VS CodeやCursorの統合ターミナルで文字が四角になったり表示が乱れたりする場合、エディタ側のGPU描画機能が原因であることが公式に案内されています。Claude Code内で /terminal-setup を実行すると、該当設定（GPUアクセラレーションをオフにする等）を自動で書き込んでくれます。なお、日本語の入出力そのものの設定・運用はClaude Codeを日本語で使う方法で解説しています。

症状別の早見表

表は横にスクロールできます →

症状まず試すこと
claudeコマンドが見つからないPATHの確認とターミナルの開き直し
ログインできない・403/login でログインし直し。会社回線ならプロキシ確認
動作が重い/compact → 再起動 → claude --safe-mode で切り分け
固まったCtrl+C → 再起動 → claude --resume で再開
文字化け/terminal-setup を実行
急に応答しなくなった使用量上限の可能性。リセット時刻を確認
529 / 500系エラーサーバー混雑。待って再試行
原因不明/doctor で自動診断。/feedback で公式に報告

法人導入では「トラブル対応力」も仕組みにする

個人利用なら試行錯誤で済みますが、チームに展開すると「動かない」という問い合わせが導入担当者に集中し、そこが浸透のボトルネックになりがちです。実務では、環境構築の手順を標準化する・本記事のような症状別の一次対応表を社内に用意する・解決しないものだけ管理者にエスカレーションする、という3層で捌くと、導入担当者が疲弊しません。

当社のClaude Code研修では、導入時の環境構築サポートに加えて、こうした「つまずいたときに自走できる状態」まで含めた定着支援を行っています。ツールの使い方だけ教えて終わりにしない設計が、社内展開の成功率を左右します。

Claude Codeを組織に定着させたい企業様へ。AI Orchestraの法人研修・導入支援をご覧ください。

Claude Code研修・導入支援の詳細を見る無料相談を申し込む