8. Artifacts

Artifact, Claude'un ürettiği ve sohbetten ayrı bir pencerede görüntülenen, üzerinde çalışılabilir içeriktir. Bir belge, bir kod parçası, bir diyagram veya çalışan bir uygulama olabilir.

Bu bölüm iki katmanlıdır. Önce özelliğin resmî olarak belgelenmiş davranışı aktarılır; sonra bu kitap için fiilen üretilen bir artifact üzerinden vaka incelemesi yapılır. Vaka incelemesinde neyin doğrulandığı ve neyin doğrulanamadığı ayrı ayrı belirtilir.

8.1 Claude Ne Zaman Artifact Üretir?

Claude bir içeriği artifact olarak üretip üretmeyeceğine belirli ölçütlere göre karar verir. Resmî dokümantasyona göre içerik şu üç niteliği taşımalıdır: kayda değer ve kendi kendine yeterli olmalı (tipik olarak on beş satırın üzerinde), sohbet dışında düzenlenmesi veya yeniden kullanılması muhtemel olmalı, ve ek bağlam gerektirmeden tek başına anlamlı olmalıdır.

Kaynak: Anthropic Destek Merkezi, "What are artifacts and how do I use them?" — https://support.claude.com/en/articles/9487310. Doğrulama tarihi: 1 Eylül 2026.

8.2 Zorunlu Ayar

Bölüm 5.5'te değinilen kurulum adımı burada tekrar edilmelidir, çünkü "artifacts çalışmıyor" şikâyetlerinin başlıca nedenidir: artifacts, kod yürütme ve dosya oluşturma ayarı açık olmadan desteklenmez.

• Sol alt köşede adınıza veya baş harflerinize tıklayın.
• Ayarlar bölümünden Yetenekler sayfasına gidin.
• "Kod yürütme ve dosya oluşturma" seçeneğini açın.

Team ve Enterprise planlarında bu ayar kuruluş düzeyinde, yönetici yetkisiyle yapılır ve bireysel kullanıcı değiştiremeyebilir.

8.3 Artifact ile Çalışma

• Sürüm seçici ile önceki sürümlere dönülebilir; her düzenleme yeni bir sürüm oluşturur.
• Markdown belgelerde yerinde düzenleme mümkündür: metin seçilir, düzenleme isteği yazılır, değişiklik tam o noktada yapılır.
• Bir sohbette birden fazla artifact açık tutulabilir; hangisinin güncelleneceği belirtilebilir.
• Hata veren bir artifact'te sunulan onarım düğmesi, hata ayrıntılarını yeni bir mesaja aktarır.
• Sohbette üretilen artifact kenar çubuğuna otomatik eklenmez; eklemek için yayımlanması gerekir.

8.4 Kalıcı Depolama

Artifacts oturumlar arası veri saklayabilir. Bu, günlük, takip aracı, puan tablosu gibi durum tutan uygulamaları mümkün kılan özelliktir.

Kişisel ve Paylaşımlı Depolama

Depolamanın Kritik Ön Koşulu

Sık karşılaşılan ve kafa karıştırıcı bir davranış: kalıcı depolama yalnızca yayımlanmış artifactlar için çalışır. Geliştirme sırasında, yani artifact henüz yayımlanmamışken depolama işlemleri başarısız olur.

Pratik sonucu şudur: depolama kullanan bir artifact'i denerken "kaydedilemedi" hatası alıyorsanız, koddaki bir sorunu aramadan önce artifact'in yayımlanmış olup olmadığını kontrol edin.

Teknik Sınırlar

• Yalnızca metin ve JSON verisi saklanabilir; dosya yüklemesi desteklenmez.
• Anahtar adları kısa olmalı ve boşluk, eğik çizgi veya tırnak içermemelidir.
• Boyut sınırları vardır. Kaynaklar anahtar başına ve artifact başına farklı üst sınırlar bildirmektedir [DOĞRULANAMADI — kesin değerler için resmî dokümantasyona bakınız].
• Eşzamanlı güncellemelerde son yazan kazanır.
• İstek sayısı sınırlıdır; birlikte güncellenen verileri tek anahtarda toplamak önerilir.

Yaygın Bir Programlama Tuzağı

Depolamadan var olmayan bir anahtar okunduğunda işlem boş değer döndürmez, hata fırlatır. Bu davranışı bilmeyen bir uygulama, ilk açılışta çöker. Doğru yaklaşım, okuma işlemini hata yakalama bloğu içine almak ve hata durumunda başlangıç değerlerine düşmektir.

8.5 Yapay Zekâ Destekli Artifacts

Bir artifact'in içine Claude'un kendisi gömülebilir. Bu durumda artifact yalnızca bir arayüz değil, çalışan bir yapay zekâ uygulaması hâline gelir.

Ekonomik Modeli

Bu özelliğin en önemli yanı, çoğu kullanıcının fark etmediği ekonomik yapısıdır: yapay zekâ destekli bir artifact paylaşıldığında, onu kullananlar kendi Claude hesaplarıyla kimlik doğrular ve kullanım onların kendi abonelik sınırlarından düşer. Üreticiye maliyet çıkmaz.

Bunun anlamı, kod yazmayı bilmeyen bir kullanıcının bile başkalarının kullanabileceği bir yapay zekâ aracı üretip dağıtabilmesidir — API anahtarı yönetmeden, altyapı kurmadan, maliyet üstlenmeden. Bölüm 30'da ele alınacak "arayüzün tavanı" tartışmasının en pratik çıkış kapısı budur.

Sınırlar

• Kullanıcının Claude hesabı olması gerekir.
• Model çağrıları kullanıcının kotasından düşer; yoğun kullanan bir araç kullanıcıyı kota sınırına dayandırabilir.
• Yanıtlar Bölüm 2'deki tüm halüsinasyon risklerini taşır. Artifact içinde üretilmiş olması doğruluk sağlamaz.

8.6 Vaka İncelemesi: Kitap Takip Panosu

Bu kitabın hazırlanması sırasında, her iki özelliği de kullanan gerçek bir artifact üretildi: kitabın kendi bölüm durumunu izleyen bir pano.

Tasarım Kararları

Araç şu işlevleri taşır: otuz dört bölümün altı kısma ayrılmış listesi, bölüm başına dört durumlu ilerleme göstergesi, sayfa sayısı girişi, toplam ilerleme ölçütleri ve Claude'dan ilerleme değerlendirmesi isteyen bir düğme.

Durum ve sayfa verileri kişisel depolamada tutulur — paylaşımlı değil. Bu bilinçli bir karardır: pano tek yazarın kendi çalışma durumunu izler, dolayısıyla verinin başkalarınca görülmesi için bir gerekçe yoktur. Bölüm 8.4'teki gizlilik ilkesinin uygulanmasıdır.

Değerlendirme düğmesi, mevcut durumu metne dönüştürüp Claude'a gönderir ve kısa bir ilerleme değerlendirmesi ister. İstemde açıkça "abartma, pazarlama dili kullanma, sorun varsa açıkça söyle" talimatı yer alır — Bölüm 7.3'teki talimat tasarımı ilkelerinin uygulanması.

Test Sonuçları

Artifact üretildikten sonra yazar tarafından fiilen açılmış ve bölüm sonundaki protokol uygulanmıştır. Sonuçlar aşağıdadır.

Depolama Testinin Yöntemi

Kalıcı depolamanın doğrulanmasında yöntemsel bir tuzak vardır ve ilk denemede bu tuzağa düşülmüştür. Artifact ilk açıldığında ekrandaki değerler, kodun içine gömülü başlangıç değerleriyle birebir aynıydı. Bu durumda iki olasılık ayırt edilemez: pano depodan okumuş olabilir, ya da okuyamayıp varsayılana düşmüş olabilir.

Geçerli test için başlangıç değerinden farklı bir değer gereklidir. İkinci denemede bir bölümün sayfa alanına varsayılandan farklı bir sayı girildi, artifact yayımlandı, sekme kapatılıp yeniden açıldı ve girilen değerin korunduğu görüldü. Ancak bu adımdan sonra depolama doğrulanmış sayılmıştır.

Tespit Edilen Hata

Testin ortaya çıkardığı tek başarısızlık biçimlendirmeyle ilgilidir. Model, yanıtında kalın vurgu için markdown işaretleri kullandı; arayüz ise metni düz metin olarak gösterdiği için bu işaretler ekranda ham hâlde göründü.

Hata, modelin değil arayüzün hatasıdır: model yaygın bir biçimlendirme kuralı uygulamıştır, arayüz bunu işlemeyi öngörmemiştir. Düzeltme, yanıt metnindeki vurgu işaretlerini ayrıştıran küçük bir bileşen eklenerek yapılmıştır.

Beklenmedik Bulgu: Aracın Kendi Projesini Sınaması

Testin en öğretici sonucu planlanmamıştı. Değerlendirme düğmesine basıldığında model, kitabın ilerleme durumunu inceleyip bir sorun tespit etti: tamamlanan bölümlerin ortalama uzunluğuna bakıldığında, otuz dört bölümün toplamının hedeflenen sayfa sayısının çok altında kalacağını hesapladı.

Bu tespit doğruydu ve projenin planlama varsayımını düzeltmeyi gerektirdi. Sayfa hedefi bu bulgu üzerine revize edilmiştir.

Buradan çıkan ders, Bölüm 4'teki ortaklık modelini somutlaştırır: araç yalnızca içerik üretmekle kalmaz, doğru kurulduğunda kendi projenizin varsayımlarını da sınayabilir. Ancak bunun ön koşulu, istemin buna izin vermesidir. Panonun istemindeki abartmama ve sorunu açıkça söyleme talimatı olmasaydı, model büyük olasılıkla nazik ve içeriksiz bir ilerleme özeti üretirdi.

8.7 Bölüm Özeti

• Artifact, kendi kendine yeterli ve yeniden kullanılabilir içerik için üretilir.
• Kod yürütme ayarı kapalıyken artifacts hiç çalışmaz.
• Yayımlanmayan artifact kenar çubuğunda görünmez.
• Kalıcı depolama yalnızca yayımlanmış artifactlarda çalışır.
• Paylaşımlı depolamadaki veriyi artifact'i açan herkes görebilir.
• Var olmayan bir anahtarı okumak hata fırlatır; hata yakalama zorunludur.
• Tarayıcı depolaması (localStorage) desteklenmez.
• Yapay zekâ destekli artifactlarda maliyet kullanıcıya aittir, üreticiye değil.
• Artifact içinde üretilmiş olması bir yanıtı doğru yapmaz.
• Kalıcılık testi, varsayılandan ayırt edilebilir bir değerle yapılmalıdır.
• Model yanıtı markdown içerebilir; arayüz bunu işlemeli veya istem bunu yasaklamalıdır.
• Doğru kurulmuş bir istem, aracın kendi projenizin varsayımlarını sınamasını sağlar.

Güncellik kontrolü: Artifacts özelliği ve depolama davranışı 1 Eylül 2026 itibarıyla https://support.claude.com/en/articles/9487310 adresinden doğrulanmıştır. Vaka incelemesindeki artifact aynı tarihte üretilmiş ve fiilen test edilmiştir.