Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [DOCS] Package-manager install docs still describe Homebrew and WinGet as manual-update only [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#56490•Fetched 2026-05-06 06:26:40
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
0
Author
coygeekcoygeek
Participants
coygeekcoygeek
Timeline (top)
labeled ×3

Root Cause

That leaves three gaps under one root cause: the docs have not been updated for the new package-manager auto-update behavior.

RAW_BUFFERClick to expand / collapse

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

"Install Claude Code" Homebrew/WinGet tabs and the "Update Claude Code" section

Current Documentation

The docs currently say:

Native installations automatically update in the background. You can configure the release channel to control whether you receive updates immediately or on a delayed stable schedule, or disable auto-updates entirely. Homebrew, WinGet, and Linux package manager installations require manual updates.

Homebrew, WinGet, apt, dnf, and apk installations do not auto-update. For Homebrew, run brew upgrade claude-code or brew upgrade claude-code@latest, depending on which cask you installed. For WinGet, run winget upgrade Anthropic.ClaudeCode.

The install tabs also say:

Homebrew installations do not auto-update. Run brew upgrade claude-code or brew upgrade claude-code@latest, depending on which cask you installed, to get the latest features and security fixes.

WinGet installations do not auto-update. Run winget upgrade Anthropic.ClaudeCode periodically to get the latest features and security fixes.

No documentation currently exists for CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE on the environment variables page.

What's Wrong or Missing?

These pages now describe Homebrew and WinGet installs as manual-update only, but v2.1.129 added CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE for those installation methods.

That leaves three gaps under one root cause: the docs have not been updated for the new package-manager auto-update behavior.

A. The current update guidance is now outdated

The setup, overview, and quickstart pages say Homebrew and WinGet installations "do not auto-update" without explaining the new opt-in behavior.

B. The new environment variable is undocumented

There is no env-vars entry explaining that CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE enables background package-manager upgrades for Homebrew and WinGet installs.

C. The restart prompt behavior is undocumented

The docs do not explain that, when this variable is set, Claude Code runs the package-manager upgrade command in the background and then prompts the user to restart.

Suggested Improvement

Update the installation and update docs to distinguish the default behavior from the new opt-in behavior added in v2.1.129.

Suggested wording for the update section:

Homebrew and WinGet installations are manual-update by default.

If CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE is set, Claude Code can run the appropriate package-manager upgrade command in the background for Homebrew and WinGet installations, then prompt you to restart after the upgrade completes.

Also add an env-vars entry that documents:

  • supported installation types (Homebrew and WinGet)
  • that the upgrade runs in the background
  • that Claude Code prompts for restart after a successful upgrade
  • the package-manager command Claude Code runs for each installer

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

PageLine(s)Context
https://code.claude.com/docs/en/setup74-87Homebrew and WinGet install tabs say these installs do not auto-update and only show manual upgrade commands
https://code.claude.com/docs/en/setup178-189Update section says Homebrew and WinGet installs require manual updates
https://code.claude.com/docs/en/overview689-702Overview repeats the same manual-only Homebrew and WinGet guidance
https://code.claude.com/docs/en/quickstart586-599Quickstart repeats the same manual-only Homebrew and WinGet guidance

Total scope: 4 locations affected

extent analysis

TL;DR

Update the documentation to reflect the new opt-in auto-update behavior for Homebrew and WinGet installations using the CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE environment variable.

Guidance

  • Review the suggested improvement wording for the update section to ensure it accurately describes the default and opt-in behaviors.
  • Add an env-vars entry to document the CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE variable, including supported installation types, background upgrade behavior, and restart prompt.
  • Verify that the updated documentation is consistent across all affected pages, including setup, overview, and quickstart.
  • Consider adding a note to explain the change in behavior and how it affects existing installations.

Example

No code snippet is necessary for this issue, as it is focused on documentation updates.

Notes

The suggested improvements should be reviewed to ensure they accurately reflect the new behavior and are consistent with the existing documentation style.

Recommendation

Apply the suggested improvements to update the documentation, as this will provide clarity on the new opt-in auto-update behavior and ensure that users can take advantage of the feature.

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…
#installation#environment variable#container setup#orchestration issue#cache issue

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 [DOCS] Package-manager install docs still describe Homebrew and WinGet as manual-update only [1 participants]