⚠️ トラブル 📖 約20分で読めます

「Claude Codeが動かない」トラブル解決集

よくあるエラーと解決方法を網羅的にまとめました

クロガイド

クロガイド｜Claude＆Claude Codeを無料で学ぼう

AI基礎からプロンプト術、Claude Codeの使い方まで。知識レッスンとクイズ式トレーニングで、AIスキルを段階的にアップ。ユーザー登録不要、すべて無料で今すぐ始められます。

無料で学習を始める クロガイドとは？

はじめに ― まず落ち着いて、エラーを読もう

Claude Codeをインストールしたけど動かない、エラーが出る、認証できない――そんなトラブルに遭遇したとき、焦る気持ちはわかります。でも大丈夫です。Claude Codeのトラブルの大半は、5〜10分あれば解決できるものです。

この記事では、実際のエラーメッセージごとに原因と解決方法を解説します。表示されたエラーメッセージをこの記事内で検索（Ctrl+F）すれば、解決策が見つかるはずです。

この記事でわかること: インストールの問題、認証・ログインの問題、ネットワークの問題、権限の問題、動作不良の問題とその解決方法

トラブル対応の基本フロー

まずこの4ステップを試そう

  1. エラーメッセージを読む ― 英語でも翻訳ツールに貼り付けて内容を理解する
  2. 基本コマンドで状態を確認 ― 下記の診断コマンドを実行する
  3. この記事でエラーメッセージを検索 ― Ctrl+F で該当箇所を探す
  4. 解決しない場合は公式リソースへ ― GitHub Issues / Anthropicサポート
最初に実行すべき診断コマンド
# Claude Codeのバージョン確認
claude --version

# インストール場所の確認
which claude      # Mac/Linux
where claude      # Windows

# ネットワーク接続確認
curl -I https://api.anthropic.com

# 環境変数の確認
echo $ANTHROPIC_API_KEY    # Mac/Linux
echo %ANTHROPIC_API_KEY%   # Windows CMD
$env:ANTHROPIC_API_KEY     # Windows PowerShell

カテゴリ1: インストールの問題

Claude Codeのインストール方法

Claude Codeはネイティブインストーラーで直接インストールできます。Node.jsは不要です。

macOS / Linux:

# ワンコマンドでインストール
curl -fsSL https://claude.ai/install.sh | bash

Windows（PowerShell）:

# PowerShellで実行
irm https://claude.ai/install.ps1 | iex

パッケージマネージャーを使う場合:

# macOS（Homebrew）
brew install --cask claude-code

# Windows（winget）
winget install Anthropic.ClaudeCode

注意: Windows環境では Git for Windows が必要です。事前にインストールしておいてください。

エラー: インストールコマンドが失敗する

原因: ネットワークの問題、権限不足、またはOSバージョンが古い可能性があります。

解決方法:

  1. インターネット接続を確認: curl -I https://claude.ai
  2. macOS/Linuxの場合、sudo を付けて再実行: 
    curl -fsSL https://claude.ai/install.sh | sudo bash
  3. Windowsの場合、PowerShellを管理者として実行して再試行
  4. 別のインストール方法を試す（例: curlが失敗したらbrew/wingetを使う）
  5. OSバージョンが最新のサポート対象か確認する

エラー: 「execution policy」エラー（Windows PowerShell）

症状: 「このシステムではスクリプトの実行が無効になっている」「cannot be loaded because running scripts is disabled on this system」

原因: PowerShellの実行ポリシーがスクリプトの実行をブロックしています。

解決方法:

# PowerShellを「管理者として実行」して以下を実行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# 確認メッセージが出たら「Y」を入力
# PowerShellを閉じて新しいウィンドウを開き、再度インストールコマンドを実行
irm https://claude.ai/install.ps1 | iex

エラー: 「claude: command not found」（インストール後に実行できない）

原因: Claude Codeのインストール先がPATHに含まれていません。

# Mac/Linux: claudeの場所を確認
which claude

# 見つからない場合、インストールスクリプトの出力を確認して
# 表示されたパスを.zshrc（または.bashrc）に追加
# 例:
export PATH="$HOME/.claude/bin:$PATH"

# 設定を反映
source ~/.zshrc

Windows での確認と対処:

# claudeの場所を確認
where claude

# 見つからない場合、再インストールを試す
irm https://claude.ai/install.ps1 | iex

# または winget で再インストール
winget install Anthropic.ClaudeCode

Windowsの場合、インストール後にターミナルを完全に閉じて新しいウィンドウを開くことで解決する場合があります。

エラー: SSL証明書エラー・プロキシ環境でのインストール失敗

原因: 企業のプロキシやファイアウォールが独自のSSL証明書を使用しています。

解決方法:

# プロキシ環境変数を設定してからインストール（Mac/Linux）
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
$env:HTTP_PROXY = "http://proxy.company.com:8080"
$env:HTTPS_PROXY = "http://proxy.company.com:8080"
irm https://claude.ai/install.ps1 | iex

証明書の問題が続く場合は、社内IT部門に相談してシステム証明書ストアに企業のCA証明書を追加してもらいましょう。

カテゴリ2: 認証・ログインの問題

エラー: 「Authentication failed」「Invalid API Key」

原因: APIキーが正しくない、期限切れ、または未設定です。

解決方法:

  1. console.anthropic.com にログイン
  2. 「API Keys」セクションでキーの状態を確認
  3. 新しいキーを発行（古いキーが不明な場合）
  4. 環境変数に設定: 
    # Mac/Linux (.zshrcまたは.bashrcに追記)
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxx"
source ~/.zshrc

# Windows PowerShell
$env:ANTHROPIC_API_KEY = "sk-ant-xxxxxxxxxxxxx"

# Windows（恒久的に設定するには「システム環境変数の編集」画面から）
  5. claude config で認証情報を再設定することもできます
よくある間違い
  • APIキーの前後に余計なスペースや改行が入っている → コピーし直す
  • APIキーを引用符なしで設定している（スペースを含む場合に問題になる）
  • 環境変数を設定したがターミナルを再起動していない
  • 間違った環境変数名を使っている（ANTHROPIC_KEY ではなく ANTHROPIC_API_KEY）

エラー: 「Rate limit exceeded」「429 Too Many Requests」

原因: APIの利用制限に達しています。

解決方法:

  1. しばらく待ってから再試行（通常1〜5分で解除）
  2. Anthropicコンソールで利用状況を確認
  3. 無料プランの場合は有料プランへのアップグレードを検討
  4. APIの場合は利用枠（Usage Tier）の確認と引き上げ申請

Tips: 短時間に大量のリクエストを送っている場合は、リクエスト間に少し間隔を空けましょう。

エラー: 「Account suspended」「Billing issue」

原因: 請求に問題がある、または利用規約違反のフラグが立っています。

解決方法:

  1. Anthropicコンソールで請求情報（クレジットカード）を確認
  2. 支払い方法が有効か確認
  3. 不明な場合はAnthropic サポートに問い合わせ

カテゴリ3: ネットワーク関連の問題

エラー: 「ENOTFOUND」「ETIMEDOUT」「Network Error」

原因: インターネット接続に問題がある、またはAnthropicのAPIサーバーに到達できません。

診断コマンド:

# インターネット接続の確認
ping google.com

# Anthropic APIへの接続テスト
curl -I https://api.anthropic.com

# DNS解決の確認
nslookup api.anthropic.com

解決方法:

  • Wi-Fiが切れている: Wi-Fiを再接続
  • VPNが干渉: VPNを一時的にオフにして試す
  • 企業プロキシ: IT部門にAPI通信の許可を依頼
  • DNS問題: DNSサーバーを 8.8.8.8（Google DNS）に変更して試す

企業のプロキシ環境で使う場合

企業ネットワークではプロキシ経由でしか外部にアクセスできないことがあります。

# プロキシ設定の確認
echo $HTTP_PROXY
echo $HTTPS_PROXY

# プロキシを設定（Mac/Linux - .zshrcまたは.bashrcに追記）
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080

# Windows PowerShell
$env:HTTP_PROXY = "http://proxy.company.com:8080"
$env:HTTPS_PROXY = "http://proxy.company.com:8080"

# Windows（恒久的に設定するには「システム環境変数の編集」画面から）

プロキシの設定値は社内のIT部門に確認してください。

カテゴリ4: 権限（パーミッション）の問題

エラー: 権限エラー（Mac/Linux）

原因: インストール先ディレクトリへの書き込み権限がありません。

解決方法:

# sudo を付けてインストールを再実行
curl -fsSL https://claude.ai/install.sh | sudo bash

# または Homebrew を使ってインストール（権限問題が起きにくい）
brew install --cask claude-code

エラー: 「EPERM: operation not permitted」（Windows）

原因: ウイルス対策ソフトやファイルのロックが原因です。

解決方法:

  1. ウイルス対策ソフトがClaude Codeの実行ファイルをブロックしていないか確認
  2. 「管理者として実行」でPowerShellを開いて再試行
  3. 他のターミナルウィンドウやエディタがClaude Code関連のファイルにアクセスしていないか確認
  4. 再インストール: irm https://claude.ai/install.ps1 | iex

エラー: ファイル・ディレクトリへのアクセス権限

症状: Claude Codeがプロジェクトのファイルを読み書きできない。

解決方法:

# Mac/Linux: ファイルの権限を確認
ls -la /path/to/your/project

# 権限を修正（自分のファイルの場合）
chmod -R u+rw /path/to/your/project

# Windows: フォルダのプロパティ→セキュリティタブで権限を確認

カテゴリ5: Claude Codeの動作に関する問題

ファイルの編集結果がおかしい

原因: 指示が曖昧で、AIが意図と異なる解釈をした可能性があります。

解決方法:

  1. git diff で変更内容を確認する
  2. 意図と違う場合は git checkout -- ファイル名 で元に戻す
  3. より具体的な指示で再度実行
  4. CLAUDE.md ファイルにプロジェクトのルール、コーディング規約を書いておくと精度向上

Tips: Claude Codeを使う前に git init と git add . git commit -m "initial" をしておくと、いつでも元に戻せて安心です。

応答が非常に遅い・フリーズする

考えられる原因と対処:

原因確認方法対処法
ネットワークが遅い速度測定サイトで確認Wi-Fi再接続 / 有線LANに切替
プロジェクトが大きすぎるファイル数の確認.gitignoreで不要ファイルを除外
APIサーバーの混雑時間帯を確認時間をずらして再試行
PCのメモリ不足タスクマネージャー確認他のアプリを閉じる

Claude Codeを快適に使うための設定Tips

Tip 1: CLAUDE.mdを活用する

プロジェクトのルートに CLAUDE.md ファイルを作成して、プロジェクトの概要やルールを記載しておくと、Claude Codeの回答精度が大幅に向上します。

# CLAUDE.md に含めるべき情報
- プロジェクトの概要
- 技術スタック（言語、フレームワーク、バージョン）
- コーディング規約
- ディレクトリ構成
- よく使うコマンド
- やってほしくないこと（例: 特定のファイルを変更しないで）

Tip 2: .gitignoreを適切に設定する

不要なファイルがプロジェクトに含まれていると、Claude Codeの処理が遅くなります。

# .gitignore に含めるべきもの
.env
*.log
dist/
build/
.DS_Store
Thumbs.db

Tip 3: バージョンを最新に保つ

# 現在のバージョン確認
claude --version

# 最新版にアップデート
claude update

# うまくいかない場合は再インストール
# macOS/Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

それでも解決しないときは

サポートリソース

  • 公式ドキュメント: docs.anthropic.com
  • GitHub Issues: 同じエラーの報告がないか検索する
  • コミュニティ: Discord / Reddit のAnthropicコミュニティ
  • サポート: support.anthropic.com

問い合わせる際は以下の情報を添えると、スムーズに解決できます:

  • OS とバージョン（例: macOS 14.2, Windows 11）
  • Claude Codeのバージョン（claude --version）
  • エラーメッセージの全文
  • 試した対処法

まとめ

  • トラブルの80%は「インストール・PATH設定」「認証（APIキー）」「ネットワーク」の3つに起因する
  • エラーメッセージを読む → 診断コマンドで状態確認 → この記事で検索 の順で対処
  • Claude Codeはネイティブインストーラーで簡単にインストールできる（Node.js不要）
  • 企業環境ではプロキシ設定（HTTP_PROXY / HTTPS_PROXY）が必要になることが多い。IT部門に相談しよう
  • CLAUDE.md と .gitignore を整備すると、日常的な動作も快適になる
  • gitで変更を管理しておけば、万が一の編集ミスもすぐ元に戻せる

他のお悩みも見る

🛡️ ルール・倫理 「AIを仕事で使っていいの？」注意点まとめ 🔧 セットアップ 「AIに何を聞けばいいかわからない」を解決 🚀 Claude Code実践 「やっぱり違う」を何度でも ― Claude Codeのundo機能で恐れずに試行錯誤する開発術

もっと学びたい方へ

クロガイドのレッスンで、Claude＆Claude Codeを体系的に学びましょう。

カテゴリ別レッスン ガイド記事を読む