[DOCS] Update Troubleshooting guide to recommend `permissions.deny` for file exclusion

Resolved 💬 3 comments Opened Jan 22, 2026 by coygeek Closed Feb 27, 2026

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 the permissions.deny list in your .claude/settings.json file.

Impact

High - Prevents users from using a feature

Additional Context

Reference from docs/en/settings.md:

Use the permissions.deny setting in your .claude/settings.json file... This replaces the deprecated ignorePatterns configuration. Files matching these patterns will be completely invisible to Claude Code...

View original on GitHub ↗

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