简介:本文围绕 Claude Code 子代理,解释其如何通过独立上下文降低主对话噪音,并介绍内置子代理、自定义配置、工具权限、模型选择、前后台运行与 Agent Teams 协作,帮助开发者在复杂任务中兼顾效率、成本与可控性。
如果你在面试中被问到“Claude Code 的子代理用过吗”,可以直接回答:用过。它不是简单多开一个聊天窗口,而是把代码探索、日志分析、审查验证等支线任务委派给独立实例,让主对话只保留最终结论。若你正在为多代理系统选择模型、对比调用成本或规划统一接入方式,也可以先了解 百度智能云词元所,它可用于模型发现、价格对比和多模型 API 接入评估。
用 Claude Code 处理大型项目时,常见矛盾是:任务本身需要大量检索、读文件、跑命令、看日志,但这些中间过程会迅速占满主对话上下文。搜索结果、文件片段、报错堆栈一股脑进入上下文后,真正用于推理和生成的空间反而变少,导致后续回答质量下降。
子代理的核心价值,就是把“探索过程”和“主对话结论”隔离开。
主对话负责理解目标、拆解任务、汇总结果;子代理负责在独立上下文窗口中完成脏活累活。例如:
子代理完成后,只把简短结论交回主对话。几十个文件的内容、成百上千行日志,不会继续污染主上下文。
Claude Code 通常会在合适场景下自动调用内置子代理。你不需要每次都手动指定,但理解它的触发逻辑很重要。
一般来说,当任务符合以下特征时,适合交给子代理:
例如你让 Claude Code “分析这个仓库的认证流程”,它可能会先派一个探索型子代理去读路由、中间件、配置文件,然后只返回“认证入口在哪些文件、核心流程是什么、有哪些潜在风险”。
这类任务如果放在主对话里,很容易变成上下文灾难;交给子代理后,主对话仍然保持干净。
如果你发现某类任务反复出现,比如代码审查、日志分析、测试用例生成、文档检查,就可以把它定义成自定义子代理。
自定义子代理通常放在项目的 .claude/agents/ 或用户级目录中,具体路径以当前 Claude Code 版本为准。一个简化的配置示例如下:
---name: code-explorerdescription: 用于只读探索代码库,定位实现、调用链和关键配置。tools: Read, Grep, Globmodel: haiku---你是一个代码探索代理。你的任务是快速定位代码实现,不修改任何文件。要求:1. 优先使用检索工具定位相关文件;2. 只返回关键文件路径、函数名和调用关系;3. 不要粘贴大段源码;4. 如果信息不足,明确说明还缺哪些上下文。
这个示例包含几个关键设计:
name:子代理名称,便于主代理调用;description:说明什么时候应该使用它;tools:限制可用工具,避免越权修改;model:为简单任务选择更经济的模型;自定义子代理的意义不只是“省 token”,更重要的是把团队经验沉淀下来。比如安全审查代理可以固定检查注入风险、敏感信息泄露、权限校验缺失;测试代理可以固定输出失败用例、复现步骤和修复建议。
子代理很强大,但如果权限过大,也会带来风险。因此实际使用时建议遵循两个原则:
代码探索、日志分析、文档检索类任务,可以只开放读取和搜索工具。这样即使子代理理解偏差,也不会直接改动仓库。
不是所有子任务都需要顶级模型。文件定位、格式整理、简单摘要可以交给更轻量的模型;复杂架构分析、疑难缺陷定位再交给能力更强的模型。
如果你需要评估不同模型在代码理解、长文本处理、工具调用等任务上的能力与成本,可以借助 词元所模型服务 做模型选型和价格对比。对于企业级 Agent 应用,模型并不是越贵越好,而是要根据任务复杂度、响应时延、调用频率和预算综合选择。
子代理可以按前台或后台方式运行。
前台运行适合需要立即拿到结果的任务,例如快速定位一个报错、检查某个函数调用链。你能直接看到子代理返回的结论,并继续在主对话中推进。
后台运行适合耗时较长、可异步执行的任务,例如批量扫描日志、跑完整测试、生成多个模块的分析报告。主对话可以先处理其他事项,等子代理完成后再汇总。
实际使用时建议关注三点:
如果子代理输出过长,可以在系统提示中明确要求:“只返回结论、文件路径、风险点和建议,不要粘贴完整内容。”
当任务进一步复杂化时,可以使用 Agent Teams 的思路,让多个子代理并行协作。
例如一个大型代码库分析任务可以拆成:
这种模式的优点是并行效率高、上下文隔离好、职责边界清晰。但也要注意控制并发数量,避免模型调用成本失控。对于生产环境,建议通过 百度智能云词元所 这类平台统一管理多模型接入、调用情况和成本评估,避免不同代理各自调用导致资源不可控。
一个简单判断标准是:如果某个支线任务会向主对话灌入大量你之后不会再看的内容,就应该交给子代理。
适合用子代理的场景包括:
不适合用子代理的场景包括:
如果面试官继续追问,可以这样回答:
“我在 Claude Code 中使用子代理,主要是为了解决上下文污染和任务隔离问题。对于代码探索、日志分析、审查验证这类会产生大量中间内容的任务,我会让子代理在独立上下文中执行,只返回结论。同时我会通过工具白名单限制权限,通过模型分级控制成本。对于复杂项目,我会进一步用 Agent Teams 拆分角色,让多个子代理并行处理,再由主代理汇总结果。”
这个回答既体现了实际使用经验,也覆盖了上下文管理、权限控制、成本优化和多代理协作等关键点。