[DOCS] Homebrew install/update docs omit stable vs latest cask channels

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/setup

Section/Topic

Homebrew install tab and the Update Claude Code section

Current Documentation

The setup page currently says:

brew install --cask claude-code Homebrew installations do not auto-update. Run brew upgrade claude-code periodically to get the latest features and security fixes. Homebrew and WinGet installations do not auto-update. Use brew upgrade claude-code or winget upgrade Anthropic.ClaudeCode to update manually.

The same page explains release channels only for the native installer:

The native installer accepts either a specific version number or a release channel (latest or stable). The channel you choose at install time becomes your default for auto-updates.

No current code.claude.com page mentions claude-code@latest.

What's Wrong or Missing?

Changelog v2.1.92 says:

Fixed Homebrew install update prompts to use the cask's release channel (claude-code → stable, claude-code@latest → latest)

Current docs still present Homebrew as a single-cask install path and always tell users to update with brew upgrade claude-code.

That leaves the Homebrew guidance incomplete and partially outdated:

• it does not explain that Homebrew release-channel choice is cask-based
• it does not say that claude-code tracks the stable channel
• it does not document claude-code@latest for users who want the latest channel
• it tells Homebrew users to run a single upgrade command even though v2.1.92 now distinguishes the correct update prompt by installed cask

Suggested Improvement

Update the Homebrew install/update docs to document the cask-specific release channels and the matching upgrade commands.

For example, clarify that:

• brew install --cask claude-code follows the stable channel
• brew install --cask claude-code@latest follows the latest channel
• brew upgrade claude-code and brew upgrade claude-code@latest should match the cask the user installed

The duplicated Homebrew snippets in quickstart, overview, troubleshooting, terminal-guide, and plugin troubleshooting should either be updated to reflect the same distinction or link back to a single canonical explanation on the setup page.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/setup | 71, 75, 171 | Primary Homebrew install and manual update guidance |
| https://code.claude.com/docs/en/quickstart | 475, 667, 671 | Install configurator and Homebrew install/update copy |
| https://code.claude.com/docs/en/overview | 52, 56 | Homebrew install snippet and update guidance |
| https://code.claude.com/docs/en/discover-plugins | 403 | Homebrew update instructions in /plugin troubleshooting |
| https://code.claude.com/docs/en/terminal-guide | 221 | Homebrew fallback install command |
| https://code.claude.com/docs/en/troubleshooting | 249, 290 | Alternative Homebrew install instructions |

Total scope: 6 pages affected

No current code.claude.com page mentions claude-code@latest.

Source: Changelog v2.1.92

Changelog entry:

Fixed Homebrew install update prompts to use the cask's release channel (claude-code → stable, claude-code@latest → latest)