2026年10月18日 / 最終更新日 : 2026年10月18日ふじながただしコラム

Claude Codeのエラー対処一覧｜「サーバーが混雑しています」「native binary not installed」「Auto-update failed」の直し方

Q: Claude Codeで「サーバーが混雑しています」と出たらどうすればいいですか？

サービス側の混雑なので、手元の設定では直りません。status.claude.com で状況を確認し、数分待って再実行するか、/model で別のモデルに切り替えてください。529 Overloaded は利用枠を消費しません。

Q: Error: claude native binary not installed はどう直せばいいですか？

npm でインストールしたときに、OS別の本体がダウンロードされなかったか、postinstall が実行されなかったのが原因です。--omit=optional や --ignore-scripts を外して入れ直すか、ネイティブインストーラーに切り替えます。

Q: インストールし直せば直りますか？

PATH の問題や二重インストールが原因なら、入れ直しても同じ状態になります。先に claude doctor と which -a claude で状況を確認してください。

Q: Node.jsは必要ですか？

ネイティブインストーラー、Homebrew、WinGet で入れる場合は不要です。npm で入れる場合だけ Node.js 22 以降が必要です。

Q: 無料プランでClaude Codeは使えますか？

公式ドキュメントでログインに使えるのは、Claude Pro・Max・Team・Enterprise のプランか Claude Console のアカウントです。claude.ai の無料プランは含まれていません。

Claude Codeでエラーが出たら、まずターミナルでclaude doctorを実行してください。インストールの状態・設定ファイルの文法エラー・直近の自動更新の結果をセッションを起動せずに診断し、直し方まで表示します。そのうえで、表示されたメッセージを下の逆引き表で探せば原因と対処がわかります。

この記事は、Anthropicの公式ドキュメント（Troubleshoot installation and login／Error reference／Troubleshooting、2026年10月18日確認）をもとに、日本語でよく検索されるエラーを症状別にまとめたものです。Claude Codeは更新が速く、メッセージの文言も版によって変わるため、表にないものは公式のError referenceで探してください。

まず試すこと：claude doctorと/doctor

claude doctor

公式ドキュメントによると、claude doctorはセッションを起動せずに、インストールの健全性、設定ファイルの検証エラー、警告と修正案を表示する読み取り専用の診断です。claude自体が起動しない状態でも使えます。Claude Codeが起動できるなら、セッションの中で/doctorを実行すると、インストール・設定・拡張機能・コンテキストの使用量まで確認し、確認後に修正まで行います。

エラーメッセージの逆引き表

表示されるメッセージ	原因	対処
`command not found: claude`／`'claude' is not recognized`	PATHが通っていない	PATHに`~/.local/bin`を追加
`Error: claude native binary not installed.`	npmのインストールが途中で止まっている	オプション依存・postinstallを有効にして入れ直す
Auto-update failed（claude doctorの実行を促される）	自動更新の失敗	`claude doctor`で原因を見る
`The connection dropped while downloading the update`	更新のダウンロードが途中で切れた	`claude update`を再実行、プロキシ設定
`irm is not recognized`／`The token '&&' is not a valid statement separator`	Windowsでシェルに合わないコマンドを実行	PowerShellとCMDでコマンドを使い分ける
`A parameter cannot be found that matches parameter name 'fsSL'`／`'bash' is not recognized`	Mac・Linux用のコマンドをWindowsで実行	Windows用のコマンドを使う
`syntax error near unexpected token '<'`／`curl: (22) ... 403`	インストールスクリプトの代わりにHTMLが返ってきた	ネットワーク・プロキシを確認
`Killed`（exit code 137）	Linuxでメモリ不足	メモリを空ける・スワップを追加
`dyld: Symbol not found`／`Abort trap: 6`	macOSが古い	macOS 13.0以上にする
`cannot execute binary file: Exec format error`	WSL1	WSL2に変換する
`Error loading shared library`	musl／glibcのバイナリ違い	環境に合ったものを入れる
`running scripts is disabled on this system`	PowerShellの実行ポリシー（npm版）	npmのシムを実行できるようにする
`Login expired · Please run /login`	保存されたログインの更新に失敗	`/login`で再ログイン
`API Error: 403 Request not allowed`	契約・権限・プロキシ	契約とロール、プロキシを確認
`This organization has been disabled`	古い`ANTHROPIC_API_KEY`が優先されている	`unset ANTHROPIC_API_KEY`
`Repeated 529 Overloaded errors`／「サーバーが混雑しています」	サービス側が混雑	待つ・`/model`で別モデルへ
`API Error: 500 Internal server error`	サーバー側の障害	status.claude.comを確認し再実行
`You've hit your session limit`など	プランの利用枠に到達	リセットを待つ・`/usage`で確認
`Request rejected (429)`	APIキーやクラウドのレート制限	`/status`で使っている認証を確認

「サーバーが混雑しています」「529 Overloaded」が出るとき

英語表示のClaude Codeでは、次のように表示されます。

API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.

公式ドキュメントでは、529は「全ユーザーにわたってAPIが一時的に容量の上限に達している」状態で、自分の利用上限ではなく、利用枠も消費しないと説明されています。このメッセージが出る前に、Claude Codeは自動で何度も再試行しています（既定で最大10回、指数バックオフ）。

status.claude.comで障害や混雑の告知が出ていないか確認する
数分待ってから、もう一度送る（長い指示は「try again」と送れば、元のメッセージは会話に残っています）
/modelで別のモデルに切り替える。混雑はモデルごとに管理されているため、切り替えると作業を続けられることがあります

日本語表示のClaudeアプリやCoworkで出る「サーバーが混雑しています。ただいま再試行しています」という表示は、日本語の文言そのものは公式ドキュメントに載っていません。ただ、再試行中である点と「混雑」という内容は、上の529の説明と同じ状況を示しています。手元の設定を変えても直らないので、待つかモデルを切り替えてください。

Error: claude native binary not installed の直し方

npmでインストールしたときに出るエラーです。macOS・Linuxでは次のように表示されます。

Error: claude native binary not installed.

Either postinstall did not run (--ignore-scripts, some pnpm configs)
or the platform-native optional dependency was not downloaded
(--omit=optional).

公式ドキュメントによると、npm版の@anthropic-ai/claude-codeは、OSごとの本体（例：@anthropic-ai/claude-code-darwin-arm64）をオプション依存としてダウンロードし、postinstallスクリプトでclaudeコマンドとして配置します。どちらかが飛ばされると、仮のスクリプトが残ってこのエラーになります。

原因	対処
オプション依存を無効にしている	npmの`--omit=optional`、pnpmの`--no-optional`、yarnの`--ignore-optional`を外し、`.npmrc`に`optional=false`がないか確認して入れ直す
インストールスクリプトを無効にしている	`node node_modules/@anthropic-ai/claude-code/install.cjs`を実行するか、`--ignore-scripts`なしで入れ直す
対応していないOS・CPU	対応は`darwin-arm64`・`darwin-x64`・`linux-x64`・`linux-arm64`・`linux-x64-musl`・`linux-arm64-musl`・`win32-x64`・`win32-arm64`の8種類
社内のnpmミラーに本体のパッケージがない	8種類の`@anthropic-ai/claude-code-*`もミラーしてもらう

npmにこだわらないなら、ネイティブインストーラーに切り替えるのがいちばん確実です。

# macOS・Linux・WSL
curl -fsSL https://claude.ai/install.sh | bash

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

npm版はNode.js 22以降が必要ですが、ネイティブインストーラーやHomebrew（brew install --cask claude-code）、WinGet（winget install Anthropic.ClaudeCode）ならNode.jsは不要です。権限エラーが出てもsudo npm install -gは使わないよう、公式ドキュメントで明記されています。

Auto-update failed と出てclaude doctorを促されたとき

ネイティブ版のClaude Codeは、起動時と実行中に更新を確認し、バックグラウンドで更新して次回の起動から反映します。公式ドキュメントには「直近の更新の結果はclaude doctorで確認できる」とあります。更新に失敗したと表示されたら、まずclaude doctorの出力を見てください。よくある原因は次のとおりです。

npm版で、npmのグローバル領域に書き込めない：起動時に一度だけ通知が出て、claude doctorに修正方法が表示されます。ネイティブインストーラーへの切り替えが確実です
ダウンロードが途中で切れた：The connection dropped while downloading the updateと出ます。最大3回まで自動で再試行し、それでも失敗した状態です。claude updateをもう一度実行し、会社のネットワークならプロキシ（HTTPS_PROXY）やdownloads.claude.aiへの通信が許可されているかを確認します
10分以内に終わらない：Download timed out: exceeded the total deadlineは再試行されないので、速い回線でclaude updateを実行します

なお、HomebrewとWinGetで入れた場合は既定では自動更新されないため、brew upgrade claude-codeやwinget upgrade Anthropic.ClaudeCodeで手動で更新します。

command not found: claude（PATHが通っていない）

インストールは成功しているのにclaudeが見つからない場合、ほとんどはPATHの問題です。インストーラーは、macOS・Linuxでは~/.local/bin/claude、Windowsでは%USERPROFILE%\.local\bin\claude.exeに置きます。

# 確認（何も表示されなければPATHに入っていない）
echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

# zshの場合（macOSの標準）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

bashなら~/.bashrcに同じ行を追加します。Windows PowerShellでは次のようにユーザーのPATHに追加し、ターミナルを開き直してからclaude --versionで確認します。

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

「更新したのに古い版が動く」場合は、npm版とネイティブ版が両方入っている可能性があります。which -a claude（Windowsはwhere.exe claude）で複数表示されたら、使わないほうを削除してください。

Windowsでインストールコマンドが通らない

Windowsで多いのは、PowerShellとCMDのコマンドの取り違えです。プロンプトの先頭にPSが付いていればPowerShell、付いていなければCMDです。

シェル	インストールコマンド
PowerShell	`irm https://claude.ai/install.ps1 \| iex`
CMD	`curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd`
WSL	`curl -fsSL https://claude.ai/install.sh \| bash`

irm https://claude.ai/install.ps1だけを実行すると、スクリプトの中身が表示されるだけで何も入りません。| iexまで含めて実行してください。

ログイン・認証のエラー

Login expired · Please run /login

保存されたclaude.aiのログインの更新が拒否され、Claude Codeが認証情報を消した状態です。/loginでサインインし直すまで、同じメッセージが出続けます。/statusの「Login」欄に「Expired — log in again」と出ていれば、この状態です。

ブラウザが開かない・ログインコードが表示される

WSL2、SSH接続、コンテナの中では、ブラウザからClaude Codeに戻れないことがあります。ブラウザに表示されたログインコードを、ターミナルのPaste code here if promptedに貼り付けてください。ブラウザが開かないときはcを押すとURLがコピーされます。貼り付けが効かない場合はclaude auth loginを使います。

403 Forbidden・This organization has been disabled

Claude Codeを使えるのは、Claude Pro・Max・Team・Enterpriseの各プランか、Claude Consoleのアカウントです。API Error: 403 Request not allowedなら、claude.ai/settingsで契約が有効か、Consoleなら「Claude Code」か「Developer」のロールがあるかを確認します。社内のプロキシが原因のこともあります。

契約があるのにThis organization has been disabledと出る場合は、シェルの設定に残った古いANTHROPIC_API_KEYがサブスクリプションより優先されています。

unset ANTHROPIC_API_KEY
claude

~/.zshrcや~/.bashrcのexport ANTHROPIC_API_KEY=...の行も消し、/statusでどの認証が使われているかを確認してください。

利用上限・レート制限のエラー

メッセージ	意味	対処
`You've hit your session limit`／`weekly limit`	プランの利用枠（全モデル共通）に到達	表示された時刻のリセットを待つ。モデルを変えても回復しない
`You've hit your Opus limit`／`Sonnet limit`	そのモデル系統の枠に到達	`/model`で別系統のモデルに切り替える
`Server is temporarily limiting requests (not your usage limit)`	一時的な制限で、プランの枠とは無関係	少し待つ
`Request rejected (429)`	APIキーやクラウドのレート制限	`/status`で意図した認証か確認

残りの枠とリセット時刻は/usageで確認できます。

エラーは出ないが遅い・指示を守らない

会話が長くなって重い・的外れになる：/contextで使用量を見て、同じ作業を続けるなら/compact、別の作業なら/clear。コマンドの使い分けは「Claude Code コマンド一覧」にまとめています
CPU・メモリの使用量が多い：公式ドキュメントは/compact、作業の区切りでの再起動、claude --safe-modeでプラグイン・MCP・フックを切り分ける方法を案内しています
確認ばかり求められる：/permissionsで許可ルールを見直します。考え方は「Claude Codeの権限設定」で解説しています
CLAUDE.mdが効かない：/contextのメモリファイルの欄に出ていなければ読み込まれていません。置き場所は「CLAUDE.mdの書き方」を参照してください
MCPサーバーにつながらない：/mcpで状態を確認します。設定は「Claude CodeのMCP設定方法」で解説しています

原因がわからないときの切り分け順

claude doctor：インストール・設定・自動更新の診断
claude --version：起動できるか、どの版か
/status：認証方法とログイン状態
which -a claude：二重インストールの確認
claude --safe-mode：カスタマイズを外して起動し、プラグインやMCPが原因か切り分ける
status.claude.com：サービス側の障害の確認

macOS 12以前で起動しない場合は「Claude CodeのMac動作要件はmacOS 13以上」、インストール手順そのものは「Claude Codeの環境構築方法」、全体像は「Claude Codeとは？」をご覧ください。重い処理を軽いモデルに任せる方法は「サブエージェント完全ガイド」で解説しています。

よくある質問

Q. Claude Codeで「サーバーが混雑しています」と出たらどうすればいいですか？

サービス側の混雑なので、手元の設定では直りません。status.claude.com で状況を確認し、数分待って再実行するか、/model で別のモデルに切り替えてください。529 Overloaded は利用枠を消費しません。

Q. Error: claude native binary not installed はどう直せばいいですか？

npm でインストールしたときに、OS別の本体がダウンロードされなかったか、postinstall が実行されなかったのが原因です。–omit=optional や –ignore-scripts を外して入れ直すか、ネイティブインストーラーに切り替えます。

Q. インストールし直せば直りますか？

PATH の問題や二重インストールが原因なら、入れ直しても同じ状態になります。先に claude doctor と which -a claude で状況を確認してください。

Q. Node.jsは必要ですか？

ネイティブインストーラー、Homebrew、WinGet で入れる場合は不要です。npm で入れる場合だけ Node.js 22 以降が必要です。

Q. 無料プランでClaude Codeは使えますか？

公式ドキュメントでログインに使えるのは、Claude Pro・Max・Team・Enterprise のプランか Claude Console のアカウントです。claude.ai の無料プランは含まれていません。

Claude Codeなどの生成AIを使ったアプリ開発を基礎から学びたい方には、テックジムのAI駆動開発コースもあります。

無料のClaude Code講座のご案内

テックジム東京本校では、Claude Codeの体験講座を毎週土曜15時から無料で開いています。ノートPCを持参し、対面のハンズオンで1時間、未経験の方でも参加できます（中学生以上）。詳しくはゼロから始めるClaude Code講座【東京本校・リアル開催】をご覧ください。

対面・無料｜東京・永田町で毎週土曜日13時

1回の参加で、プログラミングの構造がわかる

ゼロからはじめるPython入門講座

8年間・累計600回開催／これまで全国で2万人以上が参加

「やはり対面で聞けるのはとても気づきがあり、価値があると思います」

参加者の声

本当に初心者からの講座です。プログラミングに触ったことがなくて大丈夫です
対面だから、その場で聞けます。つまずいた所を持ち帰らずに解決できます
講座は1時間。そのあとも残って学習を続けられ、講師にも質問できます
独学で挫折した方も。糸口が見つかって、講座のあと会員になる方が多くいます

無料で参加する｜開催日程を見る

参加費は無料です

プログラミング学習に関するお役立ちコンテンツ

カテゴリー: コラム

Claude Codeのエラー対処一覧｜「サーバーが混雑しています」「native binary not installed」「Auto-update failed」の直し方

まず試すこと：claude doctorと/doctor

エラーメッセージの逆引き表

「サーバーが混雑しています」「529 Overloaded」が出るとき

Error: claude native binary not installed の直し方

Auto-update failed と出てclaude doctorを促されたとき

command not found: claude（PATHが通っていない）

Windowsでインストールコマンドが通らない

ログイン・認証のエラー

Login expired · Please run /login

ブラウザが開かない・ログインコードが表示される

403 Forbidden・This organization has been disabled

利用上限・レート制限のエラー

エラーは出ないが遅い・指示を守らない

原因がわからないときの切り分け順

よくある質問

Q. Claude Codeで「サーバーが混雑しています」と出たらどうすればいいですか？

Q. Error: claude native binary not installed はどう直せばいいですか？

Q. インストールし直せば直りますか？

Q. Node.jsは必要ですか？

Q. 無料プランでClaude Codeは使えますか？

無料のClaude Code講座のご案内

プログラミング学習に関するお役立ちコンテンツ

Pythonのhash()関数とは？ハッシュ値が実行ごとに変わる理由とunhashableエラーの直し方New!!

Python formatの使い方｜f文字列の書式指定を自作クラスで受け取る方法とTypeErrorの原因New!!

まず試すこと：claude doctorと/doctor

エラーメッセージの逆引き表

「サーバーが混雑しています」「529 Overloaded」が出るとき

Error: claude native binary not installed の直し方

Auto-update failed と出てclaude doctorを促されたとき

command not found: claude（PATHが通っていない）

Windowsでインストールコマンドが通らない

ログイン・認証のエラー

Login expired · Please run /login

ブラウザが開かない・ログインコードが表示される

403 Forbidden・This organization has been disabled

利用上限・レート制限のエラー

エラーは出ないが遅い・指示を守らない

原因がわからないときの切り分け順

よくある質問

Q. Claude Codeで「サーバーが混雑しています」と出たらどうすればいいですか？

Q. Error: claude native binary not installed はどう直せばいいですか？

Q. インストールし直せば直りますか？

Q. Node.jsは必要ですか？

Q. 無料プランでClaude Codeは使えますか？

無料のClaude Code講座のご案内

プログラミング学習に関するお役立ちコンテンツ

Pythonのhash()関数とは？ハッシュ値が実行ごとに変わる理由とunhashableエラーの直し方New!!

Python __format__の使い方｜f文字列の書式指定を自作クラスで受け取る方法とTypeErrorの原因New!!

Python formatの使い方｜f文字列の書式指定を自作クラスで受け取る方法とTypeErrorの原因New!!