常见问题

无法连接到服务器

症状： 连接超时或立即失败。

修复方法：

• 确认两台设备在同一 WiFi（局域网模式）。
• 检查 Mac App / 服务器是否正在运行。
• 确认 IP 地址和端口正确。在 Mac 上运行 ipconfig getifaddr en0。
• 如果 macOS 防火墙已启用，允许应用的入站连接。
• 在两台设备上禁用 VPN（如果 VPN 改变了流量路由）。
• 企业/酒店 WiFi 可能隔离设备，尝试家庭网络或手机热点。

IP 地址无法输入点号

症状： 某些地区（德语、法语等）的数字键盘显示逗号 , 而非 .。

修复方法： 切换到标准字母键盘输入点号，或从备忘录粘贴 IP 地址。

已连接但终端空白

症状： 绿色连接指示灯亮起，但终端视图无内容。

修复方法：

1. 打开会话选择器，重新选择会话。
2. 如果没有会话，创建一个新会话。
3. 如果会话存在但无输出，点击 Start 启动 Claude Code。

点击 Start 无反应

症状： 点击 Start 但界面无变化。

说明： 如果 Claude Code 已在运行，这是预期行为。应用有防重复启动保护。检查状态指示灯——如果显示绿色 Running，Claude Code 已处于活跃状态，直接发送提示即可。

收不到通知

症状： Claude Code 完成任务但没有推送通知。

修复方法：

• 检查 iOS 设置 > Tactic Remote > 通知——必须启用。
• 确保服务端和应用都是最新版本。
• 通知依赖 Claude Code 的 hook 事件，这些事件通过 WebSocket 连接自动发送。

App 后台一段时间后断连

症状： 切回应用后显示断开状态。

说明： 这是正常的 iOS 行为。iOS 会暂停后台网络连接以节省电量。应用在你回来时会自动重连。

长任务建议依赖推送通知，而不是保持应用前台。

服务器 IP 不断变化

症状： Mac 每次获得不同 IP，保存的连接失效。

修复方法：

• 在系统设置 > 网络中为 Mac 分配固定 IP。
• 使用 Bonjour 自动发现代替手动输入 IP。
• 使用 Cloudflare Tunnel 获得稳定 URL。

Claude Code 提示 "API key not set"

这是 Claude Code 的错误，不是 Tactic Remote 的问题。Claude Code 需要 Anthropic API Key 才能工作。

在终端中设置：

export ANTHROPIC_API_KEY="your-anthropic-api-key"

或运行 claude config 永久保存。

注意： 这与 Tactic Remote 服务器 API Key 不同。Anthropic Key 用于 Claude AI 服务，服务器 API Key 用于 iPhone 到 Mac 的连接认证。

需要更多帮助？

访问 支持页面 或在 GitHub 上提交 issue，附上：

• 应用版本
• 连接模式（局域网或 Cloudflare Tunnel）
• 你尝试了什么以及发生了什么