如何以编程方式运行 Claude Code：SDK 基础用法与集成场景

科技前沿 • 2026-04-12 10:51 • 阅读 0

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

本文已收录在Github，关注我，紧跟本系列专栏文章，咱们下篇再续！

Claude Code SDK 允许你在自己的应用或脚本中以编程方式运行 Claude Code。它支持 TypeScript、Python 以及 CLI，让你可以把终端中的 Claude 能力集成到更大的工作流程中。

claude -p “Look for duplicate queries”

import { query, SDKMessage } from “@anthropic-ai/claude-code”;

const prompt = “Look for duplicate queries”;

for await (const message of query({prompt})) {

console.log(message);

}

import anyio from claude_code_sdk import query

async def main():

prompt = "Look for duplicate queries" async for message in query(prompt=prompt): print(message)

anyio.run(main)

这个 SDK 运行的就是你熟悉的 Claude Code，本质上功能完全一致。它可以访问相同的工具，并用这些工具完成你指定的任务，因此在自动化和系统集成场景中特别强大。

下面是一个简单的 TypeScript 示例，用来让 Claude 查找重复查询：

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, }))

运行这段代码时，你会看到本地 Claude Code 与语言模型之间的完整对话过程（逐条消息输出），最后一条消息就是 Claude 的最终结果。

默认情况下，SDK 只有只读权限：可以读取文件、搜索目录、执行 grep，但不能写入或修改文件。

如果需要写权限，可以在调用时通过 allowedTools 参数开启：

for await (const message of query({ prompt, options: {

allowedTools: ["Edit"]

} }))

你也可以在 .claude 目录下的配置文件中进行全局权限设置。

Claude Code SDK 在集成到开发流程中时尤其有价值，例如：

可以把它理解为：在开发流程的任意环节中，引入 AI 能力，实现更智能的自动化处理。