Claude Code 是目前最强大的 AI 编程助手之一，但从本地控制台窗口使用它存在明显局限：您只能在安装它的机器上使用，无法从手机访问，也没有简便的方式与同事共享会话。
sgcClaudeCodeRemote 解决了所有这些问题。它是一款轻量级 Windows 服务器，将 Claude Code 封装在基于 Web 的终端中，让您可以从任意浏览器连接——无论是台式机、笔记本、平板电脑还是手机。其底层使用 Windows ConPTY 伪控制台 API 提供真实的终端会话，并通过 sgcWebSockets 实时将终端 I/O 流式传输到浏览器。
本文介绍 sgcClaudeCodeRemote 的功能、配置选项，以及相较于直接从控制台运行 Claude Code 的优势。
为何远程使用 Claude Code？
sgcClaudeCodeRemote 解决了开发者在控制台使用 Claude Code 时最常遇到的痛点。
|
从任意设备访问 在手机、平板或笔记本上打开浏览器，连接运行在开发机上的 Claude Code。无需安装 Node.js 或 CLI——只需一个 URL。 |
协作会话 多位开发者可加入同一个命名会话，实时查看 Claude 的输出。内置结对编程功能——无需屏幕共享工具。 |
默认安全 密码认证配备暴力破解防护、可配置超时、IP 封锁，以及面向互联网部署时可选的 TLS 1.3 加密。 |
移动端友好的终端
Web 界面专为移动设备设计。屏幕底部的触控优化按键工具栏提供 Claude Code 所需但移动端键盘缺少的特殊按键：
| 按钮 | 功能 |
|---|---|
| Esc | 取消当前操作或返回 |
| Tab | 接受建议并自动补全 |
| Intro | 确认输入（回车键） |
| Ctrl | 粘滞修饰键——点击一次后再点击字母键即可组合，如 Ctrl+C（中断） |
| ↑ ↓ ← → | 导航命令历史和菜单 |
工具栏使用 pointerdown 事件确保触摸屏即时响应，并防止焦点被抢占以保持终端活跃。视口通过动态视口单位（dvh）适配移动端浏览器界面，确保工具栏始终可见无需滚动。
命名会话
每个连接可以指定一个会话名称（如 "backend-refactor"、"devops"、"testing"）。会话在服务器运行期间持续存在，您可以断开后重新连接到同一个 Claude Code 实例。
- 多客户端会话。多个浏览器可同时加入同一会话——所有人看到相同的终端输出，并可在同一控制台输入。
- 会话历史。浏览器在 localStorage 中记录最近 10 个会话，提供下拉菜单快速重连。
- 会话指示器。认证后，活跃会话名称显示在标题栏中。
认证与安全
sgcClaudeCodeRemote 开箱即提供多层保护：
|
密码认证 单一共享密码保护访问。无需用户名，只需密码。登录表单禁用浏览器凭证自动填充以防止意外存储。 |
暴力破解防护 同一 IP 连续 5 次失败后将被封锁 5 分钟。被封锁的 IP 在连接层即被拒绝，不做进一步处理。 |
|
认证超时 客户端必须在可配置的时间窗口内（默认 15 秒）完成认证。未发送凭证的空闲连接将被自动断开。 |
TLS 1.3 加密 面向互联网部署时，使用证书和密钥文件启用 TLS。浏览器与服务器之间的所有流量均进行端到端加密。 |
跳过权限提示。登录界面的复选框（默认勾选）将以 --dangerously-skip-permissions 标志启动 Claude Code。这对于无法在服务器控制台与权限对话框交互的远程会话至关重要。
sgcClaudeCodeRemote 与控制台 Claude Code 对比
本地运行 Claude Code 与通过 sgcClaudeCodeRemote 运行的横向对比。
| 功能 | 控制台 | sgcClaudeCodeRemote |
|---|---|---|
| 从任意设备访问 | 否 | 是 |
| 移动端 / 平板支持 | 否 | 是（触控工具栏） |
| 多用户共享同一会话 | 否 | 是 |
| 命名持久会话 | 否 | 是 |
| 密码保护 | 否 | 是（暴力破解封锁） |
| TLS 加密 | 不适用 | TLS 1.3 |
| 所需客户端软件 | Node.js + CLI | 仅需浏览器 |
| 结对编程 | 需外部工具 | 内置 |
| 实时延迟显示 | 否 | 是 |
| 客户端平台 | 仅限本机 | Windows、macOS、Linux、Android、iOS |
快速入门
下载 sgcClaudeCodeRemote 并从命令行以密码运行：
sgcClaudeCodeRemote.exe --password MySecretPassword然后打开浏览器，访问 http://your-server-ip:8765/，输入密码，选择会话名称，即可连接。
示例
自定义端口并提高连接上限：
sgcClaudeCodeRemote.exe --port 9000 --password MyPass --max-conn 20启用 TLS 加密以通过互联网安全访问：
sgcClaudeCodeRemote.exe --tls --tls-cert cert.pem --tls-key key.pem --password MyPass命令行选项
| 选项 | 说明 | 默认值 |
|---|---|---|
--port |
服务器监听端口 | 8765 |
--password |
访问密码（启用认证时必填） | — |
--command |
在终端中运行的命令 | claude |
--cols / --rows |
初始终端尺寸 | 120 × 40 |
--max-conn |
最大并发连接数 | 10 |
--timeout |
认证超时（秒） | 15 |
--no-auth |
完全禁用认证 | — |
--tls |
启用 TLS 1.3 加密 | — |
--tls-cert / --tls-key |
证书和私钥 PEM 文件 | — |
--tls-password |
私钥密码（若已加密） | — |
--tls-port |
TLS 监听端口 | 与 --port 相同 |
使用场景
- 在手机上工作。随时随地审查代码、向 Claude 提问或执行命令——无论在沙发上、火车上还是咖啡馆。
- 团队协作。多位开发者连接到同一会话，实时与 Claude 互动。无需屏幕共享。
- 无头构建服务器。在强大的远程机器上运行 Claude Code，从瘦客户端或无终端环境访问。
- 演示与演讲。与听众共享会话 URL，所有人看到同一个实时终端并同步跟进。
- 安全远程访问。启用 TLS，设置强密码，从任意位置通过互联网安全使用 Claude Code。
工作原理
sgcClaudeCodeRemote 是基于三项核心技术构建的 Delphi 控制台应用程序：
|
Windows ConPTY Windows 10 伪控制台 API 创建支持完整 VT100/ANSI 序列的真实终端会话。Claude Code 在此控制台中运行，与在普通终端窗口中完全一致。 |
sgcWebSockets sgcWebSockets 库处理所有 WebSocket 通信、HTTP 服务和可选的 TLS 加密。二进制帧传输终端输出，JSON 文本帧处理认证和控制消息。 |
xterm.js 浏览器使用 xterm.js 渲染终端，配合 fit 插件（自动适应窗口大小）和 web-links 插件（可点击 URL）。深色主题与 Claude Code 的视觉风格一致。 |
系统要求：服务器需要 Windows 10 1809 或更高版本（支持 ConPTY），以及在主机上安装 Claude Code。客户端只需现代 Web 浏览器。
Web 界面功能
单页 Web 界面直接嵌入可执行文件——无需部署外部文件。功能包括：
- 状态指示器。带脉冲动画的彩色徽章（绿色 = 已连接，红色 = 已断开，蓝色 = 需要登录，琥珀色 = 连接中）。
- 实时延迟。显示毫秒级往返延迟，每帧更新。
- 终端尺寸。显示当前列数 × 行数，窗口大小变化时动态更新。
- 适配按钮。立即调整终端大小以填满浏览器窗口。
- 复制和粘贴。完整的剪贴板支持——Ctrl+C 复制选中文本，Ctrl+V 粘贴到终端。
- 自动重连。连接断开后，客户端 3 秒后自动尝试重连。
- 10,000 行回滚。向上滚动查看之前的 Claude Code 输出，不丢失任何历史记录。
sgcClaudeCodeRemote 基于 sgcWebSockets 构建——适用于 Delphi 和 .NET 的高性能 WebSocket 组件。