Claude Code SDK

Not: yukarıdaki video, artık çalışmayan eski bir package adı kullanıyor. Güncel sürüm için aşağıdaki metni takip edin.

Agent SDK, Claude Code’u kendi uygulamalarınızdan ve script’lerinizden programatik olarak çalıştırmanıza olanak tanır. TypeScript ve Python için kullanılabilir ve CLI’ın kullandığı aynı agent loop’u — dosya okuma, düzenleme, tool kullanımı — sizin kontrolünüz altında verir.

Kurulum

Proje için bir dizin oluşturun ve SDK package’ını kurun:

mkdir sdk-demo
cd sdk-demo
npm init -y
npm install @anthropic-ai/claude-agent-sdk

Package adı @anthropic-ai/claude-agent-sdk’dir. (Benzer isimli @anthropic-ai/claude-code CLI’ın kendisidir ve import edilemez.)

Minimal bir örnek

Editörünüzü kullanarak index.mjs adlı bir dosya oluşturun (veya terminalde nano index.mjs) ve şunu yapıştırın:

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

const prompt = "List the files in the current directory";

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

Çalıştırın:

node index.mjs

Bir JSON mesaj akışı göreceksiniz — CLI’da göreceğiniz aynı conversation event’leri, tool çağrıları, tool sonuçları ve Claude’un metni dahil.

Tool’ları kısıtlamak

Varsayılan olarak SDK, tam tool setine erişime sahiptir. Daraltmak için allowedTools parametresini geçin:

for await (const message of query({
  prompt,
  options: { allowedTools: ["Read", "Glob"] },
})) {
  // ...
}

Bu, CLI’ın --allowedTools flag’inin SDK karşılığıdır.

Sonraki adımlar

SDK, CLI’ın yaptığı her şeyi destekler: custom system prompt’ları, MCP server’lar, hooks, subagents ve session devamı. Tam referans için Agent SDK documentation’a bakın.