「Auto-update failed」エラーの解決方法 — Claude Codeが自動更新に失敗するとき

症状

⚠️ 本記事のコードはサンプルです。実際の認証情報・設定値は含まれていません。

Claude Code CLIの下部に以下のエラーが表示される：

✗ Auto-update failed · Try claude doctor or cd ~/.claude/local && npm update @anthropic-ai/claude-code

原因

Claude Codeには2つのインストール先があり、自動アップデートが片方だけ更新しようとして失敗するケースがあります。

| インストール先 | パス | 用途 |
|---|---|---|
| グローバル版 | /usr/local/lib/node_modules/@anthropic-ai/claude-code/ | claude コマンド本体 |
| ローカル版 | ~/.claude/local/node_modules/@anthropic-ai/claude-code/ | 自動アップデート用 |

自動アップデートは ~/.claude/local/ 側を更新しますが、実際に実行されるのはグローバル版（/usr/local/bin/claude）であるため、バージョンの不一致が起きます。

解決方法

Step 1: 現在のバージョンを確認

# 実行中のバージョン
claude --version

# 最新バージョン
npm view @anthropic-ai/claude-code version

Step 2: ローカル版を更新（エラーメッセージの通り）

cd ~/.claude/local && npm update @anthropic-ai/claude-code

Step 3: グローバル版も更新（これが本命）

npm update -g @anthropic-ai/claude-code

Step 4: 確認

claude --version

これで次回起動時にエラーが消えます。

ポイント

• claude doctor はセッション内から実行できない（ネストセッション禁止のため）。CLI一度終了してから実行する必要があります
• エラーメッセージの指示（cd ~/.claude/local && npm update）だけでは解決しないことがある。グローバル版（npm update -g）も忘れずに
• Node.js v23系を使っている場合、EBADENGINE 警告が出ますが無視してOK（動作に影響なし）