开始之前
你需要准备什么
| 必需? | 说明 | |
|---|---|---|
| 一台装好并登录了 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 凭证全部留在你自己的电脑上。
- 浏览器无状态。 关掉标签页、断网、换设备——任务在你电脑上照常运行,回来打开页面一切自动恢复。
安装顺序
每一步只要几分钟。