Claude Desktop Buddy Bridge

claude-desktop-buddy-bridge

用一块实体小屏幕，按键审批 Claude Code CLI 的每一次敏感操作。

[](https://www.python.org/) [](LICENSE) [](https://github.com/astral-sh/uv)

---

     

Anthropic 的官方 [claude-desktop-buddy](https://github.com/anthropics/claude-desktop-buddy) 固件让 M5StickC Plus 变成 Claude 的物理审批按钮——但它只与**桌面应用**通信，CLI 用户无缘使用。

**claude-desktop-buddy-bridge** 填补这个空缺：一个轻量 Python 守护进程，通过 Claude Code 原生 Hook 系统拦截工具调用，经由 BLE NUS 协议与设备通信，让你用手边的硬件按键来 approve / deny，而不是盯着终端敲 y。

flowchart TD
    A["**Claude Code CLI**\nPermissionRequest 钩子"]
    B["**cdbb 守护进程**"]
    C["**M5StickC Plus**"]
    D["**按键决策**\n批准或中止"]
    E["**继续执行**"]
    F["**中止任务**"]

    A --> B
    B -->|"BLE（NUS）"| C
    C --> D
    D -->|"决策结果"| B
    B --> E
    B --> F

---

功能

• 零侵入：通过 Claude Code 原生 Hook 接入，不需要修改任何项目文件
• Fail-open：守护进程未运行时，CC 自动回退到自己的权限对话框
• 自动扫描：无需手动查找设备地址，自动发现广播名以 Claude 开头的设备
• 中文安全：所有发往设备的字符串自动 sanitize，避免固件点阵字体索引越界崩溃
• 并发串行：多个并发 hook 请求排队，不会同时争抢设备
• EOF 竞争检测：若 CC 提前终止 hook 进程，立即清空设备显示，不会傻等超时
• 心跳自愈：BLE 链路断开后连续失败退出，由 launchd/systemd 自动重启

---

硬件要求

• M5StickC Plus，烧录 Anthropic 官方 claude-desktop-buddy 固件
• macOS（已测试）或 Linux（需额外蓝牙权限配置，见下文）

---

快速开始

1. 烧录固件

git clone https://github.com/anthropics/claude-desktop-buddy
cd claude-desktop-buddy
pio run -t erase && pio run -t upload

2. 安装 claude-desktop-buddy-bridge

# 使用 uv（推荐）
uv tool install claude-desktop-buddy-bridge

# 或直接从源码
git clone https://github.com/cuiqingwei/claude-desktop-buddy-bridge
cd claude-desktop-buddy-bridge
uv sync