手机远程控制Mac上的Claude Code开发：完整实战指南-港品优选

手机远程控制Mac上的Claude Code开发：完整实战指南

你有没有想过，在地铁上、咖啡馆里，甚至躺在床上，都能用手机写代码？

不是那种"远程桌面"的卡顿体验，而是原生的终端操作，流畅、稳定、随时随地。

这篇文章教你用手机SSH连接Mac，在tmux会话里跑Claude Code CLI，实现真正的移动开发。

一、方案架构：为什么是这套组合

核心三件套

组件	作用	为什么选它
Tailscale	内网穿透	无需公网IP，点对点直连，延迟低
SSH + tmux	远程终端 + 会话保持	断网不丢进度，多窗口并行
Claude Code CLI	AI编程助手	原生终端体验，直接改代码

方案优势

无需公网IP：Tailscale构建虚拟局域网，Mac在内网也能连
断线不丢会话：tmux保护你的Claude Code会话，网络波动不受影响
手机原生体验：Termius提供真正的终端，不是远程桌面的镜像
安全可控：Tailscale的ACL权限控制，SSH密钥认证

二、第一步：Tailscale组网（安全配置）

2.1 安装Tailscale

Mac端

# 方式一：Homebrew安装brewinstalltailscale# 方式二：官网下载pkg安装包# https://tailscale.com/download

手机端

iOS：App Store搜索"Tailscale"
Android：Google Play或官网下载APK

2.2 注册与登录

打开Tailscale，选择登录方式（Google/GitHub/Microsoft/邮箱）
同一账号在Mac和手机上都登录
设备会自动出现在同一网络中

2.3 安全配置（关键步骤）

Tailscale默认配置已经比较安全，但建议进一步加固：

关闭高风险功能

在Mac的Tailscale设置中：

关闭"Use exit node"：不要让其他设备通过你的Mac上网
关闭"Route local network"：不要暴露本地网络
如果不使用子网路由，确保Subnet router未启用

开启MFA两步验证

登录Tailscale管理后台：https://login.tailscale.com
进入Settings → Security
启用"Two-factor authentication"

配置最小权限ACL

在管理后台的ACL编辑器中：

{"acls":[{"action":"accept","src":["tag:mobile"],"dst":["tag:mac:22"]}],"tagOwners":{"tag:mobile":["autogroup:member"],"tag:mac":["你的邮箱"]}}

这段配置的含义：

只允许带tag:mobile标签的设备连接带tag:mac标签设备的22端口（SSH端口）
其他端口全部拒绝

定期清理设备

在管理后台的Machines列表中：

移除不再使用的设备
检查是否有异常连接

2.4 验证组网成功

在Mac终端查看Tailscale状态：

tailscale status

输出示例：

100.64.0.1 macbook-pro your-email@ macOS - 100.64.0.2 iphone-15 your-email@ iOS -

看到两个设备都在列表中，且IP地址在同一网段（100.64.x.x），说明组网成功。

三、第二步：Mac开启SSH服务

3.1 通过系统设置开启（推荐）

macOS Ventura及以上

点击屏幕左上角苹果图标 →系统设置
左侧边栏 →通用→共享
在服务列表中找到远程登录
将开关切换为开启
右侧显示"已允许访问"，可选择"所有用户"或指定用户

macOS Monterey及以下

点击苹果图标 →系统偏好设置
点击共享图标
勾选远程登录
右侧设置允许访问的用户

3.2 通过终端命令开启

如果你更喜欢命令行：

# 检查SSH当前状态sudosystemsetup-getremotelogin# 开启SSHsudosystemsetup-setremoteloginon# 再次验证sudosystemsetup-getremotelogin# 输出: Remote Login: On

3.3 配置防火墙

如果Mac开启了防火墙，需确保SSH端口放行：

系统设置 → 隐私与安全性 → 防火墙 → 选项

确保列表中有"远程登录（SSH）“，状态为"允许传入连接”。

如果没有，点击"+"号添加。

3.4 验证SSH服务

# 检查sshd进程是否运行psaux|grepsshd# 检查22端口是否监听lsof-i:22# 本地自测SSH连接sshlocalhost# 首次连接会提示确认指纹，输入yes

3.5 获取连接信息

在"远程登录"设置页面，会显示：

要从此电脑登录此Mac，请输入： ssh 用户名@100.64.0.1

记下这个IP地址（Tailscale分配的虚拟IP）和用户名。

四、第三步：tmux会话管理

4.1 安装tmux

# Homebrew安装brewinstalltmux# 验证安装tmux-V

4.2 核心概念

tmux有三个层级：

层级	说明	类比
Session（会话）	顶层的独立环境	一个完整的终端窗口
Window（窗口）	会话内的标签页	浏览器的Tab
Pane（窗格）	窗口内的分割区域	分屏后的每一块

4.3 基础操作

创建命名会话（推荐）

# 创建一个叫"claude-code"的会话tmux new-sclaude-code

所有tmux快捷键都要先按"前缀键"：Ctrl + b

常用快捷键：

快捷键	功能
`Ctrl+b d`	分离会话（后台运行）
`Ctrl+b c`	新建窗口
`Ctrl+b 0-9`	切换到第0-9个窗口
`Ctrl+b %`	左右分屏
`Ctrl+b "`	上下分屏
`Ctrl+b 方向键`	切换窗格
`Ctrl+b x`	关闭当前窗格
`Ctrl+b [`	进入滚动模式（按q退出）

会话管理命令

# 查看所有会话tmuxls# 重新连接到会话tmux attach-tclaude-code# 简写tmux a-tclaude-code# 只有一个会话时直接连接tmux a# 结束会话tmux kill-session-tclaude-code

4.4 为什么tmux是必需的

场景一：网络断开

没有tmux：

SSH断开 → Claude Code进程被杀 → 所有工作丢失

有tmux：

SSH断开 → tmux会话仍在后台运行 → 重连后tmux a恢复现场

场景二：切换网络

从家里WiFi切换到移动数据
Termius重新连接
tmux a回到之前的Claude Code会话，代码还在

场景三：多任务并行

在一个tmux会话中：

窗口0：跑Claude Code写代码
窗口1：跑pytest测试
窗口2：查看日志文件

手机小屏幕，用窗口切换比分屏更实用。

五、第四步：手机端Termius配置

5.1 安装Termius

iOS：App Store搜索"Termius"
Android：Google Play或官网下载

Termius免费版已足够使用，付费版提供云同步功能。

5.2 新建主机连接

打开Termius，点击右下角"+“号 → 选择"New Host”

填写连接信息：

字段	填写内容
Alias（别名）	My MacBook Pro（自定义名称）
Hostname/IP	100.64.0.1（Tailscale分配的IP）
Port	22（默认SSH端口）
Username	你的Mac用户名
Password	你的Mac登录密码

点击右上角"✓"保存。

5.3 首次连接

在Termius主机列表中点击刚创建的主机：

首次连接会提示"未知主机指纹"，点击"Continue"确认
输入Mac登录密码
连接成功后看到Mac的终端提示符

测试连接

# 查看系统信息uname-a# 查看当前目录pwd# 测试Tailscale连接tailscale status

5.4 进阶：SSH密钥认证（可选但推荐）

密码认证每次都要输入密码，密钥认证更安全更方便。

在Mac上生成密钥对

# 生成ED25519密钥（推荐）ssh-keygen-ted25519-C"your-email@example.com"# 一路回车使用默认设置# 密钥保存在 ~/.ssh/id_ed25519（私钥）和 ~/.ssh/id_ed25519.pub（公钥）

将公钥添加到授权列表

cat~/.ssh/id_ed25519.pub>>~/.ssh/authorized_keys# 设置正确权限chmod600~/.ssh/authorized_keys

导出私钥到手机

# 在Mac上查看私钥内容cat~/.ssh/id_ed25519

复制输出的全部内容（包括-----BEGIN OPENSSH PRIVATE KEY-----和-----END OPENSSH PRIVATE KEY-----）。

在Termius中导入密钥

Termius → 右下角"…" → Keychain
点击"Add Key"
Label填写：MacBook Key
Private Key粘贴刚才复制的内容
保存

修改主机连接使用密钥

编辑之前创建的主机
Password字段清空
点击"Keys"选择刚导入的密钥
保存

现在连接无需输入密码。

5.5 Termius实用技巧

中文界面设置

Termius默认英文，可切换中文：

右下角"Settings"（齿轮图标）
General → Language → 选择"中文"

快速命令片段

常用命令可以保存为Snippet：

Termius → Snippets → “+”
添加常用命令如：tmux a -t claude-code
连接后快速执行

六、第五步：Claude Code CLI安装与验证

6.1 安装Node.js

Claude Code CLI基于Node.js运行，需先安装：

# Homebrew安装brewinstallnode# 验证安装node-vnpm-v

Node.js版本需18.0以上。

6.2 安装Claude Code CLI

# npm全局安装npminstall-g@anthropic-ai/claude-code# 验证安装claude--version

6.3 配置API Key

Claude Code需要Anthropic API Key才能使用。

获取API Key

访问：https://console.anthropic.com
注册/登录账号
API Keys → Create Key
复制生成的Key（以sk-ant-开头）

配置环境变量

# 临时配置（当前终端会话有效）exportANTHROPIC_API_KEY="sk-ant-your-key-here"# 永久配置（写入shell配置文件）# 如果使用zsh（macOS默认）echo'export ANTHROPIC_API_KEY="sk-ant-your-key-here"'>>~/.zshrcsource~/.zshrc# 如果使用bashecho'export ANTHROPIC_API_KEY="sk-ant-your-key-here"'>>~/.bash_profilesource~/.bash_profile

国内用户中转配置

如果无法直接访问Anthropic API，可配置中转地址：

exportANTHROPIC_BASE_URL="https://你的中转地址"exportANTHROPIC_API_KEY="中转平台提供的Key"

6.4 在tmux会话中启动Claude Code

完整流程

# 1. SSH连接到Mac后，创建tmux会话tmux new-sclaude-code# 2. 进入项目目录cd~/projects/my-project# 3. 启动Claude Codeclaude# 4. 首次启动会提示：# - 选择主题（推荐默认）# - 确认安全须知# - 信任当前目录# 按Enter使用默认选项即可# 5. 按 Ctrl+b d 分离会话（Claude Code继续后台运行）# 6. 断开SSH连接也没关系# 7. 下次重新连接后恢复tmux a-tclaude-code

6.5 Claude Code基础使用

Claude Code是交互式AI编程助手，直接用自然语言对话：

你: 帮我写一个Python脚本，读取CSV文件并计算每列的平均值 Claude Code: 我来创建这个脚本... [自动创建文件并写入代码] 你: 能加上错误处理吗？ Claude Code: 好的，我来添加try-except... [修改代码]

常用命令

/help：查看帮助
/clear：清除对话历史
/compact：压缩对话上下文
Ctrl+C：中断当前操作

七、完整工作流演示

场景：在地铁上修复一个Bug

早上出门前

# 在Mac上cd~/projects/my-app tmux new-smy-app claude# 让Claude Code理解项目结构

按Ctrl+b d分离会话，让Mac保持开机。

地铁上（手机操作）

打开Termius
点击"My MacBook Pro"连接
执行tmux a -t my-app
看到之前的Claude Code会话，继续对话：

你: 我发现用户登录后偶尔会报500错误，帮我排查 Claude Code: 我来检查登录相关的代码... [读取auth.py] 问题可能出在数据库连接超时处理上，我建议...

修复完成后按Ctrl+b d分离
断开SSH

到公司后

在公司的电脑上：

ssh你的用户名@100.64.0.1 tmux a-tmy-app# 继续之前的会话

无缝衔接。

八、常见问题与解决方案

问题1：Tailscale连接不上

症状

Termius提示"Connection refused"或"Timeout"

排查步骤

# 在Mac上检查Tailscale状态tailscale status# 如果显示"stopped"tailscale up# 检查防火墙是否阻止# 系统设置 → 隐私与安全性 → 防火墙 → 确保SSH在允许列表

检查ACL权限

登录Tailscale管理后台，确认ACL没有阻止手机到Mac的22端口。

问题2：SSH连接被拒绝

症状

ssh: connect to host 100.64.0.1 port 22: Connection refused

解决方案

# 检查SSH服务状态sudosystemsetup-getremotelogin# 如果显示Off，开启它sudosystemsetup-setremoteloginon# 检查sshd进程psaux|grepsshd# 如果没有sshd进程，尝试重启sudolaunchctl unload /System/Library/LaunchDaemons/ssh.plistsudolaunchctl load-w/System/Library/LaunchDaemons/ssh.plist

问题3：tmux会话丢失

症状

tmux ls提示"no server running on /tmp/tmux-xxx`

原因

Mac重启了，或tmux进程被杀。

预防措施

tmux会话不持久化，Mac重启会丢失。可以考虑：

使用脚本自动恢复关键会话
重要工作记得及时提交Git
使用launchd在开机后自动启动tmux

问题4：手机输入命令太慢

解决方案

方法一：使用Snippet

在Termius中保存常用命令片段：

tmux a -t claude-code
git status
npm test

一键执行，无需手打。

方法二：配置tmux快捷键

创建~/.tmux.conf：

# 改变前缀键为Ctrl+a（手机上更容易按）set-gprefix C-a unbind C-bbindC-a send-prefix# 更直观的窗口切换bind-nM-Left select-window-t-1bind-nM-Right select-window-t+1

方法三：外接蓝牙键盘

如果经常移动办公，蓝牙键盘能大幅提升效率。

问题5：Claude Code响应慢

可能原因

网络延迟高（Tailscale中继模式）
API服务器响应慢
项目文件过多

解决方案

# 检查Tailscale是否直连tailscale status# 如果显示"relay"，说明走了中继服务器# 优化：在同一地域的设备更易直连# 如果直连，延迟通常<50ms

使用/compact定期压缩对话上下文，减少每次请求的数据量。

九、安全最佳实践

9.1 最小权限原则

Tailscale ACL

只开放必要端口：

{"acls":[{"action":"accept","src":["tag:mobile"],"dst":["tag:mac:22"]}]}

SSH用户限制

在"远程登录"设置中，只允许特定用户SSH登录，不要选"所有用户"。

9.2 密钥优于密码

密码可能被暴力破解，ED25519密钥更安全。

禁用密码登录

编辑/etc/ssh/sshd_config：

PasswordAuthentication no PubkeyAuthentication yes

重启SSH服务：

sudolaunchctl unload /System/Library/LaunchDaemons/ssh.plistsudolaunchctl load-w/System/Library/LaunchDaemons/ssh.plist

9.3 定期审计

检查登录日志

# 查看最近的SSH登录last|head-20# 查看失败的登录尝试lastb|head-20

检查Tailscale连接日志

在管理后台的Logs页面查看所有连接记录。

9.4 紧急情况处理

发现异常访问

立即在Tailscale管理后台移除可疑设备
在Mac上关闭SSH：sudo systemsetup -setremotelogin off
更改密码和密钥

远程关闭SSH

如果手机被盗，通过Tailscale管理后台的ACL立即阻止所有连接。

十、进阶玩法

10.1 多设备协同

场景：手机写代码，iPad看日志

# Mac上创建两个tmux会话tmux new-scoding# 会话1：跑Claude Codetmux new-slogs# 会话2：tail -f logs/app.log# 手机连接coding会话tmux a-tcoding# iPad连接logs会话tmux a-tlogs

两个设备同时操作，互不干扰。

10.2 自动化脚本

创建~/scripts/start-remote-dev.sh：

#!/bin/bashSESSION_NAME="claude-code"# 检查会话是否存在tmux has-session-t$SESSION_NAME2>/dev/nullif[$?!=0];then# 创建新会话tmux new-session-s$SESSION_NAME-d# 进入项目目录tmux send-keys-t$SESSION_NAME"cd ~/projects/my-project"C-m# 启动Claude Codetmux send-keys-t$SESSION_NAME"claude"C-mfiecho"会话 '$SESSION_NAME' 已就绪"echo"手机SSH连接后执行: tmux a -t$SESSION_NAME"

Mac开机后自动运行：

chmod+x ~/scripts/start-remote-dev.sh

在"系统设置 → 通用 → 登录项"中添加此脚本。

10.3 端口转发

如果需要访问Mac上的本地服务（如localhost:3000）：

SSH端口转发

# 在手机Termius中连接时添加端口转发# 编辑主机 → Port Forwarding → Add# Local Port: 3000# Remote Host: localhost# Remote Port: 3000

连接后，手机浏览器访问localhost:3000就是Mac上的服务。

十一、总结

这套方案的核心价值：

随时随地：只要有网络就能连接Mac开发
稳定可靠：tmux保护会话，网络波动不影响
安全可控：Tailscale的ACL + SSH密钥双重保护
原生体验：Termius提供真正的终端，不是远程桌面

适用场景

通勤路上处理紧急Bug
外出时需要查看服务器日志
多台设备协同工作
没有公网IP的内网环境

不适用场景

需要图形界面操作（用VNC或Parsec）
大文件传输（用Syncthing或scp）
高频输入（外接蓝牙键盘更好）

关键要点

Tailscale的安全配置是基础
tmux是会话保持的核心
Termius让手机变成真正的终端
Claude Code在tmux中才能断线不丢进度

现在，试试从手机连接你的Mac，开始第一次移动开发体验吧。

附录：命令速查表

Tailscale

tailscale status# 查看连接状态tailscale up# 启动连接tailscale down# 断开连接tailscaleip# 查看虚拟IP

SSH

sshuser@100.64.0.1# 连接远程主机ssh-keygen-ted25519# 生成密钥对ssh-copy-id user@host# 复制公钥到远程

tmux

tmux new-sname# 创建命名会话tmuxls# 列出所有会话tmux a-tname# 连接到会话tmux kill-session-tname# 结束会话

tmux快捷键（先按Ctrl+b）

d 分离会话 c 新建窗口 0-9 切换窗口 % 左右分屏 " 上下分屏 x 关闭窗格 [ 滚动模式（q退出）

Claude Code

claude# 启动交互界面claude--version# 查看版本/help# 查看帮助/clear# 清除对话/compact# 压缩上下文

企业官网建设流程全解析