How I Build and Run a Team of Claude Code Agents Without Torching My Token Budget
Here's the playbook I use for running multiple specialist Claude Code agents inside a single project.
1. Use git worktrees.
Spin up multiple sessions in the same directory and your agents will jump between branches and trample each other's work. Give each agent its own working directory.
2. Give your agents names.
Memory carries across sessions, but what each agent needs to remember is different. Put team-wide rules and shared memory in CLAUDE.md, and have each agent maintain its own .md file under its name. That's why names matter.
3. Write an ONBOARDING.md.
When I needed to migrate a Python project to Rust, I added a Rust specialist by having an existing agent draft rust_specialist.md ahead of time. Then I opened the first session with: "Hi! Your name is xxx. You've just joined our team — read the onboarding materials and get yourself up to speed." The onboarding doc covers the baseline setup and tells the agent to find its name file. That's all it takes to bring a specialist on board.
4. Use the monitor tool.
Claude Code ships with a first-party monitor tool that pipes STDOUT straight into the model as a new turn. Stand up a tiny localhost server with from/to messaging and have every agent monitor it. Now they talk to each other in real time and form expert work chains without you in the middle. New agents register on join and broadcast their role to the team.
5. Keep one agent who never writes code.
Agents deep in the work lose the plot sometimes. You need one presence whose job is to watch everything and point the way — seed it with the project's principles and philosophy, and it'll keep a growing team from scattering. When the others bring questions to you, try: "Why don't you ask them?"
6. Send your agents home (please).
Use the message server for project-wide announcements like "Stop what you're doing and align on the version." No matter how hard an agent works, if it can't get merged into main, those tokens are burned. Spend a day with your no-code agent auditing what actually made it into the main branch.
My current team:
README & .md curator
Project philosophy lead
Python specialist
Benchmark specialist
Rust specialist
Field testing specialist
This is the project we're building together.
https://lnkd.in/gwPGmZRp
Good message, bad example. I've never met a dev that didn't know about exception handling, no matter if junior or senior. Often it's even worth not handling an exception.