## Claude Watch:实时从 Apple Watch 控制 Claude Code
开发者 shobhit99 推出了 Claude Watch——一款开源应用,让你直接从 Apple Watch 控制 Claude Code 会话。该系统允许你在不离开主工作区的情况下监控终端并发送命令,包括语音命令。它解决了开发过程中快速响应 AI 工具通知的问题。
架构包括三个组件:Mac 上的网络桥接器、iPhone 应用和 watchOS 客户端。Node.js 桥接器通过 webhook 与 Claude Code CLI 集成,拦截终端事件。iPhone 作为同步中介,而手表则显示输出并接受输入。
系统组件
网络桥接器
基于 Node.js 构建,它连接到 Claude Code 并监控会话。当事件到达(终端输出、请求)时,桥接器生成通知并通过本地网络路由到 iPhone。需要安装 Node.js 和 Claude Code CLI。
iPhone 应用
处理桥接器和手表之间的通信。通过 Wi-Fi 接收数据,缓存会话状态,并转发到 watchOS。支持后台模式以实现持续监控。
watchOS 客户端
管理手表上的 UI:以滑动模式显示终端日志,通过键盘或语音听写进行文本输入。支持新事件通知的触觉反馈。
要求和安装
要部署,你需要:
- macOS 13 或更高版本的 Mac。
- iOS 17+ 的 iPhone。
- watchOS 10+ 的 Apple Watch。
- 所有设备连接到同一 Wi-Fi 网络。
启动流程:
- 在 Mac 上安装 Node.js 和 Claude Code CLI。
- 克隆 GitHub 仓库,通过 Xcode 构建应用。
- 启动桥接器:
npm install && npm start。 - 连接 iPhone 应用和 watchOS 客户端。
仓库包含自动化构建脚本和故障排除部分:端口修复、防火墙权限、网络故障时的桥接器重启。
开发者的益处
Claude Watch 通过移动性扩展了 Claude Code 的功能。资深开发者赞扬它在 TDD 会话中的应用:无需切换到 Mac 即可检查测试或日志。在多任务环境中(例如,多个终端),手表能快速响应关键 AI 事件。
// Example webhook in the bridge (Node.js)
app.post('/webhook', (req, res) => {
const { event, data } = req.body;
if (event === 'terminal_output') {
sendToWatch(data);
}
res.status(200).send('OK');
});
桥接器代码使用 Express 处理端点,并通过 WebSocket 向 iPhone 进行实时传输。
关键点
- 架构:三部分系统(桥接器-iPhone-手表)确保本地网络低延迟。
- 输入:手表上的语音命令和文本与 Claude Code 无缝集成,不会丢失上下文。
- 开源:GitHub 仓库中提供完整的构建说明和修复方法。
- 限制:需要单一 Wi-Fi,macOS 13+;不支持远程访问。
- 使用场景:非常适合开发中监控 AI 会话。
— Editorial Team
暂无评论。