用途：本指南面向使用 Claude Agent SDK 构建自定义 AI 智能体的开发者，该 SDK 与 Claude Code 使用相同基础设施。
安装：TypeScript 使用 npm install @anthropic-ai/claude-agent-sdk；Python 使用 pip install claude-agent-sdk。
主要能力：上下文管理支持自动压缩，避免长时间运行耗尽上下文；内置工具包括文件读写编辑、安全执行 bash 命令、Web 搜索，并可通过 MCP（Model Context Protocol）扩展自定义工具。权限控制支持 allowedTools 白名单、disallowedTools 黑名单与 permissionMode（default 或 strict）。
认证提供方：默认 Anthropic API，设置 ANTHROPIC_API_KEY；也支持 Amazon Bedrock（CLAUDE_CODE_USE_BEDROCK=1 及 AWS 凭据）、Google Vertex AI（CLAUDE_CODE_USE_VERTEX=1 及 GOOGLE_APPLICATION_CREDENTIALS、VERTEX_REGION、VERTEX_PROJECT_ID）、Microsoft Foundry（CLAUDE_CODE_USE_FOUNDRY=1 及 Azure 凭据）。
基于文件的配置：.claude/agents/ 存放子智能体定义，.claude/skills/ 存放技能文件（SKILL.md），.claude/commands/ 存放斜杠命令，.claude/settings.json 配置钩子，CLAUDE.md 为项目记忆与上下文；可通过 settingSources: ['project'] 启用项目设置。
使用方式：以 TypeScript 或 Python 创建 Agent 实例，指定 model、allowedTools、systemPrompt，再调用 run 传入 prompt 获取输出；可配置 mcpServers 接入外部工具，如通过 npx 启动 @modelcontextprotocol/server-postgres。
适用场景：编码类包括 SRE 诊断、安全审计、事件分诊、代码审查；业务类包括法律审查、财务分析、客户支持、内容创作。
最佳实践与限制：从最小工具权限开始按需扩展；用子智能体拆分复杂任务；优雅处理错误；通过 onToolUse、onThinking 监控行为。可用 /agent-sdk:agent-scaffold 命令生成新项目。资料未提供具体收费、价格与效果数据。