用 WebMux 远程运行 Claude Code

1. 安装并认证 Claude Code

在运行 WebMux 的机器上按 Claude Code 官方说明（外部链接） 安装，并以运行 WebMux 的服务用户身份完成认证。WebMux 不会自动安装或认证 CLI，也不代管模型密钥。

要使用聊天视图，还需在服务器上另外安装第三方 ACP 连接器 claude-agent-acp：

npm install -g @agentclientprotocol/claude-agent-acp

2. 使用预置启动配置

交互式命令

claude

预置参数

--dangerously-skip-permissions

在“新建会话 → 预先输入”选择该启动配置，指定目录或工作树，再创建会话。也可以在服务所在机器的终端里启动，Ctrl+] 分离后到手机上继续：

webmux run -- claude --dangerously-skip-permissions

已有安装升级时不会改写 launch-configs.json；列表里缺少该 CLI 时，在“设置 → 启动配置 → 新建启动配置”填写名称和上面的命令。预置命令用“加载 shell 启动文件”包装，以读取 ~/.bashrc 或 ~/.zshrc 中的 PATH。 已有安装

3. 终端、混合会话与提醒

终端

持久 PTY 终端：浏览器断线不会结束进程，可重新连接并回放缓冲；服务重启会结束会话。

混合会话（聊天 ↔ 终端）

支持。预置配置已勾选混合模式，可在终端与聊天视图之间切换同一段对话，历史由 Claude Code 自己保存。 开启条件

“需要你介入”提醒

2.1.295 及以上无需配置（OSC 7501）；2.1.141 至 2.1.294 需在 ~/.claude/settings.json 注册 hook。 提醒配置

4. 已知限制

• 聊天端需要 Node.js 22 或更高版本和第三方连接器 claude-agent-acp；WebMux 不会自动安装，也不会用 npx 临时下载。
• 已验证基线为 Claude Code 2.1.316 与 claude-agent-acp 0.99.1（Linux 原生、API key / 第三方 provider）；npm 启动器、macOS 与订阅登录未在该基线中实测。
• 复用现有登录不等于授予其他分发形态的订阅使用权，请自行确认符合 Claude 订阅与服务条款；聊天端隐藏 /login 与 /logout。
• 不要在 WebMux 之外同时打开同一个 Claude Code 会话；外部写者可能漏检。