用途:该资料面向使用 Claude Agent SDK 集成 AI 智能体工具的开发者,讲解工具、权限与 MCP(Model Context Protocol)服务器的配置方法。
主要能力:可通过 allowedTools 白名单允许 read_file、write_file、list_files、grep、bash 等工具,用 disallowedTools 屏蔽指定工具;权限模式分 strict(需用户显式批准)与 permissive(自动批准已知安全操作)。支持自定义 Tool 对象,含 name、description、input_schema 和 execute 方法,execute 可接收 input 与 context(如 context.model)。可挂载 MCP 服务器,用 command、args、env 配置,例如 npx -y @modelcontextprotocol/server-filesystem 和 @modelcontextprotocol/server-git;智能体可经由 MCP 读取文件。支持流式处理响应,遍历 chunk 判断 tool_use 与 tool_result。
用法要点:安装与引入使用 import { Agent } from '@anthropic-ai/claude-agent-sdk';自定义工具从同一包导入 Tool。调用通过 await agent.chat('...')。
限制与安全:资料强调最小权限原则,建议只允许必要工具,避免 allowedTools: ['*'],也不建议直接放开 bash。自定义工具需做输入校验(如拒绝含 .. 的路径、阻止删除 /etc 与 /sys 下文件);MCP 文件系统服务器应限制到具体目录实现沙箱。错误不应静默返回 null,而要显式返回错误信息。
其它:资料提及相关技能 agent-creation(智能体初始化与配置)与 context-management(上下文与记忆管理)。具体安装命令、版本要求、收费与平台信息暂未提供。