用途:帮助构建 AI 智能体,并以编程方式自动化 Claude Code。该技能聚焦 Claude Code 的无头模式与 Agent SDK,而非原始 Anthropic API。
主要能力:Claude Agent SDK Python(封装 Claude Code CLI,支持自定义工具与 hooks 的编程式智能体创建);无头/打印模式(通过 claude -p 在 CLI、脚本、CI/CD 中运行 Claude Code);CLI 参考(命令、标志与配置选项)。认证来自已有的 ~/.claude/ 配置,无需 API 密钥。
使用方式:优先使用 claude -p 或 claude_agent_sdk;避免 anthropic.Anthropic()、anthropic.messages.create() 或需要 ANTHROPIC_API_KEY 的写法。常见路径:一次性查询用 claude -p "query";自定义智能体用 Agent SDK 的 ClaudeSDKClient;自定义工具用带 @tool 装饰器的 SDK MCP 服务器;控制执行用 HookMatcher;流式响应用 --output-format stream-json;结构化数据用 --json-schema;继续对话用 --continue 或 --resume;CI/CD 中用 claude -p 配合 --allowedTools。
适用场景:CI/CD 流水线、代码审查、自定义分析工具、数据库查询智能体等。
限制:Agent SDK 仅支持 Python 3.10+,不覆盖 JavaScript 等绑定;需先安装并认证 Claude Code CLI;不覆盖原始 Anthropic API;SDK 启动的智能体进程默认临时,持久化需显式 --resume 或捕获会话 ID;MCP 服务器模式使用 stdio 传输,HTTP 传输需另行配置。安全上勿在生产使用 --dangerously-skip-permissions,校验自定义工具输入,用权限规则阻止破坏性命令,用 --max-budget-usd 设预算上限。