实战

用手机远程运行 Claude Code:SSH + Tailscale + Tmux 完整工作流

Harper Reed 的手机远程使用 Claude Code 完整方案:Tailscale 打通网络无需配防火墙、Mosh 保持连接断网自动重连、Tmux 管理多个 Claude Code 实例,含 Mac Keychain 解锁、Claude Code 别名和快速 Tmux 脚本。

2026/3/13分钟 阅读ClaudeEagle

开发者 Harper Reed 的手机 Claude Code 方案——不依赖第三方 AI IDE,纯粹的 SSH + Tailscale + Tmux,从手机连到工作站,在任何地方继续编程。

四个核心问题的答案

问题答案
网络Tailscale
终端客户端(iOS)Blink
工作站Mac 或 Linux,保持开机
工具Tmux + Mosh + Claude Code

第一步:让工作站可以 SSH

Linux

bash
sudo apt install openssh-server
ssh localhost  # 测试

Mac:系统设置 -> 通用 -> 共享 -> 开启「远程登录」,先用本地 IP 测试连接成功。

第二步:Tailscale 打通网络

Tailscale 创建只有你自己能访问的私有网络,无需配置防火墙:

bash
# 工作站和手机都安装 Tailscale,登录同一账号
# 即可用 Tailscale IP 直接 SSH
ssh <tailscale-ip>

效果:手机在东京,工作站在上海,直接连接,低延迟,稳定可靠。

第三步:选 iOS 终端客户端

Blink(推荐):打开即是 Shell,支持 Mosh,支持 SSH 配置管理。

其他选项:Termius(界面友好)、Prompt(Panic 出品,稳定)。

第四步:Mosh 解决断线问题

bash
# 工作站安装 mosh
brew install mosh  # Mac
apt install mosh   # Linux

# 之后用 mosh 代替 ssh
mosh <tailscale-ip>

实际效果:

  • 进地铁隧道断网 -> 出来后自动重连,Claude Code 继续跑
  • 手机息屏再打开 -> 会话完好
  • WiFi 切换到 5G -> 无感知切换

第五步:Tmux 管理多个 Claude Code 实例

bash
brew install tmux  # Mac
apt install tmux   # Linux

tmux new -s project1     # 新建会话
tmux attach -t project1  # 重新连接
# Ctrl+b c  新建窗口
# Ctrl+b n  切换窗口

Harper 同时运行 7 个 Claude Code 实例,在窗口间切换,随时可以放下手机再回来继续。

实用脚本

Claude Code 别名

bash
alias cc-start="claude --dangerously-skip-permissions"
alias cc-continue="claude --dangerously-skip-permissions --continue"

Mac Keychain 解锁

Claude Code 在 Mac 上将 API Key 存在 Keychain 中,SSH 进来后需要先解锁:

bash
#!/bin/bash
if timeout 1 security show-keychain-info &>/dev/null; then
  echo "Keychain already unlocked"
else
  security unlock-keychain
fi

快速 Tmux 脚本(tm)

bash
#!/bin/bash
# 自动创建或连接以主机名命名的 Tmux 会话
SESSION=$(hostname)
tmux has-session -t $SESSION 2>/dev/null && \
  tmux attach -t $SESSION || \
  tmux new-session -s $SESSION

输入 tm 即可,在哪台电脑上就连接哪台的 Tmux 会话。

完整工作流

  1. 手机打开 Blink
  2. mosh <工作站 Tailscale IP>
  3. tm 进入 Tmux 会话
  4. ./unlock.sh 解锁 Keychain
  5. cc-start 启动 Claude Code
  6. 开始工作,放下手机
  7. 下午拿起手机,mosh 自动重连,Claude Code 还在跑

原文:Remote Claude Code: programming like it was the early 2000s | 来源:harper.blog

相关文章推荐

实战用手机远程操控 Claude Code:SSH + Tailscale + tmux 的终极移动工作流前奥巴马竞选 CTO Harper Reed 分享用 iPhone 远程控制 Claude Code 的完整方案:Tailscale 创建私有网络、Blink 作为终端客户端、Mosh 保证断网续连、tmux 管理多个 Claude 实例。附完整 shell 脚本,真正实现随时随地编程。2026/2/28实战Claude Code 跨会话协作实战:用 SendMessage 和 ListAgents 串联你的多台设备解析 Claude Code v2.1.224 新增的跨会话消息能力,探讨 SendMessage/ListAgents 的实战用法、crossSessionInbound 安全边界与多设备协作的应用潜力。2026/8/7实战Claude Code 长会话优化实战:让 CLAUDE.md 规则在 Compaction 后依然存活实战教学:基于官方 Compaction 存活规则表,指导你如何重新组织 CLAUDE.md 规则、调整 SKILL.md 写作顺序、合理使用 /compact focus 和 /clear,确保关键约定在长会话压缩后仍然存活,附完整检查清单。2026/7/12实战Claude Code Agent Teams 实战:三视角协作设计一个 CLI 工具基于官方文档实例,实战演示如何启用 Claude Code Agent Teams 并用三个视角(UX、技术架构、唱反调)协作探索一个 CLI 工具的设计方案,详解空闲行显示逻辑、折叠交互、In-process 与 Split panes 两种显示模式的适用场景。2026/7/12实战Claude Code 实战:Desktop 内置浏览器 + Auto Mode 组合,从查文档到自动提交 PR通过一个真实集成第三方 API 的完整场景,演示 Claude Code Desktop 内置浏览器与 Auto Mode 组合使用如何实现从查阅官方文档、编写集成代码、本地预览验证到提交推送创建 PR 的端到端自动化,并梳理背后的多层安全边界设计。2026/7/11实战Claude Code 生产力工具箱:MCP + GitHub Actions + Prompt Caching 三件套实战组合实战讲解如何组合 MCP 数据连接、GitHub Actions 自动化和 Prompt Caching 优化,搭建从 Issue 到 PR 的完整自动化工作流,并给出权限最小化配置和团队级实战检查清单。2026/7/6