PaPoo
cover

Auto-update failed が消えないときに見ること

まず、自分のケースかどうかはかなり絞れます。claude doctorAuto-update failed 相当の履歴が残り続け、しかも Last update attempt: failed のような表示が消えないなら、今回の症状クラスタに近いです。Issue では、更新チェックや一時的なネットワーク断をきっかけに失敗状態が記録され、その後の起動や再接続、claude update/doctor でも自動では消えない報告がありました。

関係する報告は #70608#65093 です。前者は ~/.claude/.last-update-result.json に入った失敗状態がその後の成功で上書きされない、という内容でした。後者は Windows でセッション中にネットワークが落ちたあと、Auto-update failed のバナーが再接続後も残り、/doctor でも Last update attempt: failed (install_failed) のままになる、という報告です。

手元の環境では、少なくとも「Claude Code が native インストールで動いている」「claude doctor は正常系に見えるのに、過去の更新失敗が残るかどうかを見たい」という切り分けに使える出力が取れました。claude doctor では次のように出ています。

$ claude doctor
Claude Code doctor

Running: native (2.1.207)
Commit: bc512d563325
Platform: darwin-arm64
Path: ~/.local/share/claude/versions/2.1.207
Config install method: native
Search: OK (bundled)
Auto-updates: enabled
Auto-update channel: latest
Last update attempt: none recorded

Multiple installations found
- npm-global at /usr/local/bin/claude
- native at ~/.local/bin/claude

Remote Control
Control this session from claude.ai/code or the Claude mobile app

1 warning found
- Leftover npm global installation at /usr/local/bin/claude
  Fix: Run: npm -g uninstall @anthropic-ai/claude-code

For a full setup checkup that can also fix issues, run /doctor in a Claude Code session.

この出力だけを見る限り、少なくとも筆者の環境では Last update attempt: none recorded で、Issue で問題になっている「失敗が履歴に固定される」状態は再現していません。したがって、今この文章で確実に言えるのは、claude doctorLast update attempt: failed (install_failed) を返している人は、#65093#70608 と同系統の可能性がある、というところまでです。逆に、手元のように none recorded なら、少なくともこの sticky な失敗状態そのものは見えていません。

多重インストールも一応確認できます。claude の解決先はこうでした。

$ /usr/bin/which -a claude
~/.local/bin/claude
/usr/local/bin/claude
/usr/local/bin/claude

そして claude doctor でも npm-global の残骸が警告されています。

Multiple installations found
- npm-global at /usr/local/bin/claude
- native at ~/.local/bin/claude

ただし、今回の Auto-update failed が多重インストール由来だとまでは、この出力からは断定できません。Issue 側で問題になっているのは、ネットワーク断や更新チェック失敗のあとに失敗状態が残り続ける点であり、インストールの数そのものではありません。

見分け方は単純です。claude doctorLast update attemptfailed (install_failed) のままかどうかを見ます。Issue では、再接続後や成功した更新確認のあとでもこの値が戻らない報告がありました。手元ではそもそも失敗記録がなく、Last update attempt: none recorded でした。つまり、少なくともこの検証では症状は再現していません。

もし自分の環境で Auto-update failed が消えないなら、まず claude doctorLast update attempt と、/usr/bin/which -a claude の結果を見比べるのが出発点です。none recorded なら今回の sticky failure ではなさそうですし、failed (install_failed) が残っているなら issue の報告と一致します。現時点では、この状態が手動で確実に消える手順は、提示された issue からは確認できませんでした。


検証環境

claude --version : 2.1.207 (Claude Code)
OS          : Darwin 25.3.0 (arm64)
Python      : 3.14.2
検証日時    : 2026-08-20T09:48:39+09:00

参照した Issue(anthropics/claude-code): #65093, #70608

同じ著者の記事