Claude Remote:让 API Key 用户也能用手机远程控制 Claude Code
- 内容介绍
- 文章标签
- 相关推荐
问题描述:
前几天看到Claude Code推出了远程控制,挺想试试的,但是我日常更多是API在跑claude code,用不了官方的,我去搜了一下,替代的有不少已经做到很完善的happy/hapi 但是我的需求更偏向于极简第二屏,并且刚好之前做过一个pty的项目,所以我的思路和happy有点不一样。
以下是我的实现思路:
- 电脑上启动一个
server.js作为 Bridge(桥接服务),对外提供一个 WebSocket 服务。 - 手机上的 Android App 作为“第二屏客户端”,连接到这个 WebSocket。
server.js内部用 node-pty 起一个 PTY,在 PTY 里控制 Claude Code CLI。- 手机端发来的输入(文本/命令等)会通过 WebSocket 发送到
server.js,再写入 PTY,从而驱动 Claude Code 继续执行。 server.js则是会去读取 Claude Code 生成的 transcript(JSONL 事件流文件),路径在~/.claude/projects/下;通过解析这些 JSONL,把会话事件/记录同步到手机端展示。
image889×380 24.3 KB
以下是我的github项目链接。附一些实现效果图
1.远程对话双端显示:
RioArisk/claudecode_api_RemoteControl: 非官方 Claude Code 远程控制方案 —— 让 API 用户也能从手机操控编程会话。支持局域网 / Tailscale 组网,随时随地对话、审批权限、切换模型。
问题描述:
前几天看到Claude Code推出了远程控制,挺想试试的,但是我日常更多是API在跑claude code,用不了官方的,我去搜了一下,替代的有不少已经做到很完善的happy/hapi 但是我的需求更偏向于极简第二屏,并且刚好之前做过一个pty的项目,所以我的思路和happy有点不一样。
以下是我的实现思路:
- 电脑上启动一个
server.js作为 Bridge(桥接服务),对外提供一个 WebSocket 服务。 - 手机上的 Android App 作为“第二屏客户端”,连接到这个 WebSocket。
server.js内部用 node-pty 起一个 PTY,在 PTY 里控制 Claude Code CLI。- 手机端发来的输入(文本/命令等)会通过 WebSocket 发送到
server.js,再写入 PTY,从而驱动 Claude Code 继续执行。 server.js则是会去读取 Claude Code 生成的 transcript(JSONL 事件流文件),路径在~/.claude/projects/下;通过解析这些 JSONL,把会话事件/记录同步到手机端展示。
image889×380 24.3 KB
以下是我的github项目链接。附一些实现效果图
1.远程对话双端显示:
RioArisk/claudecode_api_RemoteControl: 非官方 Claude Code 远程控制方案 —— 让 API 用户也能从手机操控编程会话。支持局域网 / Tailscale 组网,随时随地对话、审批权限、切换模型。

