control-claude-code

为 Claude Code 的第三方中转站 API Key 用户提供类原生级别的远程操控体验

简体中文 · English

---

支持桌面端与手机端，后端支持自部署以实现隐私保护。

目前已在 Linux 和 macOS 上通过测试。

安装

需要 Node.js 22.23.4+（22.x）、24.22.1+（24.x）或 26.12.1+（26.x）。这些版本包含 2026 年 10 月安全修复， 包括 Brotli 解码器远程代码执行漏洞修复。升级 CLI 时也请升级宿主机的 Node.js。 源码开发可运行 nvm install && nvm use 使用 .nvmrc 指定的版本。

npm i -g control-claude-code

受限于实现方法，本项目对于 Claude Code 的更新是敏感的，因此建议您安装 Claude Code 的稳定版本。

使用

control-claude       # 该命令将代替 `claude` 命令，启动一个受控的 Claude Code

当你需要转手到远程操控，只需要像官方订阅用户一样使用 /rc 或者 /remote-control 命令即可。

项目默认将远程操控提交到后端 https://ccc.racel.dev，首次启动你将会被要求设置后端，你可以选定你的自部署后端， 由于我现在部署的后端尚不具备生产要求，因此暂不开放给公众使用。

本项目将配置存储到 ~/.config/control-claude-code/config.json, 如果你需要重新登录，可以使用 --login 参数.

其他参数将会被原样传输给 Claude Code，例如：

control-claude --resume
control-claude -c --model opus "fix this bug"
control-claude -- --help          # everything after -- is claude's
control-claude --headless         # phone-only, no TUI

自部署后端

将本项目的 Docker Compose 文件下载，或者干脆直接克隆本项目，然后使用指令启动即可：

INVITE_CODE=<注册邀请码> docker compose up -d

服务器默认部署到 :8787，请视需求自行修改。如果不设定环境变量 INVITE_CODE，注册将会被关闭。

更新已有部署时，请拉取新镜像并重建应用容器（保留数据库卷）：

docker compose pull app
docker compose up -d --no-deps app
docker compose exec app node --version  # v24.22.1

文档与开发

参考文档与本地开发流程请见 AGENTS.md。

许可

PolyForm Noncommercial 1.0.0。你可以使用、修改、分享本项目，用于个人使用、学习与研究。 本项目不授予商业使用许可，这也包括在公司内部的使用。claude 本身归 Anthropic 所有， 而本项目是面向其产品的一个客户端。