psmux 安装与使用指南 ​

一、psmux 是什么 ​

用 Rust 写的 Windows 原生终端复用器（相当于 Windows 版 tmux），基于 ConPTY，不需要 WSL / Cygwin / MSYS2。

• 兼容 tmux 命令和 .tmux.conf，提供 psmux / pmux / tmux 三个等价命令
• 支持鼠标、分屏、会话持久化
• 可直接在 Windows Terminal 里运行；对 Claude Code 的 agent teams 有一等支持（在 psmux 里跑 claude，teammate 会自动分到独立 pane）
• 仓库：https://github.com/psmux/psmux

二、安装 ​

方式一：包管理器 ​

方式二：GitHub Releases 直装 ​

# 1. 看架构选包：AMD64→x64，ARM64→arm64，x86→x86
powershell.exe -NoProfile -Command "\$env:PROCESSOR_ARCHITECTURE"

# 2. 下载（以 x64 为例）
mkdir psmux-install && cd psmux-install
curl -L -o psmux-x64-setup.exe \
  "https://github.com/psmux/psmux/releases/latest/download/psmux-x64-setup.exe"

# 3. 静默安装（NSIS 安装包用 /S，大写）
powershell.exe -NoProfile -Command \
  "Start-Process -FilePath 'psmux-x64-setup.exe' -ArgumentList '/S' -Wait"

# 4. 新开终端后验证
psmux --version

安装结果：%LOCALAPPDATA%\psmux\（含 psmux/pmux/tmux.exe 和 uninstall.exe），PATH 自动写入用户环境变量 —— 已开着的终端不生效，需新开。

三、配置用 cmd + 中文不乱码 ​

不配置的话，新 pane 的默认 shell 取决于启动环境（git-bash 里是 bash，wt 里是 powershell）；且中文版 Windows 的 cmd 默认代码页是 936，中文会乱码。

编辑 %USERPROFILE%\.tmux.conf：

set -g default-shell "C:\\Windows\\System32\\cmd.exe"
set -g default-command "cmd.exe /k chcp 65001 >nul"

改完要 psmux kill-server 重开才生效（配置在 server 启动时读取）。

⚠️ default-command 不能用 && 串联 —— psmux 执行它时不经过 shell，用 && 会让会话建完立刻死掉，必须写成 cmd.exe /k <命令> 的形式。

四、常用快捷键 ​

前缀键 Ctrl+b（先按前缀松开，再按后面的键）。鼠标默认开启。

窗口编号从 0 开始；完整键位表见 psmux list-keys。

五、常用命令 ​

psmux                        # 新建会话
psmux new-session -s work    # 新建命名会话
psmux ls                     # 列出会话
psmux attach -t work         # 接入会话
psmux kill-session -t work   # 结束指定会话
psmux kill-server            # 结束全部会话
psmux list-keys              # 查看全部键位
psmux --help

六、排错 ​

卸载："%LOCALAPPDATA%\psmux\uninstall.exe" /S