[DOCS] Missing documentation for `autoUpdatesChannel` and `minimumVersion` in settings.json reference

Resolved 💬 3 comments Opened Jan 12, 2026 by coygeek Closed Feb 28, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

The "Available settings" table under the "Settings files" section.

Current Documentation

The current table lists settings such as apiKeyHelper, cleanupPeriodDays, env, attribution, permissions, hooks, model, language, etc. It does not list any settings related to the auto-update release channels.

What's Wrong or Missing?

The Changelog for v2.1.3 mentions: "Added release channel (stable or latest) toggle to /config".

When a user interacts with this toggle in the CLI via /config, it modifies settings.json by adding the following keys, which are currently undocumented in the Settings reference:

  1. "autoUpdatesChannel": Added when selecting a channel (e.g., "stable").
  2. "minimumVersion": Added when selecting the option "Stay on current version... until stable catches up" during a channel switch.

Users manually configuring settings.json or auditing their configuration files have no reference for what these keys do or their valid values.

Suggested Improvement

Please add autoUpdatesChannel and minimumVersion to the "Available settings" table in docs/en/settings.md.

Suggested text:

| Key | Description | Example |
| :--- | :--- | :--- |
| autoUpdatesChannel | Specifies the release channel for automatic updates. Values can be "stable" or "latest". | "stable" |
| minimumVersion | Prevents the auto-updater from downgrading below a specific version. This is often set automatically when switching to the stable channel to ensure the installation stays on the current version until stable catches up. | "2.1.5" |

Impact

High - Prevents users from using a feature

Additional Context

Reproduction Steps to see settings generation:

  1. Run claude and enter /config.
  2. Select Auto-update channel.
  3. When prompted "Switch to Stable Channel", select option 1. Allow possible downgrade.
  • Result: settings.json updates with "autoUpdatesChannel": "stable".
  1. Repeat steps 1-2, but select option 2. Stay on current version....
  • Result: settings.json updates with "minimumVersion": "2.1.5" (or current version).

Screenshot/Snippet of generated config:

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.5"
}

View original on GitHub ↗

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