Source: https://aiprimetech.io/zh/claude-code/sdk/

[首页](/zh/) › [Claude Code](/claude-code/zh/) › Agent SDK

[概览](/claude-code/zh/)[安装](/claude-code/zh/install/)[CLI 参考文档](/zh/claude-code/cli/)[定价与限制](/claude-code/zh/pricing/)[Agent SDK](/zh/claude-code/sdk/)[技能与插件](/zh/claude-code/skills/)[GitHub](/zh/claude-code/github/)[网页、桌面与 IDE](/zh/claude-code/web-and-desktop/)[模型](/zh/claude-code/models/)[错误](/zh/claude-code/errors/)[是否开源？](/zh/claude-code/open-source/)[教程](/claude-code/zh/tutorial/)[学生指南](/zh/claude-code/for-students/)[QA 自动化](/zh/claude-code/qa-automation/)[与 Cursor 对比](/zh/claude-code/vs-cursor/)[与 Codex 和 OpenCode 对比](/zh/claude-code/vs-codex/)[子智能体](/zh/claude-code/subagents/)[钩子](/zh/claude-code/hooks/)[MCP](/zh/claude-code/mcp/)[生态系统](/zh/claude-code/ecosystem/)[VS Code](/zh/claude-code/vscode/)[OpenRouter](/zh/claude-code/openrouter/)[速率限制](/zh/claude-code/rate-limits/)[中文指南](/claude-code/zh/)

最后更新：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 创建账户](/register?promo=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 密钥](/register?promo=CLAUDECODE) [查看不限量方案](/zh/plans/)

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

## 更多 Claude Code 指南

[Claude Code：完整指南](/claude-code/zh/)[如何安装 Claude Code](/claude-code/zh/install/)[Claude Code CLI 文档：命令与参数](/zh/claude-code/cli/)[Claude Code 定价与限制详解](/claude-code/zh/pricing/)[Claude Code 技能与插件](/zh/claude-code/skills/)[在 GitHub 中使用 Claude Code：App、Action 和 @claude](/zh/claude-code/github/)[Claude Code 有网页界面吗？网页、桌面与 IDE 版本详解](/zh/claude-code/web-and-desktop/)[Claude Code 使用哪个模型，以及如何更改](/zh/claude-code/models/)[Claude Code 错误及修复方法](/zh/claude-code/errors/)[Claude Code 开源吗？](/zh/claude-code/open-source/)[Claude Code 教程：您的首次实际会话](/claude-code/zh/tutorial/)[学生使用 Claude：Claude Code、API，以及教育优惠实际提供什么](/zh/claude-code/for-students/)[如何使用 Claude Code 实现 QA 自动化](/zh/claude-code/qa-automation/)[Claude Code 与 Cursor 对比：如何选择、何时使用，以及如何同时使用两者](/zh/claude-code/vs-cursor/)[Claude Code、Codex 与 OpenCode：终端智能体对比](/zh/claude-code/vs-codex/)[Claude Code 子智能体：工作原理、定义方法与智能体团队](/zh/claude-code/subagents/)[Claude Code 钩子：以确定性方式控制智能体的行为](/zh/claude-code/hooks/)[Claude Code MCP：连接服务器、作用域、远程 MCP 与实际示例](/zh/claude-code/mcp/)[Claude Code 生态系统：路由器、框架、插件及收录它们的清单](/zh/claude-code/ecosystem/)[在 VS Code 中使用 Claude Code：扩展、终端方式与常见错误](/zh/claude-code/vscode/)[如何在 Claude Code 中使用 OpenRouter（以及何时不宜使用）](/zh/claude-code/openrouter/)[Claude 速率限制错误：“API error: rate limit reached”的含义与解决方法](/zh/claude-code/rate-limits/)[Claude Code 怎么用：从安装到日常使用](/claude-code/zh/)