Claude Codeを使っていて「あれ、動かない…」と固まった経験、きっとありますよね。原因はだいたい決まっているので、この記事をブックマークしておけば次からすぐ解決できます。
まだ一度も動かせていない段階なら、Claude Codeの使い方 非エンジニアがはじめて使う日の手順から辿るほうが早いかもしれません。
症状別に、試す順番 まで書いておきます。上から順に試してください。
症状1: パネルが開かない / 反応しない
VS Code右側のClaude Codeパネルが真っ白、または何も起きない状態。
試す順番
- VS Codeを再起動 — これで7割は直ります
- 拡張機能を一度無効化→有効化 — Extensions画面から
- VS Codeのアップデート確認 —
Help → Check for Updates - Claude Code拡張機能を最新版に更新 — Extensions画面で更新ボタンが出ていないか
- 拡張機能を一度アンインストールして入れ直す — 最終手段
多くの場合、①か②で直ります。
症状2: ログインできない
「Sign in」を押しても先に進まない、または認証ページがエラーになる。
試す順番
- ブラウザを別のものに切り替える — ChromeがダメならEdgeで試す
- シークレットモードで試す — ブラウザ拡張が干渉していることがあります
- クッキーを削除する —
claude.aiのクッキーだけ消せば十分 - Anthropic公式(claude.ai)に別途ログインしておく — VS Codeで再試行
- ネットワーク環境を確認 — 会社の社内ネットワークはAnthropicへのアクセスをブロックしている場合があります
症状3: 英語で返事をされる
日本語で質問したのに英語で返ってくる。
対処法
会話の冒頭にこう書いてください。
以後、すべての返答を日本語でお願いします。
これだけで日本語に切り替わります。毎回同じことを言うのが面倒なら、作業フォルダに CLAUDE.md を置いて「すべての返答を日本語でお願いします」と書いておけば、以降は自動で日本語になります。
症状4: ファイルを書き換えない / 途中で止まる
「ファイルを作ってください」と頼んでも、説明だけで実際にファイルが作られない。
試す順番
- 作業フォルダが開かれているか確認 — 「フォルダを開く」から対象フォルダを選び直す
- 承認を見落としていないか — 「実行しますか？」という確認が出ていることがあります
- 権限の問題を確認 — 書き込み禁止の場所（例:
Program Files）に作ろうとしていると失敗します - フォルダをデスクトップなどに移動 — 変なパスに置いているとトラブルの原因です
症状5: 急に遅くなった / 固まる
最初はサクサク動いていたのに、作業が進むにつれて遅くなる、または返事が来なくなる。
原因と対処
主な原因は 会話が長くなりすぎている ことです。Claude Codeは会話の内容を毎回読み直すので、会話が長くなるほど遅くなります。
対処法はシンプルで、作業の区切りで新しい会話に切り替える ことです。VS Code右側のClaude Codeパネルで、新しい会話を始めるボタンを押してください。
症状6: エラーメッセージが出る
Error, Failed, Timeout などの英語メッセージが出た場合。
万能対処法
エラーメッセージをそのままClaude Codeに貼り付けて、こう聞いてください。
このエラーが出ました。原因と対処法を日本語で教えてください。
[エラー本文をペースト]
Claude Code自身がエラーの意味を解説してくれます。これが一番早い対処法 です。
それでも直らないときは
- 時間を置いて再試行 — Anthropic側の障害の可能性があります（status.anthropic.com で確認できます）
- 別の端末で試す — 端末固有の問題かどうかを切り分ける
- 公式Discordや問い合わせに相談 — 最終手段
まとめ: 困ったら順番に試す3ステップ
どの症状も、まずこの3つから試してください。9割以上はこれで解決します。
- VS Codeを再起動
- 作業フォルダを開き直す
- 新しい会話を始める
それでもダメなら、エラーメッセージをClaude Code自身に見せて対処法を聞く。これだけ覚えておけば、Claude Codeとのお付き合いはずっと楽になります。
