在托管 Mac mini 上跑 Claude Code：从 SSH 到会话保活

设备上架、拿到连接信息之后，下面这套流程大约 20 分钟可以走完，之后你的 Claude Code 就有了一个不会合盖、不会断网的家。

第 1 步：配置 SSH 密钥登录

在你自己的电脑上生成密钥（已有可跳过），再拷到 Mac mini：

ssh-keygen -t ed25519 -C "you@laptop"
ssh-copy-id dev@<托管地址>

然后在本机 ~/.ssh/config 加一个别名，之后只用敲 ssh mini：

Host mini
  HostName <托管地址>
  User dev
  ServerAliveInterval 30
  ServerAliveCountMax 4

ServerAliveInterval 会定期发心跳，能明显减少“静置一会儿就断”的情况。

第 2 步：安装 Claude Code

用官方安装脚本最省事，不依赖 Node 版本：

curl -fsSL https://claude.ai/install.sh | bash
claude --version

如果你更习惯 npm，也可以先用 Homebrew 装 Node，再 npm install -g @anthropic-ai/claude-code。两种方式选一种即可，不要混装。

第 3 步：用 tmux 让会话常驻

brew install tmux
tmux new -s work
cd ~/code/your-project && claude

按 Ctrl-b 再按 d 脱离，SSH 断开也没关系。下次登录：

ssh mini -t "tmux attach -t work || tmux new -s work"

这一行可以存成本机 alias，一键回到上次的现场。

第 4 步：处理 macOS 的权限弹窗

macOS 对“访问文稿、桌面、下载”等目录有隐私保护。通过 SSH 第一次访问这些目录时，可能静默失败或卡住。两个办法：

• 项目放在 ~/code 这类非受保护目录，避开桌面和文稿；
• 通过远程桌面登录一次，在“系统设置 → 隐私与安全性 → 完全磁盘访问权限”里给终端或 sshd-keygen-wrapper 授权。

第 5 步：考虑断电和重启

托管节点会尽量保证供电，但系统更新、偶发重启无法完全避免。建议：

• 打开“断电后自动启动”，详见这篇设置清单；
• 重要的长任务定期提交到 Git，别把成果只放在会话里；
• 开启 FileVault 时，意外重启后会停在解锁界面，需要联系客服协助；计划内重启可用 sudo fdesetup authrestart。

常见坑

tmux 里颜色或中文显示异常

在 ~/.tmux.conf 里加上 set -g default-terminal "tmux-256color"，并确认本机终端编码是 UTF-8。

Homebrew 命令找不到

Apple 芯片的 Homebrew 装在 /opt/homebrew，SSH 非交互登录可能没加载 PATH。把 eval "$(/opt/homebrew/bin/brew shellenv)" 写进 ~/.zprofile。

多个项目同时跑

每个项目开一个 tmux window（Ctrl-b c），或者每个项目一个独立 session，名字和项目目录对应，切换时不容易搞混。