首页 › Claude Code › Agent SDK
概览安装CLI 参考文档定价与限制Agent SDK技能与插件GitHub网页、桌面与 IDE模型错误是否开源?教程学生指南QA 自动化与 Cursor 对比与 Codex 和 OpenCode 对比子智能体钩子MCP生态系统VS CodeOpenRouter速率限制中文指南
最后更新:2026 年 11 月

Claude Code SDK,现已更名为 Claude Agent SDK

终端中运行的同一套智能体循环,也可以作为库使用。当人们显然开始用它构建远不止编程工具的应用时,Anthropic 将 Claude Code SDK 更名为 Claude Agent SDK。

TLDR

  • Python: pip install claude-agent-sdk;TypeScript: npm install @anthropic-ai/claude-agent-sdk.
  • 你可以通过代码驱动完整的智能体——文件工具、bash、子智能体、MCP——并使用权限回调。
  • SDK 与 CLI 一样会读取 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY,因此适用网关计费。

自动化 Claude Code 的两种方式

轻量方式是使用 CLI 的打印模式—— claude -p 可使用任何语言,并输出 JSON 格式。完整的实现方式是使用 Agent SDK,它将循环、工具集、钩子和权限暴露为由你控制的对象。

Python

import anyio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    options = ClaudeAgentOptions(
        allowed_tools=["Read", "Edit", "Bash"],
        max_turns=8,
    )
    async for message in query(
        prompt="add type hints to utils.py and run the tests",
        options=options,
    ):
        print(message)

anyio.run(main)

TypeScript

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

for await (const message of query({
  prompt: "find and fix the flaky test in this repo",
  options: { allowedTools: ["Read", "Edit", "Bash"], maxTurns: 8 },
})) {
  console.log(message);
}

通过网关运行

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
python agent.py

SDK 会启动同一个 Claude Code 运行时,因此只需配置环境变量。对于长时间运行的智能体,网关定价尤为重要:自主循环每小时可能发起数百次调用,而固定费率套餐可将预估成本变为固定金额。

SDK 相比打印模式增加了什么

  • 权限回调——通过你自己的代码批准或拒绝每次工具调用。
  • 通过进程内 MCP 服务器提供自定义工具,让智能体能够调用你的函数。
  • 针对工具事件、会话生命周期和错误的钩子。
  • 支持子智能体和结构化输出,无需调用 shell 并解析文本。

先免费试用

新账户可获得 $5 免费 API 额度 使用优惠码 CLAUDECODE — 足够用 Sonnet 运行 Claude Code 一晚,之后可获得面值 7.69231 倍的额度。

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

使用优惠码 CLAUDECODE 创建账户

常见问题

Claude Code SDK 和 Anthropic SDK 是同一个吗?

不是。Anthropic SDK 直接调用 Messages API。Claude Agent SDK(原名 Claude Code SDK)则在其之上运行完整的智能体,包括工具、文件、bash 和子智能体。

Agent SDK 支持哪些语言?

官方支持 Python 和 TypeScript;其他语言都可以驱动 CLI 的打印模式,获得 JSON 格式的输出。

SDK 支持自定义基础 URL 吗?

支持。它与 CLI 完全一样,会从环境中继承 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY。

通过网关运行 Claude Code

相同的模型,两个环境变量,面值 7.69231 倍的额度,或固定费率不限量方案。 新账户:使用优惠码 CLAUDECODE 可获得 $5 免费 API 额度。

获取 API 密钥 查看不限量方案

AI Prime Tech 是独立的 API 网关,与 Anthropic 无关联,也未获得其认可或赞助。“Claude”和“Claude Code”是 Anthropic 的商标。此处介绍的 Claude Code 功能以撰写时 Anthropic 的公开文档为依据,且经常发生变化;本页面的价格和模型列表读取自此网关的实时设置。

更多 Claude Code 指南

Claude Code:完整指南如何安装 Claude CodeClaude Code CLI 文档:命令与参数Claude Code 定价与限制详解Claude Code 技能与插件在 GitHub 中使用 Claude Code:App、Action 和 @claudeClaude Code 有网页界面吗?网页、桌面与 IDE 版本详解Claude Code 使用哪个模型,以及如何更改Claude Code 错误及修复方法Claude Code 开源吗?Claude Code 教程:您的首次实际会话学生使用 Claude:Claude Code、API,以及教育优惠实际提供什么如何使用 Claude Code 实现 QA 自动化Claude Code 与 Cursor 对比:如何选择、何时使用,以及如何同时使用两者Claude Code、Codex 与 OpenCode:终端智能体对比Claude Code 子智能体:工作原理、定义方法与智能体团队Claude Code 钩子:以确定性方式控制智能体的行为Claude Code MCP:连接服务器、作用域、远程 MCP 与实际示例Claude Code 生态系统:路由器、框架、插件及收录它们的清单在 VS Code 中使用 Claude Code:扩展、终端方式与常见错误如何在 Claude Code 中使用 OpenRouter(以及何时不宜使用)Claude 速率限制错误:“API error: rate limit reached”的含义与解决方法Claude Code 怎么用:从安装到日常使用