Troubleshooting Library

Fix common Claude Cowork errors and get back to work.

Permission Denied / File Access Error

Claude cannot read or write to a specific folder. Usually caused by macOS privacy settings.

macOSPermissionsFile System

Context Window Exceeded

Error when processing too many files or large PDFs. Exceeds the 200K/1M token limit.

TokensLimitsPerformance

MCP Connection Failed

Trouble connecting to local servers or external tools via Model Context Protocol.

MCPNetworkTools

Sub-Agent Timeout

Parallel sub-agents fail to return results or hang indefinitely.

AgentsTimeoutConcurrency

Exit Code 127 / Command Not Found

Claude fails to run git, npm, python3 or other CLI tools. Usually a PATH or install issue.

CLIPATHShellExit Code

Cannot find what you are looking for?

Check the Getting Started Guide or join the Community for help.