Settings keys missing from docs, hard to discover
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
- Document all settings in the settings reference page, including ones currently only shared via social media or blog posts
- Keep the JSON schema in sync with all available settings so editors can autocomplete them and AI assistants can discover them
- 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.
This issue has 6 comments on GitHub. Read the full discussion on GitHub ↗