使用说明
克劳德遥控+
通过手机在项目之间热交换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 status
MCP设置
添加 ~/.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 <name> |
切换到项目 |
crp list |
列出已配置的项目 |
crp add <name> <path> [--sandbox] |
添加项目 |
crp remove <name> |
删除项目 |
crp update <name> [--path P] [--sandbox] |
更新项目设置 |
crp set-default <name> |
设置默认项目 |
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
许可证
麻省理工学院
