Claude Codeが動かない・エラーの直し方｜原因4つと対処

Claude Codeをターミナルで起動したら、いきなりエラーが出て止まってしまった——そんな時でも、原因の多くは複雑な不具合ではなく、環境設定の見直しで解決できます。本記事では、まず「何が原因か」を切り分け、つまずきやすい4つの原因ごとに直し方を解説します。非エンジニアの方でも、上から順にチェックすれば起動できるよう構成しました。

まず切り分け（claude doctorで自己診断）

エラーが出たら、闇雲にコマンドを試す前に「どこでつまずいているか」を切り分けましょう。Claude Codeには公式の自己診断ツールが用意されています。

claude doctor で今の状態を確認する

ターミナルに次のコマンドを入力して実行してください。ネットワーク接続・認証状態・必要なソフトの整合性を、自動でまとめてチェックしてくれます。

claude doctor

すべて正常なら、緑色のチェックマークと「All systems operational（すべて正常）」が表示されます。逆に赤い警告が出た場合は、そこに「何が足りないか」が書かれています。たとえば「Node.js version mismatch（バージョン不一致）」と出ていれば、Node.jsを入れ直すだけで解決します。この赤字メッセージが、解決への最短ルートです。

原因チェックリスト（4つの落とし穴）

診断と合わせて、まずは以下の4点に当てはまっていないかを確認すると、早く切り分けられます。

チェック項目	確認する内容
プラン・認証	有料プラン（Pro/Max）でログイン済みか、またはAPIキーを設定しているか
実行環境	Node.js（実行プログラム）が入っているか
バージョン	Node.jsがv18.19.0以上か
OS環境	macOS/Linux、またはWindowsならWSLか

原因別の直し方

原因1：プラン・認証（無料では使えない）

意外と多いのが、プランや認証の行き違いです。Claude Codeには大きく2通りの使い方があり、どちらかが正しく設定されている必要があります。

• 有料プランでログインして使う：claude login を実行し、Claude Pro / Max プランのアカウントで認証します（サブスクの利用枠で動きます）。
• APIキーで使う：Anthropicのコンソールで発行した ANTHROPIC_API_KEY を設定し、従量課金（クレジット残高）で動かします。

「Proを契約しているのにエラーが出る」場合は、ログイン方法がかみ合っていないことがほとんどです。今どちらの認証で動いているかは、次のコマンドで確認できます。

/status

APIキーを使う設定なのに残高が不足していると「Unauthorized（許可なし）」というエラーになります。その場合はキーと残高を確認してください。

• キー確認：echo $ANTHROPIC_API_KEY
• 古いキーや末尾の空白が残っていないか、コンソールのクレジット残高があるかを確認

※無料プランだけでは利用できません。有料プラン（Pro/Max）か、APIクレジットのどちらかが必要です。

原因2：Node.js（バージョン・パスの設定）

Claude Codeは新しめのNode.js環境を前提に動きます。古いと、インストールや起動の段階でエラーになります。まず node -v でバージョンを確認しましょう。v18.19.0未満なら、最新のLTS（長期サポート版・v20系またはv22系）に更新してください。

node -v

「インストールしたはずなのにコマンドが見つからない」という場合は、Node.jsの“置き場所”の指定（パス）がずれているケースが大半です（nvm や anyenv などのバージョン管理ツールを使っていると起きやすい）。

• which node を実行し、意図しない古い場所（例：/usr/bin/node）を参照していないか確認
• シェル設定ファイル（.zshrc や .bashrc）に、使いたいNode.jsのパスが通っているか確認

原因3：認証・ログイン（ブラウザが開かない／ループする）

認証は、特にサーバー上やWSL（後述）など、デスクトップ画面がない環境でつまずきやすいポイントです。

ブラウザが自動で開かずタイムアウトする場合は、ブラウザを使わないオプションを付けて実行します。実行後に表示されるURLを手元のPCのブラウザで開き、認証コードを貼り付ければ完了です。

claude login --no-browser

ログイン画面で何度もリダイレクトされてループする場合は、ブラウザのキャッシュや拡張機能（広告ブロック等）が干渉していることがあります。一度シークレットモード（プライベートブラウジング）でURLを開いてログインを試してください。

原因4：Windows環境（WSLで安定化する）

Windowsでエラーが頻発するのは、PCの故障ではなくOSの仕様によるものです。Claude CodeはLinux系の環境を最も得意とするため、Windowsでは WSL（Windows上で動くLinux環境） を使うと、予期せぬエラーが大きく減ります。導入は次の手順だけです。

1. スタートメニューで「PowerShell」を右クリックし、「管理者として実行」を選ぶ
2. wsl --install と入力してEnterキーを押す
3. PCを再起動し、画面の指示に従う

これでWindowsでもClaude Codeが安定して動く環境が整います。

それでも直らない時

エラーログをWeb版Claudeに投げる

原因が特定できないときは、ターミナルに出たエラーログをそのままコピーして、Web版のClaudeに相談するのが手軽です。次のように頼んでみてください。提案されたコマンドを実行する際は、念のため大事なデータのバックアップを取ってから進めると安心です。

Claude Codeで次のエラーが出ました。原因と解決手順を初心者向けに教えてください。
［ここにエラーログを貼り付け］

公式GitHub Issuesを確認する

根本的に難しいエラーは、公式GitHubリポジトリの「Issues」を確認すると、同じ問題の報告と開発者の回答が見つかることがよくあります。自分で深追いする前に、まず確認するのが近道です。

最新版の維持と運用のコツ

Claude Codeは更新が速く、古いバージョンを使い続けると仕様変更で突然エラーが出ることがあります。作業を始める前に最新版へ更新する習慣をつけましょう。常に最新版（latest）を指定しておくと、既知の不具合や認証まわりが修正された状態を保てます。

npm install -g @anthropic-ai/claude-code@latest

まとめ

Claude Codeが動かない・エラーが出る原因の多くは、環境設定の小さなつまずきです。次のポイントを順に確認しましょう。

• まず claude doctor で状態を診断し、赤字メッセージを手がかりにする
• プラン・認証：Pro/Maxでログインするか、APIキー＋残高を用意する（無料では使えない）
• Node.js：v18.19.0以上に更新し、パスの通りを確認する
• 認証：画面のない環境では --no-browser を使う
• Windows：WSLで安定化する
• それでも直らなければ、エラーログをWeb版Claudeに投げる／GitHub Issuesを確認する

まずはターミナルで claude doctor を実行し、今の自分の環境を正しく把握することから始めてください。