克劳德遥控+
通过手机在项目之间热交换Claude Code远程会话。一个守护进程+MCP服务器,用于管理 claude remote-control 具有自动重启、健康监控和项目切换功能的进程——所有这些都可以通过远程会话本身内的MCP工具进行控制。
为什么?
克劳德代码 remote-control 该功能允许您从手机或浏览器进行编码,但每个进程只处理一个会话。如果您跨多个项目工作,则需要SSH并手动重新启动。 克劳德遥控+ 修复此问题:
- 持久守护进程管理您的项目池
- 从远程会话本身切换项目(不需要SSH)
- 健康监控自动重启崩溃的会话
- 适用于手机、平板电脑或任何浏览器
快速开始
# Install
npm install -g claude-remote-plus
# Add your projects
crp add my-app ~/projects/my-app
crp add api-server ~/projects/api-server
# Start the daemon
crp start --project my-app
# Check status (shows session URL)
crp status在手机上打开会话URL。你加入了。
切换项目
从远程会话(电话/浏览器)
只需让Claude使用MCP工具:
“切换到api服务器” “列出我的项目” “显示服务器日志”
克劳德会打电话的 remote_switch, remote_list, remote_logs 等等。
从终端
crp switch api-server
crp list
crp statusMCP设置
添加 ~/.claude/settings.json:
{
"mcpServers": {
"claude-remote-plus": {
"url": "http://localhost:24880/sse"
}
}
}这使每个Claude Code会话(包括远程会话)都可以访问交换工具。
CLI命令
| 命令 | 描述 |
|---|---|
crp start [--project name] [--port PORT] | 启动守护进程 |
crp stop | 停止守护进程 |
crp status | 显示服务器和会话状态 |
crp switch | 切换到项目 |
crp list | 列出已配置的项目 |
| `crp add | |
| [--sandbox]` | 添加项目 |
crp remove | 删除项目 |
crp update [--path P] [--sandbox] | 更新项目设置 |
crp set-default | 设置默认项目 |
crp restart | 重新启动当前会话 |
crp install | 作为自动启动服务安装 |
crp uninstall | 删除自动启动服务 |
MCP工具
可从任何连接的Claude Code会话中获得:
| 工具 | 说明 |
|---|---|
remote_switch | 切换到其他项目 |
remote_list | 列出所有具有状态的项目 |
remote_status | 当前会话信息 |
remote_add | 注册新项目 |
remote_remove | 注销项目 |
remote_update | 更新项目路径或沙盒模式 |
remote_restart | 重新启动当前会话 |
remote_logs | 查看最近的服务器日志 |
配置
Config住在 ~/.claude-remote-plus/config.json:
{
"projects": [
{ "name": "my-app", "path": "/home/user/projects/my-app", "sandbox": false },
{ "name": "api-server", "path": "/home/user/projects/api-server", "sandbox": true }
],
"defaultProject": "my-app",
"healthCheckInterval": 30000,
"autoRestart": true,
"port": 24880
}登录时自动启动
# macOS (launchd)
crp install
# Also works on Linux (systemd) and Windows (startup script)删除与 crp uninstall.
运作原理
┌──────────────────────────────────────────┐
│ claude-remote-plus daemon │
│ HTTP server on localhost:24880 │
│ │
│ MCP Server (SSE) ──── Claude sessions │
│ REST API ──────────── CLI (crp) │
│ Session Manager ───── claude processes │
│ Health Monitor ────── auto-restart │
└──────────────────────────────────────────┘- 守护进程作为后台HTTP服务器运行
- 它正在孕育
claude remote-control作为目标项目目录中的子进程 - MCP工具和REST API都控制同一个会话管理器
- 健康监视器监视崩溃和具有回退功能的自动重启(每5分钟最多重启5次)
- 日志轮换保持
~/.claude-remote-plus/server.log10MB以下
需求
- Node.js>=18
- 克劳德代码CLI 已安装并验证
发展
npm install
npm run build
npm test
npm run dev # watch mode许可证
麻省理工学院
