claude-code - 💡(How to fix) Fix Docs: bypassPermissions scoping to cwd is undocumented

TL;DR

The bypassPermissions mode may be implicitly scoped to the current working directory and additionalDirectories, causing permission prompts for files outside this scope.

Guidance

• Review the documentation for bypassPermissions mode to understand its intended behavior and scope.
• Check the additionalDirectories setting in ~/.claude/settings.json to ensure it includes all necessary directories.
• Consider adding frequently accessed directories to additionalDirectories as a workaround to avoid permission prompts.
• Verify the behavior of bypassPermissions mode with different file paths and directory settings to confirm its scope.

Example

No code snippet is provided as the issue is related to configuration and documentation.

Notes

The actual behavior of bypassPermissions mode may not be immediately clear due to the lack of explicit documentation on its scope. The workaround of adding directories to additionalDirectories may help mitigate the issue, but a clear documentation update is necessary to resolve the confusion.

Recommendation

Apply workaround: add frequently accessed directories to additionalDirectories in settings, as this provides a clear and immediate solution to avoid permission prompts, while awaiting clarification on the bypassPermissions mode's documentation.