ccr-cloud documentation
ccr-cloud lets you run Claude Code tasks on your own server and control them from a browser or phone. Start a task, close your laptop, and come back to its progress, approvals and results later. Your code, model access and Git credentials stay on your server.
New here? Start with Getting started. It takes about five minutes on a server where Claude Code already works.
#Get started
- Getting started: install, connect from your laptop and run your first task.
- How it works: the control plane, runners, execution modes and what each one can access.
- Security model: what a task can access, what ccr-cloud enforces, and how to deploy it safely.
- Failure and recovery: what survives disconnects, restarts and crashes, and what doesn't.
#Guides
- Work with repositories: use checkouts already on the server, add a repository by URL, and prepare each task with a setup script.
- Run and control tasks: permissions, response style, approvals beside the message box, follow-ups, change review, pull requests, stop and resume.
- Switch models with CCR: use another model, such as an open-source one, while you're at a Claude usage limit.
- Access from your phone: Tailscale, your own domain with Cloudflare, or a VPN you already run, and pairing a phone with a one-time link.
- Notifications: approval and completion alerts, with Allow once and Deny buttons where the platform supports them.
- Discord control: an optional owner-only Discord bot.
- Docker and CCR sessions: isolated containers through a Claude Code Router gateway.
- Operate your server: updates, restarts, backups, logs and host resources.
#Reference
- Configuration: every setting in
server.env. - Command line:
setup,doctor,pair,github,resources,dev, and thewechatandwhatsapppairing commands. - HTTP API: routes for scripts and other clients.
- Troubleshooting: symptoms, checks and fixes.
#Current scope
ccr-cloud is a single-owner prototype. Tasks run Claude Code. Other task agents and multi-agent coordination are not supported.
Older links to the user guide and the operations reference still work; those pages point to where each section moved.
#Experimental channels
- Personal WeChat: optional iLink text control; real-account verification pending.
- Personal WhatsApp: experimental spare-number QR pairing, disabled by default.