Claude API için Eksiksiz Rehber: Kurulum, Maliyet Yönetimi ve İlk Projenizi Geliştirme

Anthropic’in Claude API’sini kullanmak, yalnızca bir sohbet botuyla konuşmanın ötesine geçmenizi sağlar. Claude AI’ın tüm yeteneklerini uygulamalarınıza entegre etme gücü verir. 

Anthropic, Fable 5’in yayınlanmasıyla yapay zeka dünyasını şaşırttı; bu model o kadar yetenekliydi ki, lansmandan kısa süre sonra ABD hükümeti erişimi geçici olarak kısıtladı. Model daha sonra dünya genelindeki kullanıcılara yeniden sunulmuş olsa da, ona erişme şeklimiz değişti.

Anthropic artık Fable 5’i yalnızca ölçülü kullanım kredileri üzerinden API tabanlı erişimle sınırlandırıyor (kesişme, kısa bir beş günlük uzatmanın ardından yürürlüğe girdi).

Bu, yapay zekâ ile etkileşim kurma biçimimizi yeniden düşünmemiz gerektiği anlamına geliyor. Yüksek güçlü modeller ve otomatik kodlama araçları, sabit ücretli tüketici planlarının sağlayabileceğinden çok daha fazla hesaplama kaynağı gerektirir.

Bu eğitimde, Claude API’sinin nasıl kullanılacağını inceleyerek sizi bu yeni gerçekliğe hazırlayacağım.

Anthropic Developer API ile Claude Code’u nasıl kuracağınızı adım adım göstereceğim. Bugün kullanım başına ödemeye geçerek Fable 5 gibi en güncel modellere kesintisiz erişim sağlayacak, görünmez hız limitlerini ortadan kaldıracak ve karmaşık kodlama oturumlarını doğrudan terminalinizden nasıl çalıştıracağınızı öğreneceksiniz.

Hızlı bir başvuru arıyorsanız, Python’da Claude API kopya kâğıdına göz atmanızı öneririm.

Claude Pro Aboneliği Yerine Neden Claude API’ye İhtiyacınız Var?

Pek çok kişi için aylık 20 $’lık Claude Pro planı, üst düzey yapay zekaya erişmenin ideal yoluydu. Sabit bir fiyat ve istikrarlı erişim sunuyordu.

Ancak, otomatik kodlama araçlarının yükselişi hesapları tamamen değiştirdi. Ajans benzeri iş akışları, standart bir aboneliğin sağlayabileceğinden çok daha fazla kaynak gerektirir ve bu da Claude API’yi ciddi geliştiriciler için tek uygulanabilir seçenek haline getirir.

Aşağıda, aboneliği bırakıp Claude Code’u doğrudan API üzerinden kullanmak için üç ana neden yer alıyor.

Ajan araçlarında token tüketimi

Standart planlar, bu araçların çalışma biçimi nedeniyle Claude Code gibi araçlarla zorlanır.

Basit bir web sohbetinden farklı olarak, otomatik bir geliştirici aracı üzerinde çalıştığı şeyi anlamak için sürekli olarak tüm projemizi taramak zorundadır.

Her görev verdiğimizde birkaç adımdan geçer: dosyaları okur, yapıları kontrol eder ve testler çalıştırır. Bu, yapay zekayı kodumuzun güncel durumu hakkında haberdar tutmak için büyük miktarda verinin ileri geri gönderilmesini gerektirir. 

Bu süreç token’ları çok hızlı tüketir. Pro aboneliğinde, bu karmaşık iş akışları birkaç dakika içinde çok saatlik kullanım limitimizi tüketerek çalışmamızı aniden durdurabilir.

Günlük kullanım kapasitenizi koruma

Claude Pro hesapları, paylaşılan tek bir kaynak havuzu kullanır. Ana hesabımızı terminal tabanlı kodlama için kullanırsak, bu ağır otomatik görevler tarayıcı veya mobil uygulamamızdaki kapasitemizden götürür.

Arka plandaki bir kodlama görevi limitimize takıldığı için basit bir konuşmanın dışına itilmek istemeyiz. Geliştirme araçlarınızı Claude API üzerinden yönlendirmek, profesyonel kodlama çalışmalarınızı günlük yapay zekâ kullanımınızdan tamamen ayrı tutar.

Ağır iş yüklerine özel modellere ayrıcalıklı erişim

Anthropic, Claude Fable 5 gibi yoğun mühendislik ve otonom çalışmalar için özel olarak tasarlanmış modeller yayınladıkça, sabit ücretli planlardan uzaklaşıyor. 

Fable 5 muazzam hesaplama gücü gerektirdiğinden, Anthropic bu özel modelin yüksek operasyonel maliyetleri yönetmek için sonunda kullanım başına faturalandırma gerektireceğini doğruladı.

Bu kısıtlama, geleceğin bir ön izlemesi. Tüketici aboneliğine bağlı kalmak, sonunda Anthropic’in en güçlü akıl yürütme motorlarına erişimi kaybedeceğiniz anlamına gelir; bu da en güncel kalmak için bir Claude API hesabını kesin bir gereklilik haline getirir.

Claude API ve Claude Aboneliği Karşılaştırması

Tüketici aboneliği ile geliştirici API’si arasındaki fark, öngörülebilir maliyetlerle kesintisiz erişim arasındaki bir ödünleşime dayanır.

Bir Claude aboneliği bize sabit bir aylık ücret verir. 

Bir süre yoğun kullanabiliriz ve sonunda sunucu yüküne bağlı dinamik bir kullanım sınırına takılırız. Claude Code bu görünmez duvara proje ortasında çarptığında tamamen çalışmayı durdurur. 

Aracın kodumuzu yazmayı bitirmesi için limitimizin sıfırlanmasını beklemek zorunda kalırız.

Claude API bu destek tekerleklerini kaldırır. Saatlik mesaj sınırları, paylaşılan bant genişliği limitleri ve bekleme süreleri yoktur. Fable 5’in sekiz saat boyunca devasa bir kod tabanını yeniden düzenlemesini istiyorsak, API tek bir kesinti olmadan her komutu memnuniyetle yürütür.

Ancak bu özgürlük önemli bir tehlikeyi beraberinde getirir: bütçe taşmaları. Abonelik kullanmak sınıra çarptığınızda sinir bozucu olabilir, ancak en azından ay sonunda faturanının ne kadar olacağını tam olarak biliriz.

Bu, Fable 5 gibi pahalı modellerde özellikle tehlikelidir.

Claude API maliyet yönetimi ve bütçe kontrolü

API’yı kullanırken bütçemizi kontrol etmenin iki yolu vardır. 

İlki, otomatik yüklemenin kapalı olduğundan emin olmaktır. Otomatik yükleme, krediler bittiğinde Claude’un otomatik olarak kredi satın almasına izin verir. 

Claude Code kullanırken token kullanımı oldukça öngörülemez olduğundan, bunu etkinleştirmemenizi şiddetle tavsiye ederim.

İkincisi ise hangi modelin kullanılacağını dikkatle seçmektir. 

Fable 5, karmaşık görevleri çözme ve karmaşık uygulamaları hayata geçirme konusunda son derece yeteneklidir. Ancak, daha basit görevler için çoğu zaman gereğinden fazladır.

Ben şahsen daha ucuz modelleri kullanmayı ve ancak daha ucuz modeller bir görevi birden fazla denemeye rağmen çözemediğinde daha pahalı modellere geçmeyi tercih ediyorum. En çok kullandığım model aslında Haiku 4.5.

Modeli seçmek için /model komutunu kullanın.

Adım Adım Claude API Kurulumu (Fable 5 Dahil)

Özel bir Claude Fable 5 API eğitimi arıyorsanız, ayrı rehberimize göz atmanızı öneririm.  

Başlamak için Claude web platformuna giriş yapın ve faturalandırmayı ayarlayın. Ardından bir terminal açın ve şu komutla Claude Code’u yükleyin:

npm install -g @anthropic-ai/claude-code

Kurulum tamamlandıktan sonra, terminalde claude yazarak çalıştırabiliriz. İlk çalıştırmada yapılandırma isteyecektir. Kurulum sırasında mutlaka “API usage billing” seçeneğini işaretleyin:

Sonunda Claude tarayıcıyı açacak ve hesabımızı bağlamak ve bizim için bir API anahtarı oluşturmak için izin isteyecektir. “Authorize”a tıklayın; hesap otomatik olarak bağlanır.

Kurulum tamamlandıktan sonra, Claude Code ile geliştirmeye başlamaya hazırız:

Benim durumumda Claude Code zaten Fable 5 ile çalışıyor. Böyle değilse, /model komutunu kullanarak modeli seçebilir ve menüden Fable 5’i belirleyebiliriz.

Claude Code’u abonelikten API’ye geçirme

Claude Code’u hâlihazırda abonelikle kullanan ve API kullanım faturalandırmasına geçmek isteyenler için süreç basittir.

1. /logout komutunu kullanarak çıkış yapın.
2. claude komutuyla Claude Code’u yeniden çalıştırın ve giriş yöntemi olarak “Anthropic Console account · API usage billing” seçeneğini seçin.

Claude Code bir özelliği uygulamanın ortasındayken kredilerimiz biterse, duracak ve kredi eklememiz gerektiğini bildirecektir. 

Kredi ekledikten sonra, Claude hâlâ açıksa, bir istem vererek devam etmesini isteyin; kaldığı yerden devam edecektir. Çalışmıyorsa claude --continue komutunu kullanın.

Claude API ile Gerçek Dünya Projesi Geliştirme

Bu eğitimin odak noktası, Claude Code’u API ile kurmayı öğrenmek; Claude Code’un nasıl kullanılacağına dair ayrıntılı bir eğitim sunmak değil.

Daha fazlasını öğrenmek isterseniz, Claude Code 101 Kursumuza kaydolmanızı öneririm.

Proje genel bakışı

Bu projenin amacı, kullanıcıların bilgisayarlarındaki fotoğrafları kolayca bulmalarını sağlayan bir Python uygulaması oluşturmaktır. 

Günümüzde insanlar çok sayıda fotoğraf çekiyor ve bunlar çoğu zaman düzensiz bir şekilde birden fazla konuma dağılıyor. Benim için, bir fotoğrafçı olarak, çekimden aylar sonra bir fotoğrafı bulmak çoğu zaman baş ağrısı oluyor.

Uygulamanın arkasındaki fikir, kullanıcıların ya fotoğrafta ne olduğunu anlatarak ya da bir ekran görüntüsü veya görsel referansı sağlayarak fotoğraflarını bulmalarına olanak tanımaktır. 

Bu ikinci mod benim için özellikle yararlı; çünkü çalışmalarımı sık sık sosyal medyada paylaşıyorum, böylece gönderinin ekran görüntüsünü alıp orijinal yüksek kaliteli dosyayı bulabilirim.

Proje mimarisini Claude Code’a bırakıp tüm uygulamayı ona yaptırabilirdik. Muhtemelen gayet iyi çalışırdı. 

Ancak eğitim amaçlı olarak, proje mimarisini kendim tanımlamak ve Claude Code’un uygulamaya odaklanmasını istedim.

CLAUDE.md ile proje mimarisi

Bu uygulamayı oluşturmak için, projenin mimarisini açıklayan bir CLAUDE.md dosyası oluşturdum. 

CLAUDE.md dosyası, Claude Code’un her oturumun başında okuyarak mimarinize, kodlama standartlarınıza ve iş akışı tercihlerinize dair kalıcı bir bellek oluşturduğu, projeye özgü bir Markdown yapılandırma dosyasıdır.

Uygulamanın iki ana bileşeni vardır:

1. Kullanıcının görsellerin bulunduğu bir klasörü seçmesine olanak tanıyan, bu görselleri vektörlere dönüştüren ve bir vektör veritabanına kaydeden bir fotoğraf alım süreci.
2. Kullanıcının veritabanında arama yapmasına izin veren çok modlu bir girdi.

Görselleri vektörlere kodlamak için CLIP modelini kullanıyoruz. Veritabanı için, yerelde ücretsiz çalışan ChromaDB’yi kullanıyoruz.

Çalışma sezgisi şu: CLIP modeli, metin ve görselleri vektörlere (verinin sayısal temsili) dönüştürmek üzere eğitilmiştir; böylece benzer görünen veya benzer kavramlar içeren görseller bu harita üzerinde birbirine yakın noktalara yerleştirilir, ilgisiz görseller ise birbirinden uzaklaştırılır.

Bir görseli bulmak istediğimizde, sorguyu da bir sorgu vektörüne dönüştürür ve sorgu vektörüne en yakın vektörleri bulmak için ChromaDB’yi kullanırız.

Vektör veritabanları hakkında daha fazla bilgi edinmek isterseniz, şu ChromaDB Eğitimi: Adım Adım Rehber’e göz atın.

İstem

Proje mimarisi CLAUDE.md dosyasında belirtildiği şekliyle hazır olduğunda, o klasörde bir terminal başlattım ve Fable 5 modelini çalıştıran Claude Code’a şu istemi verdim:

Build a desktop graphical app for my photography search engine with Python. 
First, plan the application architecture exactly as outlined in the CLAUDE.md file, ensuring the GUI can handle both folder ingestion and searching. 
Create a virtual environment, install the necessary dependencies (including customtkinter and raw image processing libraries), and save them to requirements.txt. 
Write the application logic, paying special attention to background threading for the ingestion process. 

Sonuç

İstemi gönderdim ve Claude Code’un işini yapmasına izin verdim. Yaklaşık yedi dakika sonra tamamlandı.

Uygulamayı çalıştırdım ve şöyle görünüyordu:

Bu yıl çektiğim bazı görselleri yükledim, ardından Instagram’a gidip yaptığım bir paylaşımın ekran görüntüsünü referans görsel olarak aldım.

Uygulamanın kaynak görseli bulmasını zorlaştırmak için bilerek tüm arayüzü dahil ettim. Elde ettiğim sonuç şu:

Söylemeliyim ki, oldukça iyi çalışıyor ve arayüz tam da hayal ettiğim gibi. Tayvan’ın en yüksek binası Taipei 101’in fotoğraflarını bulmayı deneyerek metin aramasıyla da test ettim. 

Sonuçlar şöyle:

Claude API token kullanımı ve gerçek maliyetler

Toplamda, bu projeyi oluşturmanın maliyeti 3,65 $ tutarında API token’ı oldu. Bir oturumun maliyetinin ayrıntılı dökümünü /cost komutunu kullanarak alabiliriz:

İlginç bir şekilde, işin bir kısmı için claude-haiku-4.5’ın da kullanıldığını görüyoruz.

Bu da Fable 5’in oldukça pahalı olduğunu gösteriyor. 

Boş bir projede yedi dakikalık bir oturum bize zaten 3,65 $’a mal oldu. 

Yüzlerce kod dosyasına sahip mevcut bir projede Fable 5 kullanmanın ne kadara mal olacağını ancak tahmin edebiliyorum.

Elbette, gerçek dünyada, gelir de üreten gerçek bir uygulama geliştirirken bu maliyetler bir yatırım haline geldiği için farklı değerlendirilmelidir.

Bilmeniz Gereken Gelişmiş Claude API Özellikleri

API’ye geçmek, Claude.ai’ın sunmadığı araçları ortaya çıkarır: istem önbellekleme, toplu işleme ve araç entegrasyonu.

Claude Code kullanıyor, yüksek hacimli API çağrıları yönlendiriyor veya harici servislerle etkileşen ajan benzeri sistemler kuruyorsanız, maliyet ve gecikmeyi en doğrudan etkileyen özellikler bunlardır.

1. İstem önbellekleme (maliyet azaltma)

İstem önbellekleme, bağlam penceresinin statik bölümlerini API çağrıları arasında sunucu tarafında saklar; böylece her istekte aynı içeriği yeniden işlemek için ödeme yapmayı bırakırsınız.

Eğer Claude Code ile çalışıyorsanız, muhtemelen her çağrıda aynı büyük bağlamı gönderiyorsunuz (bir CLAUDE.md dosyası, bir kod tabanı özeti veya uzun bir sistem istemi). Anthropic’in önbellekleme belgelerine göre, önbelleğe alınmış önekler girdi maliyetlerini %90’a kadar düşürür ve önek yeniden alma aşamasını atladığından ilk token’a kadar geçen süreyi kısaltır.

İlk istek tam girdi fiyatını öder. Aynı önbellek önekine çarpan her sonraki çağrı ise indirimli orandan faturalandırılır.

2. Batch API (eşzamansız işleme)

Batch API, gerçek zamanlı yanıt gerektirmeyen iş yüklerini yönetir.

10.000 müşteri destek biletini işlemek, tüm bir kod tabanı için dokümantasyon üretmek veya büyük bir test setinde değerlendirmeler çalıştırmak: hepsi toplu işleme uygundur. Anthropic, toplu istekleri standart girdi ve çıktı token maliyetlerinin %50’si üzerinden fiyatlandırır ve tüm işi tek bir API çağrısıyla gönderirsiniz; bir kuyruğu yönetmeniz gerekmez.

Kısıt, toplu işlerin tamamlanmasının 24 saate kadar sürebilmesi ve sonuçların birlikte, akış olmadan gelmesidir. Bu durum çevrimdışı boru hatları için uygundur; kullanıcıya dönük her şey için uygun değildir.

3. Araç kullanımı ve Model Context Protocol (MCP)

Araç kullanımı (bazen fonksiyon çağırma olarak da adlandırılır), Claude’un üretim sırasında harici fonksiyonları çağırmasına ve sonuçları yanıtına dahil etmesine olanak tanır.

Mevcut araçları JSON şeması formatında tanımlarsınız; Claude ne zaman çağıracağına, hangi argümanları ileteceğine ve çıktıyla ne yapılacağına karar verir. Böylece Claude, siz isteminizde tam çağrı noktasını belirtmeden bir veritabanını sorgulayabilir, bir REST API’yi çağırabilir veya bir Python betiği çalıştırabilir.

Model Context Protocol (MCP), bunu standartlaştırılmış bir sunucu arayüzüyle genişletir: araçları proje başına tanımlamak yerine, Claude dosya erişimi, kod yürütme veya veritabanı okuma sunan yerel bir MCP sunucusuna bağlanır.

Computer Use API farklı çalışır. Claude bir ekran görüntüsünü yorumlar ve klavye ile fare olayları üretir; alttaki uygulamaya programatik API erişimi olmadan arayüzlerde gezinir.

Sonuç

Otomatik geliştirme araçlarını çalıştırmak için Claude API’ye geçmek gerekli bir adımdır; ancak projeleri yönetme biçimimizde değişiklik gerektirir.

Fable 5, tartışmasız olağanüstü bir kodlama modelidir ve tek bir istemle tamamen çalışan, karmaşık uygulamalar üretebilir. 

Akıl yürütme gücü, mimari bir vizyonu dakikalar içinde işlevsel bir gerçeğe dönüştürebilir ki bu son derece etkileyicidir.

Ancak bu düzeyde bir gücü kullanmak için Claude API’yi tercih etmek bir bedelle gelir. Fable 5 gibi modellerin işletme maliyetleri yüksek olduğundan, model seçiminiz konusunda stratejik olmak kritik önemdedir. 

Rutin görevlerde daha ucuz ve verimli modellere güvenmenizi, Fable 5’i ise ancak gerçek engellerle karşılaştığınızda veya daha derin akıl yürütme gerektiren karmaşık mimari zorluklarda kullanmanızı öneririm.

Projede gördüğümüz gibi, nispeten basit, tek dosyalı bir uygulamada bile API token maliyetleri hızla artabilir. Kullanımınızı yakından izleyerek ve en önemlisi, otomatik yeniden yüklemeyi devre dışı bırakarak bütçenizi koruyun; böylece otomatik bir kodlama oturumu bütçenizi kontrolden çıkarmaz.

Claude ekosistemi hakkında daha fazla bilgi edinmek isterseniz, Claude 101 kursumuza göz atmanızı öneririm.