从Claude Agent SDK开始，了解智能代理

R
ryan j January 25, 2026

什么是 Claude Agent SDK？

简单来说，它是一个 开发框架 / 库，可以让开发者用 Claude 作为“智能大脑” 来构建自动化代理，这些代理具备：

  • 读取文件、执行命令、搜索网络等工具能力
  • 自动管理对话上下文，不容易跑出上下文限制
  • 运行复杂工作流而不是单次问答
  • 支持 Python 和 TypeScript/Node.js 开发语言环境

智能代理运行时（Agent Loop）

SDK 内置了完整的 代理循环（agent loop），包括：

  • 决策：理解任务
  • 计划：选择正确的工具与步骤
  • 执行：调用工具（如文件、命令、网络等）
  • 校验：检查执行结果并继续下一步

这意味着你不用自己去写协调逻辑，只需 query() 一句，SDK 帮你把任务分解、执行、反馈。

📌 与传统的 LLM API 比较不同，Agent SDK 不只是单个 prompt → response，它是 长期运行、状态持久、可以执行操作的系统。

支持哪些功能和工具？

SDK 提供了很多内置功能，包括但不限于：

  • 文件操作（读取、编辑、创建文件）
  • 命令执行（运行 shell 或脚本）
  • 代码编辑和生成
  • 网络搜索、API 调用等（通过 MCP 标准集成）
  • 管理权限与工具权限控制机制（防止危险操作）

支持哪些底层模型？

  • SDK 内部通过 Claude Code 运行时来驱动 agent 逻辑和工具执行。
  • 你需要设置 ANTHROPIC_API_KEY 并连接到 Anthropic 的 API 进行身份验证。

所以从官方设计来看：它本质上 支持 Claude 系列模型（比如 Claude Agent / Claude Code），并且是围绕这一生态构建的。

但可以通过第三方 API 提供者接入其他平台

文档里明确提到，你可以通过一些环境变量配置，让 SDK 使用：

  • Amazon Bedrock
  • Google Vertex AI
  • Microsoft Foundry

作为底层模型提供者（不过仍需这些平台的凭据和设置）。

对比Codex Cli

我自己的理解：

  • codex-cli 是「AI 工具」
  • Claude Agent SDK 是「开发者用来“造 AI 代理”的工具」

使用 claude agent开发一个代理的流程

需求
 ↓
定义 Agent 角色
 ↓
定义 Agent 能做什么（工具）
 ↓
配置 Agent 规则 & 权限
 ↓
启动 Agent Loop
 ↓
观察 / 记录 / 优化

1️⃣ 明确需求

确定你要开发什么 agent，它的角色是什么，负责哪些任务，以及怎样的输出才算成功，避免一开始目标模糊。

2️⃣ 定义角色

为 agent 编写长期有效的 system prompt，明确它的身份、职责、工作风格和基本规则，而不是一次性的问答提示。

3️⃣ 配置工具

决定 agent 可以使用哪些工具，例如读写文件、执行命令或访问 API，只授予必要权限，避免 agent 行为失控。

4️⃣ 启动代理

通过 Claude Agent SDK 传入目标和配置，启动 agent loop，让 agent 自行拆解任务并按步骤执行。

5️⃣ 观察行为

查看 agent 的执行过程和工具调用顺序，判断它是否按预期工作，是否存在重复、偏离目标或失败情况。

6️⃣ 迭代优化

根据运行结果不断调整角色描述、工具权限和输出格式，使 agent 更稳定、更高效。

7️⃣ 系统集成

将成熟的 agent 接入定时任务、API 或多 agent 流程中，成为系统的一部分，而不是一次性脚本。

对比Langchain

Claude Agent SDK 提供现成的 agent 执行引擎，让你快速打造可运行的 agent；LangChain 提供框架和工具，让你自己搭建 agent 的结构与流程。

参考文档