自动化 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常见问题
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 的公开文档为依据,且经常发生变化;本页面的价格和模型列表读取自此网关的实时设置。