[DOCS] Update Troubleshooting guide to recommend `permissions.deny` for file exclusion
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/troubleshooting
Section/Topic
Performance and stability section, under the High CPU or memory usage heading.
Current Documentation
3. Consider adding large build directories to your .gitignore file
What's Wrong or Missing?
The troubleshooting guide currently advises using .gitignore to manage performance issues caused by large directories. While valid, this is a version control setting, not a specific Claude Code configuration.
According to docs/en/settings.md (under "Excluding sensitive files"), the permissions.deny setting is the explicit replacement for the deprecated ignorePatterns configuration. The documentation should align the troubleshooting advice with the current configuration model (permissions.deny), which allows users to exclude files from Claude's context without necessarily removing them from git tracking.
Suggested Improvement
Update step 3 under "High CPU or memory usage" to explicitly reference permissions.deny.
Suggested text:
3. Exclude large build directories from Claude's access by adding them to thepermissions.denylist in your.claude/settings.jsonfile.
Impact
High - Prevents users from using a feature
Additional Context
Reference from docs/en/settings.md:
Use thepermissions.denysetting in your.claude/settings.jsonfile... This replaces the deprecatedignorePatternsconfiguration. Files matching these patterns will be completely invisible to Claude Code...
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗