メインコンテンツまでスキップ

第13章　トラブルシューティング / FAQ

困ったときは、まずここを探してみてください。 「症状 → 原因 → やること」 の形でまとめています。

🎯 この章のゴール​

  • よくあるトラブルを自分で解決できる
  • 解決できないとき、何を伝えて相談すればよいかわかる
迷ったらこの2つ
  • Claude Code の中で /help … 使い方のヘルプ
  • ターミナルで claude doctor … インストールの「健康診断」。問題と直し方を教えてくれます

インストール関連​

command not found / 「claude は認識されません」と出る​

  • 原因：インストール直後で、ターミナルがまだ気づいていない／パスが通っていない
  • やること：
    1. ターミナル（PowerShell）を 完全に閉じて、開き直す
    2. もう一度 claude --version を試す
    3. それでもダメなら claude doctor を実行して指示に従う

権限エラーでインストールできない​

  • 原因：会社パソコンの管理者権限がない
  • やること：事前準備の情シス依頼テンプレートで相談。sudo での無理なインストールは避けてください。

Windows で 'irm' is not recognized と出る​

  • 原因：PowerShell ではなく別の画面（CMD）を開いている
  • やること：スタートから 「Windows PowerShell」 を開き直してから、もう一度コマンドを実行。

ログイン・認証関連​

ブラウザが開かない／認証画面から戻ってこない​

  • 原因：自動でブラウザが開けない環境
  • やること：画面に表示された URL をコピーして、自分でブラウザに貼り付けます。ログイン後、必要なら表示された確認用URLを Claude Code に貼り戻します。

サブスクと API、どちらでログインしたか分からない​

  • やること：Claude Code の中で /status を実行すると、今のログイン方法が確認できます。サブスクで使いたいのに API になっていたら、/login でログインし直してください。

ログインが切れた・入り直したい​

  • やること：Claude Code の中で /login を実行して、もう一度認証します。

動作関連​

反応が遅い・止まったように見える​

  • やること：少し待つ（重い作業は時間がかかります）。長すぎるときは Esc で中断し、指示を小さく分けて頼み直します。

指示通りに動かない​

  • 原因：指示があいまい
  • やること：「具体的に・1つずつ・例を添える」で言い直す（基本操作のコツ参照）。話が混乱したら /clear で仕切り直し。

ファイルが意図せず変わった／元に戻したい​

  • やること：まず慌てず、何が変わったかを Claude に尋ねます。普段から大事なファイルはバックアップ（コピー）を取っておくと安心です。変更前には必ず許可を求められる仕組みなので、許可は内容を読んでから。

エージェント・コマンド関連​

エージェントやコマンドが呼び出せない​

  • 原因：ファイルがまだ読み込まれていない／名前が違う
  • やること：
    1. / を打って一覧に出るか確認
    2. 手で作ったファイルは、Claude Code を 再起動すると反映
    3. 名前（ファイル名）のつづりを確認

MCP関連​

MCPサーバーが接続できない／認証が通らない​

  • やること：Claude Code の中で /mcp を開き、状態を確認。認証が必要なものはそこからブラウザでログイン。ブラウザが開かなければ表示URLを手動で開きます。

/mcp に claude.ai のコネクタが出てこない​

  • 原因：サブスク（Claude.ai）以外でログインしている（API キー等）
  • やること：/status でログイン方法を確認し、サブスクでログインし直す。

接続をやめたい・鍵を取り消したい​

  • やること：/mcp の「Clear authentication」、またはターミナルで claude mcp remove 名前。

プライバシー関連​

会話の履歴を消したい​

  • 原因：履歴はパソコン内（~/.claude/projects/ の中）に約30日保存されます
  • やること：共有PCや退職時は、この履歴の削除を運用ルールに。消し方は情シスの手順に従ってください（セキュリティ参照）。

それでも解決しないとき：相談のしかた​

サポートに相談するときは、次の4点を伝えるとスムーズです。

相談テンプレート（コピペして使ってください）
■ OS：Windows 11 / Mac（どちらか）
■ 状況：何をしようとしていたか
■ やったこと：実行したコマンドや手順
■ エラー：画面に出た文字（スクリーンショットがあれば添付）