Tmux 完全指南：从入门到 AI 多智能体并行开发工作流

echo $TMUX
# 如果有输出 → 你在 tmux 中
# 如果输出为空 → 你在普通终端中

brew install tmux

sudo apt-get install tmux

sudo yum install tmux

tmux -V
# tmux 3.5a

tmux server（服务器）
└── Session（会话：一个命名的工作空间）
    ├── Window 0（窗口：类似浏览器标签页）
    │   ├── Pane 0（窗格：上半部分）
    │   └── Pane 1（窗格：下半部分）
    ├── Window 1
    │   └── Pane 0（完整窗口）
    └── Window 2
        ├── Pane 0（左侧）
        ├── Pane 1（右上）
        └── Pane 2（右下）

# 启动一个未命名的会话
tmux

# 启动一个命名会话（推荐）
tmux new -s dev

# 在指定目录启动命名会话
tmux new -s myproject -c ~/projects/myproject

# 从当前会话断开
# 快捷键：Ctrl+b d
tmux detach

# 列出所有会话
tmux ls

# 重新连接到命名会话
tmux attach -t dev
tmux a -t dev  # 简写

# 重新连接到最近的会话
tmux attach

# 终止指定会话
tmux kill-session -t dev

# 终止除当前外的所有会话
tmux kill-session -a

# 终止整个 tmux 服务器（所有会话）
tmux kill-server

# 重命名会话
tmux rename-session -t old-name new-name

# 切换到另一个会话（在 tmux 内部）
tmux switch -t other-session

# 创建新窗口
# 快捷键：Ctrl+b c
tmux new-window

# 创建命名窗口
tmux new-window -n tests

# 重命名当前窗口
# 快捷键：Ctrl+b ,
tmux rename-window editor

# 垂直分割（左 | 右）
# 快捷键：Ctrl+b %
tmux split-window -h

# 水平分割（上 / 下）
# 快捷键：Ctrl+b "
tmux split-window -v

Ctrl+b Ctrl+←  # 向左缩小
Ctrl+b Ctrl+→  # 向右扩大
Ctrl+b Ctrl+↑  # 向上缩小
Ctrl+b Ctrl+↓  # 向下扩大

# 调整当前窗格大小（单位为单元格）
tmux resize-pane -D 10  # 向下 10 行
tmux resize-pane -U 5   # 向上 5 行
tmux resize-pane -L 20  # 向左 20 列
tmux resize-pane -R 20  # 向右 20 列

# ~/.tmux.conf — 为 AI 开发优化

# ============================================
# 通用设置
# ============================================

# 将前缀键从 Ctrl+b 改为 Ctrl+a（更方便按到）
unbind C-b
set-option -g prefix C-a
bind-key C-a send-prefix

# 窗口编号从 1 开始（而不是 0）
set -g base-index 1
setw -g pane-base-index 1

# 关闭窗口时重新编号
set -g renumber-windows on

# 增大滚动缓冲区（对 Claude Code 输出很重要）
set -g history-limit 50000

# 启用鼠标支持
set -g mouse on

# 减少转义时间（更快的按键响应）
set -sg escape-time 10

# 启用焦点事件（用于 vim/neovim 集成）
set -g focus-events on

# ============================================
# 显示设置
# ============================================

# 启用 256 色和真彩色支持
set -g default-terminal "screen-256color"
set-option -ga terminal-overrides ",xterm-256color:Tc"

# 设置状态栏更新间隔
set -g status-interval 5

# ============================================
# 键位绑定
# ============================================

# 直观的分屏快捷键
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"
unbind '"'
unbind %

# 新窗口继承当前路径
bind c new-window -c "#{pane_current_path}"

# Vim 风格的窗格导航
bind h select-pane -L
bind j select-pane -D
bind k select-pane -U
bind l select-pane -R

# Shift+方向键调整窗格大小
bind -r H resize-pane -L 5
bind -r J resize-pane -D 5
bind -r K resize-pane -U 5
bind -r L resize-pane -R 5

# 快速重载配置
bind r source-file ~/.tmux.conf \; display "配置已重载！"

# 启用 vi 模式复制
setw -g mode-keys vi

# Vi 风格的复制绑定
bind-key -T copy-mode-vi v send-keys -X begin-selection
bind-key -T copy-mode-vi y send-keys -X copy-selection-and-cancel

tmux source-file ~/.tmux.conf

git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

# 插件管理器
set -g @plugin 'tmux-plugins/tpm'

# 推荐插件
set -g @plugin 'tmux-plugins/tmux-sensible'      # 合理的默认设置
set -g @plugin 'tmux-plugins/tmux-resurrect'      # 保存/恢复会话
set -g @plugin 'tmux-plugins/tmux-continuum'      # 自动保存会话
set -g @plugin 'tmux-plugins/tmux-yank'           # 系统剪贴板集成

# 每 15 分钟自动保存
set -g @continuum-save-interval '15'

# tmux 启动时自动恢复
set -g @continuum-restore 'on'

# 初始化 TPM（保持在底部）
run '~/.tmux/plugins/tpm/tpm'

# 创建一个专用的 Claude Code 会话
tmux new -s claude

# 启动 Claude Code
claude

# ... 与 Claude 进行关于你项目的深入对话 ...
# 需要离开？Ctrl+a d 断开

# 随时回来
tmux attach -t claude
# 你的整个对话都保留着

#!/bin/bash
# 保存为 ~/scripts/ai-dev.sh

SESSION="ai-dev"

# 创建会话，第一个窗口用于 Claude Code
tmux new-session -d -s $SESSION -n claude

# 右侧分出窗格用于测试
tmux split-window -h -t $SESSION:claude

# 右下角分出窗格用于日志
tmux split-window -v -t $SESSION:claude.1

# 设置窗格大小（Claude 占 60% 宽度）
tmux resize-pane -t $SESSION:claude.0 -x '60%'

# 创建第二个窗口用于 git 操作
tmux new-window -t $SESSION -n git

# 选择 Claude 窗格并连接
tmux select-window -t $SESSION:claude
tmux select-pane -t 0

tmux attach -t $SESSION

┌──────────────────────┬───────────────┐
│                      │               │
│    Claude Code       │    测试       │
│    （主工作区）       │  (npm test)   │
│                      │               │
│                      ├───────────────┤
│                      │               │
│                      │    日志       │
│                      │ (tail -f ...) │
└──────────────────────┴───────────────┘

# 添加到 ~/.tmux.conf
bind -r y run-shell '\
  SESSION="claude-$(echo #{pane_current_path} | md5 | cut -c1-8)"; \ # macOS 用 md5；Linux 用 md5sum
  tmux has-session -t "$SESSION" 2>/dev/null || \
  tmux new-session -d -s "$SESSION" -c "#{pane_current_path}" "claude"; \
  tmux display-popup -w80% -h80% -E "tmux attach-session -t $SESSION"'

P(至少一个成功) = 1 - (0.75)^4 ≈ 68%

# 为并行智能体创建 worktree
git worktree add -b feature-auth ../project-auth
git worktree add -b feature-api ../project-api
git worktree add -b feature-ui ../project-ui

# 创建 tmux 会话，每个智能体一个窗口
tmux new-session -d -s agents -n auth -c ../project-auth
tmux new-window -t agents -n api -c ../project-api
tmux new-window -t agents -n ui -c ../project-ui

# 在每个窗口中启动 Claude Code
tmux send-keys -t agents:auth "claude" Enter
tmux send-keys -t agents:api "claude" Enter
tmux send-keys -t agents:ui "claude" Enter

# 连接并监控
tmux attach -t agents

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

创建一个智能体团队来完成这个功能：
- 一个队友负责后端 API 实现
- 一个队友负责前端组件
- 一个队友负责编写测试

# 终端 1：规划智能体
tmux new-session -s planner -c ~/project
# "探索认证系统重新设计，编写 Feature Design 规格说明"

# 终端 2-4：执行智能体（各自有 worktree）
tmux new-session -s worker1 -c ~/project-wt1
# "按照 docs/fd/042-auth-redesign.md 中的规格说明实现 FD-042"

tmux new-session -s worker2 -c ~/project-wt2
# "按照 docs/fd/043-api-routes.md 中的规格说明实现 FD-043"

tmux new-session -s worker3 -c ~/project-wt3
# "为 FD-042 和 FD-043 编写测试"

# 启动 3 个带有隔离 worktree 的并行智能体
dmux start --agents 3 --prompt "实现用户仪表盘功能"

# 监控所有智能体
dmux status

# 合并结果
dmux merge

# 在你的服务器上
tmux new -s remote-claude
claude

# 从任何设备（笔记本、手机、平板）
ssh user@your-server
tmux attach -t remote-claude

Host devserver
    HostName your-server.com
    User your-username
    ServerAliveInterval 60
    ServerAliveCountMax 3
    TCPKeepAlive yes

# 切换同步输入
Ctrl+a :setw synchronize-panes on

# 现在每次按键都会发送到所有窗格
# 在多个 worktree 中运行相同的设置命令时很有用

# 完成后关闭
Ctrl+a :setw synchronize-panes off

# 向指定窗格发送命令
tmux send-keys -t agents:auth.0 "npm test" Enter

# 向会话中的所有窗口发送
for window in $(tmux list-windows -t agents -F '#W'); do
  tmux send-keys -t "agents:$window" "git pull" Enter
done

# 终端 1
tmux new -s shared

# 终端 2（加入相同会话，独立的窗口选择）
tmux new -t shared -s paired

# 添加到 ~/.tmux.conf
# 当窗格在静默后产生输出时发出 bell 通知
set -g visual-activity on
setw -g monitor-activity on

# 或在智能体脚本中使用 bell 字符
# 当 Claude Code 完成任务时：
echo -e '\a'  # 触发 tmux bell 通知