Claude Projects: Project Knowledge, Instructions ve RAG ile Kalıcı Çalışma Alanı

Sürüm notu: Bu yazı Claude Projects'i 15 Kasım 2026 itibarıyla anlatır; project oluşturma, dosya sınırları, RAG (retrieval-augmented generation; soruya göre dokümanlardan ilgili parçaları bulup modele veren yöntem) davranışı ve paylaşım ayarları aynı gün Claude Help Center'dan (support.claude.com) kontrol edilmiştir. Bu yazıda resmî belgelerden yararlanılmıştır. Birleşik Claude deneyimine geçmiş ve geçmemiş hesaplarda bazı menüler farklı görünebilir.

Önce Tahmin Et

Ayşe, sitedeki serilerin ortak örnek uygulaması Bookstore (bir online kitapçı) için bir Claude project'i açtı ve içine 60 dosya yükledi: mimari karar kayıtları, API tanımı, kod kuralları, destek ekibinin sık gelen soruları. İlk haftalar her şey yolundaydı. Sonra bir gün "sipariş iptalinde stok ne zaman serbest bırakılıyor?" diye sordu ve Claude, cevabın açıkça yazdığı dokümana hiç değinmeden genel bir cevap verdi. Ayşe dosyanın orada olduğundan emin.

Tahminin ne? Claude dosyayı neden "görmedi"? Dosya bozuk mu, project'in bir sınırı mı aşıldı, yoksa Claude bu büyüklükteki bir project'te dosyaları farklı bir yöntemle mi okuyor? Ve Ayşe soruyu nasıl sorsaydı doğru dokümana ulaşma ihtimali artardı? Cevap, Help Center'ın project'lerde RAG makalesinde.

Project Ne Zaman Açılır

Help Center'ın tanımıyla project, konuşmaları ortak bir bağlam etrafında toplamanın yolu (https://support.claude.com/en/articles/9519177). İki durumda işe yarıyor: aynı dokümanlara ve kurallara tekrar tekrar ihtiyaç duyuyorsan ve bir iş birden çok konuşmaya yayılıyorsa. Tek seferlik bir soru için project açmak gereksiz; ama her hafta aynı mimari dokümanlara soru soruyorsan, o dokümanların yeri project.

Project oluşturmak için soldaki Projects bölümüne ya da claude.ai/projects adresine gidip sağ üstteki "+ New Project"e tıklıyorsun, bir ad ve açıklama yazıyorsun. Bir ayrıntı dikkat çekiyor: Help Center'a göre Claude project'in adını ve açıklamasını görmüyor. Claude'un bilmesi gereken her şey instructions'a ya da knowledge'a yazılmalı. Free planda en fazla beş project açılabiliyor; Team ve Enterprise'da project'i oluştururken onu özel tutmayı ya da organizasyonla paylaşmayı seçebiliyorsun.

Var olan bir konuşmayı project'e almak da mümkün: konuşmanın adının yanındaki menüden "Add to project". Aynı menüden konuşmayı project'ten çıkarabiliyor ya da başka bir project'e taşıyabiliyorsun.

Bir Project'in Parçaları

Bir project dört parçadan oluşuyor. Project instructions, "Set project instructions" alanına yazdığın ve project'teki her konuşmaya uygulanan talimatlar; Claude'un hangi rolü üstleneceği, hangi kurallara uyacağı, cevabın biçimi. Üçüncü yazıda gördüğümüz Instructions for Claude bütün hesap için geçerliydi; project instructions yalnız bu project için.

Project knowledge, yüklediğin dokümanlar, metin dosyaları ve kod parçaları; project'teki her konuşmada kullanılabiliyor. Konuşmalar ise birbirini görmüyor: Help Center'a göre bir konuşmadaki bağlam, knowledge'a eklenmedikçe diğer konuşmalara geçmiyor. Bir konuşmada vardığın bir kararın diğer konuşmalarda da bilinmesini istiyorsan onu bir dosya olarak knowledge'a koymalısın.

Dördüncü parça project memory. Her project'in kendi memory'si var; Claude project içinde bu memory'yi ve project dışı konuşmalardan gelen account memory'yi birlikte kullanıyor, ama başka project'lerin memory'sini kullanmıyor. Project'i tamamen ayırmak istiyorsan project sayfasındaki Memory bölümünden "Use account memory" ayarını kapatıyorsun. Memory'nin ayrıntılarını beşinci yazıda göreceğiz.

Birleşik deneyime geçmiş hesaplarda project'ler görevleri de topluyor. "Organize your tasks with projects in Claude Cowork" makalesine göre (https://support.claude.com/en/articles/14116274) bir project'e ona özgü scheduled task'lar ve context olarak bilgisayarındaki bir klasör ya da bir URL eklenebiliyor; mevcut bir chat project'inden dosya ve instructions içe aktarılabiliyor.

Project Knowledge: Ne Yüklenir, Sınırlar Ne?

Help Center'ın "Upload files to Claude" makalesi (https://support.claude.com/en/articles/8241126, 23 Temmuz 2026'da güncellenmiş) project dosyaları için şu sınırları veriyor: dosya başına 30 MB, dosya sayısında sabit bir sınır yok ama toplam içeriğin Claude'un context window'una sığması gerekiyor. Project dosyalarından yalnız metin çıkarılıyor; istisna, görselleriyle birlikte işlenebilen PDF'ler. Sohbete doğrudan eklenen dosyalar için sınırlar farklı: dosya başına 500 MB, konuşma başına 20 dosya, PDF'lerde 100 sayfaya kadar görsel analiz, 1.000 sayfaya kadar yalnız metin. Desteklenen türler arasında PDF, Word (DOCX), CSV (virgülle ayrılmış değerler içeren metin dosyası), düz metin (TXT), HTML, JSON ve Excel (XLSX) var; XLSX için hesapta kod çalıştırma ve dosya oluşturma özelliğinin açık olması gerekiyor.

Project knowledge'ın kullanım açısından bir avantajı da var: birinci yazıda gördüğümüz gibi project içeriği cache'leniyor ve tekrar kullanıldığında daha az sayılıyor. Cache bir süre işlem yapılmazsa siliniyor; uzun bir aradan sonra ilk soru içeriği yeniden tam saydırıyor.

Knowledge Büyüyünce: Project'lerde RAG

"Toplam içerik context window'a sığmalı" kuralının ücretli planlarda bir devamı var. Help Center'ın "Retrieval augmented generation (RAG) for projects" makalesine göre (https://support.claude.com/en/articles/11473015) Pro, Max, Ultra, Team ve Enterprise planlarında project knowledge context window sınırına yaklaştığında Claude otomatik olarak RAG moduna geçiyor. Bu modda project, context window'un izin verdiğinden yaklaşık 10 kat fazla içerik tutabiliyor. Claude her soru için bütün dosyaları okumak yerine bir project knowledge arama tool'u kullanıyor ve yalnız en ilgili parçaları alıyor. Project'in RAG modunda olduğu arayüzde bir işaretle gösteriliyor; içerik eşiğin altına düşerse standart moda geri dönüyor. Bunu açıp kapatan bir ayar yok, geçiş içerik büyüklüğüne göre kendiliğinden oluyor.

Önce Tahmin Et'teki durumun büyük ihtimalle açıklaması bu. 60 dosyalık bir project'te Claude artık her şeyi aynı anda okumuyor; sorunun kelimelerine göre arıyor ve en ilgili gördüğü parçaları alıyor. Ayşe'nin sorusu "stok ne zaman serbest bırakılıyor" diye soruyorsa, ama doküman aynı şeyi "rezervasyonun iptali" diye anlatıyorsa, arama o parçayı en üste çıkarmayabiliyor. RAG serisinin ilk yazısı "Production RAG Mimarisi: Ingestion ve Query Pipeline'ları, Minimal RAG Neden Çöker?" ve LLM Temelleri serisinin "LLM ve RAG: Modelin Bilmediği Veriyle Cevap Vermek" yazısı bu mekaniği kendi kodumuzla anlattı; burada aynı şey senin kontrolünde olmayan bir arama tool'uyla oluyor.

Help Center'ın önerileri tam bu sorunu hedefliyor: ilgili dosyaları baştan yükle, dosyalara açık ve tanımlayıcı adlar ver, ilgili dokümanları aynı project'te topla ve sorunda belirli bir dokümanın adını an. Buna kendi pratiğimizden bir madde ekleyelim: uzun dokümanları başlıklarla bölümlere ayır. Arama tool'unun bulduğu parça ne kadar tek bir konuya odaklıysa cevaba o kadar iyi taşınıyor. Makale, RAG'in web search, extended thinking ve Research ile birlikte çalıştığını ve cevap kalitesinin standart işlemeyle tutarlı kaldığını söylüyor.

Bookstore: Teknik Dokümantasyon Project'i

Ayşe'nin project'ini baştan, bu kurallara göre kuralım. Adı "Bookstore Teknik Dokümantasyon". Knowledge'a girenler:

• Mimari karar kayıtları: her biri ayrı bir dosya, adında numara ve konu var; örneğin ADR-007-order-cancellation-and-stock-release.md. ADR (Architecture Decision Record; bir mimari kararın gerekçesi ve sonuçlarıyla yazıldığı kısa doküman) başına tek karar.
• Bookstore.Api'nin OpenAPI tanımı: openapi-bookstore-api-v1.yaml.
• Kod kuralları: CONVENTIONS-backend.md ve CONVENTIONS-angular.md, iki ayrı dosya.
• Destek ekibinin sık gelen soruları: support-faq-2026-q3.md; müşteri adı, adresi, sipariş numarası temizlenmiş hâliyle.

Project instructions:

You answer questions about Bookstore's backend and API for the development team.

Sources: use the project files first. For every claim, name the file and the
heading it comes from. If the files do not answer the question, say so before
using general knowledge, and label that part as general knowledge.

Decisions: ADR files are the source for architecture decisions. If an ADR and
the OpenAPI file disagree, point out the conflict instead of choosing one.

Code: follow CONVENTIONS-backend.md for C# and CONVENTIONS-angular.md for Angular.
Language: answer in Turkish; keep code, identifiers and technical terms in English.

Bu metnin üç satırı RAG modunda özellikle işe yarıyor. Her iddia için dosya ve başlık istemek, cevabın hangi parçaya dayandığını görmeni sağlıyor; dosya adı yoksa cevap büyük ihtimalle knowledge'dan değil genel bilgiden geliyor. "Dosyalar cevaplamıyorsa önce bunu söyle" kuralı, aranan parçanın bulunamadığı durumu görünür kılıyor. Çelişkiyi işaretleme kuralı da bayat bir dokümanı fark etmenin yolu.

Ayşe'nin sorusu da bu yapıya göre daha iyi sorulabilir:

According to ADR-007-order-cancellation-and-stock-release.md and the
cancel endpoint in openapi-bookstore-api-v1.yaml: when an order is cancelled,
when is the reserved stock released, and which status transitions are allowed?
Quote the heading of each part you use.

Dokümanın adını anmak Help Center'ın açıkça önerdiği şey ve arama tool'unu doğru dosyaya yönlendiriyor. Bu soruya beklenen cevap, ADR'deki kararı ve OpenAPI'deki durum geçişlerini hangi başlıktan aldığını söyleyerek anlatan ve ikisi arasında bir fark varsa onu işaretleyen bir cevap.

Paylaşım, Arşiv ve Silme

Team ve Enterprise planlarında project'ler ekiple paylaşılabiliyor. Project içindeki "Share project" düğmesiyle kişileri adla, e-postayla ya da toplu bir adres listesiyle ekliyorsun; yönetici paylaşımı kapattıysa düğme çalışmıyor. İki yetki seviyesi var: "Can view" project'te konuşabilir ama instructions'ı ya da knowledge'ı değiştiremez; "Can edit" instructions'ı ve knowledge'ı değiştirebilir, üyeleri yönetebilir. Projects sayfasında "Your projects", "Organization" ve "Shared with you" sekmeleri var. Birleşik deneyimde görevleri içeren project'ler de aynı biçimde paylaşılıyor.

Biten bir project'i silmek yerine arşivlemek çoğu zaman daha doğru: arşivde paylaşım, üyeler ve knowledge korunuyor, konuşmalara erişilebiliyor. Arşivdeki bir project doğrudan silinemiyor; önce arşivden çıkarmak gerekiyor. Silme ise kalıcı. Sık kullandığın project'leri yıldızlayıp sol panelde sabitleyebiliyorsun.

Üretimde Dikkat

Knowledge'ın bir sahibi olsun. Ekip project'lerinde en sık görülen sorun bayat doküman: ADR güncellenmiş, project'teki kopyası eski. Project'i düzenleme yetkisini bir iki kişiyle sınırla ve dokümanlar değiştiğinde project'teki dosyayı da güncellemeyi iş akışına ekle; eski sürümü silmeden yenisini yüklemek, iki çelişkili dosya bırakır.

Project'i işe göre böl, ekibe göre değil. "Backend ekibi" adlı her şeyi içeren bir project yerine "Bookstore Teknik Dokümantasyon" ve "Bookstore Destek Cevapları" gibi amacı belli project'ler, hem aramayı hem de yetkiyi kolaylaştırıyor.

Değişen veriyi dosya olarak koyma. Stok seviyeleri, günlük satışlar ya da açık hata kayıtları gibi sürekli değişen veri, yüklendiği gün bayatlar. Bunların yeri connector'lar; sekizinci yazıda Bookstore'un kendi verisine bir MCP (Model Context Protocol; Claude'un dış araç ve veri kaynaklarına bağlandığı açık protokol) server üzerinden bağlanmayı göreceğiz.

Sık Düşülen Tuzaklar

Bütün repository'yi zip'leyip yüklemek. Project'ler codebase'i gezmek için değil, dokümanlarla çalışmak için; birleşik deneyimde "Add from GitHub" de desteklenmiyor. Kodun içinde çalışan bir agent istiyorsan onun yeri Claude Code ve kendi serisinde anlatılıyor.

Anlamsız dosya adları. doc1.pdf, final-v2.docx gibi adlar, RAG modunda hem aramayı hem de cevaptaki kaynağı okumayı zorlaştırır.

Gizli ve kişisel veriyi knowledge'a koymak. Project knowledge paylaşılan project'te herkesin konuşmasına giriyor. Müşteri adı, adres, API anahtarı ya da şifre içeren dosyayı yüklemeden önce temizle.

Project adının ve açıklamasının Claude'a ulaştığını sanmak. Ulaşmıyor; Claude'un bilmesi gerekeni instructions'a yaz.

Konuşmaların birbirini gördüğünü varsaymak. Bir konuşmadaki karar, knowledge'a yazılmadıkça diğer konuşmada bilinmiyor; memory bir kısmını taşıyabilir ama bu bir garanti değil.

Küçük Bir Deneme

★☆☆ Sık kullandığın üç dokümanla bir project aç, instructions'a "her iddia için dosya adını ve başlığı yaz" kuralını ekle ve aynı soruyu project içinde ve dışında sor. Cevaplarda kaynak gösterme farkı ne?

★★☆ Bir project'teki dosya adlarını tanımlayıcı adlarla değiştir ve uzun bir dokümanı başlıklarla bölümlere ayır. Değişiklikten önce ve sonra, doküman adını anmadan aynı üç soruyu sor; hangi cevaplarda doğru dosyaya atıf yapıldı?

★★★ Ekibin için iki project tasarla: biri teknik dokümantasyon, biri destek cevapları. Her biri için knowledge listesini, instructions metnini, kimin "Can edit" yetkisi alacağını ve dokümanların hangi olayda güncelleneceğini yazan bir sayfalık bir kural metni hazırla.

Project memory'den kısaca bahsettik. Beşinci yazıda Claude'un memory'sinin 2026'daki yapısını, neyi hatırlayıp neyi hatırlamadığını, chat search'ü ve hassas işler için incognito'yu Bookstore ekibinin günlük işi üzerinden göreceğiz.