程序化调用：Claude Code SDK

Claude Code SDK 把 Claude Code 从"命令行工具"变成了"可调用的模块"。你可以在 CI/CD 流程里跑代码审查、在 Git Hook 里做提交质量检查、用脚本批量处理代码任务——把 Claude Code 嵌入到任何自动化工作流里。

SDK 和命令行的关系

• SDK 不是另一套系统，它就是命令行版本的程序化封装
• 同样的功能，同样的配置文件，同样的权限控制
• 区别只是触发方式：命令行你手动输入，SDK 是代码调用

基本用法（TypeScript）

• import { query } from "@anthropic-ai/claude-code";
• for await (const message of query({ prompt: "你的任务描述" })) {
• console.log(message);
• }
• 返回的是异步迭代器，每条消息流式输出

权限控制

• 默认只读：SDK 启动时只有读取权限，不能修改文件
• 授权写操作：传入 allowedTools 参数，列出允许的工具
• 例：{ prompt: "...", allowedTools: ["Edit", "Write"] }
• 也可以在全局 .claude/settings.json 里预先配置，就不用每次传参数

典型应用场景

• Git Pre-commit Hook：提交前自动检查代码质量
• CI/CD Pipeline：每次合并前自动做安全审查
• 批量文档生成：扫描所有函数，批量生成注释
• 自动化测试生成：根据代码变更自动补充相关测试