## Description The status line always shows `brew upgrade claude-code` even though the installed version is already the latest. ## Steps to Reproduce 1. Install claude-code via Homebrew 2. Launch Claude Code 3. Notice `brew upgrade claude-code` displayed in the status line on the right ## Expected Behavior The update hint should not appear when the installed version is already up to date. ## Actual Behavior Running `brew upgrade claude-code` returns "already up-to-date", but the hint cont

brew upgrade claude-code hint shown in status line even when already on latest version

Status Fixed / completed

Reported on v2.1.86

Maintainer reply ✓ Yes — ashwin-ant

Activity 7 comments · opened Mar 29, 2026 · closed Apr 18, 2026

💡 Likely answer: A maintainer (ashwin-ant, collaborator) responded on this thread — see the highlighted reply below.

Description

The status line always shows brew upgrade claude-code even though the installed version is already the latest.

Steps to Reproduce

Install claude-code via Homebrew
Launch Claude Code
Notice brew upgrade claude-code displayed in the status line on the right

Expected Behavior

The update hint should not appear when the installed version is already up to date.

Actual Behavior

Running brew upgrade claude-code returns "already up-to-date", but the hint continues to appear every session.

Environment

Claude Code version: 2.1.86
Homebrew formula version: 2.1.86
OS: macOS Darwin 25.4.0 (Apple Silicon)
Installed via: Homebrew Cask (/opt/homebrew/Caskroom/claude-code/2.1.86)

View original on GitHub ↗

7 Comments

yurukusa · 5 months ago

The update hint compares version numbers differently than Homebrew, causing false positives.

// ~/.claude/settings.json
{
  "autoUpdate": false
}

If you use a custom statusLine, the built-in update hint is replaced by your custom output:

{
  "statusLine": {
    "enabled": true,
    "template": "{{model}} | {{tokenUsage}}"
  }
}

This replaces the default status bar (including the update hint) with your preferred information.

herveyallen · 5 months ago

Same issue:

macOS 26.4 on M3 MacBook Pro
Claude Code v2.1.81
Brew install at /opt/homebrew/Caskroom/claude-code/2.1.86

Error displayed in UI (bottom-right)
"Update available! Run: brew upgrade claude-code"

file ~/.claude/settings.json is blank:

{
}

Running zsh 5.9 (arm64-apple-darwin25.0) in macOS terminal

immdevrov · 5 months ago

Happening on v2.1.81 (macOS 15.5, Homebrew cask, arm64). brew outdated claude-code returns nothing.

This has been reported many times now:

#40464
#41139
#41140
#41194
#41444
#41602
#41623
#41650 (marked duplicate)
#41840
#41947

Would be great to get this prioritized in some way

Thanks!

noeclement · 4 months ago

@immdevrov you might want to try this https://github.com/anthropics/claude-code/issues/41947#issuecomment-4170128953

immdevrov · 4 months ago

I never would've guessed, but i think, resolutiols lies in here
https://formulae.brew.sh/cask/claude-code#default:

This cask tracks the stable release channel. In-app update notifications
default to the latest channel regardless. To align notifications with this
cask, set the auto-update channel to "stable" via /config or in
~/.claude/settings.json:
    https://code.claude.com/docs/en/setup#configure-release-channel

maybe this was the reason for notification all along

ashwin-ant collaborator · 4 months ago

This was fixed in v2.1.101 — The 'Update available' hint for Homebrew installs now checks the actual cask version instead of suggesting an upgrade Homebrew can't deliver. If you're still seeing this in the latest version, please comment with your version and repro and we'll reopen.

github-actions[bot] · 4 months ago

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.