Skip to content

Claude Code 源码文档 - Bridge 远程通信

版本: 2.1.88 | 文件数: 31 | 源码路径: src/bridge/

1. 概述

Bridge 模块实现 Claude Code 的远程控制能力,允许从外部(IDE 插件、移动端等)连接和控制 Claude Code 会话。

2. 文件清单

文件职责
bridge.tsBridge 主入口
bridgeMain.tsBridge 主逻辑
bridgeApi.tsBridge API 接口
bridgeConfig.tsBridge 配置
bridgeDebug.tsBridge 调试工具
bridgeEnabled.tsBridge 启用状态检查
bridgeMessaging.ts消息传递
bridgePermissionCallbacks.ts权限回调处理
bridgePointer.tsBridge 指针/引用
bridgeStatusUtil.ts状态工具函数
bridgeUI.tsBridge UI 渲染
capacityWake.ts容量唤醒
codeSessionApi.ts代码会话 API
createSession.ts创建 Bridge 会话
debugUtils.ts调试工具函数
envLessBridgeConfig.ts无环境配置
flushGate.ts刷新门控
inboundAttachments.ts入站附件处理
inboundMessages.ts入站消息处理
initReplBridge.tsREPL Bridge 初始化
jwtUtils.tsJWT 工具
pollConfig.ts / pollConfigDefaults.ts轮询配置
remoteBridgeCore.ts远程 Bridge 核心
replBridge.tsREPL Bridge
replBridgeHandle.tsREPL Bridge 句柄
replBridgeTransport.tsREPL Bridge 传输
sessionIdCompat.ts会话ID兼容
sessionRunner.ts会话运行器
trustedDevice.ts信任设备管理
types.ts类型定义
workSecret.ts工作密钥

3. Bridge 架构

外部客户端 (IDE/Mobile/Web)
   ↓ WebSocket / HTTP
Bridge Transport

BridgeMessaging (消息路由)

SessionRunner (会话管理)

QueryEngine (查询执行)

4. 通信方式

  • REPL Bridge - 本地 REPL 模式的 Bridge
  • Remote Bridge - 远程 WebSocket 连接
  • HTTP Poll - 轮询模式(兼容性更好)

5. 安全机制

  • JWT 认证 (jwtUtils.ts)
  • 信任设备管理 (trustedDevice.ts)
  • 工作密钥 (workSecret.ts)
  • 权限回调 (bridgePermissionCallbacks.ts)

MIT