SuperAPI AI 工具集

nest-claude

智能体与模型

查看项目

更新于 10-15 22:38

技能介绍

用途:从父 Claude Code 会话中启动完整的子 Claude Code 进程。每个子进程拥有独立上下文窗口、工具访问和会话,区别于更轻量但无法嵌套、共享进程的 Task 工具子代理。适合长时间自主工作(5 分钟以上)、子进程需再派生子代理、N 个独立任务并行扇出,以及可能超过 600 秒 Bash 超时的工作。

必要用法:每次嵌套调用都需以下标志,缺一即失败:env -u CLAUDECODE -u CLAUDE_CODE_ENTRYPOINT claude -p "提示词" --dangerously-skip-permissions < /dev/null 2>&1。其中 env -u 用于取消父进程继承的环境变量,避免子进程静默挂起;-p 为非交互模式;--dangerously-skip-permissions 因无 TTY 无法弹出权限确认;< /dev/null 对二级及以上嵌套必需,否则孙进程会无限挂起。

可选标志:--output-format json 返回含 result、session_id、total_cost_usd、duration_ms、num_turns 的结构化输出;stream-json 提供实时 NDJSON;--append-system-prompt 追加系统指令;--agent 指定 .claude/agents/*.md 中的代理;--name 设置会话显示名(建议用 _nest: 前缀便于清理);--json-schema 校验最终响应;--resume 与 --fork-session 用于续接或分叉会话。

并行执行:可用后台 Bash 命令(约 5 个以内)或 shell 脚本(更多或动态数量)。不要在命令内使用 &,应使用 Bash 工具的 run_in_background: true。并发无硬性上限,实际受 API 速率与机器资源限制,5-10 个并发较合理。默认不添加 --max-turns、token 或成本上限,除非调用方明确要求。

监控与结果:子进程通常运行 5-30 分钟。后台子进程完成时会收到 task-notification,优先于轮询。可用 /find-claude 或直接读取 ~/.claude/projects 下的 JSONL 文件实时内省运行中的子会话。结果可通过 stdout 内联返回、文件持久化或文件式 IPC 收集;文件式 IPC 可避免多代理链中的信息损耗。

继承与限制:子进程自动继承环境变量、项目级 CLAUDE.md/AGENTS.md、设置文件、MCP 配置和 Git 上下文;不继承父会话历史、已加载技能内容、权限批准、CLI 标志、技能 $ARGUMENTS 和任务状态。settings.json 的 env 键会覆盖命令行环境变量,因此可覆盖配置应优先通过提示词传递。默认每个子进程全新开始,-p 提示词即其全部指令。