Claude Code Bridge

将 OpenClaw(QQ、Telegram、微信等消息渠道)桥接至后台 tmux 中持久运行的 Claude Code CLI 会话。

安装

概览

Claude Code Bridge 是一款专为开发者设计的消息桥接工具,能够将 OpenClaw(支持 QQ、Telegram、微信等主流即时通讯渠道)的消息无缝桥接到后台持久运行的 Claude Code CLI 会话中。该工具的核心设计理念是让开发者在多平台消息环境中获得与本地终端完全一致的交互体验——用户通过任意聊天渠道发送指令,系统会像在真实终端中操作一样将命令转发给 Claude Code,并实时返回处理结果。这种架构特别适合需要频繁使用 AI 编程助手进行复杂代码任务的开发场景。 为了实现这一目标,Claude Code Bridge 构建了一套完整的会话状态检测机制。每当有新消息进入时,系统首先会通过脚本查询指定会话的运行状态,判断当前是否处于有效的 Claude Code 工作模式。根据检测结果,消息会被智能路由到不同的处理路径:若检测到活跃会话且未处于审批等待状态,则直接转发至 Claude Code 执行;若遇到权限请求或长时间运行任务,则会触发相应的交互流程。整个过程中,所有特殊字符和格式都会被原样保留,确保 CLI 环境的完整性。 该工具特别注重对 Claude Code 原生功能的完整支持,包括其丰富的斜杠命令体系(如 /plan、/model、/compact 等),这些命令会被自动识别并透传给后端进程处理。同时针对中文用户的使用习惯,提供了本地化的控制指令映射,例如“启动cc”、“关闭cc”等自然语言指令可对应到标准操作流程。对于需要用户确认的工具调用请求,系统会解析用户的语义选择并转换为对应的审批动作,实现人机协同的安全控制闭环。

核心功能特点

  1. 支持多平台消息接入:兼容 QQ/Telegram/微信等主流通讯渠道的实时消息桥接
  2. 持久化会话管理:通过 tmux 后台进程维持长期运行的 Claude Code 实例
  3. 智能状态检测:每次消息触发时自动检查会话活性及审批等待状态
  4. 原生命令透传:完整支持 Claude Code 所有斜杠命令的自动转发处理
  5. 中文友好交互:提供符合中文习惯的控制指令与自然语言响应格式
  6. 长任务流控:针对耗时操作提供超时监控与进度反馈机制

适用场景

对于需要在移动办公或多设备切换环境下持续进行 AI 辅助开发的程序员而言,Claude Code Bridge 提供了完美的解决方案。想象一下,当你在咖啡厅用手机收到同事关于代码优化的讨论请求时,可以直接在 Telegram 中输入 ‘/refactor’ 指令,系统会自动唤醒后台的 Claude Code 实例进行处理,并将详细的重构建议以 Markdown 格式返回给你——整个过程无需切换设备或中断工作流,就像直接在本地终端操作一样自然流畅。这种无缝衔接的体验特别适合敏捷开发团队中的远程协作场景。 更复杂的适用场景体现在大型项目的维护工作中。例如当面对一个包含数百个文件的企业级应用时,开发者可能需要执行全局搜索替换、批量注释生成或架构分析等高阶操作。此时通过在微信群聊中发送 ‘帮我梳理整个项目的依赖关系’ 这类自然语言描述,Claude Code Bridge 不仅能理解任务意图,还会自动启用长任务模式(5分钟超时),期间定期通过 peek 命令获取处理进度,最终输出结构清晰的依赖图谱和优化建议。对于涉及敏感操作的场景(如生产环境部署),系统会在首次执行危险命令前弹出交互式确认界面,确保每一步变更都经过人工审核,有效防范误操作风险。