代理与扩展

这是 Claude Code 真正变得强大的地方——通过代理系统和扩展机制，Claude 可以处理任意复杂的任务。

子代理（Sub-agents）

每个子代理拥有独立的 200k 上下文窗口，执行专门任务，可并行运行。

内置子代理

代理	模型	用途
Explore	Haiku	快速只读探索代码库
Plan	Sonnet	规划研究
General-purpose	Sonnet	复杂多步任务

自定义子代理

通过 /agents 命令或手动创建 .claude/agents/ 目录下的 Markdown 文件：

---
name: code-reviewer
description: 代码审查专家，只读模式
model: haiku
tools:
  - Read
  - Glob
  - Grep
permissionMode: plan
maxTurns: 10
---

你是一个代码审查专家。审查代码的质量、安全性和性能。
关注以下方面：
- 输入验证
- 错误处理
- 性能问题
- 安全隐患

关键配置

字段	说明
model	sonnet/opus/haiku/模型 ID/inherit
tools	允许的工具白名单
disallowedTools	禁止的工具黑名单
permissionMode	权限模式
maxTurns	最大执行轮次
memory	持久记忆（user/project/local）
background	后台运行
isolation	隔离模式（worktree）
skills	预加载技能

代理技能（Agent Skills）

技能是指令、脚本和资源的文件夹，按需赋予 Claude 专业知识。基于开放标准，可跨工具使用。

插件（Plugins）

将命令、代理、技能、Hooks 和 MCP 服务器捆绑为一个包：

/plugin install my-setup

通过市场发现新工作流，支持搜索过滤。

LSP 集成

语言服务器协议提供 IDE 级别的代码智能：

• 即时诊断：编辑后立即看到错误和警告
• 代码导航：跳转到定义、查找引用
• 语言感知：类型信息和文档

Claude Agent SDK

用 Python 或 TypeScript 构建与 Claude Code 相同能力的代理。

安装

# TypeScript
npm install @anthropic-ai/claude-agent-sdk

# Python
pip install claude-agent-sdk

基础示例

import { query } from '@anthropic-ai/claude-agent-sdk';

for await (const msg of query({
  prompt: "为 src/ 中所有公共函数生成 Markdown API 文档",
  options: {
    allowedTools: ["Read", "Write", "Glob"],
    permissionMode: "acceptEdits"
  }
})) {
  if (msg.type === 'result') console.log("文档已生成:", msg.result);
}

内置工具

Read、Write、Edit、Bash、Monitor、Glob、Grep、WebSearch、WebFetch、AskUserQuestion

认证

支持 ANTHROPIC_API_KEY、Amazon Bedrock、Google Vertex AI、Microsoft Azure。

Hooks

SDK 支持 PreToolUse、PostToolUse、Stop、SessionStart 等回调。

实践建议

子代理的威力在于委派和隔离。把需要大量上下文的子任务交给子代理，保护主会话的上下文窗口。自定义代理用 Haiku 模型降低成本，复杂任务才用 Sonnet/Opus。Agent SDK 则适合将 Claude Code 的能力嵌入到自动化流程中。