Skip to content

开始之前

你需要准备什么

必需?说明
一台装好并登录了 Claude Code 的电脑必需macOS、Linux 或 Windows。Agent 跑在这里,你的项目也在这里。
手机 / 平板 / 任意浏览器必需你用它来操作。什么都不用装,就是一个网页。
一台有公网 IP 的小型 Linux VPS仅自建服务器时最便宜的实例就够。也可以直接用托管的 16code 服务器,完全跳过 VPS。
一个域名自建时推荐自动 HTTPS 需要它。用 IP 也能跑,但没有 HTTPS。

三个组成部分

┌───────── 你的 VPS ─────────┐        ┌───── 你的电脑 ──────────┐
│  code-server               │  WSS   │  code-agent             │
│  (Web 界面 + 中继 + 存储)   │◄───────│  (运行 Claude Code)      │
└────────────▲───────────────┘ 拨出    └─────────────────────────┘
             │ HTTPS
        你的浏览器
   (手机 / 平板 / 电脑)
  • Agent 主动拨出。 你的电脑不开任何入站端口、不需要公网 IP——家里 NAT 后面、公司防火墙里都能用。
  • 服务器只是中继。 Claude Code 本体、你的代码和 API 凭证全部留在你自己的电脑上。
  • 浏览器无状态。 关掉标签页、断网、换设备——任务在你电脑上照常运行,回来打开页面一切自动恢复。

安装顺序

  1. 安装服务端——在 VPS 上一条命令(用托管服务器可跳过)
  2. 安装 Agent——在你的电脑上一条命令
  3. 登录并绑定机器——设个密码,打开 Web 界面

每一步只要几分钟。