Wrong Documentation for Config settings.

Environment

• Platform (select one):
• [x] Anthropic API
• [ ] AWS Bedrock
• [ ] Google Vertex AI
• [ ] Other:
• Claude CLI version: 1.0.51 (Claude Code)
• Operating System: macOS 15.5, M-series, Apple Silicon
• Terminal: Terminal App

Bug Description

There is no way to set project specific version in claude code (available for gemini-cli). Any config changes automatically applies to the global config file even when the project has a folder .claude/setting.json

Moreover the documentation is wrong for the settings:

Claude_Code_Settings

Nowhere is it mentioned that the config file is located at : ~/claude.json

It is very difficult to managed the setting if all the settings are lumped into one config file.

In the documentation there is mention of User settings , Project settings , and Enterprise settings like in google-gemini-cli but it does not work.

Steps to Reproduce

1. Install claude-code : Follow the installation guide Installation_Guide
2. Goto your working directory and create a folder .claude
3. Create a file settings.json and add some normal setting as mentioned Claude_Code_Settings
4. Start claude from cli using command claude
5. Make some config changes
6. Exit claude

Expected Behavior

The config changes should be visible and added to the local .claude/settings.json

Actual Behavior

The config gets added to ~/.claude.json

Additional Context

Please make sure we can add local/project specific configs and global configs only takes into effect if local config is not available.

The documentation related to config setting is wrong, please update the docs.

Regards,