字
字节笔记本
2026年2月20日
Claude Code Remote：在手机上通过 VPN 使用 Claude Code
API中转
¥120
本文介绍 Claude Code Remote，一个让你在手机上或任何地方通过安全 VPN 连接使用 Claude Code 的开源工具。
项目简介
Claude Code Remote 是一套脚本工具，让你能够通过手机浏览器获得完整的 Claude Code CLI 交互体验。无论你身在何处，只要你的 Mac 处于唤醒状态，就能安全地访问 Claude Code。
该项目在 GitHub 上已获得 117+ stars，由 buckle42 开发。
核心特性
- 手机端访问 - 在手机浏览器中使用完整的 Claude Code CLI
- 安全连接 - 使用 Tailscale 创建设备间的加密隧道
- Web 终端 - 通过 ttyd 将终端作为网页服务
- 会话保持 - 使用 tmux 保持会话在断开后依然存活
- 语音支持 - FastAPI 语音包装器提供移动端友好的 UI，支持 iOS 语音输入
- 私有网络 - 所有服务仅绑定到 Tailscale IP，不暴露到公共互联网
- 随处可用 - 不限于家庭 WiFi，只要有网络就能使用
技术栈
| 技术 | 用途 |
|---|---|
| Tailscale | 创建安全的加密 VPN 隧道 |
| ttyd | 将终端作为网页服务 |
| tmux | 保持会话跨断开存活 |
| FastAPI | 提供语音包装器和移动端 UI |
| Claude Code | Anthropic 的 AI 编程助手 |
系统架构
text
[手机/任何设备] ←→ [Tailscale VPN] ←→ [Mac 电脑]
↓
[ttyd Web 终端]
↓
[Claude Code CLI]所有组件都通过 Tailscale 的私有网络连接，确保安全性。
使用场景
场景 1：通勤路上编程
在地铁或公交车上通过手机访问 Claude Code，继续你的开发工作。
场景 2：外出应急
不在电脑旁但需要紧急修复 bug？用手机连接 Claude Code 快速处理。
场景 3：语音输入代码
利用 iOS 的语音输入功能，通过语音与 Claude Code 交互，提高移动场景下的输入效率。
安装指南
前置要求
- macOS 电脑（运行 Claude Code）
- Tailscale 账号
- 手机或其他设备（iOS/Android）
安装步骤
- 克隆仓库
bash
git clone https://github.com/buckle42/claude-code-remote.git
cd claude-code-remote- 配置环境
bash
cp .env.example .env
# 编辑 .env 文件，配置你的设置- 运行安装脚本
项目包含 CLAUDE.md 文件，可以使用 Claude Code 协助完成设置。
- 启动服务
bash
./scripts/start.sh- 手机连接
- 确保手机和 Mac 都连接到同一个 Tailscale 网络
- 在手机浏览器中访问 Mac 的 Tailscale IP 地址
- 开始使用 Claude Code
使用方法
基本操作
- New - 创建新的 Claude Code 会话
- Copy - 复制终端内容
- Resume - 恢复之前的 tmux 会话
语音输入
点击语音按钮，使用 iOS 语音输入功能向 Claude Code 发送指令。
快捷操作按钮
移动端 UI 提供快速操作按钮，方便在手机上进行常见操作。
安全说明
- 所有服务仅绑定到 Tailscale IP（100.x.x.x）
- 没有端口暴露到公共互联网
- 需要 Tailscale 认证才能访问
- 建议配合 Tailscale 的 ACL 规则进一步限制访问
成本
- Tailscale - 个人使用免费（最多 20 台设备）
- Claude Code - 需要 Anthropic API 密钥
- 其他组件 - 全部开源免费
注意事项
- Mac 必须保持唤醒状态才能访问
- 需要稳定的网络连接
- 首次设置需要一些技术知识
- 建议使用 Tailscale 的 MagicDNS 简化连接
项目链接
- GitHub 仓库：github.com/buckle42/claude-code-remote
- Tailscale：tailscale.com
- ttyd：github.com/tsl0922/ttyd
总结
Claude Code Remote 是一个创新的解决方案，让开发者能够突破设备限制，随时随地使用 Claude Code。通过组合 Tailscale、ttyd、tmux 和 FastAPI，它提供了一个安全、便捷的移动端 Claude Code 体验。对于需要经常在外出时使用 Claude Code 的开发者来说，这是一个非常实用的工具。
分享: