claude-code - 💡(How to fix) Fix False positive 'Update available' banner when already on latest version [2 comments, 3 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#49251Fetched 2026-04-17 08:46:36
View on GitHub
Comments
2
Participants
3
Timeline
9
Reactions
4
Author
Timeline (top)
labeled ×5commented ×2cross-referenced ×2

The status bar (bottom right) persistently shows "Update available! Run: brew upgrade claude-code" even though the installed version is already the latest.

Root Cause

The status bar (bottom right) persistently shows "Update available! Run: brew upgrade claude-code" even though the installed version is already the latest.

Code Example

$ claude --version
2.1.92 (Claude Code)

$ brew info claude-code
==> claude-code (Claude Code): 2.1.92
Installed: 2.1.92

$ brew outdated claude-code
(no output)
RAW_BUFFERClick to expand / collapse

Description

The status bar (bottom right) persistently shows "Update available! Run: brew upgrade claude-code" even though the installed version is already the latest.

Steps to Reproduce

  1. Install claude-code via Homebrew (brew install claude-code)
  2. Observe the "Update available" banner in the bottom-right of the Claude Code window
  3. Run brew upgrade claude-code — reports already up to date
  4. Run brew reinstall claude-code — banner persists after restart

Environment

  • Installed version: 2.1.92 (confirmed via claude --version)
  • Homebrew cask version: 2.1.92 (confirmed via brew info --json=v2 claude-code)
  • brew outdated claude-code: returns nothing (no update available)
  • Platform: macOS (Darwin 24.6.0, Apple Silicon)
  • Install method: Homebrew cask

Verification

All of the following confirm no update is actually available:

$ claude --version
2.1.92 (Claude Code)

$ brew info claude-code
==> claude-code (Claude Code): 2.1.92
Installed: 2.1.92

$ brew outdated claude-code
(no output)

Expected Behavior

The "Update available" banner should not appear when the installed version matches the latest available version.

Actual Behavior

The banner persists across restarts and even after brew reinstall. There is no local cache file to clear that resolves it. The update check mechanism appears to be out of sync with the actual latest version.

extent analysis

TL;DR

The "Update available" banner may be due to a mismatch between the installed version and the version reported by the update check mechanism, and a potential workaround is to reset the application's internal state or check for any configuration files that might be causing the issue.

Guidance

  • Check if there are any configuration files or preferences associated with Claude Code that might be causing the update check mechanism to malfunction.
  • Verify that the brew package manager is properly configured and up-to-date, as issues with brew can sometimes cause problems with installed packages.
  • Consider resetting Claude Code to its default settings or reinstalling it using a different method to see if the issue persists.
  • Look for any error messages or logs that might indicate what is causing the update check mechanism to report an available update when none is present.

Example

No code snippet is provided as the issue seems to be related to the application's internal state or configuration rather than a specific code problem.

Notes

The issue might be specific to the interaction between Claude Code and Homebrew, or it could be a problem with the application's update check mechanism. Without more information about the internal workings of Claude Code, it's difficult to provide a more specific solution.

Recommendation

Apply workaround: The issue seems to be related to the application's internal state or configuration, so trying to reset the application or reinstall it using a different method might resolve the problem.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING