Run Claude Code remotely with WebMux

1. Install and sign in to Claude Code

On the machine running WebMux, follow the official Claude Code docs (external link) to install it, and sign in as the same user that runs the WebMux service. WebMux does not install or sign in to CLIs and does not manage model keys.

For the chat view, also install the third-party ACP connector claude-agent-acp on the server:

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

2. Use the preset launch configuration

Interactive command

claude

Preset arguments

--dangerously-skip-permissions

In “New session → Pre-type”, pick this launch configuration, choose a directory or worktree and create the session. You can also start it from a terminal on the server, detach with Ctrl+] and continue on your phone:

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

Upgrades never rewrite an existing launch-configs.json; if this CLI is missing, add it in “Settings → Launch configurations → New” with the command above. Presets use the “load shell startup files” wrapper so the CLI sees the PATH from ~/.bashrc or ~/.zshrc. Existing installs (Chinese)

3. Terminal, hybrid sessions and alerts

Terminal

Persistent PTY terminal: a browser disconnect does not end the process, and you can reconnect and replay the buffer; a service restart ends the session.

Hybrid session (chat ↔ terminal)

Supported. The preset has hybrid mode enabled, so the same conversation switches between terminal and chat views; Claude Code keeps the history itself. Requirements (Chinese)

“Needs you” alerts

2.1.295+ works without setup (OSC 7501); 2.1.141–2.1.294 needs a hook in ~/.claude/settings.json. Alert setup (Chinese)

4. Known limits

• The chat side needs Node.js 22 or later and the third-party connector claude-agent-acp; WebMux never installs it or fetches it with npx.
• Verified baseline: Claude Code 2.1.316 with claude-agent-acp 0.99.1 (native Linux, API key / third-party provider); the npm launcher, macOS and subscription login were not part of that baseline.
• Reusing an existing login does not grant subscription rights for other distribution forms; confirm your use complies with Claude's subscription terms. The chat side hides /login and /logout.
• Do not open the same Claude Code session outside WebMux at the same time; external writers may go undetected.