Claude API Anahtarını Kullanma: Eksiksiz Kılavuz 2025

\n\n## Giriş

Claude, Anthropic tarafından geliştirilen ve yaratıcı içerik oluşturmaktan ayrıntılı açıklamalar sağlamaya kadar çok çeşitli görevleri yerine getirebilen güçlü bir yapay zeka asistanıdır. Claude'un yeteneklerine programlı olarak erişmek için bir API anahtarına ihtiyacınız vardır. Bu kılavuz, Claude API anahtarınızı edinme ve kullanma sürecinde size yol gösterecek ve net, uygulanabilir adımlar sağlayacaktır.

Bu kılavuz, programlama kavramları hakkında temel bir anlayışa sahip olduğunuzu ve API'leri kullanmaya aşina olduğunuzu varsayar. Claude ile ilgili önceden deneyim gerekmez. Bu eğitimin sonunda, Claude API'si ile kimlik doğrulaması yapabilecek ve ilk API çağrınızı yapabileceksiniz.

Ön Koşullar

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

• Bir Anthropic Hesabı: API'lerine erişmek için Anthropic ile bir hesabınızın olması gerekir. Anthropic web sitesine gidin ve bir hesaba kaydolun.
• API Anahtarı: Anthropic'ten bir API anahtarı almanız gerekir. Bu anahtar, Claude API'sine yaptığınız isteklerin kimliğini doğrulamak için gereklidir.
• Programlama Ortamı: Bir programlama dili (örneğin, Python, Node.js) seçin ve geliştirme ortamınızı kurun. Bu kılavuzda, örnekler için öncelikle Python kullanılacaktır.
• Paket Yöneticisi: Bir paket yöneticisinin kurulu olduğundan emin olun (örneğin, Python için pip, Node.js için npm).
• Temel Programlama Bilgisi: Değişkenler, fonksiyonlar ve HTTP istekleri yapma gibi temel programlama kavramları hakkında temel bir anlayış gereklidir.

Adım 1: Bir Anthropic Hesabına Kaydolun

Henüz bir Anthropic hesabınız yoksa, bir tane oluşturmanız gerekir.

1. Anthropic Web Sitesini Ziyaret Edin: Resmi Anthropic web sitesine (anthropic.com) gidin.
2. Kaydolun: Bir "Kaydol" veya "Başlayın" düğmesi arayın. Kesin ifade değişebilir.
3. Bilgi Sağlayın: Adınız, e-posta adresiniz ve şifreniz gibi gerekli bilgileri doldurun.
4. E-postanızı Doğrulayın: Anthropic'ten gelen bir doğrulama e-postası için e-posta gelen kutunuzu kontrol edin. Hesabınızı onaylamak için doğrulama bağlantısını tıklayın.
5. Profili Tamamlayın (Gerekirse): Bazı platformlar, e-postanızı doğruladıktan sonra profil bilgilerinizi tamamlamanızı isteyebilir.

Adım 2: Claude API Anahtarınızı Alın

Bir Anthropic hesabınız olduğunda, API anahtarınızı alabilirsiniz.

1. Giriş Yapın: Web sitelerinde Anthropic hesabınıza giriş yapın.
2. API Ayarlarına Gidin: "API Anahtarları", "Geliştiriciler" veya "Hesap Ayarları" ile ilgili bir bölüm arayın. Konum, Anthropic web sitesi düzenine bağlı olarak değişebilir.
3. API Anahtarı Oluşturun: Yeni bir API anahtarı oluşturma seçeneğini tıklayın. Anahtar için bir ad veya açıklama sağlamanız gerekebilir.
4. Güvenli Bir Şekilde Kopyalayın ve Saklayın: Anahtar oluşturulduktan sonra, güvenli bir yere kopyalayın. Bu çok önemlidir çünkü sayfayı kapattıktan sonra anahtarı tekrar göremezsiniz. Bir parola yöneticisi gibi güvenli bir şekilde saklayın ve Git gibi sürüm kontrol sistemlerine göndermekten kaçının.

Adım 3: Programlama Ortamınızı Kurun

Şimdi, Claude API'sini kullanmak için programlama ortamınızı kurun. Bu örnekte Python kullanacağız.

1. Python'ı Yükleyin: Python kurulu değilse, resmi Python web sitesinden (python.org) en son sürümü indirin ve yükleyin.

2. Anthropic Python Kütüphanesini Yükleyin: Terminalinizi veya komut isteminizi açın ve Anthropic Python kütüphanesini yüklemek için pip'i kullanın:

   pip install anthropic
   

   Bu komut, Claude API'si ile etkileşim kurmak için gerekli Python kütüphanesini indirir ve yükler.

3. Kurulumu Doğrulayın: Kütüphanenin doğru şekilde kurulduğunu doğrulamak için terminalinizde aşağıdaki komutu çalıştırın:

   pip show anthropic
   

   Bu, sürümü ve konumu dahil olmak üzere kurulu Anthropic kütüphanesi hakkında bilgi görüntülemelidir.

Adım 4: Claude API'si ile Kimlik Doğrulayın

Claude API'sini kullanabilmeniz için, API anahtarınızı kullanarak isteklerinizin kimliğini doğrulamanız gerekir.

1. Anthropic Kütüphanesini İçe Aktarın: Python betiğinizde Anthropic kütüphanesini içe aktarın:

   import anthropic
   

2. API Anahtarını Ayarlayın: ANTHROPIC_API_KEY ortam değişkenini ayarlayın veya istemciyi oluştururken API anahtarını doğrudan iletin.

   Seçenek 1: Ortam Değişkenini Kullanma (Önerilir):

   ANTHROPIC_API_KEY ortam değişkenini işletim sisteminizde ayarlayın. Bu, anahtarı betiğinizde sabit kodlamanızı önler.

   • Linux/macOS:

     export ANTHROPIC_API_KEY="SİZİN_API_ANAHTARINIZ"
     

   • Windows:

     set ANTHROPIC_API_KEY=SİZİN_API_ANAHTARINIZ
     

   SİZİN_API_ANAHTARINIZ yerine Anthropic'ten aldığınız gerçek API anahtarını yazın.

   Seçenek 2: API Anahtarını Doğrudan İletme (Daha Az Güvenli):

   Anthropic istemcisini oluştururken API anahtarını doğrudan iletebilirsiniz, ancak bu daha az güvenlidir ve üretim ortamları için önerilmez.

   client = anthropic.Anthropic(api_key="SİZİN_API_ANAHTARINIZ")
   

   SİZİN_API_ANAHTARINIZ yerine gerçek API anahtarınızı yazın.

3. Bir Anthropic İstemcisi Oluşturun: API ile etkileşim kurmak için Anthropic sınıfının bir örneğini oluşturun:

   client = anthropic.Anthropic() # ANTHROPIC_API_KEY'nin ayarlandığı varsayılarak
   

   Ortam değişkeni yöntemini kullanıyorsanız, istemci API anahtarını ortamdan otomatik olarak alacaktır.

Adım 5: İlk API Çağrınızı Yapın

Kimliğiniz doğrulandığına göre, Claude API'sine ilk API çağrınızı yapabilirsiniz. Claude'a bir mesaj göndermek ve yanıt almak için messages.create uç noktasını kullanacağız.

1. İsteminizi Hazırlayın: Claude'a göndermek için bir istem oluşturun. İstem, Claude'dan ne yapmasını istediğinizi söyleyen açık ve öz olmalıdır.

   prompt = "Okyanus hakkında kısa bir şiir yaz."
   

2. messages.create Uç Noktasını Çağırın: İsteminizi Claude'a göndermek ve bir yanıt almak için messages.create yöntemini kullanın.

   message = client.messages.create(
       model="claude-3-opus-20240229", # İstediğiniz modelle değiştirin
       max_tokens=1024,
       messages=[{"role": "user", "content": prompt}],
   )
   

   • model: Kullanmak istediğiniz Claude modelini belirtir. En son kullanılabilir modeller için Anthropic belgelerine bakın.
   • max_tokens: Oluşturulan yanıttaki maksimum jeton sayısını belirtir.
   • messages: Konuşma geçmişini temsil eden bir mesaj listesi. Her mesajın bir role ("user" veya "assistant") ve content'i vardır.

3. Yanıtı Yazdırın: Claude'un ne oluşturduğunu görmek için yanıtın içeriğini yazdırın.

   print(message.content[0].text)
   

   Bu, Claude tarafından oluşturulan şiiri yazdıracaktır.

Adım 6: Tam Örnek Kod

İşte Claude API'sine bir API çağrısı yapmak için tam Python kodu: