Claude Code SDK

Claude Code SDK 让你可以在应用或脚本中以编程方式调用 Claude Code。它提供 TypeScript、Python 以及 CLI 方式，功能与终端中的 Claude Code 一致。

SDK 运行的就是你熟悉的 Claude Code，同样具备完整工具集，适用于自动化与系统集成。

关键特性

• 支持编程方式调用 Claude Code
• 功能与终端版本一致
• 继承同目录下 Claude Code 的设置
• 默认只读权限
• 适合嵌入更大的自动化流程

基础用法

以下是一个 TypeScript 示例，用于查找重复查询：

import { query } from "@anthropic-ai/claude-code";

const prompt = "Look for duplicate queries in the ./src/queries dir";

for await (const message of query({
  prompt,
})) {
  console.log(JSON.stringify(message, null, 2));
}

运行后你会看到 Claude Code 与模型之间的完整消息流，最终消息即 Claude 的完整响应。

权限与工具

SDK 默认是只读模式，只能读取与检索文件，无法写入或编辑。如果需要写权限，可以在调用时传入 allowedTools：

for await (const message of query({
  prompt,
  options: {
    allowedTools: ["Edit"]
  }
})) {
  console.log(JSON.stringify(message, null, 2));
}

也可以在项目的 .claude 设置文件中进行全局授权。

实用场景

• 在 Git hooks 中自动评审改动
• 在构建脚本中分析和优化代码
• 辅助维护任务的工具命令
• 自动生成文档
• CI/CD 中的代码质量检查

SDK 让你把 AI 能力融入任意开发环节，是自动化与集成场景的强大基础设施。