Ücretsiz8 dk okumaDers 4 / Bu gece telefonunda uygulaman
Bu dersin sonunda yeni projendeki üç ajan dosyasının ne olduğunu, hangisine yazacağını ve nedenini biliyorsun. AGENTS.md dosyasına gerçek makineni anlatan dört kural eklemiş — emülatör yok, Windows, fiziksel telefon — ve Claude Code'u proje içinde başlatıp onlara okutmuş olacaksın.
Proje klasörünü bir dosya gezgininde aç ve gizli dosyaları göster. Beklediğin şeylerin yanında — app, package.json, app.json — istemediğin üç tane daha var.
Üç dosya, senin için create-expo-app tarafından yazıldı. Bunları henüz kimse öğretmiyor, çünkü mevcut kurs kuşağı kaydedildiğinde yoklardı.
create-expo-app onları varsayılan olarak yazıyor ve bu, bu kursun ne olduğunu değiştiriyor: bir ajanı mobil uygulama yapmaya yönlendirmek artık akıllıca bir numara değil, üreticinin desteklediği çalışma biçimi. Onlar olmadan bir proje istersen, npx create-expo-app@latest --no-agents-md üçünü de atlıyor.
Her biri ne işe yarıyor
AGENTS.md, ajanı projenin SDK sürümüne uyan Expo belgelerine yönlendiriyor. Bu cümle göründüğünden değerli: modeller daha eski Expo üzerine eğitildi ve yapay zekânın yazdığı Expo kodunun çoğu iki, üç ya da dört SDK sürümü geride ve kendinden emin biçimde yanlış. Bu dosya o düzeltme.
CLAUDE.md tek bir satır içeriyor: @AGENTS.md. Bu, AGENTS.md'yi Claude Code'un bağlamına aktarıyor.
.claude/settings.json, Claude Code eklenti pazarındaki resmî Expo eklentisini önceden etkinleştiriyor.
Bir yerine üç dosya var, çünkü her biri farklı bir ajan geleneğini hedefliyor; böylece aynı proje, ajana özel hiçbir yapılandırma olmadan Claude Code, Codex ya da Cursor ile çalışıyor.
Tek bir import tutuyorsa CLAUDE.md neden var peki? Çünkü Claude Code AGENTS.md'yi değil, CLAUDE.md'yi okuyor. Anthropic'in belgeleri tam olarak bu deseni öneriyor: bir depo başka ajanlar için zaten AGENTS.md kullanıyorsa, onu içeri aktaran bir oluştur ki her iki araç da aynı talimatları çoğaltmadan okusun. Bir symlink de işe yarardı, ama Windows'ta symlink Yönetici hakları ya da Geliştirici Modu istiyor. Import istemiyor.
Pratik
Claude Cowork'ü kendi bilgisayarında aç ve bunu gerçek dosyalarda dene. Her modül, yaptığını gönderdiğin bir checkpoint'le biter.
Yani kursun geri kalanı için kural şu ve bu Expo'nun kendi tavsiyesi:
Proje talimatlarını CLAUDE.md'ye değil, AGENTS.md'ye koy. Tek yer, her ajan, çoğaltma yok.
İlk düzenlemen
AGENTS.md yazıldığı hâliyle Expo'yu biliyor. Seni bilmiyor: Windows'ta olduğunu, bu makinede emülatör olmadığını, test cihazının masandaki telefon olduğunu.
AGENTS.md'yi herhangi bir metin düzenleyicide aç — Not Defteri olur — ve en alta şu dört kuralı ekle.
## Bu projenin makinesi- `npx expo start` ile fiziksel bir Android cihazda çalıştır. Bir emülatör ya da simülatörün mevcut olduğunu asla varsayma.- Paketleri `npm install` ile değil, her zaman `npx expo install <paket>` ile kur; böylece sürümler SDK ile eşleşir.- Bu proje Windows'ta geliştiriliyor. Asla Xcode, CocoaPods ya da `npx expo run:ios` önerme.- Bana önce sormadan `npx expo prebuild` çalıştırma.
Her satır belirli bir şeyi engelliyor. Birincisi 2. dersteki dört saatlik emülatör sapmasını durduruyor. İkincisi okunduğundan daha önemli: npx expo install SDK'na uyan paket sürümünü seçiyor, npm install en yenisini seçiyor ve bu uyumsuzluk, bir Expo build'inin kimsenin açıklayamadığı sebeplerle çökmesinin en yaygın nedeni. Üçüncüsü, çalıştıramayacağın bir makinede Xcode açman söylenmesinden kurtarıyor. Dördüncüsü bir korkuluk — SDK 57 itibarıyla expo prebuild varsayılan olarak yerel klasörleri siliyor ve yeniden üretiyor.
Expo'nun bölümü olduğu yerde kalıyor. Seninki altına gidiyor. Dört kısa, kontrol edilebilir cümle, bir sayfa iyi niyeti döver.
Dosyayı kısa tut. Anthropic'in tavsiyesi 200 satırın altı — daha uzun dosyalar daha fazla bağlam tüketiyor ve uyumu düşürüyor; bir ajanın kesinlikle yazdığın bir talimatı bazen görmezden gelmesinin gösterişsiz sebebi bu.
modül buraya bir kural daha ekliyor: Claude'un izin vermediğin build'lere paranı harcamasını durduran kural. Harcanacak para olana kadar bekleyebilir.
Claude'u projenin içinde başlat
dersteki hesabın önem kazanmaya başladığı yer burası: buradan sonra Claude'un klasörün içinde çalışması ve dosyalarını okuyup yazması gerekiyor, bu da abonelik ya da Console kredisi istiyor.
Belgeler klasöründen değil, projenin içinden çalıştır. Dev server'ı kendi penceresinde çalışır hâlde bırak.
claude
Claude Code, CLAUDE.md'yi başlatıldığı klasörden ve üstündeki her klasörden okuyor; yani onu burada başlatmak @AGENTS.md'yi ve dört kuralını yükleyen şey. Bir üst dizin hiçbir şey yüklemiyor ve elinde hangi makinede olduğuna dair fikri olmayan, kendinden emin bir ajan oluyor.
Ona cevabı kontrol edilebilir bir soru sor:
AGENTS.md'yi oku ve bu makineyle ilgili eklediğim dört kuralı, her birini tek cümleyle bana söyle.
Dört kuralınla geri dönerse zincir çalışıyor. Expo hakkında genel bir şeyle dönerse yanlış klasörde başlatmışsın.
Eklenti ve MCP sunucusu
Birinci taraf iki parça daha var ve ikisi de 4. modülde gerçekten kullanışlı hâle geliyor.
Resmî Claude Code eklentisi, Expo'nun skill'lerini kuruyor ve Expo'nun MCP sunucusunu tek adımda kaydediyor. Bir oturumun içinden /plugin install expo@claude-plugins-official ile çalıştır. Skill'ler slash komutu olarak çağrılmak yerine konuşmadan keşfediliyor, yani ezberlenecek bir liste yok.
Expo MCP sunucusuhttps://mcp.expo.dev/mcp adresinde yaşıyor ve ajana güncel Expo belgelerine canlı erişim, build geçmişin ve — sonradan önemli olan kısım — çalışan uygulamanın ekran görüntüsünü alıp üzerine dokunma yeteneği veriyor. Bu, 4. modülün imza dersi ve yapay zekâyla uygulama yapmaya yönelik en eski şikâyetin cevabı: modelin telefonu göremediği şikâyetinin.
Kontrol et
Projende AGENTS.md, CLAUDE.md ve .claude/settings.json dosyalarını bulabiliyorsun
CLAUDE.md, AGENTS.md'nin kopyasını değil, import'unu içeriyor
Dört makine kuralın CLAUDE.md'de değil, AGENTS.md'de
claude proje klasörünün içinden başlıyor
AGENTS.md'yi okuması istendiğinde dört kuralını sana geri sayıyor
Şunu görürsen Claude'un kurallarımdan haberi yok gibi
Olasılık sırasına göre iki sebep. Claude Code'u projenin üstündeki bir klasörden başlattın, yani projenin CLAUDE.md'sini hiç okumadı — çık, projeye cd yap, yeniden başlat. Ya da kuralları CLAUDE.md'ye koydun ve bir şey onun üzerine yazdı; zaten ait oldukları yer olan AGENTS.md'ye taşı.
Şunu görürsen Her mesaj, 401 ile başarısız olan bir giriş tetikliyor
Haziran 2026'da raporlandı: bir Expo proje dizininin içinde her mesaj, başarısız olan ve Claude Code'u yanıt veremez hâlde bırakan otomatik bir /login tetikliyordu; aynı oturum projenin dışında normal çalışıyordu. .claude klasörünü silmek ve etkin eklenti listesini boşaltmak, raporlayan kişide sorunu çözmedi. Sende olursa yanlış bir şey yapmış değilsin — bir akşamını kaybetmeden önce raporun hâlâ açık olup olmadığına bak.
Az önce ne öğrendin
create-expo-app varsayılan olarak AGENTS.md, CLAUDE.md ve .claude/settings.json yazıyor; --no-agents-md bunu devre dışı bırakıyor.
AGENTS.md, ajanı SDK'ya uyan Expo belgelerine yönlendiriyor; bu, daha eski Expo üzerine eğitilmiş bir model için düzeltme demek.
Claude Code CLAUDE.md'yi okuyor, o yüzden CLAUDE.md, AGENTS.md'yi @AGENTS.md ile içeri aktarıyor — symlink değil import, çünkü Windows'ta symlink Yönetici hakkı istiyor.
Proje talimatları AGENTS.md'ye gidiyor ve yaklaşık 200 satırın altında tutuluyor, çünkü uzun dosyalara uyum düşüyor.
Claude Code o zinciri başlatıldığı klasörden yüklüyor, o yüzden onu projenin içinde başlat.