Step-by-step guide to running Claude Code agent teams on Windows using WSL2 and tmux, including installation, configuration, and tips for getting multiple AI agents working in parallel.

Ardalis' platform is a central hub for software developers, offering insights into software architecture, design patterns, and clean coding principles. Through articles, tutorials, and podcasts, Ardalis offers insights into building maintainable and scalable software applications. Developers can learn about SOLID principles, domain-driven design, and refactoring techniques to write high-quality code and design robust software architectures.

Ardalis

A step-by-step setup guide for running Claude Code agent teams on Windows using WSL2 and tmux. Covers enabling WSL2, installing Ubuntu and dependencies, installing Claude Code, configuring tmux for multi-pane agent visibility, symlinking the .claude config between Windows and WSL, enabling the experimental agent teams feature, and launching Claude inside a tmux session.

Setting Up Claude Code Agent Teams With Wsl2 and Tmux on Windows

Step 1 — Enable WSL2 and Install Ubuntu

Step 2 — Install Dependencies Inside WSL

Step 5 — Symlink Your Windows .claude Config to WSL

Step 6 — Enable Agent Teams in Claude Code