远程执行 · IDE Bridge
Remote Session 远程会话、Teleport 环境传送、VS Code/JetBrains 双向通信协议。
4. Remote 远程执行
Remote 系统让 Claude Code 能够在远程环境中执行操作，而不仅限于本地终端。这对于在服务器上运行构建、在云端开发环境中工作或者在沙箱中执行危险操作等场景至关重要。Remote 包含多种模式，各有其适用场景。
Remote Session（SSH 隧道）
最基础的远程模式。Claude Code 通过 SSH 隧道连接到远程机器，并在远程环境中执行命令。远程环境拥有自己的文件系统和进程空间，Claude Code 的工具调用（如 Bash、Read、Write）会被转发到远程机器执行。SSH 连接的建立、保活和重连都由系统自动管理，用户只需要提供远程主机信息。
Teleport（远程环境传送）
Teleport 是一种更高级的远程模式。它不仅仅是连接到远程机器，而是将本地的开发上下文"传送"到远程环境。这包括当前的工作目录状态、环境变量和会话信息。Teleport 的目标是让远程执行感觉像本地执行一样无缝。传送完成后，远程环境的状态会与本地保持同步，直到会话结束。
WebSocket 轮询
对于需要持续通信的远程会话，系统使用 WebSocket 连接维持实时双向通信。当 WebSocket 不可用时（如防火墙限制），会降级到 HTTP 长轮询模式。这种弹性设计确保了在各种网络条件下远程功能都能正常工作。WebSocket 的心跳机制会检测连接断开并自动重连，保证长时间运行的远程任务不会因为网络抖动而丢失。
Remote Control / Bridge 模式的关系
| 模式 | 通信方式 | 场景 | 特点 |
|---|---|---|---|
| Remote Session | SSH 隧道 | 远程服务器开发 | 标准远程执行 |
| Teleport | 环境快照传送 | 云端沙箱 | 无缝上下文切换 |
| Remote Control | WebSocket/HTTP | 远程协助 | 外部控制本地实例 |
| Bridge | JWT + IPC | IDE 集成 | 双向消息协议 |
remote-safe 命令过滤：在远程模式下，某些命令会被标记为不安全或不适用。系统维护一个 remote-safe 过滤列表，只允许经过审核的命令在远程环境中执行，防止意外操作影响远程生产环境。
5. Bridge IDE 集成
Bridge 是 Claude Code 与 IDE（VS Code、JetBrains 等）之间的通信桥梁。它允许 IDE 扩展与 Claude Code 的核心进程进行双向通信，实现诸如在编辑器内显示 AI 建议、从 IDE 上下文发起操作等功能。
Bridge 的安全性通过 JWT（JSON Web Token）身份验证保障。每次 IDE 扩展连接到 Claude Code 时，都需要提供有效的 JWT token 进行身份验证。这防止了未授权的进程连接到 Claude Code 并执行操作。
Session 隔离是 Bridge 的另一个重要特性。每个 IDE 窗口对应一个独立的 Bridge Session，它们之间的上下文和权限完全隔离。这意味着你在一个项目中授予的文件访问权限不会泄露到另一个项目。
Bridge 还集成了 MCP Connection Manager，管理通过 Bridge 暴露给 IDE 的 MCP 服务。IDE 扩展可以通过 Bridge 访问 Claude Code 注册的所有 MCP 工具，就像它们是 IDE 原生功能一样。
权限回调机制
当 Claude Code 需要执行一个需要用户确认的操作时（如写入文件），权限请求会通过 Bridge 回调到 IDE。IDE 扩展可以在编辑器界面内弹出确认对话框，用户无需切换到终端即可授权操作。这种回调机制保持了 Claude Code 的权限模型完整性，同时优化了 IDE 内的使用体验。
5. Bridge IDE 集成
Bridge 是 Claude Code 与 IDE（VS Code、JetBrains 等）之间的通信桥梁。它允许 IDE 扩展与 Claude Code 的核心进程进行双向通信，实现诸如在编辑器内显示 AI 建议、从 IDE 上下文发起操作等功能。
Bridge 的安全性通过 JWT（JSON Web Token）身份验证保障。每次 IDE 扩展连接到 Claude Code 时，都需要提供有效的 JWT token 进行身份验证。这防止了未授权的进程连接到 Claude Code 并执行操作。
Session 隔离是 Bridge 的另一个重要特性。每个 IDE 窗口对应一个独立的 Bridge Session，它们之间的上下文和权限完全隔离。这意味着你在一个项目中授予的文件访问权限不会泄露到另一个项目。
Bridge 还集成了 MCP Connection Manager，管理通过 Bridge 暴露给 IDE 的 MCP 服务。IDE 扩展可以通过 Bridge 访问 Claude Code 注册的所有 MCP 工具，就像它们是 IDE 原生功能一样。
权限回调机制
当 Claude Code 需要执行一个需要用户确认的操作时（如写入文件），权限请求会通过 Bridge 回调到 IDE。IDE 扩展可以在编辑器界面内弹出确认对话框，用户无需切换到终端即可授权操作。这种回调机制保持了 Claude Code 的权限模型完整性，同时优化了 IDE 内的使用体验。