psmux Claude CodeAI Agent 团队自动分屏零配置实现多智能体并行开发【免费下载链接】psmuxTmux on Windows Powershell - tmux for PowerShell, Windows Terminal, cmd.exe. Includes psmux, pmux, and tmux commands. This is native High-Performance Tmux designed for Windows in Rust 项目地址: https://gitcode.com/gh_mirrors/ps/psmuxpsmux是运行在 Windows 上的原生 tmuxRust 编写直连 ConPTY而Claude Code的 Agent Teams 功能在 psmux 内可零配置让每个智能体自动获得独立分屏实现多智能体并行开发、全程可视。无需 WSL、无需 Cygwin一条命令即可开始。为什么选 psmux 跑 Claude Code在 Linux/macOS 上Claude Code 的 teammate 模式依赖 tmux 分屏而在 Windows 上普通终端标签页做不到脚本可控、可后台常驻。psmux 补齐了这块拼图能力对多智能体开发的意义每个分屏都是真实 ConPTY每个 Agent 有独立、完整的终端环境渲染与 Windows Terminal 完全一致会话常驻后台服务器关闭终端窗口 Agent 不中断psmux attach随时回来看进度全套 tmux 命令兼容split-window、send-keys、capture-pane直接可用Linux 脚本无改动迁移原生 Windows 进程任务管理器直接可见每个 Agent 进程无需任何仿真层环境准备安装 PowerShell 7与 Claude Code 配合psmux要求 PowerShell 7 或更高版本env shim 和 teammate 模式注入依赖 PS7 特性。# 检查当前版本 $PSVersionTable.PSVersion # 旧版本用 winget 升级 winget install --id Microsoft.PowerShell --source wingetpsmux 本身的安装任选其一winget install psmux # 或 cargo install psmux / choco install psmux三步上手零配置启动 Agent 团队完整指南见 docs/claude-code.md核心流程只有 3 步psmux new-session -s work # 1. 创建命名会话 claude # 2. 在分屏中运行 Claude Code # 3. 直接让 Claude 组建团队分屏自动出现就这么多。psmux 会自动完成 Claude Code 需要的所有配置你只需像往常一样用claude命令即可。原理psmux 替你做了什么当分屏在 psmux 内启动时以下环境变量被自动设置详见 docs/claude-code.md#L56-L72变量值作用TMUX/tmp/psmux-{pid}/...让 Claude Code 识别我在 tmux 里CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1打开 Agent Teams 功能开关PSMUX_CLAUDE_TEAMMATE_MODEtmux触发自动注入--teammate-mode tmux其中第二个修复尤为关键Claude Code 的 teammate 工具集spawnTeam、spawnTeammate默认被这个环境变量门控没有它 Claude 只会用不可见的进程内 Agent永远不会创建分屏。psmux 的claude包装函数还会在你没有自行配置teammateMode时自动注入参数——你自己的配置始终优先两者永不冲突。避坑指南两套 Agent 系统别混淆Claude Code 内部其实有两套完全不同的 Agent 系统psmux 只能控制其中一套✅ Teammate 模式分屏可见每个 teammate 拥有独立分屏全程可见由CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1--teammate-mode tmux驱动psmux 都已设置Haiku、Sonnet 等模型倾向于选择这条路⚠️ Worktree 模式进程内、不可见通过git worktree创建隔离分支在进程内运行没有任何分屏Opus 倾向选择它追求 git 级隔离Windows 上该模式的 tmux 集成被硬编码禁用无法强制切到分屏实用技巧在项目CLAUDE.md中写入指令引导模型优先使用 teammate 系统# Agent Configuration 当生成子代理时始终使用 teammate 系统team_name name 参数 不要使用 isolation: worktree确保 Agent 在 tmux 分屏中可见。这是 best-effort 方案模型仍可能为复杂任务选择 worktree 隔离。另一个必知限制Agent 团队只在交互模式直接运行claude下分屏。使用claude -p管道模式时Agent 有意在进程内运行——因为没有可分屏的交互终端。验证与排错进入 psmux 分屏后三条命令确认环境就绪Write-Host TMUX: $env:TMUX Write-Host AGENT_TEAMS: $env:CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS Write-Host TEAMMATE_MODE: $env:PSMUX_CLAUDE_TEAMMATE_MODE预期输出1和tmux即配置成功。常见问题速查症状原因与解法打开 Agent View 后 teammate 不再分屏Agent View 重新执行二进制时丢失了注入参数。在~/.claude/settings.json设置{ teammateMode: tmux }一劳永逸Agent 仍在进程内运行检查是否误用了-p管道模式可用--debug-file $env:TEMP\claude_debug.log排查分屏报 The module X could not be loaded路径含空格引发的引号解析问题psmux 3.3.9 起已修复更多细节包括鼠标滚轮在 Claude Code 分屏中的 Windows 版本差异见 docs/claude-code.md#L221-L300。进阶手动编排多智能体网格除了自动分屏你也可以用脚本精确编排多个 Agent 各占一个窗口配合send-keys下达指令、capture-pane读取输出、remain-on-exit保留崩溃现场psmux new-session -d -s agents -n hub -x 200 -y 50 foreach ($n in backend, frontend, docs) { psmux new-window -t agents -n $n -d psmux select-pane -t agents:${n}.0 -T agent: $n psmux pipe-pane -t agents:${n}.0 -o cat C:\logs\$n.log psmux send-keys -t agents:${n}.0 claude Enter } psmux attach -t agentsdetachprefix d后所有 Agent 继续后台运行随时psmux attach -t agents回来看。完整的多智能体布局、日志轮询、崩溃自动重启等模式请阅读教程 docs/tutorials/terminal-agents-and-tuis.md。小结psmux 让 Claude Code 的 Agent 团队能力在 Windows 上开箱即用环境变量自动设置、teammate 模式自动注入、每个智能体一个真实分屏。理解 teammate 与 worktree 两套系统的区别后你就能放心地在 Windows 原生环境中组建并观察你的 AI 开发团队了。【免费下载链接】psmuxTmux on Windows Powershell - tmux for PowerShell, Windows Terminal, cmd.exe. Includes psmux, pmux, and tmux commands. This is native High-Performance Tmux designed for Windows in Rust 项目地址: https://gitcode.com/gh_mirrors/ps/psmux创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考