Claude Code Bridge — Development skill for Claude Code

Agent Bridge

用手机（飞书里的网页）远程查看、驱动你电脑上的 Claude Code：接着 VS Code / 终端里正在进行的会话继续聊，审批工具调用，看代码改动，发图片。

非官方项目，与 Anthropic 无关。Claude 是 Anthropic 的商标。

手机（飞书 H5）  ──▶  公网中继 relay  ◀── 出站隧道 ──  你的电脑 / 远程开发机：Bridge ──▶ claude

目录结构

入口脚本留在仓库根目录，实现按功能放进子目录：

agent-bridge/
├── relay.py             入口：中继。serve 服务端 / 管理命令（含一份仅供测试使用的 Python 客户端）
├── bridge-js/           Bridge 与中继客户端（Node，只用内置模块，运行在 Claude Code 所在的机器上）
│   ├── server.js          入口：本机 Bridge（HTTP + SSE，监听 127.0.0.1）
│   ├── relay-client.js    中继客户端：绑定、隧道、把任务完成/待审批上报给中继
│   ├── hook-approve.js    PreToolUse Hook 脚本，向 Bridge 请求审批
│   └── lib/               会话列表与多窗口登记、转录渲染、任务执行、审批与差异、命令、二维码
├── relay_lib/           中继的依赖
│   ├── feishu_auth.py     飞书登录、设备与令牌
│   └── qr.py              纯标准库的二维码生成（终端与插件面板用）
├── web/                 手机端 H5：index.html、app.js、markdown.js、style.css
├── deploy/              部署材料：nginx 配置、systemd 服务、启动脚本、上线检查
├── vscode-extension/    VS Code 插件（一键启动、扫码绑定、状态栏）
├── tests/
│   ├── bridge/            对 bridge-js 的集成测试，以及假的 claude
│   ├── relay/             中继、Node 客户端与二维码测试
│   ├── parity/            二维码编码器的 Python / JavaScript 逐项比对
│   └── web/               手机端页面测试（需要 jsdom）
├── Makefile             测试、打包的统一入口
└── README.md  CHANGELOG.md  CONTRIBUTING.md

三个运行单元各自独立：**Bridge 与中继客户端**（`bridge-js/`）跑在用户机器上，**中继**（`relay.py` + `relay_lib/` + `web/`）跑在公网服务器上，**插件**（`vscode-extension/`）把前两者在用户机器上一键拉起。用户电脑上只有 Node 版本，由 VS Code 自带的 Node 运行，不需要安装 Python 或 Node；中继在服务器上，用纯 Python 标准库。都没有第三方依赖。

背景：遇到的问题

1. 人不在电脑旁，Claude Code 就停住了。 它在等你审批一次写文件或执行命令，或者你想补一句话，但只能回到电脑前。
2. 开发机没有公网入口。 代码和 Claude 跑在公司内网、容器或远程服务器上，不能为了手机访问而对外开放端口。
3. 多人使用，账号必须隔离。 每个人有自己的电脑，一个飞书账号只能看到、操作自己绑定的那些电脑（可以不止一台，比如同时连着几个远程容器）。
4. 自定义 API 用不了官方的远程连接。 VS Code 里的 Claude Code 只有使用官方 API 时才能远程连接（Remote Control）。配置了自定义 API（第三方或自建网关）的用户没有这条路，人一离开电脑就没法继续。
5. 离开电脑就看不到进度。 VS Code 里的会话、Claude 改了哪些代码、贴过的图片，在手机上都没有办法查看，也没法在手机上接着对话。

方案

• Bridge：跑在 Claude Code 所在的机器上，只监听 127.0.0.1。读取本机的 Claude 会话