Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix "Update available" notification persists on latest Homebrew version (v2.1.109) — regression from #43251 fix [1 comments, 1 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#54844•Fetched 2026-04-30 06:34:20
View on GitHub
Comments
1
Participants
1
Timeline
6
Reactions
0
Author
bryanjjbryanjj
Participants
bryanjjbryanjj
Timeline (top)
labeled ×4closed ×1commented ×1

The "Update available! Run: brew upgrade claude-code" notification appears in the status line, but brew upgrade has no newer version available. The notification directs users to a command that can't resolve it.

It appears the update check is comparing against a version (2.1.116) that exists on npm but hasn't landed in the Homebrew cask yet. This is the same root cause as #43251, which was reportedly fixed in v2.1.101 to compare against the actual cask version on formulae.brew.sh.

Root Cause

It appears the update check is comparing against a version (2.1.116) that exists on npm but hasn't landed in the Homebrew cask yet. This is the same root cause as #43251, which was reportedly fixed in v2.1.101 to compare against the actual cask version on formulae.brew.sh.

Code Example

$ claude --version
2.1.109 (Claude Code)

$ brew info claude-code
==> claude-code (Claude Code): 2.1.109
Installed
/opt/homebrew/Caskroom/claude-code/2.1.109 (201.7MB)
RAW_BUFFERClick to expand / collapse

Description

The "Update available! Run: brew upgrade claude-code" notification appears in the status line, but brew upgrade has no newer version available. The notification directs users to a command that can't resolve it.

It appears the update check is comparing against a version (2.1.116) that exists on npm but hasn't landed in the Homebrew cask yet. This is the same root cause as #43251, which was reportedly fixed in v2.1.101 to compare against the actual cask version on formulae.brew.sh.

Steps to reproduce

  1. brew upgrade claude-code → confirms already on latest Homebrew version (2.1.109)
  2. Launch claude
  3. "Update available! Run: brew upgrade claude-code" shown in lower-right status line
  4. Running brew upgrade again does nothing — 2.1.109 is the latest available via Homebrew

Environment

$ claude --version
2.1.109 (Claude Code)

$ brew info claude-code
==> claude-code (Claude Code): 2.1.109
Installed
/opt/homebrew/Caskroom/claude-code/2.1.109 (201.7MB)
  • Latest available (npm): 2.1.116
  • Latest available (Homebrew): 2.1.109
  • Platform: macOS Darwin 25.5.0 (Apple Silicon)
  • Install method: Homebrew

Expected

For Homebrew installs, the update check should either:

  1. Compare against the latest Homebrew cask version (not npm), or
  2. Suggest npm install -g @anthropic-ai/claude-code@latest if the Homebrew version lags behind

extent analysis

TL;DR

The update check should compare against the latest Homebrew cask version instead of the npm version to resolve the mismatch.

Guidance

  • Verify the version discrepancy between Homebrew and npm by checking the brew info claude-code output and the latest version available on npm.
  • Consider modifying the update check to compare against the Homebrew cask version, as suggested in the expected behavior.
  • If the Homebrew version is outdated, suggest using npm install -g @anthropic-ai/claude-code@latest as a workaround to get the latest version.
  • Review the fix implemented in v2.1.101 to ensure it correctly compares against the actual cask version on formulae.brew.sh.

Example

No code snippet is provided as it is not explicitly mentioned in the issue.

Notes

The issue seems to be related to a version comparison mismatch between Homebrew and npm, which was reportedly fixed in v2.1.101. However, the fix may not be fully effective, leading to the current issue.

Recommendation

Apply workaround: Suggest using npm install -g @anthropic-ai/claude-code@latest if the Homebrew version is outdated, as this provides a way to get the latest version despite the Homebrew version lagging behind.

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…
#generation error#database connection#vector store#embedding generation#cache error

Still need to ship something?

×6

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

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix "Update available" notification persists on latest Homebrew version (v2.1.109) — regression from #43251 fix [1 comments, 1 participants]