Claude Agent SDK #1：query() 函数全解——三行代码启动一个自主 Agent

from claude_agent_sdk import query, ClaudeAgentOptions

async for message in query(
    prompt="找出 auth.py 里会崩溃的 bug 并修复",
    options=ClaudeAgentOptions(
        allowed_tools=["Read", "Edit", "Glob"],
        permission_mode="acceptEdits",
    ),
):
    if hasattr(message, "result"):
        print(message.result)

• allowed_tools：预授权工具列表，列在里面的工具 Claude 可以直接调用，不需要每次询问
• permission_mode：权限模式（见下）
• system_prompt：给 Claude 的角色定制指令

• Read / Write / Edit：读写文件，Edit 可精确按行范围替换
• Bash：执行终端命令、git 操作、跑测试
• Glob / Grep：按模式搜文件路径、正则搜文件内容
• WebSearch / WebFetch：联网搜索 + 抓取页面内容
• Monitor：监听后台脚本输出，逐行触发响应
• AskUserQuestion：向用户提问（带多选选项）

• ["Read", "Glob", "Grep"] → 只读分析，最安全
• ["Read", "Edit", "Glob"] → 分析 + 改代码
• ["Read", "Edit", "Bash", "Glob", "Grep"] → 全自动化（写代码 + 跑测试 + 修复）

async for message in query(prompt="...", options=...):
    if isinstance(message, AssistantMessage):
        for block in message.content:
            if hasattr(block, "text"):
                print(block.text)       # Claude 的思考过程
            elif hasattr(block, "name"):
                print(f"工具调用: {block.name}")  # 工具名
    elif isinstance(message, ResultMessage):
        print(f"完成: {message.subtype}")  # 最终结果

参考文档

• 1
• 2