SuperAPI AI 工具集

claude-remote

智能体与模型

查看项目

更新于 10-15 17:24

技能介绍

用途:管理在 macOS Terminal.app 中运行的 Claude Code 远程控制会话(即 claude --remote-control,非普通本地会话),面向通过远程桌面客户端从移动设备操控 Claude Code 的用户。

主要能力:提供启动(start/open/launch)、停止(stop/close/kill)、列出(list/status)和清理(cleanup)远程会话的操作。会话状态保存在 ~/.claude-remote/,每个会话一个 JSON 文件;会话管理逻辑由技能目录下的 scripts/session-manager.sh 脚本处理。

使用方式:每次调用技能前先运行清理操作:

bash <skill-dir>/scripts/session-manager.sh cleanup

启动会话:

bash <skill-dir>/scripts/session-manager.sh create <directory-path> [extra-flags...]

列出会话:

bash <skill-dir>/scripts/session-manager.sh list

停止会话:

bash <skill-dir>/scripts/session-manager.sh stop <session-id>

或停止全部:

bash <skill-dir>/scripts/session-manager.sh stop-all

启动时可通过标志指定权限模式(--permission-mode,默认 bypassPermissions)、模型(--model)、会话名(-n)、努力级别(--effort)以及 git worktree(-w, --worktree)。使用 -c 标志可继续某目录下最近的对话。若目录不明确,可运行 list-dirs 列出 ~/Workspace 下的目录供选择。

适用场景:在 macOS 上,从移动设备或其他远程客户端启动、查看、停止 Claude Code 远程会话;需要为某目录创建独立 Terminal 窗口运行远程控制实例;需要继续此前对话或使用 worktree。

限制:脚本通过 osascript 控制 Terminal.app,仅适用于 macOS。每个会话会打开一个新的 Terminal 窗口(而非标签页)。停止操作使用 Terminal 原生的“终止进程”对话框关闭 Claude Code,然后关闭窗口。清理操作会检查记录的 Terminal 窗口是否仍存在并移除失效记录。~/.claude-remote/ 为状态目录。其他平台、价格或更多功能资料暂未提供。