claude-code - 💡(How to fix) Fix "Claude Code process exited with code 1" on macOS — real cause is folder privacy permission, no helpful error shown [3 comments, 4 participants]

The error gives no indication of what went wrong. After extensive troubleshooting (checking .zprofile, PATH, binary versions), the real cause turned out to be a macOS privacy permission: the system was blocking Claude from accessing the folder. The problem: The error message is completely unhelpful. It should say something like "Access denied: go to System Settings > Privacy & Security and allow Claude to access this folder."

TL;DR

The issue can likely be resolved by granting the Claude Code desktop app permission to access the project folder through System Settings.

Guidance

• Check the system's privacy settings to ensure Claude Code has the necessary permissions to access the project folder.
• Verify that the project folder path is correctly formatted and accessible, considering the presence of accented characters and spaces.
• If the issue persists, try resetting the app's permissions or reinstalling the Claude Code desktop app to ensure a clean configuration.
• Consider reporting the unhelpful error message to the app developers to improve future troubleshooting experiences.

Example

No code snippet is necessary for this issue, as it is related to system permissions rather than code functionality.

Notes

This solution applies specifically to macOS (Apple Silicon) with the Claude Code desktop app v2.1.111. The presence of accented characters and spaces in the project folder path may require additional attention to ensure correct handling.

Recommendation

Apply the workaround by granting the necessary permissions through System Settings, as this directly addresses the identified root cause of the issue.