在家电脑上开了个头, 出门改用手机, 路上想到事儿打开平板再补两句 —— 你跟 AI 之间的一切对话和进度, 永远接得上。
自托管的 Claude Code 远程控制台. 多机 Hub 聚合 session, PWA 跨设备 同步, 聊天 / 工具调用 / diff / 推送通知, 全部跑在自己机器上.
Vibing everything is a self-hosted web console
for the claude CLI. The Hub you're looking at is
a central service that aggregates one or more server
processes running on your machines. From here you can chat with Claude
on any of them, approve tool calls, see diffs — same UI regardless of
which machine the session lives on.
claude CLI
subprocesses and persist sessions locally.laptop,
vps-01), and you'll get a device token.
Copy it now — it's shown only once.Source: https://github.com/hwaipy/ClaudeCodeRemote
(or your fork).
git clone https://github.com/hwaipy/ClaudeCodeRemote.git
cd ClaudeCodeRemote
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
Replace tok-... with the device token from
step 3 of the quick path. CCR_TOKEN protects the local
port if you also browse the server directly (LAN); pick any random
hex string.
Drop a unit at
~/.config/systemd/user/ccr.service from
deploy/ccr.service.example in the repo. Then:
systemctl --user daemon-reload
systemctl --user enable --now ccr.service
journalctl --user -u ccr.service -f
For the server to keep running when you log out:
sudo loginctl enable-linger $USER.
Cleaner option — full stack (Python + Node + Claude Code) in a container, drop-in replacement for the Linux host path.
git clone https://github.com/hwaipy/ClaudeCodeRemote.git
cd ClaudeCodeRemote/deploy/local-app
docker compose up -d --build
docker compose logs -f ccr-app-local
| Symptom | Likely cause / fix |
|---|---|
| Server stays offline on Hub | Check journalctl --user -u ccr for the hub_client
connect line. Common: wrong CCR_HUB_URL (must be
wss://) or revoked token. |
| Server constantly disconnects with superseded | Two processes sharing the same device token. Each server needs its own. Revoke + re-register if unsure. |
| Sessions on one server appear under another | Caches; hard-reload (Ctrl+Shift+R). If persists, restart the affected server — it'll resync its session snapshot to the Hub. |
| Lost the device token | Revoke the server entry from Cloud Servers and register a new one. Tokens are stored as a SHA-256 hash; the Hub can't recover them. |
把下面这段话原样丢给你 server 那台机器上的 Claude Code, 它会自动帮你完成剩下的安装 + 接入. 完成后这个弹窗会自动关闭.
) —
关闭这页就拿不回; server 一旦接入 token 就用过了, 后续不需要.