多智能体协作
介绍如何使用 tmux 和 Claude Code 搭建多窗格 Team 环境,包括一键启动、布局效果、快捷键和工作流程。
建议安装 fswatch 以获得实时监控能力:
创建的文件总览
| 文件 | 说明 |
|---|---|
~/.local/bin/claude-team |
一键启动多窗格 Team 环境 |
~/.local/bin/claude-dashboard |
任务看板 — 实时显示任务状态和进度条 |
~/.local/bin/claude-agent-log |
Agent 活动日志 — 监控文件变化和会话状态 |
~/.tmux.conf |
tmux 配置 — 适配 Ghostty + Claude Code |
布局效果
使用方式
tmux 快捷键 (前缀: Ctrl-a)
| 快捷键 | 功能 |
|---|---|
Alt + h/j/k/l |
无需前缀直接切换窗格 (vim 风格) |
Ctrl-a z |
当前窗格全屏/还原 |
Ctrl-a T |
新开 Claude 窗口 |
Ctrl-a D |
打开 Dashboard |
Ctrl-a A |
打开 Agent Log |
Ctrl-a Ctrl-t |
在当前窗口一键补全 Team 布局 |
| `Ctrl-a | ` |
Ctrl-a - |
水平分割 |
Ctrl-a r |
重载 tmux 配置 |
| 鼠标点击 | 直接切换窗格 |
工作流程
- 运行
claude-team启动环境 - 在主窗格中使用 Claude Code 创建 Team(
TeamCreate) - 右侧看板自动刷新任务状态和 Agent 信息
- 用
Alt+h/j/k/l快速在窗格间跳转 Ctrl-a z全屏某个窗格查看详情,再按一次恢复
提示: tmux 配置已开启
allow-passthrough,这是 v2.1.78 版本新增的功能,可以让 Claude Code 的终端通知(iTerm2/Kitty/Ghostty 弹窗)穿透 tmux 到达你的终端。
brew install fswatch┌──────────────────────────┬─────────────────────┐
│ │ 📋 任务看板 │
│ 🤖 Claude Code 主会话 │ (实时刷新任务状态) │
│ (Team Lead) │ 进度条 + Agent 信息 │
│ ├─────────────────────┤
│ │ 📜 Agent 活动日志 │
│ │ (文件变化监控) │
└──────────────────────────┴─────────────────────┘# 🚀 一键启动
claude-team
# 宽屏三列布局
claude-team --wide
# 恢复已有会话
claude-team --resume <session-id>