[DOCS] Missing documentation for `autoUpdatesChannel` and `minimumVersion` in settings.json reference
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:
"autoUpdatesChannel": Added when selecting a channel (e.g., "stable")."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:
- Run
claudeand enter/config. - Select Auto-update channel.
- When prompted "Switch to Stable Channel", select option 1. Allow possible downgrade.
- Result:
settings.jsonupdates with"autoUpdatesChannel": "stable".
- Repeat steps 1-2, but select option 2. Stay on current version....
- Result:
settings.jsonupdates with"minimumVersion": "2.1.5"(or current version).
Screenshot/Snippet of generated config:
{
"autoUpdatesChannel": "stable",
"minimumVersion": "2.1.5"
}This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗