第4集：tmux — 不死会话的基石

终端复用器，跑在任何 Unix 服务器上。detach/attach 让 Agent 会话永不停歇。

tmux 是什么

tmux 不是终端模拟器。它是终端复用器——跑在终端模拟器里面。

关键区别：

• 终端模拟器（Ghostty/iTerm2/Warp）：渲染图形、管理窗口，macOS/Linux 桌面应用
• 终端复用器（tmux）：管理会话（session），纯命令行，跑在服务器上

┌─────────────────────────────────────┐
│ 终端模拟器 (Ghostty/iTerm2/Warp)     │
│  ┌───────────────────────────────┐  │
│  │ tmux session                  │  │
│  │  ┌──────────┬──────────────┐  │  │
│  │  │ Agent 1  │ Agent 2      │  │  │
│  │  │ (pane)   │ (pane)       │  │  │
│  │  └──────────┴──────────────┘  │  │
│  └───────────────────────────────┘  │
└─────────────────────────────────────┘

安装方式

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

# CentOS/RHEL/Fedora
sudo yum install tmux
# 或
sudo dnf install tmux

# Arch Linux
sudo pacman -S tmux

# 验证安装
tmux -V
# 输出: tmux 3.5a（或更高版本）

操作系统支持

三层结构

tmux 的组织结构：session → window → pane

graph TB
    S[tmux server] --> SE1[Session: agent-1]
    S --> SE2[Session: agent-2]
    S --> SE3[Session: review]

    SE1 --> W1[Window 0]
    W1 --> P1[Pane: claude]
    W1 --> P2[Pane: logs]

    SE2 --> W2[Window 0]
    W2 --> P3[Pane: claude]
    SE2 --> W4[Window 1]
    W4 --> P4[Pane: tests]

    style S fill:#ff6b6b,color:#fff
    style SE1 fill:#4a9eff,color:#fff
    style P1 fill:#2ecc71,color:#fff

• Session：独立的工作空间。detach 后继续运行，attach 后恢复。
• Window：Session 内的标签页。一个 Session 可有多个 Window。
• Pane：Window 内的分屏。一个 Window 可有多个 Pane。

关键操作

会话生命周期

stateDiagram-v2
    [*] --> Created: tmux new -s agent
    Created --> Attached: 自动 attach
    Attached --> Detached: Ctrl+b d
或关闭终端
    Detached --> Attached: tmux attach -t agent
    Attached --> Attached: 正常使用
    Detached --> Running: 后台持续运行
    Running --> Attached: tmux attach -t agent
    Running --> Destroyed: tmux kill-session
    Attached --> Destroyed: tmux kill-session
    Destroyed --> [*]

    note right of Running
        Agent 继续运行
        SSH 断线不影响
        关掉笔记本不影响
    end note

Agent 交互机制

tmux 提供最强大的命令行级 Agent 控制能力：

flowchart TB
    subgraph 控制方式
        A[tmux send-keys
命令注入]
        B[tmux 命令行
session管理]
        C[Socket 文件
进程间通信]
        D[配置文件
~/.tmux.conf]
    end

    subgraph Agent会话
        E[Session: agent-1]
        F[Session: agent-2]
        G[Session: agent-N]
    end

    A -->|向指定pane发送命令| E
    A -->|向指定pane发送命令| F
    B -->|创建/销毁/列出| E
    B -->|创建/销毁/列出| G
    C -->|直接socket通信| E
    D -->|启动时加载配置| H[tmux server]

    style A fill:#2ecc71,color:#fff
    style B fill:#4a9eff,color:#fff
    style C fill:#ff6b6b,color:#fff

send-keys 自动化示例：

#!/bin/bash
# 批量启动 Claude Code Agent

# 创建 3 个 session
tmux new-session -d -s research -d 'claude'
tmux new-session -d -s coding -d 'claude'
tmux new-session -d -s review -d 'claude'

# 向 research agent 发送指令
tmux send-keys -t research '/gsd-research-phase 1' Enter

# 向 coding agent 发送指令
tmux send-keys -t coding '/gsd-execute-phase 1' Enter

# 向 review agent 发送指令
tmux send-keys -t review '/gsd-code-review' Enter

echo "3 个 Agent 已启动，使用 tmux attach -t <name> 查看"

推荐配置

~/.tmux.conf 必改项：

# 鼠标支持（滚动、点击切换 pane、调整分屏大小）
set -g mouse on

# 大缓冲区（Agent 输出很多）
set -g history-limit 100000

# 状态栏显示 session 名称
set -g status-left '#[fg=green]#S #[default]'

# 状态栏显示时间
set -g status-right '#[fg=yellow]%H:%M#[default]'

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

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

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

# 窗口编号从 1 开始
set -g base-index 1
setw -g pane-base-index 1

# 减少 ESC 延迟（影响 Vim 用户）
set -sg escape-time 0

优缺点

适用场景

• 远程服务器跑 Agent（核心场景）
• 多 Agent 并行 + 脚本自动化
• SSH 断线后会话保持
• 作为 Ghostty/iTerm2 的"内层"使用