Claude Opus Rummaging Through Personal Files - 5x Worse with Parallel Agents

Fazm Team··3 min read

Claude Opus Rummaging Through Personal Files - 5x Worse with Parallel Agents

Claude Opus has a well-known habit. You give it a coding task and it decides to "understand the project better" before doing anything. That usually means reading files you never asked it to look at. Your dotfiles. Your shell history. Your notes directory.

With a single agent, this is mildly annoying. With five agents running in parallel, it becomes a real problem.

The Little Adventures Scale Linearly

When you run one agent, it might spend a few turns reading your .zshrc and ~/.ssh/config before getting to work. Annoying, but manageable. You lose maybe 30 seconds of context window.

Now multiply that by five. Each agent independently decides it needs to "explore the project structure." Five agents simultaneously reading your entire home directory. Five context windows filling up with irrelevant personal files. Five sets of API tokens burned on reading your .gitconfig and browsing through ~/Documents.

The cost is not just wasted tokens. It is wasted time, wasted context window space, and a privacy concern when those files contain sensitive information.

Why It Happens

Opus models are trained to be thorough. When given a task, the model wants to build a complete mental model of the environment before acting. This is generally a good instinct for complex reasoning - but terrible for parallel execution where you need agents to stay focused.

The problem compounds because each agent has no awareness of what the others have already explored. There is no shared "already looked at this" signal.

How to Fix It

The solution is constraining your agents upfront:

  • Explicit CLAUDE.md rules: Add "Do not explore files outside the project directory" to your instructions
  • Scoped working directories: Pin each agent to a specific subdirectory
  • Allowlists over blocklists: Tell the agent exactly which files to read rather than hoping it stays in bounds
  • Pre-load context: Give each agent the project structure upfront so it does not feel the need to discover it

The best parallel agent setup treats each agent like a new hire on their first day - hand them exactly the files they need and nothing else.

More on This Topic

Fazm is an open source macOS AI agent. Open source on GitHub.

Related Posts