[DOCS] Troubleshooting guide incorrectly references deprecated `~/.claude.json` for "allowed tools" configuration

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

The Configuration file locations section (specifically the table listing file purposes).

Current Documentation

In the table describing configuration files, the entry for ~/.claude.json reads:

| File | Purpose |
| :--- | :--- |
| ~/.claude.json | Global state (theme, OAuth, MCP servers, allowed tools) |

What's Wrong or Missing?

The documentation incorrectly states that allowed tools are stored in ~/.claude.json.

According to recent updates (specifically changelog v2.0.8 and v1.0.7), the allowedTools configuration was migrated to settings.json and removed from .claude.json.

Users following this troubleshooting guide may attempt to debug or modify permission settings in ~/.claude.json, which will have no effect on the application's behavior in current versions. The permissions (formerly allowedTools) are now handled within settings.json files.

Suggested Improvement

Update the table in the Troubleshooting guide to accurately reflect the separation of concerns between state and settings.

Suggested text:

| File | Purpose |
| :--- | :--- |
| ~/.claude/settings.json | User settings (permissions, allowed tools, hooks, model overrides) |
| ... | ... |
| ~/.claude.json | Global state (theme, OAuth, MCP servers) |

Remove "allowed tools" from the ~/.claude.json row description.

Impact

High - Prevents users from using a feature

Additional Context

• Related Documentation: The Settings documentation correctly identifies that permissions are configured within settings.json.
• Changelog Context: v2.0.8 explicitly mentions: "Remove deprecated .claude.json allowedTools... config options (instead, configure these in your settings.json)".