The connection droppedエラーの対処 — Claude Codeアップデート

「The connection dropped」はバイナリのダウンロードが途中で切れたエラー

claude install・claude update・バックグラウンドで動く自動アップデーターのいずれかが、Claude Code本体のバイナリを取得している最中に起きます。ダウンロード先サーバーとの接続が切れると、次のメッセージが出ます。

The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

かっこ内には失敗した試行回数(例では3回中3回目)と、その時点で発生したネットワークエラーの種類が入ります。表示される回数や内訳は実行のたびに変わり得るため、ログを控えておくと再現性のあるトラブルかどうかの判断材料になります。claude updateから出る場合は、標準エラー出力にError: Failed to install native updateという一行が前に付きます。

Claude Codeは接続が切れた・転送が止まった・ダウンロード後のチェックサムが一致しなかった、のいずれかが起きると自動でダウンロードをリトライします。上限は合計3回です。3回とも失敗した時点でこのエラーになります。一方、404のようにサーバーが明確なエラーを返して応答を完了させた場合はリトライしません。サーバーが「もう一度聞いても同じ答えが返る」ことが分かっているケースだからです。

接続は保たれたまま10分以内にダウンロードが終わらない場合は、このメッセージにはなりません。代わりにDownload timed out: exceeded the total deadlineという別のメッセージになり、こちらもリトライはされません。制限時間内に終わらない遅さの回線は、即座に再試行しても結果は変わらないという判断です。

The connection droppedは切れた接続の回数を数えるエラーで、Download timed outは時間切れを検知するエラーです。原因の性質が異なるため区別しておくと切り分けが早くなりますが、以降の対処はどちらのメッセージにも共通です。

このエラーが表示された時点で、内部的なリトライはすでに使い切られています。だからといって手動での再実行が無意味というわけではありません。直前と全く同じ経路上の恒常的な不調であれば同様に失敗しますが、回線の瞬断やサーバー側の一時的な混雑が原因なら、時間を空けて実行し直すだけで解消することは珍しくありません。

対処 — まず再実行、直らなければプロキシを疑う

大半のケースは一時的なネットワークの揺らぎで、単純な再実行で解決します。

claude update

The connection dropped側は接続が途中で断たれた合図なので、再実行すれば同じ試行が短時間でもう一度走るだけで済みます。健全なネットワークであれば次の実行で通ることがほとんどです。一方Download timed out側は転送速度が遅すぎて制限時間内に終わらなかった合図で、即座に再試行しても同じ結果になりやすい性質です。回線が細い環境でこちらのメッセージが出た場合は、時間を置くよりも先に、より高速な回線やモバイルルーターの帯域を使わないネットワークに切り替える方が早く解決します。

繰り返し失敗する場合、原因は多くがプロキシやゲートウェイが長時間の転送を途中で切っていることです。Claude Codeのバイナリは比較的サイズが大きいダウンロードで、通常のAPI通信では問題にならないプロキシの接続時間制限に引っかかることがあります。プロキシ経由が必要な環境では、インストーラーやclaude updateの実行前に環境変数を設定します。

export HTTPS_PROXY=http://proxy.example.com:8080
claude update

社内プロキシがどうしても長時間転送を切ってしまう場合は、ネットワーク管理者にdownloads.claude.aiからのダウンロードを許可してもらう必要があります。原因の切り分けに迷ったら、まずclaude doctorでネットワーク診断の結果を確認してください。環境変数の設定だけで解決するケースと、管理者側の許可リスト変更が必要なケースを早めに見分けることで、無駄な再試行を減らせます。

インストール時とアップデート時、両方で出るメッセージ

このエラーは初回インストール(claude install)でも、既存環境の更新(claude update・自動アップデーター)でも同じ文言で出ます。バイナリを取得する処理そのものが共通だからです。新規インストール時に別系統のネットワークエラー(curl: (56)・curl: (23)・TLSハンドシェイク失敗など)に当たることもあります。これはインストーラーのシェルスクリプトが直接出すエラーで、リトライ・チェックサム検証を経由しない別の失敗経路です。切り分けはClaude Codeインストールエラーの切り分けチェックリストのネットワーク・証明書の節で扱っています。

claude update実行時には、その他の失敗パターンもあります。シェル設定ファイルのスキャンでハングする、npmのグローバルディレクトリへの書き込み権限がない、WinGetの実行中ロックで失敗する、パッケージマネージャー側の反映が遅れる、といった原因です。これらはClaude Codeアップデートの方法にまとめてあります。この記事はダウンロード時の接続断・タイムアウト系だけに絞って深掘りしています。

ダウンロードするバイナリの取得先ホストはdownloads.claude.aiで固定されています。ネイティブインストーラー・ネイティブ自動アップデーター・バージョンチェックのすべてがこの1ホストに集約されています。プロキシやファイアウォールの許可リストにここが漏れていると、通常のAPI通信(api.anthropic.com)は通るのにアップデートだけ失敗するという状態になります。API通信は正常なのにアップデートだけこのエラーになる場合は、まずこのホストが許可リストに入っているかを確認するのが近道です。

v2.1.202より前は1回切れただけで即失敗していた

v2.1.202より前のClaude Codeは、ダウンロード中の接続断を1回検知した時点で即座に失敗させ、abortedという素っ気ない一言だけを表示していました。リトライという仕組み自体がなく、不安定なネットワークでは何度実行しても同じところで落ちることがありました。

現在のバージョンでこのエラーに当たった場合、1回程度の揺らぎではもう表面化しない仕組みの先で起きています。つまり単発の瞬断は内部のリトライで吸収済みで、それでもなお失敗が残った状態を見ているということです。エラーが出た時点でネットワーク側に構造的な問題がある可能性は、v2.1.202より前より高いと考えられます。

よくある質問

ダウンロードは新しいバイナリだけですか、設定も失われますか

ダウンロードが失敗するのはClaude Code本体のバイナリ取得だけで、settings.jsonや認証情報には影響しません。失敗した回のダウンロードは何も適用されずに終わるため、既存のインストールはそのまま動き続けます。

自動アップデーターとネイティブインストーラー、どちらの経路で失敗していますか

新規インストール中にこのエラーが出た場合はclaude installまたは初回セットアップの経路、既存環境で気づかないうちに古いバージョンのままだった場合は自動アップデーターの経路です。どちらも同じdownloads.claude.aiから同じバイナリを取得する処理を経由するため、エラーメッセージ自体は共通で、対処法も変わりません。表示されたタイミング(セットアップ中か、普段の起動時か)で判断できます。

バックグラウンドの自動アップデーターが失敗し続けていないか確認する方法はありますか

自動アップデーターは起動のたびに裏で最新版を確認・取得しますが、ダウンロードが失敗しても対話セッション中に目立つ通知が出るとは限りません。気づかないまま古いバージョンを使い続けることを避けるには、定期的な確認が確実です。claude --versionで今のバージョンを確認するか、claude doctorを実行して最新版との差分診断を見る習慣をつけてください。

VPNを使っているとこのエラーが出やすいですか

VPN自体が原因になるとは限りませんが、VPN経由の経路がさらに社内プロキシを挟む多段構成になっている場合、どちらかの区間で長時間の転送が切られやすくなります。VPN接続時にだけこのエラーが再現する場合は、VPNを切った状態、あるいは自宅などの単純なネットワークから一度claude updateを試し、経路の複雑さが原因かどうかを切り分けてください。

チェックサムが一致しないとどうなりますか

ダウンロードしたバイナリがチェックサム検証に失敗した場合も、接続が切れた場合や転送が止まった場合と同じ扱いでリトライの対象になります。合計3回の試行の中でチェックサムの不一致・接続断・転送停止のどれが起きても区別なくカウントされ、3回とも失敗した時点で同じThe connection droppedエラーになります。

会社のネットワークでは接続すらできません

HTTPS_PROXYを設定しても症状が変わらない場合、プロキシがそもそもdownloads.claude.aiへの到達自体をブロックしている可能性があります。許可ドメインの設定手順はClaude Codeプロキシ設定ガイドにまとめてあります。ネットワーク管理者と一緒に確認してください。

遠回りの少ない切り分け順は次の通りです。

1. claude updateをもう一度実行する
2. 繰り返し失敗するならHTTPS_PROXYを設定して再試行する
3. それでも直らなければdownloads.claude.aiへの到達性をclaude doctorで確認する
4. 社内プロキシが原因と分かればネットワーク管理者に許可リストへの追加を依頼する

個人のネットワークやモバイル回線からの実行では、2番目の時点でネットワークそのものを変える方が早いこともあります。

まとめ

「The connection dropped while downloading the update」は、ダウンロードのリトライを3回とも使い切った後に出るエラーです。まずはclaude updateを再実行し、直らなければプロキシが長時間転送を切っていないかを疑います。10分以内に終わらない場合のDownload timed outも対処は同じです。v2.1.202より前は1回の接続断で即失敗していたため、古いバージョンで頻発する場合はアップデート自体をまず試す価値があります。