远程访问

从 iPad 或手机控制 Claude Code

LingCode iPad 内置远程控制(主机列表、点击即连)。也可以用 Termius 通过 SSH 登录你的 Mac,再用 tmux 附加会话。离开桌面时也能做出快速改动。

概览

LingCode 会在有 tmux 的情况下把 Claude Code 放进 tmux。这样你就能从 iPad 或手机 SSH 登录你的 Mac,附加到同一个会话——看同一个终端、输入提示词、远程控制 Claude Code。

iPad 用户:LingCode 内置 Termius 风格的主机列表。添加你的 Mac、保存、点击即连。不需要额外的 SSH 应用。

前置条件

Tailscale 让你的 Mac 从手机上通过互联网可达。同一 Wi-Fi 下可以跳过 Tailscale,改用 Mac 的本地 IP。SSH 客户端:用 LingCode iPad 内置的远程控制,或 Termius / Blink / JuiceSSH。

步骤 1:在 Mac 上安装 Tailscale

下载并登录

tailscale.com/download/mac 下载 Mac 应用。打开并登录。验证:

tailscale status

你应看到你的 Mac。获取它的 IP:

tailscale ip -4

例如:100.116.50.10

步骤 2:在手机上安装 Tailscale

同一账号

从 App Store(iOS)或 Play Store(Android)安装 Tailscale。用与 Mac 相同的账号登录。手机和 Mac 就处于同一个虚拟网络里。

步骤 3:在 Mac 上开启远程登录(SSH)

系统设置

打开 系统设置 → 通用 → 共享。打开 远程登录。确保你的用户(或"所有用户")在允许列表中。

步骤 4:从手机连接

LingCode iPad(内置)

如果你用 iPad,LingCode 应用 内置 Termius 风格的远程控制主机列表,不需要单独的 SSH 客户端。

  • 在 iPad 上打开 LingCode,点击菜单,选 远程控制
  • 点击 添加主机,填入:主机(Tailscale IP)、端口(22)、用户名、密码
  • 点击主机连接。左滑可编辑或删除已保存主机。

或者用 Termius / Blink / JuiceSSH

安装 Termius(iOS/Android)或其他 SSH 客户端。添加新主机:

  • 主机:Mac 的 Tailscale IP(如 100.116.50.10
  • 用户名:Mac 用户名(如 weijiahuang
  • 端口:22

免密登录可用 SSH Key(见 支持)。

步骤 5:安装 tmux 并打开 Claude Code

在 Mac 上

brew install tmux

打开 LingCode,再打开一个 Claude Code 标签(或新建一个)。标签头会显示:

Remote: tmux attach -t lingcode-12345678

记下会话名(如 lingcode-12345678)。如果显示"Remote: brew install tmux",说明 tmux 还没装。

步骤 6:SSH 并附加会话

LingCode iPad

点击保存的主机连接。你会拿到一个 shell。附加到 Claude Code:输入 tmux attach -t lingcode-12345678(用 Mac 上 Claude Code 标签里的会话名)。用 分离 按钮或 Ctrl+bd 分离。

Termius / 其他 SSH 客户端

连接到 Mac。提示主机密钥时点 继续。输入 Mac 密码(或用 SSH Key)。连上后运行(把会话名换成 LingCode 显示的那个):

tmux attach -t lingcode-12345678

你会看到同一个 Claude Code 会话。输入提示词、运行命令。Ctrl+bd 分离,让它继续在 Mac 上跑。

故障排查

Tailscale:"failed to connect to local Tailscale service"

Tailscale 没在跑。用 tailscale.com/download/mac 的官方 Mac 应用,不要用 Homebrew。打开应用并登录。

SSH:"Authentication failed (password)"

用 Mac 登录密码(不是 Apple ID)。或配置 SSH Key:运行 ssh-keygen -t ed25519 -f ~/.ssh/phone_key -N "",把公钥加到 ~/.ssh/authorized_keys,然后把私钥加到 Termius。

远程登录:"requires Full Disk Access"

用 系统设置 → 通用 → 共享 → 远程登录,不要用命令行。

附加时提示 "no such session"

确认 LingCode 里开着一个 Claude Code 标签且 tmux 已安装。装完 tmux 后关闭并重新打开 Claude Code 标签。