Docs: clarify or restore documented way to disable auto-updates
Resolved 💬 5 comments Opened May 6, 2026 by sakal-s Closed Jun 5, 2026
The settings reference at https://code.claude.com/docs/en/settings does not document any top-level key to disable auto-updates. The only update-related keys listed are autoUpdatesChannel ("stable" / "latest") and minimumVersion.
Community sources and an older docs page reference both:
DISABLE_AUTOUPDATER=1environment variable"autoUpdates": falsesettings key
Issues #10079 and #12564 both flag this inconsistency and were closed without a documented resolution.
Request
Could the docs either:
- Document the supported way to fully disable auto-updates (env var, setting, or both), or
- Explicitly state that auto-updates cannot be disabled and the closest supported behavior is
autoUpdatesChannel: "stable"+minimumVersion.
Why this matters
Users who want a stable, predictable CLI experience (e.g., for team workflows, training material, or to avoid behavior changes mid-task) currently have no authoritative answer for how to pin or disable updates.
Environment
- Claude Code version: 2.1.131
- Platform: macOS (Darwin 25.3.0)
Related
- #10079
- #12564
This issue has 5 comments on GitHub. Read the full discussion on GitHub ↗