Claude Code 源码文档 - Bridge 远程通信
版本: 2.1.88 | 文件数: 31 | 源码路径:
src/bridge/
1. 概述
Bridge 模块实现 Claude Code 的远程控制能力,允许从外部(IDE 插件、移动端等)连接和控制 Claude Code 会话。
2. 文件清单
| 文件 | 职责 |
|---|---|
bridge.ts | Bridge 主入口 |
bridgeMain.ts | Bridge 主逻辑 |
bridgeApi.ts | Bridge API 接口 |
bridgeConfig.ts | Bridge 配置 |
bridgeDebug.ts | Bridge 调试工具 |
bridgeEnabled.ts | Bridge 启用状态检查 |
bridgeMessaging.ts | 消息传递 |
bridgePermissionCallbacks.ts | 权限回调处理 |
bridgePointer.ts | Bridge 指针/引用 |
bridgeStatusUtil.ts | 状态工具函数 |
bridgeUI.ts | Bridge UI 渲染 |
capacityWake.ts | 容量唤醒 |
codeSessionApi.ts | 代码会话 API |
createSession.ts | 创建 Bridge 会话 |
debugUtils.ts | 调试工具函数 |
envLessBridgeConfig.ts | 无环境配置 |
flushGate.ts | 刷新门控 |
inboundAttachments.ts | 入站附件处理 |
inboundMessages.ts | 入站消息处理 |
initReplBridge.ts | REPL Bridge 初始化 |
jwtUtils.ts | JWT 工具 |
pollConfig.ts / pollConfigDefaults.ts | 轮询配置 |
remoteBridgeCore.ts | 远程 Bridge 核心 |
replBridge.ts | REPL Bridge |
replBridgeHandle.ts | REPL Bridge 句柄 |
replBridgeTransport.ts | REPL 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)