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=1 environment variable
  • "autoUpdates": false settings key

Issues #10079 and #12564 both flag this inconsistency and were closed without a documented resolution.

Request

Could the docs either:

  1. Document the supported way to fully disable auto-updates (env var, setting, or both), or
  2. 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

View original on GitHub ↗

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