Windows 下 Claude Code使用 Agent Teams 配置教程

在linux和macos系统下安装tmux，使用agent teams非常简单，但是在windows系统下无法直接安装tmux，只能另辟蹊径，于是我从github上找到了tmux_for_windows项目。

前提条件

1. 安装 Git for Windows

安装后确认：

powershell 复制代码

where.exe git
# 输出示例：C:\Program Files\Git\cmd\git.exe

2. 安装 tmux for Windows

tmux 必须运行在 Git Bash（MinGW64）环境下，CMD 和 PowerShell 不支持，原因：

依赖	CMD/PowerShell	Git Bash
PTY 伪终端	✗	✓
Unix 系统调用	✗	✓
MSYS2 运行库	✗	✓

安装步骤：

克隆仓库（或下载 zip）：

bash 复制代码

git clone https://github.com/hongwenjun/tmux_for_windows.git

以管理员权限 将 zip 解压到 Git 的 usr 目录：

powershell 复制代码

# PowerShell（管理员）
Start-Process powershell -Verb RunAs -ArgumentList `
  "-Command Expand-Archive -Path 'tmux_for_windows\tmux_for_git-bash.zip' -DestinationPath 'C:\Program Files\Git\usr' -Force" -Wait

验证安装：

bash 复制代码

# Git Bash 中
tmux -V
# 输出：tmux 2.7 或更高版本

复制 .tmux.conf（启用鼠标支持）：

powershell 复制代码

Copy-Item "tmux_for_windows\.tmux.conf" -Destination "$env:USERPROFILE\.tmux.conf"

配置 Claude Code

settings.json 路径

范围	路径
全局（推荐）	`C:\Users\<用户名>\.claude\settings.json`
项目级	`<项目路径>\.claude\settings.json`

完整配置

编辑 ~/.claude/settings.json，添加以下字段：

json 复制代码

{
  "env": {
    "PATH": "<原有PATH>;C:\\Program Files\\Git\\usr\\bin",
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  },
  "teammateMode": "tmux"
}

关键字段说明：

字段	值	说明
`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`	`"1"`	启用实验性 agent 团队功能
`teammateMode`	`"tmux"`	使用 tmux 管理多个 agent 进程
PATH 追加	`C:\Program Files\Git\usr\bin`	让 Claude Code 能找到 tmux.exe

teammateMode 合法值：

"auto" --- 自动选择
"tmux" --- 使用 tmux 分 pane 运行（Windows 需配合 Git Bash）
"in-process" --- 在同一进程内运行（不需要 tmux）

注意： teammateSessions 不是合法字段，settings.json 的 schema 会报错，不要添加。

工作原理

复制代码

Git Bash（tmux 会话）
└── claude CLI 主进程
        └── 触发多 agent 并行任务
                ├── tmux pane 1 → claude 进程（Agent 1）
                ├── tmux pane 2 → claude 进程（Agent 2）
                └── tmux pane 3 → claude 进程（Agent 3）

每个 teammate 是一个独立的 claude 进程，运行在单独的 tmux pane 中
各 agent 有独立的上下文、环境变量和工作目录
可通过 Ctrl+B + 方向键在 pane 之间切换，实时观察各 agent 输出

使用方式

启动方式

必须在 Git Bash 中启动 Claude Code：

bash 复制代码

# 方式一：在任意目录右键 → "Git Bash Here"，然后
claude

# 方式二：在已有 tmux 会话中启动
tmux new-session -s work
claude

查看 tmux 会话

bash 复制代码

tmux list-sessions          # 查看所有会话
tmux list-panes -a          # 查看所有 pane
tmux attach-session -t work # 连接到指定会话

tmux 常用快捷键

快捷键	功能
`Ctrl+B` + 方向键	切换 pane
`Ctrl+B` + `d`	脱离会话（后台运行）
`Ctrl+B` + `[`	进入复制/滚动模式
`q`	退出复制模式

验证配置

重启 Claude Code 后，执行以下检查：

bash 复制代码

# 1. 确认 tmux 可访问
tmux -V

# 2. 确认配置已加载（在 Claude Code 会话内执行）
# 触发一个多 agent 并行任务，观察是否在 tmux 中创建新 pane

常见问题

问题	原因	解决方案
`tmux: command not found`	PATH 未包含 tmux 路径	在 settings.json 的 PATH 中追加 `C:\Program Files\Git\usr\bin`
解压时 Access Denied	写入 Program Files 需要管理员权限	用 `Start-Process -Verb RunAs` 以管理员运行
agent 不在新 pane 中出现	未在 Git Bash/tmux 环境下运行 claude	必须从 Git Bash 启动 Claude Code
`teammateSessions` 报 schema 错误	该字段不在官方 schema 中	删除该字段，只保留 `teammateMode`

参考

tmux for Windows 仓库：https://github.com/hongwenjun/tmux_for_windows
Git for Windows：https://git-scm.com/download/win