用途
本技能用于把 Claude Code CLI(命令 claude)作为被委派的对象调用,承担三种角色:审阅者(第二意见)、只读复核者,或编辑工人(实际改代码)。它的核心思路是先写一份结构化简报,再用命令行把这个任务交给 Claude Code 执行,最后收割结果,并把制作方与检查方拆开以避免自审。
主要能力
- 交互式委派:默认路径 claude-rc-spawn,在分离的 tmux 会话中运行带 Remote Control 的交互式 Claude,用户可在 claude.ai/code 上观看并介入调整。
- 无交互回退:当机器可读的捕获比可见性更重要时,使用 claude -p,可通过 --output-format json 取回结果、用 stream-json --verbose 获取实时日志。
- 编辑工人:将 --permission-mode plan 替换为 --permission-mode acceptEdits,并用 --worktree 让 Claude 自动创建 worktree 与分支。
- 后台工人:使用 claude --bg --worktree ... 启动 fire-and-return 后台任务,并用 claude agents --json 管理。
- 会话续接:用 claude --continue / --resume <session-id> 恢复,加 --fork-session 可分叉。
- 模型与强度控制:默认 --model opus --effort high,琐碎任务用 sonnet --effort low。
使用方式
第一步是写简报:把上下文、确切任务、约束、验收标准、验证命令、输出形态写入 .agent-runs/$slug/prompt.md(slug 形如 claude-$(date +%Y%m%d-%H%M%S),先 mkdir -p)。简报中要索取证据(执行的命令、退出状态、变更文件、风险),并明确要求同步验证——绝不要在等待后台监视器或 watcher 时结束回合,否则工人会停在“等待监视器”状态并空转让出。
启动审阅者(只读)通过 Remote Control tmux:
claude-rc-spawn
--cwd "$PWD"
--prompt-file ".agent-runs/$slug/prompt.md"
--name "$slug-review" --tmux-session "$slug-review"
--permission-mode plan
--model opus --effort high
编辑工人使用同一命令,把 --permission-mode plan 换成 --permission-mode acceptEdits,把 --name/--tmux-session 改名为 "$slug-edit",并加上 --worktree "$slug"(由 Claude 创建 worktree 和分支)。
无交互回退(JSON 捕获,无 Remote Control):
cat ".agent-runs/$slug/prompt.md" | claude -p
--model opus --effort high
--permission-mode plan
--output-format json
--name "$slug-review" --add-dir .
编辑工人相应地把 --permission-mode plan 换成 --permission-mode acceptEdits,把 --output-format json 换成 --output-format stream-json --verbose,并加上 --worktree "$slug" --max-budget-usd 10。若需要 fire-and-return 的后台工人,使用 claude --bg --worktree "$slug" --model opus --effort high --permission-mode acceptEdits --name "$slug-edit" "$(cat ".agent-runs/$slug/prompt.md")",并用 claude agents --json 管理。
收割结果:--output-format json 时最终文本在 .result、会话 id 在 .session_id;stream-json --verbose 用于实时日志。claude-rc-spawn 会把提示词与 tmux.log 保存在 .agent-runs/<tmux-session>/ 下。可用 tmux attach -t "$slug-review" 观看,或在 claude.ai/code 上按名称观看。用 claude --continue / --resume <session-id> 恢复,加 --fork-session 分叉。对于大工作量,把制作者与检查者拆开:在接受 diff 之前,让一个全新的审阅者复查。
注意事项
Remote Control 需要完整的 claude.ai 登录。环境中的 CLAUDE_CODE_OAUTH_TOKEN、ANTHROPIC_API_KEY 或非默认 ANTHROPIC_BASE_URL 可能在会话启动前就破坏它;claude-rc-spawn 默认会剥离这些变量。Remote Control 会随本地进程一起终止,因此要保证 tmux 会话存活到运行结束。
--worktree 从 origin/HEAD 开始,而不是从你的分支开始。当工人必须看到本地进行中的状态时,设置 worktree.baseRef 为 head。Worktree 落在 .claude/worktrees/<name> 下(应把该目录加入 gitignore);-p --worktree 运行不会给退出提示,因此需要自己清理已完成 worktree。
如果工人以“等待监视器”结束回合,说明它卡住了。提示它一次(恢复会话或向它的 tmux 会话粘贴内容);若它再次停下,就接管——它的改动已经落在 worktree 的磁盘上。
--agent 只选择人格;硬权限来自 --permission-mode(plan、acceptEdits、auto),每次都要搭配使用。对于有边界的无人值守编辑工人用 acceptEdits;当希望对更宽泛的工具调用做后台安全检查时用 auto。
--max-budget-usd 仅限制 print 模式(claude -p)的运行。
当你想要 Claude Code 内置的 tmux 处理而不是 claude-rc-spawn 时,把 --tmux 与 --worktree 一起加。
claude -p 会跳过工作区信任对话框——只在信任的目录中运行它。
--add-dir 授予文件访问权限;它不会把该目录变成工作检出目录,也不会复制其配置。
给每次运行命名(--name),以便并发的智能体在 claude agents 和 claude.ai/code 中可区分。
限制
- Remote Control 不能与 API key / claude setup-token / CLAUDE_CODE_OAUTH_TOKEN 认证一起使用——只支持完整的 claude.ai 登录。
- --bg 后台智能体不支持预算上限(--max-budget-usd 仅适用于 print 模式)。
- 在受控且尽量网络隔离的容器/VM 之外,不要使用 --dangerously-skip-permissions——它可能写入受保护的配置区域;绝不能作为编辑工人的默认模式。
- 不支持为未来的移动端/网页端派发而设的持久服务器——那是 claude remote-control server 模式,应改用 claude-remote-control-server 技能。