[BUG] - CLI is insisting an upgrade is required

Resolved 💬 3 comments Opened Jan 28, 2026 by novemberalpha Closed Jan 31, 2026

Preflight Checklist

  • [x] I have searched existing issues and this hasn't been reported yet
  • [x] This is a single bug report (please file separate reports for different bugs)
  • [x] I am using the latest version of Claude Code

What's Wrong?

why do you keep saying an update is available when it is not. I've run
brew upgrade claude-code several times and it reports thre is no update

⏺ I understand your frustration. This is likely a version check caching issue
in the CLI. Let me help troubleshoot:

⏺ Bash(claude-code --version)
⎿ Error: Exit code 127
(eval):1: command not found: claude-code

⏺ Bash(brew info claude-code)
⎿ ==> claude-code: 2.1.20
https://www.anthropic.com/claude-code
Installed
… +12 lines (ctrl+o to expand)

⏺ Bash(claude --version 2>&1 | head -5)
⎿ 2.1.20 (Claude Code)

⏺ Your installed version (2.1.20) matches what Homebrew reports as current. The
update notification is likely cached. Try:

⏺ Read 1 file (ctrl+o to expand)

⏺ The update notification might be stale. Try these steps:

  1. Update Homebrew itself (in case its version cache is old):

brew update

  1. Clear Homebrew's cache:

brew cleanup claude-code

  1. Restart your terminal completely (the notification might persist in the

current session)

If it persists, this is likely a bug in the CLI's update check logic. You can
report it at: https://github.com/anthropics/claude-code/issues

You're on the latest version (2.1.20), so you can safely ignore the
notification.

✻ Sautéed for 30s

❯ clearly there's a bug with the claude-code cli app

⏺ You're absolutely right. The version check is incorrectly showing an update
notification when you're already on the latest version (2.1.20). This is a
bug in the CLI.

Please report it at https://github.com/anthropics/claude-code/issues with:

  • Your version: 2.1.20
  • Platform: macOS (Homebrew)
  • Issue: False update notification despite being current

In the meantime, you can safely ignore the notification - you're up to date.

What Should Happen?

Show me an upgrade notice when it's required and be right about it - ffs!

Error Messages/Logs

(base) jjuhnke@Mac root-health % brew upgrade claude-code 
✔︎ JSON API cask.jws.json                                                             Downloaded   15.3MB/ 15.3MB
✔︎ JSON API formula.jws.json                                                          Downloaded   32.0MB/ 32.0MB
Warning: Not upgrading claude-code, the latest version is already installed

Steps to Reproduce

(base) jjuhnke@Mac root-health % brew upgrade claude-code
✔︎ JSON API cask.jws.json Downloaded 15.3MB/ 15.3MB
✔︎ JSON API formula.jws.json Downloaded 32.0MB/ 32.0MB
Warning: Not upgrading claude-code, the latest version is already installed

Claude Model

None

Is this a regression?

Yes, this worked in a previous version

Last Working Version

_No response_

Claude Code Version

2.1.20

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

_No response_

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗