第 03 期 | 开发环境搭建：tmux 与 Claude 协作系统

⏱ 预计阅读 4 分钟 更新于 2026/5/7
💡 进群学习加 wx: agentupdate
(申请发送: agentupdate)

3.1 环境准备

3.1.1 前置条件

# 确认 Claude Code 已安装
claude --version

# 确认 tmux 已安装
tmux -V

# 重要：Agent teams 默认禁用。
# 必须通过环境变量 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 启用。
# 方法 A: 在 shell 配置文件（如 .zshrc）中添加：
# export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
# 方法 B: 在 .claude/settings.json 中添加：
# { "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } }

# 创建项目目录
mkdir -p ~/work/teamtest && cd ~/work/teamtest

3.1.2 tmux 环境初始化

创建 scripts/setup-team.sh：

#!/bin/bash
SESSION="calc-dev"

# 如果 session 已存在，先杀掉
tmux kill-session -t "$SESSION" 2>/dev/null

# 创建新 session
tmux new-session -d -s "$SESSION" -n "team-lead"

# 创建 agent pane（水平分割）
tmux split-window -h -t "$SESSION" -n "ui-dev"
tmux split-window -h -t "$SESSION" -n "logic-dev"

# 设置 pane 标题
tmux select-pane -t "$SESSION:0.0" -T "team-lead"
tmux select-pane -t "$SESSION:0.1" -T "ui-dev"
tmux select-pane -t "$SESSION:0.2" -T "logic-dev"

# 均匀布局
tmux select-layout -t "$SESSION" even-horizontal

echo "tmux session '$SESSION' created with 3 panes"
echo "Attach: tmux attach -t $SESSION"
tmux attach -t "$SESSION"

启用鼠标支持（在 tmux 内）：

:set -g mouse on

3.1.3 tmux 窗口切换指南

操作 快捷键 说明
切换 pane Ctrl+B 然后 方向键 在 pane 间移动
全屏当前 pane Ctrl+B 然后 z 再次按恢复
翻页查看历史 Ctrl+B 然后 [ 进入复制模式，用方向键/q/pgup/pgdn
退出复制模式 q -
切换 session Ctrl+B 然后 s 列出所有 session
查看所有 pane tmux list-panes -a 在任意 pane 执行

关键发现： Agent 实际运行在 Claude Code 自动创建的 tmux session 中（如 session 2、session 4），不是 calc-dev session。calc-dev session 的 pane 始终是空的 zsh shell。要查看 agent 实际运行情况，用 tmux list-sessions 找到对应 session，再 tmux switch-client -t <session> 切换过去。