用途:在当前 cmux 会话中将 Claude Code 对话派生(fork)到新的 cmux 窗格或工作区,并保留完整会话上下文。仅用于 fork Claude Code 会话;若要启动其他智能体(Codex、Gemini CLI),应改用 cmux-delegate。
主要能力:支持三种方向。默认向右分屏;输入 right、下、down 等关键字可指定方向;输入 workspace、新工作区等可新建工作区。可根据输入语言自动切换输出语言(日语使用 references/fork-guide.ja.md,英语使用 references/fork-guide.md),显式指定优先。默认以 --dangerously-skip-permissions 启动派生会话,避免重复授权;仅当用户明确要求交互模式时去掉该参数。
使用方式:先确认环境,执行 echo $CMUX_SOCKET_PATH,若为空或未设置则报错并停止。然后根据方向执行 cmux new-split right、cmux new-split down 或 cmux new-workspace,从输出 OK surface:{N} workspace:{N} 中提取 surface 句柄。接着向新界面发送命令:cmux send --surface surface:{N} "claude --continue --fork-session --dangerously-skip-permissions\n"(交互模式则去掉 --dangerously-skip-permissions)。最后等待并验证:sleep 3 后执行 cmux read-screen --surface surface:{N},检查是否出现启动信息或提示符。
适用场景:需要在保留上下文的前提下并行探索不同思路、开新窗格继续对话或开新工作区隔离任务时使用。
限制:必须在 cmux 会话内运行,否则无法获取 socket 路径;new-split 失败通常说明 cmux 未运行;claude --continue --fork-session 失败可能是会话历史为空(首次启动);重试后仍未检测到提示符时需提示用户手动检查新窗格。
事实说明:以上为资料中明确提供的命令与行为,价格、计费、支持平台等未在资料中说明,暂未提供。