Settings keys missing from docs, hard to discover

Resolved 💬 6 comments Opened Mar 21, 2026 by JayDoubleu Closed Apr 21, 2026

Problem

Several Claude Code settings are not documented in the official docs, making them very difficult to discover for both users and AI assistants.

Example: hiding user info from start screen

A setting to hide user/account info from the Claude Code start screen was shared on X (Twitter) by the team, but it does not appear anywhere in the official documentation. I spent significant time searching for it across:

  • Settings docs (code.claude.com/docs/en/settings) -- not listed among the 56 documented settings
  • Changelog (code.claude.com/docs/en/changelog) -- no mention
  • Full docs index (code.claude.com/docs/llms.txt) -- not found across any documentation page
  • JSON Schema (json.schemastore.org/claude-code-settings.json) -- not present among the 56 schema properties

Even with Claude Code itself helping search, we could not find this setting anywhere.

This is a recurring problem

This is not an isolated case. Recently, showClearContextOnPlanAccept was removed or changed, and Claude burned a large number of tokens searching docs, changelog, and schema for it, only to eventually find a brief reference in the changelog. There was no clear indication it had been removed or what replaced it.

Suggestion

  1. Document all settings in the settings reference page, including ones currently only shared via social media or blog posts
  2. Keep the JSON schema in sync with all available settings so editors can autocomplete them and AI assistants can discover them
  3. Call out removed/renamed settings explicitly in the changelog or a migration guide, so users and AI assistants don't waste time searching for settings that no longer exist

A complete, authoritative settings reference would save everyone (humans and AI alike) from expensive searches across multiple sources that come up empty.

View original on GitHub ↗

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