auto-update failed が消えないときに見たことauto-update failed の表示が出ても、実際には壊れていないケースがあります。少なくとも issue #82408 と #89286 では、背景の自動更新が一度失敗したあと、その失敗表示が残り続ける挙動が報告されています。しかも claude doctor を実行しても「No installation issues found」と返り、表示されている警告と実態が一致しません。
読者がまず確認したいのは、今見えている auto-update failed が「本当に更新失敗中」なのか、「過去の失敗記録が残っているだけ」なのかです。issue の報告を見る限り、この切り分けが重要です。#82408 では、失敗時の状態が ~/.claude/.last-update-result.json に残る一方で、claude doctor はその内容を見ていないと説明されています。#89286 でも、健康診断は通るのに、画面右下の警告だけが居座る、と報告されています。
手元で実測できている範囲では、環境情報は次のとおりです。
[env_summary]
OS : Linux 3.10.0-1160.76.1.el7.x86_64 (x86_64)
Python : 3.8.13
検証日時 : 2026-08-26T08:50:43+09:00
この環境では Claude Code 本体の更新挙動そのものは再現していません。なので、ここで書けるのは issue で確認されている事実だけです。たとえば #82408 の報告では、claude update を実行しても、すでに最新の場合は「Claude Code is up to date」と出るだけで、古い失敗記録は消えないとされています。コメントでも同じ点が補強されていて、成功した手動更新が記録ファイルを書き換えないため、表示が永続化する、と述べられています。
つまり、claude doctor が正常でも auto-update failed が残るなら、少なくとも issue ベースでは「インストール全体の異常」ではなく「自動更新の失敗履歴が残っているだけ」の可能性があります。逆に、表示が出ていても claude doctor が何も拾わないなら、その警告文だけを信じて作業を止める必要はなさそうです。ただし、これは issue の観測に基づく言い方であって、こちらで独自に再現確認したわけではありません。
報告されている回避策も、かなり限定的です。#82408 の本文とコメントでは、~/.claude/.last-update-result.json を手で消すと表示が消えるケースがある一方で、あとから再び失敗記録が生成されるので恒久対策にはならない、とされています。つまり、ファイルを消して終わりではなく、背景の更新処理がまた失敗すれば同じ表示に戻る、ということです。
この症状に遭遇したときは、まず claude doctor の結果と、auto-update failed の表示が一致しているかを見てください。一致しないなら、issue で報告されているのと同じ「古い失敗状態が残っている」側に近いはずです。現時点で確認できるのはそこまでで、根本修正は issue 側でも未解決です。
OS : Linux 3.10.0-1160.76.1.el7.x86_64 (x86_64)
Python : 3.8.13
検証日時 : 2026-08-26T08:50:43+09:00