多智能体协作

介绍如何使用 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 到达你的终端。

plain
brew install fswatch
plain8 行
┌──────────────────────────┬─────────────────────┐
│                          │  📋 任务看板         │
│  🤖 Claude Code 主会话    │  (实时刷新任务状态)   │
│  (Team Lead)             │  进度条 + Agent 信息  │
│                          ├─────────────────────┤
│                          │  📜 Agent 活动日志    │
│                          │  (文件变化监控)       │
└──────────────────────────┴─────────────────────┘
bash8 行
# 🚀 一键启动
claude-team

# 宽屏三列布局
claude-team --wide

# 恢复已有会话
claude-team --resume <session-id>