Claude Kod SDK'sı: Kapsamlı Rehber

Yazılım geliştirme dünyası, yapay zekanın gücüyle yönlendirilen dönüştürücü bir değişimin ortasında bulunuyor. Yapay zeka destekli araçlar artık fütüristik bir konsept değil, geliştiricilerin yeteneklerini artıran ve iş akışlarını düzenleyen günümüz gerçekliğidir. Bu devrimin ön saflarında, özellikle kodlama görevleri için tasarlanmış güçlü bir yapay zeka modeli olan Anthropic'in Claude Code'u yer alıyor. Geliştiricilerin bu en son teknolojiyi kendi uygulamalarına ve iş akışlarına sorunsuz bir şekilde entegre etmelerini sağlamak için Anthropic, Claude Code SDK'sını yayınladı. Bu kapsamlı kılavuz, Claude Code SDK'sını derinlemesine inceleyecek, özelliklerini ve işlevlerini keşfedecek ve farklı programlama ortamlarında kullanımına ilişkin adım adım bir yol haritası sunacaktır.

💡

Yapay Zeka API'lerini saniyeler içinde test etmek ister misiniz? Apidog, Claude, GPT veya herhangi bir yapay zeka uç noktasını tek bir temiz kullanıcı arayüzünde tasarlamanıza, taklit etmenize ve test etmenize olanak tanır; Postman veya koda gerek yok. Tam yapay zeka yığınınızı istemden üretime kadar zahmetsizce oluşturun.

button

Claude Code ve Claude Code SDK Nedir?

SDK'nın ayrıntılarına dalmadan önce, onu güçlendiren temel teknolojiyi anlamak önemlidir. Claude Code, Anthropic'ten büyük bir dil modelidir (LLM) ve devasa bir kod veri kümesi üzerinde titizlikle eğitilmiştir. Bu özel eğitim, geniş bir programlama dili yelpazesinde yüksek derecede yeterlilikle kodu anlamasını, üretmesini ve kod hakkında akıl yürütmesini sağlar. Şablon kod üretmekten karmaşık algoritmalar yazmaya, hata ayıklamadan kod parçacıklarını açıklamaya kadar Claude Code, her geliştiricinin araç setinde çok yönlü bir araçtır.

Claude Code SDK (Yazılım Geliştirme Kiti), geliştiricilerin Claude Code modeliyle programlı olarak etkileşim kurmasını sağlayan bir köprü görevi görür. Geliştiriciler, bir web arayüzüyle sınırlı kalmak yerine, Claude Code'un tüm potansiyelinden yararlanan özel uygulamalar, betikler ve entegrasyonlar oluşturmak için SDK'dan yararlanabilirler. İster kişiselleştirilmiş bir kodlama yardımcısı oluşturmak, CI/CD hattınızdaki kod incelemelerini otomatikleştirmek veya kodu bir dilden diğerine çevirebilen bir araç oluşturmak isteyin, Claude Code SDK fikirlerinizi hayata geçirmek için gerekli araçları ve arayüzleri sağlar.

SDK kullanmanın birincil faydası, etkileşimli, tek seferlik sorguların ötesine geçerek otomatik, programlı kontrol dünyasına adım atma yeteneğidir. Bu, yapay zekayı yazılım geliştirme yaşam döngüsünün dokusuna entegre etmek için geniş bir olasılıklar manzarasını açar.

Başlarken: Claude Code SDK ile İlk Adımlarınız

Claude Code SDK ile yolculuğunuza başlamak basit bir işlemdir. Başlamak için ihtiyacınız olanlar şunlardır:

Önkoşullar

Claude Code API'ye çağrı yapmaya başlamadan önce bir API anahtarına ihtiyacınız olacaktır. Bu anahtar, isteklerinizin kimliğini doğrular ve bunları Anthropic hesabınıza bağlar. Anthropic Konsolu'nda özel bir API anahtarı oluşturabilirsiniz. Daha iyi güvenlik ve yönetim sağlamak için özellikle SDK kullanımınız için yeni bir anahtar oluşturmanız şiddetle tavsiye edilir.

API anahtarınızı aldıktan sonra, geliştirme ortamınız tarafından erişilebilir hale getirmeniz gerekir. Önerilen yaklaşım, onu ANTHROPIC_API_KEY adlı bir ortam değişkeni olarak ayarlamaktır. Bu, anahtarı doğrudan kaynak kodunuza yazmaktan daha güvenli bir uygulamadır.

Kurulum: Seçiminizi Yapın

Claude Code SDK, farklı ortamlarda çalışan geliştiriciler için çok yönlü ve erişilebilir olacak şekilde tasarlanmıştır. Komut satırı, TypeScript ve Python için mevcuttur.

Komut Satırı Arayüzü (CLI): CLI, SDK ile etkileşim kurmanın en doğrudan yoludur ve deneyler ve basit betikler için harika bir başlangıç noktasıdır.
TypeScript SDK: Web uygulamaları oluşturan veya Node.js ortamında çalışan geliştiriciler için, NPM'de @anthropic-ai/claude-code olarak bulunan TypeScript SDK ideal seçimdir.
Python SDK: Python ekosisteminde olanlar için, PyPI'deki claude-code-sdk paketi sorunsuz bir entegrasyon deneyimi sunar.

Bunların her birinin kurulum süreci aşağıdaki ilgili bölümlerde ele alınacaktır.

Claude Code SDK'ya Derin Bir Bakış: Komut Satırından Özel Uygulamalara

Şimdi, Claude Code SDK'sını farklı ortamlarda kullanmanın pratik yönlerini keşfedelim.

Komut Satırı Arayüzü (CLI): Claude Code'a Açılan Kapınız

CLI, Claude Code ile doğrudan terminalinizden etkileşim kurmak için güçlü ve esnek bir yol sağlar.

Temel Kullanım:

Tek İstem: En temel kullanım, tek bir istem çalıştırmayı ve Claude Code'un bir yanıt oluşturmasını sağlamayı içerir.Bash

claude-code "write a python function to calculate the factorial of a number"

stdin Yönlendirme: Diğer komutların çıktısını veya bir dosyanın içeriğini girdi olarak Claude Code'a yönlendirebilirsiniz.Bash

cat my_script.py | claude-code "add type hints to this python code"

JSON Çıktısı: Programlı kullanım için çıktıyı yapılandırılmış bir JSON formatında alabilirsiniz.Bash

claude-code --json "explain this javascript code" < my_script.js

JSON Akışı: Uzun süren istekler için JSON çıktısını kullanılabilir hale geldikçe akış halinde alabilirsiniz.Bash

claude-code --stream-json "write a comprehensive unit test for this function" < my_function.go

Temel CLI Seçenekleri:

CLI, davranışını ince ayar yapmanıza olanak tanıyan zengin bir seçenek setiyle birlikte gelir:

i, --non-interactive: Etkileşimli olmayan modda çalıştırın.
f, --output-format <format>: Çıktı formatını belirtin (text, json, stream-json).
c, --continue <file>: Bir dosyadan önceki bir konuşmayı devam ettirin.
-verbose: Hata ayıklama için ayrıntılı günlük kaydını etkinleştirin.
-agentic-turns <n>: Ajan dönüşlerinin sayısını sınırlayın.
-system <prompt>: Varsayılan sistem istemini geçersiz kılın.
-allow-tool <tool> ve -disallow-tool <tool>: Harici araçlara erişimi kontrol edin.

TypeScript SDK: Modern Yapay Zeka Destekli Uygulamalar Oluşturma

TypeScript SDK, Claude Code'u web uygulamalarınıza, arka uç hizmetlerinize veya herhangi bir Node.js tabanlı projenize entegre etmek için mükemmeldir.

Kurulum:

Bash

npm install @anthropic-ai/claude-code

Temel Kullanım:

`import { claudeCode } from '@anthropic-ai/claude-code';
async function main() { const result = await claudeCode({ prompt: 'Write a TypeScript interface for a User', }); console.log(result.stdout); }
main();`

Ek Argümanlar:

TypeScript SDK, CLI tarafından desteklenen tüm argümanları ve bazı ek argümanları kabul eder:

abortController: İsteği iptal etmek için bir AbortController.
cwd: Geçerli çalışma dizini.
executable: Claude Code yürütülebilir dosyasının yolu.
executableArgs: Yürütülebilir dosyaya iletilecek ek argümanlar.

Python SDK: Python Ekosisteminde Yapay Zekayı Serbest Bırakma

Python geliştiricileri, Claude Code'un yeteneklerini betiklerine ve uygulamalarına entegre etmek için claude-code-sdk'dan yararlanabilir.

Kurulum:

Bash

pip install claude-code-sdk

Önkoşullar:

Python SDK, Python 3.10 veya üstü, Node.js ve Claude Code CLI'nın kurulu olmasını gerektirir.

Temel Kullanım:

import anyio
from claude_code_sdk import query, ClaudeCodeOptions, Message

async def main():
    messages: list[Message] = []
    
    async for message in query(
        prompt="Write a haiku about foo.py",
        options=ClaudeCodeOptions(max_turns=3)
    ):
        messages.append(message)
    
    print(messages)

anyio.run(main)

ClaudeCodeOptions sınıfı, desteklenen tüm komut satırı argümanlarını yapılandırılmış bir şekilde belirtmenize olanak tanır.

Gelişmiş Özellikler: Yapay Zeka Destekli Geliştirmenin Sınırlarını Zorlama

Temellerin ötesinde, Claude Code SDK, daha da güçlü yeteneklerin kilidini açan bir dizi gelişmiş özellik sunar.

Çok Turlu Konuşmalar: Bağlamı Korumak

Birçok geliştirme görevi karşılıklı bir diyalog gerektirir. SDK'nın çok turlu konuşma desteği, bağlamı koruyabilen ve daha doğal, etkileşimli bir his veren uygulamalar oluşturmanıza olanak tanır. Claude Code'un önceki etkileşimleri hatırlamasını ve daha ilgili yanıtlar vermesini sağlayarak, konuşma geçmişini sağlayarak bir konuşmayı sürdürebilir veya devam ettirebilirsiniz.

Özel Sistem İstemleri: Claude'un Davranışını Yönlendirme

Bir sistem istemi, yapay zeka modelinin davranışını yönlendirmek için verilen bir dizi talimattır. Claude Code SDK, özel sistem istemleri sağlamanıza olanak tanıyarak Claude Code'un yanıtlarını özel ihtiyaçlarınıza göre uyarlamanızı sağlar. Örneğin, Claude Code'a her zaman belirli bir stilde kod üretmesi, kod incelemesi sağlayan kıdemli bir geliştirici gibi davranması veya kavramları bir başlangıç seviyesindeki kişinin kolayca anlayabileceği bir şekilde açıklaması talimatını veren bir sistem istemi sağlayabilirsiniz.

Model Bağlam Protokolü (MCP): Claude'un Yeteneklerini Genişletme

Model Bağlam Protokolü (MCP), harici araçlara ve kaynaklara bağlayarak Claude Code'un yeteneklerini genişletmenize olanak tanıyan güçlü bir özelliktir. Bu, modele ek bağlam sağlayabilen bir MCP sunucusu çalıştırılarak elde edilir. Güvenlik nedenleriyle, --allowedTools bayrağını kullanarak MCP araçlarının kullanımına açıkça izin vermelisiniz. Bu, son derece özel ve güçlü yapay zeka destekli geliştirme araçları oluşturmak için heyecan verici olasılıklar açar.

Pratik Uygulamalar ve En İyi Uygulamalar: Teoriden Gerçeğe

Claude Code SDK'nın gerçek gücü, onu gerçek dünya geliştirme zorluklarına uygulamaya başladığınızda ortaya çıkar.

Gerçek Dünya Kullanım Durumları:

Yapay Zeka Destekli Kodlama Yardımcıları: IDE'nize doğrudan entegre edilmiş, gerçek zamanlı kod tamamlama, öneriler ve açıklamalar sağlayan özel bir kodlama yardımcısı oluşturun.
Otomatik Kod İncelemeleri: SDK'yı CI/CD hattınıza entegre ederek kod incelemelerini otomatikleştirin. Claude Code, yaygın hataları kontrol edebilir, iyileştirmeler önerebilir ve yeni kodun ekibinizin kodlama standartlarına uygun olduğundan emin olabilir.
Otomatik Çekme İsteği ve Sorun Yönetimi: Bir dizi değişiklikten otomatik olarak çekme istekleri oluşturabilen veya projenizin deposundaki gelen sorunları önceliklendirebilen araçlar oluşturmak için SDK'yı kullanın.

En İyi Uygulamalar:

Yanıtların Programlı Ayrıştırılması: JSON çıktı formatını kullanırken, ihtiyacınız olan bilgiyi çıkarmak için yanıtları programlı olarak ayrıştırabilirsiniz. Mesaj şemaları kesinlikle yazılmıştır ve tipler Anthropic SDK'larında mevcuttur, bu da bu süreci sağlam ve güvenilir hale getirir.
Hata Yönetimi: Herhangi bir API entegrasyonunda olduğu gibi, sağlam hata yönetimi çok önemlidir. Ağ hatalarını, API hatalarını ve diğer olası sorunları ele almak için mekanizmalar uygulayın.
Oturum Yönetimi: Çok turlu konuşmaları içeren uygulamalar için, konuşma geçmişini takip etmek için uygun oturum yönetimi uygulayın.
Zaman Aşımları ve Oran Sınırları: API oran sınırlarına dikkat edin ve uygun geri çekilme ve yeniden deneme stratejileri uygulayın. Uygulamanızın takılmasını önlemek için istekleriniz için makul zaman aşımları ayarlayın.

Claude Code GitHub Actions: SDK'nın Potansiyelinin Bir Vitrini

Claude Code SDK'nın eylemde olduğu önemli bir örnek, Claude Code GitHub Actions'dır. Bu eylem seti, çeşitli geliştirme görevlerini doğrudan GitHub iş akışlarınız içinde otomatikleştirmenize olanak tanır. Kod incelemelerini otomatikleştirmek, çekme istekleri oluşturmak ve sorunları önceliklendirmek için kullanabilirsiniz, hepsi Claude Code tarafından desteklenir. Bu, SDK'nın bir geliştirme ekibinin üretkenliğini önemli ölçüde artırabilecek pratik ve değerli araçlar oluşturmak için nasıl kullanılabileceğinin güçlü bir göstergesidir.

💡

API arka ucunuzda aynı gücü mü arıyorsunuz? Apidog, Claude çağrılarını taklit etmenize, uç durumları simüle etmenize ve canlı Swagger belgeleri oluşturmanıza olanak tanır; üretimde bozulmayacak yapay zeka uç noktaları oluşturmak için mükemmeldir.

Sonuç

Claude Code SDK, sadece bir araçtan daha fazlasıdır; yazılım geliştirmenin yeni bir çağına açılan bir kapıdır. Anthropic, Claude Code'un gücüne programlı erişim sağlayarak, geliştiricileri yeni nesil yapay zeka destekli geliştirme araçlarını oluşturmaya teşvik etmiştir. Basit bir komut satırı yardımcı programından karmaşık, entegre bir yapay zeka yardımcısına kadar olasılıklar yalnızca hayal gücünüzle sınırlıdır. Yapay zeka modelleri evrimleşmeye ve gelişmeye devam ettikçe, Claude Code SDK gibi araçların rolü yalnızca daha kritik hale gelecek ve yazılımı nasıl yazdığımızı, incelediğimizi ve sürdürdüğümüzü şekillendirecektir. Yolculuk daha yeni başladı ve Claude Code SDK, bu heyecan verici devrimin bir parçası olmak için biletinizdir.