cmux 用于在终端内编排会话：拆分窗格、创建标签页、启动 Claude Code 实例、发送命令并读取输出，还能操作内置浏览器和预览 Markdown。
检测：检查 CMUX_WORKSPACE_ID 环境变量，已设置说明处于 cmux 中，未设置则跳过所有 cmux 命令。层级为 Window > Workspace > Pane > Surface，短引用如 workspace:1、pane:1、surface:2。
定位与创建：cmux identify --json 查看当前上下文，cmux list-workspaces、cmux list-panes、cmux list-pane-surfaces --pane <ref>、cmux tree --all 查看层级；cmux new-split <left|right|up|down> 拆分窗格，cmux new-workspace --cwd <path> 新建工作区，cmux new-surface 新建标签页。
启动 Claude Code：网络访问需代理，命令前须带 proxy。交互模式用 cmux send --surface <ref> 'proxy && claude --dangerously-skip-permissions\n'；非交互模式用 cmux send --surface <ref> 'proxy && claude -p "your prompt" --model haiku 2>&1 | tee /tmp/agent-output.txt; echo "AGENT_DONE"\n'。
输入输出：cmux send --surface <ref> "text\n" 发送文本，cmux send-key --surface <ref> <key> 发送特殊键，cmux read-screen --surface <ref> --lines <n> 读取输出。
侧边栏状态：cmux set-status、cmux set-progress、cmux log、cmux notify 及对应 clear 命令。工作区管理：rename-workspace、rename-tab、close-surface、close-workspace。
浏览器：cmux --json browser open <url> 打开，cmux browser <surface> wait/snapshot/click/fill/screenshot/get/navigate 等操作页面。Markdown 预览：cmux markdown open plan.md 可自动重载，支持 --workspace 指定目标。
安全规则：不要向非自己创建的 surface 发送内容，始终用 --surface <ref> 指定目标，避免抢焦点，用完关闭自己创建的 surface/workspace，先执行 identify --json 了解上下文。
限制：资料未提供安装方式、收费、平台支持等细节。