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 组网，随时随地对话、审批权限、切换模型。
8183a97d4b8f9175af82b12ab3d655ce1920×1111 342 KB
2.历史记录重放
image1920×1113 241 KB
3.切换工作目录
image1920×1111 250 KB
还有许多细节写在了 GitHub 项目的 README 里面，目前项目处于初级阶段，欢迎各位佬友提 issue / 建议 / PR～
--【壹】--：
感谢佬友分享
--【贰】--：
感谢分享
--【叁】--：
这样.是原理不一样是吧.哈雷佬的方案是和A社一样的是吧
--【肆】--：
感谢大佬
--【伍】--： RioArisk:
erver.js则是会去读取 Claude Code 生成的 transcript（JSONL 事
佬，跟这个项目有什么区别吗？
GitHub - tiann/hapi: App for Claude Code / Codex / Gemini / OpenCode,...
App for Claude Code / Codex / Gemini / OpenCode, vibe coding anytime, anywhere
--【陆】--：
海量rust代码 惹不起惹不起
--【柒】--：
感谢分享
--【捌】--：
弄一个 codex 的远程
--【玖】--：
我要抓紧上线了
--【拾】--：
@Haleclipse 哈雷可以休息了
--【拾壹】--：
我的项目更像是一个轻量的终端转发器：
- 桥接器（server.js)启动 Claude Code 进程，注入 Hook 脚本
- Claude Code 通过 Hook 向桥接器上报 session（会话文件标识）
- 桥接器根据 session 定位并轮询 JSONL 会话文件，解析后转发给 App
- 本质是对 Claude Code 进程的远程监视与转发，不改变 Claude Code 自身的工作方式
- 没有修改claude code，体验和正常用claude code一样，就是server.js调用了claude命令启动claude code
我理解的 HAPI 则构建了一个完整的中间层协议：
Web PWA → SSE/REST → Hub Server → Socket.IO/RPC → CLI Agent → Claude Code
- 不直接操控终端，而是通过会话/消息/权限协议交互
- Hub 作为独立服务，负责持久化、多用户隔离、消息路由
- CLI 通过 MCP 协议暴露工具给 Claude，形成双向通信
- 多 Agent — 不局限于 Claude Code
- 生产级基础设施 — 数据库持久化、版本冲突解决、命名空间隔离
按我的理解是：
我的项目是类似于是监视器 — 桥接器读取 Claude Code 的会话文件，原样转发给远端 App；
HAPI 是管理平台 — 在 Claude Code 之上构建了完整的会话管理、多 Agent、多用户协议层。
--【拾贰】--：
感谢分享，晚上试用一下
--【拾叁】--：
关注一下，或许后续会用到
--【拾肆】--：
佬，最新的3.0版本弹窗在会被输入法遮挡。
还有能否适配一下Linux中图片上传的问题。我在Linux上的claude无法接收图片
--【拾伍】--：
我也许愿codex，codex真的很适合在app上执行，发布一个长任务，跑完然后在app上大概看一下，然后再在pc端验证。
--【拾陆】--：
我的意识是codex 的app?哈哈，就当我许愿了。
哈雷佬快做.jpg
--【拾柒】--：
期待哈雷.要不顺手再vibe一个codex出来?
--【拾捌】--：
完全不一样 我只能说
我说过了 我是直接衔接官方方案 也就是在CC里面直接打开 remote-control 开关 本机不需要装任何其他东西
--【拾玖】--：
很有用，现在我要看cc的情况都是用远程回家里的电脑看的。。这个解决了这个问题
前几天看到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 组网，随时随地对话、审批权限、切换模型。
8183a97d4b8f9175af82b12ab3d655ce1920×1111 342 KB
2.历史记录重放
image1920×1113 241 KB
3.切换工作目录
image1920×1111 250 KB
还有许多细节写在了 GitHub 项目的 README 里面，目前项目处于初级阶段，欢迎各位佬友提 issue / 建议 / PR～
--【壹】--：
感谢佬友分享
--【贰】--：
感谢分享
--【叁】--：
这样.是原理不一样是吧.哈雷佬的方案是和A社一样的是吧
--【肆】--：
感谢大佬
--【伍】--： RioArisk:
erver.js则是会去读取 Claude Code 生成的 transcript（JSONL 事
佬，跟这个项目有什么区别吗？
GitHub - tiann/hapi: App for Claude Code / Codex / Gemini / OpenCode,...
App for Claude Code / Codex / Gemini / OpenCode, vibe coding anytime, anywhere
--【陆】--：
海量rust代码 惹不起惹不起
--【柒】--：
感谢分享
--【捌】--：
弄一个 codex 的远程
--【玖】--：
我要抓紧上线了
--【拾】--：
@Haleclipse 哈雷可以休息了
--【拾壹】--：
我的项目更像是一个轻量的终端转发器：
- 桥接器（server.js)启动 Claude Code 进程，注入 Hook 脚本
- Claude Code 通过 Hook 向桥接器上报 session（会话文件标识）
- 桥接器根据 session 定位并轮询 JSONL 会话文件，解析后转发给 App
- 本质是对 Claude Code 进程的远程监视与转发，不改变 Claude Code 自身的工作方式
- 没有修改claude code，体验和正常用claude code一样，就是server.js调用了claude命令启动claude code
我理解的 HAPI 则构建了一个完整的中间层协议：
Web PWA → SSE/REST → Hub Server → Socket.IO/RPC → CLI Agent → Claude Code
- 不直接操控终端，而是通过会话/消息/权限协议交互
- Hub 作为独立服务，负责持久化、多用户隔离、消息路由
- CLI 通过 MCP 协议暴露工具给 Claude，形成双向通信
- 多 Agent — 不局限于 Claude Code
- 生产级基础设施 — 数据库持久化、版本冲突解决、命名空间隔离
按我的理解是：
我的项目是类似于是监视器 — 桥接器读取 Claude Code 的会话文件，原样转发给远端 App；
HAPI 是管理平台 — 在 Claude Code 之上构建了完整的会话管理、多 Agent、多用户协议层。
--【拾贰】--：
感谢分享，晚上试用一下
--【拾叁】--：
关注一下，或许后续会用到
--【拾肆】--：
佬，最新的3.0版本弹窗在会被输入法遮挡。
还有能否适配一下Linux中图片上传的问题。我在Linux上的claude无法接收图片
--【拾伍】--：
我也许愿codex，codex真的很适合在app上执行，发布一个长任务，跑完然后在app上大概看一下，然后再在pc端验证。
--【拾陆】--：
我的意识是codex 的app?哈哈，就当我许愿了。
哈雷佬快做.jpg
--【拾柒】--：
期待哈雷.要不顺手再vibe一个codex出来?
--【拾捌】--：
完全不一样 我只能说
我说过了 我是直接衔接官方方案 也就是在CC里面直接打开 remote-control 开关 本机不需要装任何其他东西
--【拾玖】--：
很有用，现在我要看cc的情况都是用远程回家里的电脑看的。。这个解决了这个问题