npm install @anthropic-ai/claude-agent-sdk
# 或
yarn add @anthropic-ai/claude-agent-sdkimport asyncio
from claude_agent_sdk import query, ClaudeAgentOptions
async def main():
# 使用异步流式 API 执行编程任务
async for event in query(
prompt="将项目中所有的 var 声明改为 const 或 let，并修复 ESLint 错误",
options=ClaudeAgentOptions(
model="claude-sonnet-5", # 指定模型版本
allowed_tools=["Read", "Edit", "Bash(npm test *)"], # 自动批准的窄范围工具
permission_mode="dontAsk", # 未命中 allow 规则的工具直接拒绝
cwd="/path/to/project", # 工作目录
max_turns=20 # 最大对话轮次
),
):
# 生产日志不要直接输出完整 event，避免泄露 prompt、工具参数或文件片段
# Python SDK 的消息对象按类区分（UserMessage/AssistantMessage/ResultMessage...），
# 没有 .type 字段，记录类名即可
print({"type": type(event).__name__})
asyncio.run(main())import { query } from "@anthropic-ai/claude-agent-sdk";
async function generateTests(filePath: string) {
const events = [];
for await (const event of query({
prompt: `为 ${filePath} 中的所有公共函数生成单元测试，使用 Jest 框架`,
options: {
model: "claude-sonnet-5",
cwd: process.cwd(),
allowedTools: ["Read", "Edit", "Bash(npm test *)"],
permissionMode: "dontAsk",
maxTurns: 15,
},
})) {
events.push(event);
// 生产日志不要直接输出完整 event，避免泄露 prompt、工具参数或文件片段
console.log({ type: event.type });
}
return events;
}
// 使用示例
generateTests("./src/utils/parser.ts").then((events) => {
console.log({ eventCount: events.length });
});# .github/workflows/ai-review.yml
name: AI Code Review
on: [pull_request]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Run Claude Review
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
run: |
pip install claude-agent-sdk
python scripts/ai_review.py --pr ${{ github.event.pull_request.number }}// VS Code Extension 示例
vscode.commands.registerCommand('claude.fixIssue', async () => {
const editor = vscode.window.activeTextEditor;
const diagnostics = vscode.languages.getDiagnostics(editor.document.uri);
const events = [];
for await (const event of query({
prompt: `修复以下问题：${diagnostics.map(d => d.message).join(', ')}`,
options: {
cwd: vscode.workspace.rootPath,
allowedTools: ['Read', 'Edit'],
permissionMode: 'dontAsk',
},
})) {
events.push(event);
}
if (events.length > 0) {
vscode.window.showInformationMessage('问题已修复！');
}
});import asyncio
import os
from claude_agent_sdk import query, ClaudeAgentOptions
async def migrate_file(filepath: str):
async for event in query(
prompt=f"将 {filepath} 从 Python 2 迁移到 Python 3，保持功能不变",
options=ClaudeAgentOptions(
cwd="./legacy_project",
allowed_tools=["Read", "Edit"],
permission_mode="dontAsk",
),
):
print({"type": type(event).__name__})
async def main():
for root, dirs, files in os.walk("./legacy_project"):
for file in files:
if file.endswith(".py"):
await migrate_file(os.path.join(root, file))
asyncio.run(main())import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions
async def main():
try:
async for event in query(
prompt="...",
options=ClaudeAgentOptions(cwd=".", allowed_tools=["Read"], permission_mode="dontAsk"),
):
print({"type": type(event).__name__})
except Exception as e:
print(f"SDK 调用失败：{e}")
asyncio.run(main())