Claude Code, Cursor ve Codex’e PDF ve Word dosyalarınızı verin

Ekim 2026 itibarıyla Claude Code bir PDF’yi kendi başına okuyabilir, Cursor sohbete eklediğiniz bir PDF’yi okur, Codex CLI ise görsel girdisini belgeler ama PDF’leri belgelemez. Üçü de doğrudan okuduğu biçimler arasında Word (DOCX) dosyalarını saymaz. Ajanın birden fazla kez kullanacağı belirtimler, kılavuzlar, makaleler ve sözleşmeler için bunları Markdown’a dönüştürün, kopyaları projede tutun ve ajana nerede olduklarını söyleyin.

Bu rehber, bir proje klasöründe çalışan kodlama ajanları içindir. Bir kod projesi yerine ayrı bir başvuru belgeleri klasörü hazırlıyorsanız şu rehberimizle başlayın: belgeleri yapay zekâ ajanları için hazırlama.

Her ajan doğrudan ne okur

Her satıcının belgelerinin Ekim 2026 itibarıyla söylediği şudur.

Claude Code kısa bir PDF’yi bütünüyle okur. 10 sayfadan uzun bir PDF, her seferinde en fazla 20 sayfalık aralıklarla okunur ve bu okumalar poppler’daki pdftoppm programını gerektirir. Windows’ta bir poppler derlemesini kendiniz kurar ve PATH’inize eklersiniz; o olmadan okuma başarısız olur. Ayrıntılar şurada: Claude Code araçlar başvurusu.

Cursor, 2.4 sürümünde PDF okumayı ekledi, Ocak 2026’da yayımlandı. Cursor’un varsayılan yok sayma listesi hâlâ PDF dosyalarını ve birkaç Office biçimini içeriyor, Cursor’un yardım sayfası da yok sayılan dosyaların ajandan engellendiğini belirtiyor. PDF’yi ajanın projede bulmasını beklemek yerine sohbete kendiniz ekleyin.

Codex CLI görselleri kabul eder ; bunlar komut satırında verilebilir ya da isteme yapıştırılabilir. Belgeleri, CLI için PDF veya Word girdisini anlatmıyor.

Bir ajan, bilgisayarınıza kurulu bir programı çalıştırarak yine de bir belgeden metin çekmeye çalışabilir. Bu bazen işe yarar, ama hangi metni aldığını görmezsiniz ve yanlış okunmuş bir tablo doğrudan yanıtına girer.

Markdown kopyası neden daha iyi çalışır

Markdown; başlıkları, listeleri ve tabloları olan düz metindir. Bir proje içinde bu, size bir PDF veya DOCX dosyasının vermediği dört şey sağlar.

• Ajan onda arama yapabilir. Düz metin araması bir ifadeyi Markdown dosyasında bulur. DOCX dosyası, XML parçalarından oluşan bir ZIP arşividir, bu yüzden düz metin araması onun içinde hiçbir şey bulamaz.
• Ajan kesin satırları alıntılayabilir, siz de alıntılanan her cümleyi dosyada bulup çevresinde ne olduğunu okuyabilirsiniz.
• Ajan yalnızca ihtiyaç duyduğunu okur: uzun bir kılavuzda arama yapar, sonra sayfaları baştan sona taramak yerine önemli olan tek bölümü açar.
• Git neyin değiştiğini gösterir. Bir belirtimin yeni baskısı geldiğinde diff değişen satırları listeler.

Ajanın tam olarak ne okuduğunu da görürsünüz. Bir tablo yanlış çıktıysa onu Markdown dosyasında bir kez düzeltirsiniz ve sonraki her oturum düzeltilmiş kopyayı kullanır.

Metin katmanı olmayan taranmış bir PDF yalnızca sayfa görüntülerinden oluşur. Bir ajan onda arama yapabilmeden önce OCR (metin tanıma) gerekir. MD Factory taranmış PDF’lerdeki metni bilgisayarınızda tanır. Sonucu kontrol etmek için bkz. taranmış PDF’leri dönüştürme rehberimiz.

Belgeleri bir docs klasörüne koyun

Orijinalleri ve Markdown kopyalarını projenin içinde, onlara bağlı kodun yanında tutun:

payments-service/
  AGENTS.md
  docs/
    partner-api-spec.pdf
    partner-api-spec.md
    partner-api-spec_images/
    supplier-contract.docx
    supplier-contract.md
  src/

1. PDF ve Word dosyalarını docs klasörüne kopyalayın. MD Factory her Markdown dosyasını orijinalinin yanına kaydeder, yani kopyalar burada görünecektir.
2. MD Factory’de Klasör ekle’ye tıklayıp docs klasörünü seçin ya da klasörü pencereye bırakın. Dönüştürme hemen başlar.
3. Her dosya bir durum gösterene kadar bekleyin: Tamamlanmış, İnceleme gerekiyor veya Arızalı.
4. Neye bakılacağını görmek için bir dosyanın yanındaki İnceleme gerekiyor’a tıklayın, ardından o kısmı orijinalle karşılaştırın.

Bir belgedeki görseller, adını taşıyan bir klasöre konur, örneğin partner-api-spec_images. PDF ve Word dosyalarının kendisi değişmez.

Orijinalleri projede tutun. Sayfa numaraları, şekiller ve imzalı kesin ifade orada durur; kopya ile ajanın yanıtı çeliştiğinde bunlara ihtiyacınız olacak.

Ajana dosyaları gösterin

Ajana, yönerge dosyasında belgelerin kısa bir listesini verin. Claude Code CLAUDE.md dosyasını okur; projede CLAUDE.md yoksa AGENTS.md dosyasını okur. Codex ve Cursor AGENTS.md dosyasını okur. Örneğin:

## Başvuru belgeleri

PDF ve Word dosyalarının Markdown kopyaları docs/ içindedir.
Her kopyanın orijinali yanındadır.

- `docs/partner-api-spec.md`: iş ortağı API belirtimi, sürüm 3.2
- `docs/supplier-contract.md`: tedarikçi sözleşmesi, 2026 baskısı

İş ortağı API’si veya sözleşme hakkındaki soruları yanıtlamadan önce docs/ içinde arama yapın.
Dayandığınız bölüm başlığını alıntılayın.
docs/ içindeki dosyaları düzenlemeyin.

Yolları yukarıdaki gibi ters tırnak içinde yazın, şu biçimde değil: @docs/partner-api-spec.md. CLAUDE.md’de @ ile başlayan bir yol içe aktarmadır: Claude Code dosyanın tamamını her oturumun başında yükler. Ters tırnak içindeki bir yol yalnızca düz bir anma olarak kalır ve Claude dosyayı bir görev gerektirdiğinde açar.

Listeyi kısa tutun. Codex, yönerge dosyalarını birlikte varsayılan sınırı olan 32 KiB’a ulaştığında okumayı bırakır.

Tek bir görev için dosyayı isteminizde belirtin:

• Claude Code’da @ yazın ve dosyayı seçin. Claude Code içeriğini konuşmaya ekler okuma sınırına sığıyorsa; varsayılan sınır 25.000 belirteçtir. Daha uzun bir dosya için Claude’dan önce onda arama yapmasını isteyin.
• Cursor’da @ yazın ve dosyayı ya da docs klasörünün tamamını seçin, şurada anlatıldığı gibi: Cursor yardımı.
• Codex CLI’da dosya yolu eklemek için @ yazın ya da dosya eklemek için /mention komutunu kullanın, şurada anlatıldığı gibi: Codex istem rehberi.

Belgeyi adıyla belirten ve alıntı isteyen bir istem şöyle görünebilir:

docs/partner-api-spec.md dosyasındaki "Authentication" ve "Rate limits" bölümlerini
okuyun. API istemcisini bunlara uyacak şekilde güncelleyin.
Her değişiklik için dayandığı belirtim satırını alıntılayın.

Yanıtları kontrol edin ve kopyaları güncelleyin

Bir yanıta güvenmeden önce alıntılanan bölümü kendiniz bulun. İlk komutu PowerShell’de, ikincisini Git Bash’te kullanın:

Select-String -Path docs\*.md -Pattern "rate limit"
grep -n -i "rate limit" docs/*.md

Alıntı Markdown dosyasında yoksa orijinale bakın. Orada da yoksa ajan onu belgeden almamıştır. Sayfa numaraları ve şekiller için orijinali her zaman açın.

.gitignore dosyanıza dikkat edin. Claude Code’un araması gitignore’lanmış dosyaları atlar, ancak Claude yine de yolunu verdiğiniz bir dosyada arama yapabilir veya onu okuyabilir. Cursor, gitignore’lanmış dosyaları ajandan uzak tutar ancak .cursorignore içinde ! ile başlayan bir satır onları yeniden içeri almadıkça. Belgelerin Git dışında kalması gerekiyorsa Claude Code için her dosya yolunu yönerge dosyasında listeleyin ve Cursor için .cursorignore dosyasına şu satırı ekleyin: !docs/

Başvuru dosyaları yalnızca siz karar verdiğinizde değişmelidir. Her görevden sonra diff’e bakın. Claude Code’un docs klasörüne dokunmamasını istiyorsanız bunun için bir Edit deny kuralı ekleyin.

Yeni bir baskı geldiğinde docs klasöründeki orijinali aynı dosya adını koruyarak değiştirin ve MD Factory’ye yeniden ekleyin. Eski Markdown kopyasını düzenlemediyseniz MD Factory onun yerini alır. Düzenlediyseniz yeni kopya, örneğin partner-api-spec (2).md gibi numaralı bir ad alır ve düzenlemeleriniz eski dosyada kalır. Markdown dosyasının diff’i bu durumda hangi bölümlerin değiştiğini ve hangi kodun buna uyması gerekebileceğini gösterir.

Gizli belgeler: ajan ne gönderir

MD Factory belgeleri bilgisayarınızda dönüştürür ve yüklemez, ancak bu yalnızca dönüştürmeyi kapsar. Ajan Markdown kopyasını okuduğunda metin, isteminizin geri kalanı gibi model sağlayıcısına gider.

• Claude Code bilgisayarınızda çalışır ama istemleri ve model çıktısını ağ üzerinden gönderir. Anthropic’in bu verileri ne kadar süre sakladığı hesap türünüze ve gizlilik ayarlarınıza bağlıdır; bkz. Claude Code’da veri saklama.
• Cursor, ajan bir dosyayı açtığında içeriğinin model isteğine eklenebileceğini söylüyor.
• Codex, varsayılan model sağlayıcısı olarak OpenAI’ı kullanır.

Bir ajan gizli bir belgeyi okumadan önce:

• Yalnızca görevin ihtiyaç duyduğu belgeleri dönüştürün ve ekleyin.
• Bir belge gizlilik anlaşması veya müşteri sözleşmesi kapsamındaysa metnin dış bir yapay zekâ hizmetine gönderilmesine izin verip vermediğini kontrol edin.
• Ajanın okumaması gereken belgeleri proje klasörünün dışında tutun. Claude Code’un reddetme kuralları ve Cursor’un yok sayma dosyaları yerleşik dosya araçlarını engeller. Her iki satıcı da bazı terminal komutlarının bu tür dosyaları yine de okuyabileceğini belirtir; bkz. Claude Code izinleri ve Cursor yok sayma dosyaları.
• Başkalarından gelen belgelere güvenilmeyen girdi gözüyle bakın: bunlar bir ajanı yönlendirmek için yazılmış metin içerebilir. Ajanın önerdiği komutları ve düzenlemeleri gözden geçirin.