Claude Code Remote：在手机上通过 VPN 使用 Claude Code

本文介绍 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] ←→ [Mac 电脑]
                                          ↓
                                    [ttyd Web 终端]
                                          ↓
                                    [Claude Code CLI]

所有组件都通过 Tailscale 的私有网络连接，确保安全性。

使用场景

场景 1：通勤路上编程

在地铁或公交车上通过手机访问 Claude Code，继续你的开发工作。

场景 2：外出应急

不在电脑旁但需要紧急修复 bug？用手机连接 Claude Code 快速处理。

场景 3：语音输入代码

利用 iOS 的语音输入功能，通过语音与 Claude Code 交互，提高移动场景下的输入效率。

安装指南

前置要求

• macOS 电脑（运行 Claude Code）
• Tailscale 账号
• 手机或其他设备（iOS/Android）

安装步骤

1. 克隆仓库

git clone https://github.com/buckle42/claude-code-remote.git
cd claude-code-remote

2. 配置环境

cp .env.example .env
# 编辑 .env 文件，配置你的设置

3. 运行安装脚本

项目包含 CLAUDE.md 文件，可以使用 Claude Code 协助完成设置。

4. 启动服务

./scripts/start.sh

5. 手机连接

• 确保手机和 Mac 都连接到同一个 Tailscale 网络
• 在手机浏览器中访问 Mac 的 Tailscale IP 地址
• 开始使用 Claude Code

使用方法

基本操作

1. New - 创建新的 Claude Code 会话
2. Copy - 复制终端内容
3. 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 的开发者来说，这是一个非常实用的工具。