安全加固

Tactic Remote 让你的 iPhone 控制 Mac 上的终端。本页介绍保护机制、配置方式和注意事项。

API Key 认证

服务器支持 API Key 认证。设置后，每次连接都必须提供正确的 Key。

export CLAUDE_REMOTE_API_KEY="your-secret-key"

Mac App 可以为你自动生成随机 Key。

何时需要：

• 公网/隧道访问时强制要求。
• 局域网访问时可选，但仍建议设置。

注意事项：

• 不要在截图或聊天中分享 API Key。
• 怀疑泄露时立即轮换 Key。
• Mac App 将 Key 存储在 macOS 钥匙串中。

路径限制

你可以限制 Claude Code 能访问的目录：

export CLAUDE_REMOTE_ALLOWED_PATH="/Users/you/projects"

默认设置为主目录（~）。将范围缩小到项目文件夹可以防止 Claude 访问无关文件。

默认屏蔽： 服务器自动阻止对 .ssh、.aws、.gnupg 等敏感目录的访问，不受 allowed path 设置影响。

会话安全

• 会话名称 经过验证：仅允许字母数字、下划线和连字符（最长 50 个字符），防止通过会话名注入命令。
• 命令 传递给 tmux 前经过验证，仅允许带批准参数的 claude 命令。
• 路径遍历 攻击（如 ../../etc/passwd）被自动阻止。

速率限制

服务器对每个连接强制执行 每分钟 30 次请求 的速率限制，防止滥用和意外的请求风暴。

网络安全

局域网

在可信的家庭或办公网络上，局域网模式足够安全。主要风险来自同网络的其他设备。将 IP 和 API Key 视为凭据保护。

Cloudflare Tunnel

隧道连接默认加密（WSS/TLS）。Cloudflare 还提供 DDoS 防护。隧道无需在路由器上开放入站端口。

公网访问时务必：

1. 设置 API Key。
2. 尽量使用 Named Tunnel 获得稳定 URL。
3. 不再使用时及时清理旧的隧道配置。

安全检查清单