Anthropic'in Claude ailesi, ciddi kodlama, aracılı işler ve uzun bağlam muhakemesi için en yetenekli kapalı kaynak model serisidir ve API fiyatı da bunu yansıtır: Sonnet, milyon belirteç başına 3 $ / 15 $ olarak çalışırken, Opus daha yüksek fiyatlıdır. Bu maliyet, çoğu yan projenin başlamadan sona ermesine neden olur. Faturalandırma modelini tamamen değiştiren tek bir yol var: Puter.js, tam Claude serisini (Opus 4.7, Sonnet 4.6, Haiku 4.5 ve yedi diğer varyant) Anthropic anahtarı olmadan sunar ve geliştirici yerine son kullanıcıya fatura keser. Bir geliştirici olarak sizin için yapısal olarak ücretsiz ve sınırsızdır.
Bu rehber, kurulumu baştan sona ele alıyor: model kimlikleri, çalışan kod, akış ve yayına almadan önce bilmeniz gereken tavizler.
ÖZET
- Puter.js, geliştiricilere API anahtarı, Anthropic faturalandırması veya sunucu olmaksızın tam Claude ailesine ücretsiz, sınırsız erişim sağlar.
- Son kullanıcı, kendi kullanımını bir Puter hesabından karşılar; siz sıfır ödersiniz.
- Desteklenen modeller: Opus 4.7, Opus 4.6, Opus 4.6 Fast, Opus 4.5, Opus 4.1, Opus 4, Sonnet 4.6, Sonnet 4.5, Sonnet 4, Haiku 4.5.
- Tek bir
<script>etiketi, tek bir fonksiyon çağrısı (puter.ai.chat) ile Claude ile konuşmaya başlarsınız. - Akış, sistem istemleri, çok turlu sohbetler hepsi çalışır; Puter, Anthropic'in mesaj yapısını yansıtır.
- Puter aracılığıyla Claude'a karşı ve resmi Anthropic API'sine karşı aynı istemi betiklemek için Apidog'u kullanın.
“Ücretsiz sınırsız” aslında nasıl çalışır?
Puter.js, tarayıcıda çalışan sunucusuz bir bulut ve yapay zeka kütüphanesidir. Mimari değişimi şu şekilde: Anthropic API anahtarını elinde tutan ve faturayı ödeyen siz olmak yerine, son kullanıcınız Puter'a (ücretsiz hesap) giriş yapar ve çağrı onların bakiyesinden ücretlendirilir. Yeni Puter hesapları başlangıç kredisiyle gelir; kullanıcılar daha fazlasını isterlerse bakiye yüklerler.
Geliştirici için bu üç anlama gelir:
- Deponuzda API anahtarı yok. Sızıntı riski yok, rotasyon yok, yönetilecek proje tabanlı anahtarlar yok.
- Sizin tarafınızda kullanım sınırı yok. Her kullanıcı kendi hesabına karşı çalışır, bu nedenle "limitiniz" kullanıcı tabanınızla doğrusal olarak ölçeklenir.
- Anthropic ile bir ilişkiye gerek yok. Anthropic ile asla bir sözleşme imzalamazsınız; Puter aracıdır.
Taviz: bu tarayıcı merkezlidir. Bir arka uç Python betiği, oturum açmış bir kullanıcı oturumu olmadan Puter'ı kullanamaz. Arka uç kullanımı için aşağıdaki alternatifler bölümüne bakın.
Adım 1: Betiği Ekleyin
HTML'inizde tek bir etiket, derleme adımı yok:
<script src="https://js.puter.com/v2/"></script>
Kurulumun tamamı bu. `npm install`, anahtar yapılandırması, DNS kurulumu yok. Paketlenmiş bir uygulama için NPM'i tercih ederseniz:
npm install @heyputer/puter.js
import { puter } from '@heyputer/puter.js';
CDN etiketi, statik bir site veya hızlı bir prototip için en kolay yoldur. NPM içe aktarımı, bir Vite veya Webpack derlemesinde size tree-shaking ve TypeScript türleri sağlar.
Adım 2: Bir Claude Modeli Seçin
Puter, Anthropic'in tüm kataloğunu sunar. Model kimlikleri, Anthropic'in isimlendirmesini kısa çizgi ayırıcılarla takip eder:
| Model Kimliği | Ne zaman kullanılır |
|---|---|
claude-opus-4-7 |
En yeni amiral gemisi; en derin muhakeme, en iyi aracılı işler |
claude-opus-4-6 |
Önceki amiral gemisi; güçlü kodlama, biraz daha ucuz |
claude-opus-4.6-fast |
Daha düşük gecikmeli Opus varyantı |
claude-opus-4-5 |
Üretim aracıları için istikrarlı bir seçim |
claude-opus-4-1 |
Eski, kararlı; iyi anlaşılmış davranış |
claude-opus-4 |
Orijinal Opus 4 temel sürümü |
claude-sonnet-4-6 |
Varsayılan günlük kullanım; güçlü maliyet/kalite dengesi |
claude-sonnet-4-5 |
Önceki Sonnet; daha ucuz, çoğu görev için hala mükemmel |
claude-sonnet-4 |
Sonnet 4 temel sürümü |
claude-haiku-4-5 |
En hızlı, en ucuz; yüksek hacimli sınıflandırma için iyi |
İlk olarak başvuracağınız iki model: günlük muhakeme için claude-sonnet-4-6 ve hızlı sınıflandırma için claude-haiku-4-5. Gerçek derinliğe ihtiyacınız olduğunda (uzun biçimli muhakeme, karmaşık kod incelemesi, aracılı çok adımlı planlama) claude-opus-4-7'yi kullanın.
Adım 3: Claude'u Konuşturun
Minimum çalışır durumdaki çağrı:
<!DOCTYPE html>
<html>
<body>
<script src="https://js.puter.com/v2/"></script>
<script>
puter.ai.chat(
"Explain quantum computing in simple terms",
{ model: 'claude-sonnet-4-6' }
).then(response => {
puter.print(response.message.content[0].text);
});
</script>
</body>
</html>
Dosyayı bir tarayıcıda açın. Puter API çağrısını yönetir, kullanıcı giriş yapar (veya ilk çalıştırmada ücretsiz bir Puter hesabı oluşturur) ve yanıt sayfaya yazdırılır.
Yanıt yapısı, Anthropic'in mesaj API'sini yansıtır. response.message.content, içerik bloklarından oluşan bir dizidir; düz metin yanıtları için [0].text değerini okursunuz. Çok parçalı yanıtlar (metin + araç çağrıları) için diziyi yineleyin.
Adım 4: Yanıtı Akışla İletin
Akış olmadan uzun yanıtlar yavaş hissedilir. `stream: true` değerini geçirin ve yineleyiciyi tüketin:
const response = await puter.ai.chat(
"Write a detailed essay on the impact of artificial intelligence on society",
{ model: 'claude-sonnet-4-6', stream: true }
);
for await (const part of response) {
puter.print(part?.text);
}
`for await` deseni, parçacıkları geldikçe okur. Bir sohbet kullanıcı arayüzü için, her `part.text`'i mesaj baloncuğunuza ekleyin; kullanıcı metnin kelime kelime göründüğünü görür.
Adım 5: Çok Turlu Sohbetler
Tek bir dizge yerine bir mesaj dizisi geçirin. Her mesajın bir `role` ve `content`'i vardır:
const messages = [
{ role: 'user', content: 'I am building a Next.js app with Postgres.' },
{ role: 'assistant', content: 'Got it. What do you need help with?' },
{ role: 'user', content: 'How should I structure the migrations folder?' },
];
const response = await puter.ai.chat(messages, {
model: 'claude-opus-4-7',
});
console.log(response.message.content[0].text);
Turlar arasında durumu korumak için, bir sonraki çağrıdan önce her kullanıcı mesajını ve her asistan yanıtını diziye ekleyin. Claude tüm konuşma dökümünü okur ve tutarlı kalır.
Adım 6: Sistem İstemleri
Karakteri, kısıtlamaları ve çıktı formatını en üstte bir sistem mesajı ile ayarlayın:
const messages = [
{ role: 'system', content: 'You are a senior backend engineer. Reply in numbered bullets, never more than five.' },
{ role: 'user', content: 'How do I prevent SQL injection in a Node app?' },
];
const response = await puter.ai.chat(messages, { model: 'claude-sonnet-4-6' });
Sistem istemleri tüm konuşma boyunca geçerli olur ve ton, çıktı formatı ve davranışsal koruyucular için doğru yerdir.
Aynı İstemde Modelleri Karşılaştırma
Kullanım durumunuz için doğru Claude modelini bulmanın en hızlı yolu, aynı istemi hepsinde betiklemek ve karşılaştırmaktır. Küçük bir kıyaslama döngüsü:
const models = ['claude-haiku-4-5', 'claude-sonnet-4-6', 'claude-opus-4-7'];
const prompt = "Refactor this React component to use hooks: ...";
for (const model of models) {
const start = performance.now();
const response = await puter.ai.chat(prompt, { model });
const elapsed = performance.now() - start;
console.log(`${model}: ${elapsed.toFixed(0)}ms`);
console.log(response.message.content[0].text);
console.log('---');
}
Bir kez çalıştırın ve ödünleşme modelini göreceksiniz: Haiku, Opus'tan 5-10 kat daha hızlıdır, Sonnet ortada yer alır, Opus zorlu istemlerde gözle görülür şekilde daha iyi yanıtlar üretir. Çoğu uygulama için Sonnet 4.6 doğru varsayılandır.
Puter'ın ücretsiz yolunu Apidog'daki resmi Anthropic API'sine karşı kıyaslamak için, her iki sağlayıcıyı da aynı koleksiyonda tutun ve ortamı değiştirin.
Ne Elde Edersiniz ve Ne Elde Edemezsiniz
Puter aracılığıyla ücretsiz sınırsız Claude gerçektir, ancak yüzey resmi API'nin bir alt kümesidir. Dürüst liste:
Elde ettikleriniz:
- Tam Claude model kataloğu (Opus, Sonnet, Haiku, tüm güncel versiyonlar)
- Çok turlu sohbetler
- Sistem istemleri
- Akışlı yanıtlar
- Üretim için hazır ölçek (altyapıyı Puter yönetir)
- Geliştirici olarak size sıfır faturalandırma riski
Elde edemeyebilecekleriniz (Puter sürümüne bağlı olarak):
- Yerel araç kullanımı / fonksiyon çağrısı (en son Puter belgelerini kontrol edin)
- Görsel giriş (görüntü ekleri)
- Anthropic'in istem önbellekleme maliyet azaltması
- Tarayıcı bağlamı olmadan sunucu tarafı kullanım
- Doğrudan hız limiti görünürlüğü (Anthropic'in başlıklarını görmezsiniz)
Derin araç kullanım iş akışları için, resmi Anthropic API'si veya Apidog'daki MCP sunucu testi size daha fazla kontrol sağlar. Tipik bir sohbet botu, Soru-Cevap uygulaması veya içerik oluşturucu için Puter'ın sunduğu yeterlidir.
Puter'ı Ne Zaman, Resmi Anthropic API'sini Ne Zaman Kullanmalı
Ayrım:
Puter'ı şu durumlarda kullanın:
- Ücretsiz bir herkese açık uygulama yayınlıyor ve faturalandırma riskini istemiyorsanız.
- Prototip oluşturuyorsanız ve henüz Anthropic ile bir faturalandırma ilişkisi kurmak istemiyorsanız.
- Claude'u arka uç olmadan statik bir sitede, hackathon projesinde veya tarayıcı uzantısında desteklemek istiyorsanız.
- Kullanıcılarınız Puter'a giriş yapmaktan memnunsa (veya zaten kullanıyorlarsa).
Resmi Anthropic API'sini şu durumlarda kullanın:
- Sunucu tarafı çağrılara ihtiyacınız varsa (cron işleri, API uç noktaları, toplu işleme).
- Kararlı sistem istemlerinde maliyet tasarrufu için istem önbelleğe almaya ihtiyacınız varsa.
- Ayrıntılı araç kullanımına, görsel girişe veya Dosyalar API'sine ihtiyacınız varsa.
- Uyumluluk için (BAA'lar, SOC 2, bölgesel ikamet) sözleşmeli bir ilişkiye ihtiyacınız varsa.
- Kullanıcılarınız bir Puter giriş adımını tolere etmeyecekse.
Çoğu proje prototipleme için Puter'da başlar ve yukarıdaki sınırlamalardan birine ulaştıklarında resmi API'ye geçiş yapar. Geçiş basittir; mesaj yapısı aynıdır.
GPT eşdeğeri için, GPT-5.5 API'si Nasıl Kullanılır bölümüne bakın.
Apidog'da Entegrasyonu Test Etme
Puter çağrıları tarayıcıda gerçekleştiği için, bunları doğrudan bir arka uç test çalıştırıcısından betikleyemezsiniz. Çalışan desen şudur:
- Puter betiği ve istem için bir sorgu parametresi içeren küçük bir statik sayfa oluşturun.
- Yukarı akış Anthropic API yüzeyini (nihayetinde geçiş yaptığınızda) doğrulamak için Apidog'u kullanın.
- Her ikisini de aynı Apidog koleksiyonunda ayrı ortamlar olarak tutun, böylece tek tıklamayla değiştirebilirsiniz.
Apidog'u indirin ve iki ortam kurun: `puter-prototype` (Puter sayfanızı barındıran bir localhost URL'si) ve `anthropic-prod` (`https://api.anthropic.com/v1`). Puter'dan resmi API'ye geçtiğinizde koleksiyon sorunsuz bir şekilde taşınır.
SSS (Sıkça Sorulan Sorular)
Bu gerçekten sınırsız mı, yoksa gizli bir üst sınır mı var?Geliştirici tarafı için sınırsız, evet. Son kullanıcının Puter hesabında ne kadar bakiye varsa o kadar kullanabilir; yeni hesaplar başlangıç kredisi alır ve kullanıcılar daha fazlasını isterlerse bakiye yüklerler. Geliştirici başına bir üst sınır yoktur.
Anthropic'e kaydolmam gerekiyor mu?Hayır. Puter, Anthropic ilişkisini yönetir. Bir Anthropic anahtarı asla görmezsiniz.
Bunu üretimde kullanabilir miyim?Tarayıcı tabanlı uygulamalar için evet. Puter üretim altyapısını çalıştırır. Doğru soru, kullanıcılarınızın Puter'a giriş yapmaya istekli olup olmadığıdır; evet ise, yayınlayın.
Claude, Puter aracılığıyla resmi API ile aynı şekilde mi performans gösteriyor?Model çıktısı aynıdır; Puter, kullanıcının adına resmi Anthropic API'sini çağırır. Ek atlama nedeniyle gecikme marjinal olarak daha yüksek olabilir, ancak model davranışı değişmez.
Claude'un istem önbellekleme tasarrufları ne olacak?Puter, Anthropic'in istem önbellekleme fiyatlandırma kontrollerini bugün itibarıyla sunmuyor. Eğer kararlı bir 50 bin belirteçlik sistem isteminiz varsa ve önbellek indirimine ihtiyacınız varsa, resmi API'yi kullanın.
Claude'u bir Discord botunda veya arka uç hizmetinde Puter aracılığıyla kullanabilir miyim?Sorunsuz değil. Puter tarayıcı merkezlidir ve bir kullanıcı oturumu varsayar. Arka uç hizmetleri resmi Anthropic API'sini kullanmalıdır.
Varsayılan olarak hangi modeli kullanmalıyım?`claude-sonnet-4-6`. Çoğu istem için maliyet, hız ve kalite arasında doğru dengeyi sunar. Daha derin muhakemeye ihtiyacınız olduğunda `claude-opus-4-7`'ye ve toplu sınıflandırmaya ihtiyacınız olduğunda `claude-haiku-4-5`'e geçin.
Kullanıcılarım çok mu ücretlendirilecek?Çoğu sohbet tarzı kullanım, Anthropic'in oranlarıyla oturum başına sentler tutar. Sıradan bir kullanıcı, bakiye yüklemeden önce Puter'ın başlangıç kredisiyle onlarca konuşma yapabilir.
Özetle
Puter.js aracılığıyla ücretsiz sınırsız Claude, Anthropic kalitesinde faturalandırma olmadan Anthropic kalitesinde çıktı isteyen herhangi bir tarayıcı tabanlı uygulama için en temiz yoldur. Betiği ekleyin, bir model seçin, istemi yazın. Son kullanıcı kullanımı karşılar; siz anahtar olmadan yayınlarsınız.
Sunucu tarafı iş yükleri, istem önbellekleme veya tam araç kullanım akışları için resmi Anthropic API'si hala doğru yanıttır. Ancak prototipler, ücretsiz halka açık uygulamalar, hackathon projeleri, yan projeler ve statik siteler için Puter cevaptır.
İsteği Apidog'da bir kez oluşturun, Puter'ı resmi API'ye karşı kıyaslayın ve yapınıza uyan yolu seçin.