用途:将 Claude Code CLI 作为独立协作方无头调用,由调用方智能体负责验证、汇总与最终决策。适合获取设计/边界情况/测试缺口的第二意见、审查或提出 unified diff、在自身实现时进行多轮分析。不适合琐碎的一次性编辑、需要权威引用事实的任务,以及涉及密钥或生产数据的场景。
主要能力:桥接脚本 scripts/claude_bridge.py 包装 claude --print,向 stderr 流式输出进度,返回含遥测的结构化 JSON,并通过 SESSION_ID 管理多轮连续性。始终经由桥接脚本调用,不要直接调用 claude。返回字段含 success、SESSION_ID、agent_messages、model、subtype、total_cost_usd、usage、num_turns,以及相关时的 tools_used、tools_failed、permission_denials 等。
使用方式: python3 skills/collaborating-with-claude/scripts/claude_bridge.py --cd "." --model sonnet --permission-mode plan --PROMPT "$PROMPT" --output-format stream-json 在宿主中可用 run_in_background 参数后台运行(属宿主工具参数,非 shell 参数)。多轮:首次调用取 SESSION_ID,后续用 --SESSION_ID "<id>"(需同一 --cd)或 --continue 续接。大或含 shell 敏感字符的提示写入文件并用 --prompt-file。常用标志:--cd(必填)、--model、--output-format、--permission-mode(default·plan·acceptEdits·auto·dontAsk·bypassPermissions)、--tools、--allowed-tools、--max-budget-usd、--max-turns、--timeout 等。
限制:无头模式无法交互授权,所有受限操作当场拒绝并记入 permission_denials,须在调用前通过权限参数确定授权;网络由工具策略控制而非 OS 沙箱。默认只读委派(plan 或 Read,Glob,Grep);--cd 之外的读取也受限,用 --add-dir 授权。不要把密钥、私钥或生产数据交给 Claude。需已登录 Claude(claude 后 /login)或设置 ANTHROPIC_API_KEY(--bare 必需)。实际命令、标志语义与完整参数文档见技能内 cli-reference.md 等参考文件。