Claude Code のよくあるエラーと対処法｜インストール・401認証・接続エラーの解決【2026年版】

結論：エラーは「層」で切り分ける

Claude Code のトラブルは、下の層から順に切り分けると速く解決できます。

1. インストール / Node(そもそも動くか)
2. 認証(401)
3. ネットワーク / レート制限(429 / 5xx)
4. MCP / 権限

エラーメッセージの種別(401・429・EACCES 等)をまず読み、該当層から対処します。以下、症状別の原因と対処です。

症状別の対処

401・認証エラー

最も多いのが認証です。主因は3つ：

1. ログインセッション/トークンの期限切れ
2. API キーが無効・失効・コピーミス(余分な空白や改行)
3. ANTHROPIC_API_KEY とサブスク認証など複数の認証経路が競合

対処：claude を起動し直して再認証 → API キー利用ならキーの有効性確認 → 不要な環境変数を外して認証経路を1つに絞る。

インストール・PATH

node -v   # 18 以上か
npm install -g @anthropic-ai/claude-code
claude --version

EACCES(権限エラー)は npm グローバルディレクトリの権限問題が定番。sudo を使うより nvm 等で Node をユーザー権限管理するのが安全です。インストール後に claude が見つからない時は npm グローバル bin が PATH に入っているか確認します。

MCP 接続エラー

claude mcp list                                   # 状態確認(✓ か)
npx @modelcontextprotocol/inspector <command>     # サーバー単体を検証

確認ポイント：command が絶対パスか・依存が解決できるか・stdio サーバーが標準出力に余計なログを出していないか(通信を壊す)。Inspector で動けばサーバーは正しく、問題は登録側です(MCPサーバーの作り方参照)。

レート制限・サーバーエラー

• 429: レート制限。短時間に使いすぎ or プラン上限。時間をおく/枠を確認
• 500 / 529: Anthropic 側の一時障害。クライアントの問題ではないので少し待って再試行

頻発するなら時間帯をずらす・処理を分割します。

コマンド拒否・許可

Claude Code は安全のため一部操作に許可を求めます(意図した動作)。煩わしければ安全なコマンドを許可設定に追加。逆に想定外にブロックされる場合は、設定した hooks(PreToolUse のガード)が効いている可能性があるので matcher と条件を見直します。

まとめ

• 切り分けは「インストール/Node → 認証 → ネットワーク → MCP/権限」の順
• 401 は再認証・キー有効性・経路の競合解消
• インストールEACCES は nvm 等でユーザー権限管理、PATH 確認
• MCP は claude mcp list → Inspector で切り分け
• 429 は時間/プラン、5xx は一時障害で再試行
• 想定外のコマンド拒否は hooks のガードを疑う

手を動かして定着させる：環境構築とトラブル対処は、一度通しでやると以後つまずきません。当サイトの「バイブコーディング実践編」では前提環境(Node/Git/PR運用)から提出物付き演習で固めます。4週間限定で無料公開中。

関連ガイド：

• Claude Code 入門 — CLI の環境構築と認証
• Claude Code を VS Code で使う — エディタ連携の設定
• MCPサーバーの作り方 — MCP の動作確認
• Claude Code hooks 設定方法 — 許可ガードの仕組み