Claude Agent SDK
Claude Agent SDK 是 Anthropic 提供的软件开发工具包，用于帮助开发者基于 Claude Code 的 Agent Harness 框架构建自定义 AI Agent。该 SDK 支持 Python 和 TypeScript 两种主流编程语言，为开发者提供标准化接口和工具链，使其能够扩展和定制 AI Agent 的行为与能力，适用于自动化任务、工作流编排等场景。
核心事实
时间轴 (近 90 天)
Claude Agent SDK 包内置了原生 Claude Code 二进制文件，大多数机器无需额外安装。
claude agent sdk 教程推荐使用 uv 包管理器，Python 版本需 3.10 以上。
在 Claude Agent SDK 中，deny 规则可拦截 rm 命令并在所有模式下生效（包括 bypassPermissions），但 deny 规则匹配的是命令字面，/bin/rm 这类写法可以绕过，因此需要 pre-tool-use hook 在链条最前面检查每个 bash 调用。
Claude Agent SDK 中未捕获的工具异常不会终止代理循环，服务器会将其转换为携带原始异常信息的错误结果。
Claude Agent SDK 默认使用 tool search 延迟加载 MCP 工具 schema，以避免大型服务器一开始就占用上下文窗口。
在 Claude Agent SDK 中，MCP 工具的完全限定名为 mcp__服务器名__工具名（用双下划线连接），该完整字符串必须一字不差地出现在 allowed 列表中，否则调用会落到权限模式。
Claude Agent SDK 的权限模式常见取值包括 default（未预批准调用需回调确认，无回调即拒绝）、acceptEdits（自动接受文件编辑）、dontAsk（未预批准即拒绝）和 bypassPermissions（跳过全部权限检查）。
Claude Agent SDK 中工具请求的检查顺序为：hooks → deny 规则 → ask 规则 → 权限模式 → allow 规则 → can use tool 回调（默认模式下无回调即拒绝）。
在 Claude Agent SDK 的权限系统中，allowed 列表仅表示预批准，未列出的工具不会被关闭，而是进入权限模式处理；要移除工具必须将其裸名称放入 disallowed 列表。
Claude Agent SDK 不会自动加载 .env 文件，需要在运行代理的 shell 中设置 ANTHROPIC_API_KEY 环境变量，或使用 dotenv 等在 SDK 启动前手动加载。
还有 40 条时间轴事件
全部知识事实 (20)
Agent Skills是Anthropic发布的能力封装标准，定义为一个包含Skill.md文件的目录，可包含说明、脚本和其他资源
80%已验证Agent SDK的核心接口是一个query()函数，传入提示词与配置即可启动代理循环；关键配置项包括settingSources、allowedTools和systemPrompt。
65%已验证Claude Agent SDK支持多步骤推理、工具调用和环境交互，包括代码编写、文件操作、命令执行等能力
65%已验证Claude Agent SDK内置了Web Search和Web Fetch等工具，使Agent具备联网搜索和网页抓取能力
65%待验证claude-memory-compiler采用三层自动化流水线架构：会话捕获层（Hooks机制）、知识提取层（Claude Agent SDK）和知识编译层（LLM Compiler）
90%待验证该方案的所有数据和推理都在本地完成，不会外传到第三方服务器，适合对数据隐私有严格要求的企业场景
90%待验证通过设置环境变量ANTHROPIC_BASE_URL指向LiteLLM Proxy的本地端口，可以将Claude Agent SDK的请求重定向到本地模型，无需修改SDK源码
90%待验证2024-2025年，Anthropic Claude Agent SDK、OpenAI Agents SDK、Google ADK等Agent框架集中涌现
85%待验证Claude Agent SDK提供工具注册与调用、多轮对话上下文管理、智能体间消息传递与协调机制以及结构化输出控制等能力
85%待验证框架能力与推理能力解耦是AI工程领域的重要趋势，Claude Agent SDK提供Agent编排框架，实际推理可由任何兼容模型完成
75%待验证该方案的整体架构分为三层：Agent Framework层（任务管理和调度）、Claude Agent SDK层（核心Worker）、LiteLLM Proxy层（请求代理转发）
60%待验证通过LiteLLM Proxy将Claude Agent SDK连接本地大模型的方案，可以将API调用成本从每个简单任务近1美金降至几乎为零
60%待验证Claude Agent SDK 包内置了原生 Claude Code 二进制文件，大多数机器无需额外安装。
50%待验证Claude Agent SDK 不会自动加载 .env 文件，需要在运行代理的 shell 中设置 ANTHROPIC_API_KEY 环境变量，或使用 dotenv 等在 SDK 启动前手动加载。
50%待验证Claude Agent SDK 默认使用 tool search 延迟加载 MCP 工具 schema，以避免大型服务器一开始就占用上下文窗口。
50%待验证Claude Agent SDK 中工具请求的检查顺序为：hooks → deny 规则 → ask 规则 → 权限模式 → allow 规则 → can use tool 回调（默认模式下无回调即拒绝）。
50%待验证在 Claude Agent SDK 的权限系统中，allowed 列表仅表示预批准，未列出的工具不会被关闭，而是进入权限模式处理；要移除工具必须将其裸名称放入 disallowed 列表。
50%待验证Claude Agent SDK 的权限模式常见取值包括 default（未预批准调用需回调确认，无回调即拒绝）、acceptEdits（自动接受文件编辑）、dontAsk（未预批准即拒绝）和 bypassPermissions（跳过全部权限检查）。
50%待验证在 Claude Agent SDK 中，MCP 工具的完全限定名为 mcp__服务器名__工具名（用双下划线连接），该完整字符串必须一字不差地出现在 allowed 列表中，否则调用会落到权限模式。
50%待验证Claude Agent SDK 中未捕获的工具异常不会终止代理循环，服务器会将其转换为携带原始异常信息的错误结果。
50%