Bridge

Bridge 模块是 Claude Code 的远程协作基础设施，包含 30+ 个文件，实现了完整的远程会话管理能力。核心功能包括：远程会话创建与生命周期管理（createSession、sessionRunner）、基于 JWT 的设备信任认证（jwtUtils、trustedDevice）、长轮询消息传输（replBridgeTransport、pollConfig）、入站消息与附件处理（inboundMessages、inboundAttachments）、容量唤醒与多会话并发（capacityWake）、以及无头模式运行（bridgeMain 中的 runBridgeHeadless）。它是 Claude Code 从单机工具进化为分布式协作平台的关键模块。

架构决策

使用场景

关键代码片段

async function runBridgeLoop(
  config: BridgeConfig, logger: BridgeLogger
): Promise<void> {
  while (!signal.aborted) {
    const work = await pollForWork(config)
    if (work.type === 'session') {
      await handleSession(work, config)
    } else if (work.type === 'capacity_wake') {
      await spawnNewSession(work)
    }
    await backoff.wait()
  }
}

// 设备首次连接时签发信任令牌
function issueDeviceTrust(deviceId: string): JWT {
  return sign({
    sub: deviceId,
    iss: 'claude-code-bridge',
    exp: Date.now() + 30 * 24 * 60 * 60 * 1000, // 30 天
    permissions: ['session:create', 'session:join'],
  }, BRIDGE_SECRET)
}

// 后续连接验证令牌
function verifyDeviceTrust(token: string): DeviceInfo | null {
  try {
    return verify(token, BRIDGE_SECRET) as DeviceInfo
  } catch { return null }
}