Claude Code × NotebookLM Bağlantı Rehberi

Araştırma tarafında NotebookLM, üretim ve otomasyon tarafında Claude Code. Bu rehber, ikisini aynı akışta kullanmak için kurulumu, güvenli kullanım sınırlarını ve pratik komut örneklerini adım adım anlatır.

Hedef: tek sohbetten kaynak ekleme, özet çıkarma, podcast/sunum/zihin haritası üretme ve araştırmadan üretime geçme akışını kurmak.

1. Araştır — YouTube, PDF, URL ve doküman kaynaklarını NotebookLM tarafında düzenle.
2. Sentezle — Claude Code üzerinden kaynakları sorgula, özetle ve üretime hazır hale getir.
3. Üret — Podcast, slide deck, zihin haritası, quiz ve içerik taslağı gibi çıktılar oluştur.
4. Kontrol et — Kurulum, kimlik doğrulama ve limit sorunlarını test komutlarıyla denetle.

Güncel durum

Mayıs 2026 itibarıyla notebooklm-py, Google NotebookLM için geliştirilmiş gayriresmi bir Python istemcisi ve agentic skill yapısı olarak konumlanıyor. Proje; Claude Code, Codex ve benzeri ajanlarla kullanılabilecek bir NotebookLM skill'i sunuyor.

Rehberi iki katmanda düşünmek gerekir: birincisi NotebookLM'in kullanıcıya sunduğu üretim özellikleri, ikincisi notebooklm-py'nin bunları komut satırı ve ajan akışına taşıma yaklaşımıdır.

• NotebookLM — Kaynak ekleme, sohbet, Audio Overview, Video Overview, mind map, infographic ve slide deck gibi çıktılar üretir.
• Claude Code — Terminal, masaüstü, IDE ve web akışlarında çalışan; kod tabanı, dosyalar ve komut satırıyla çalışan bir geliştirme ajanıdır.
• notebooklm-py — NotebookLM'i Python/CLI ve agent skill yapısına bağlamayı amaçlayan gayriresmi topluluk projesidir.
• Risk — Kullandığı uç noktalar resmi/stabil API garantisi taşımaz. Bu yüzden kurulum bugün çalışırken ileride değişebilir.

Başlamadan önce gerekenler

En sık hata, Claude Code veya Python tarafı hazır olmadan NotebookLM bağlantısını kurmaya çalışmaktır.

• Claude Code — NotebookLM skill'ini konuşma ve terminal akışına bağlamak için.
• Claude hesabı — Claude Code kullanımı için aktif erişim gerekir. Plan ve limitler hesabına göre değişebilir.
• Google hesabı — NotebookLM not defterlerine erişmek ve kimlik doğrulamak için.
• Python — notebooklm-py paketini çalıştırmak için.
• Playwright/Chromium — Google oturum açma ve tarayıcı tabanlı doğrulama akışı için.
• GitHub repo bağlantısı — Repoyu incelemek, skill kurulumunu yapmak veya Claude Code'a kurdurmak için.

Hiç terminal bilmiyorsan önce Claude Code'un kurulup açıldığını test et. claude --version ve Claude Code içindeki /doctor kontrolleri işini kolaylaştırır.

İki kurulum yaklaşımı

Yol A — Kolay kurulum: Claude Code'a GitHub repo linkini ver, kurulumu yapmasını iste. Yeni başlayanlar için daha anlaşılırdır.

Yol B — Manuel kurulum: pip, Playwright, login ve skill install komutlarını sırayla kendin çalıştırırsın. Hata ayıklaması daha nettir.

Yeni başlayan için önerilen prompt:

Bu GitHub reposunu incele, güvenli kurulum adımlarını açıkla ve bilgisayarıma notebooklm-py kurulumunu adım adım yaptır. Hata alırsam durup önce sorunu teşhis et.

Daha otomasyon odaklı prompt:

Repo: github.com/teng-lin/notebooklm-py
Bunu Claude Code ile çalışacak şekilde kur. Python, Playwright, Google login ve NotebookLM skill kontrolünü sırayla yap. Her adımdan sonra doğrulama komutunu çalıştır.

Onay bilinci: Claude Code'un dosya değiştirmesine veya komut çalıştırmasına izin verirken ne yaptığını oku. Onay istemeden kritik işlem yapmaması güvenlik açısından önemlidir.

Claude Code'u hazırlama

Claude Code tarafını hazır hale getirmeden notebooklm-py kurulumuna geçme.

macOS, Linux veya WSL için:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell için:

irm https://claude.ai/install.ps1 | iex

Kurulumdan sonra terminali kapatıp aç ve kontrol et:

claude --version

Claude Code açıldıktan sonra kullanılabilecek temel kontrol:

/doctor

Windows kullanıyorsan Git for Windows kurulu olması Claude Code'un Bash araçlarını daha sağlıklı kullanmasına yardımcı olabilir.

notebooklm-py kurulumu

Manuel kurulumda önce paketi tarayıcı desteğiyle kurarsın. Bu destek, Google oturum açma akışında Playwright/Chromium kullanımını kolaylaştırır.

pip install "notebooklm-py[browser]"
playwright install chromium

Ardından Google hesabı ile giriş akışını başlat:

notebooklm login

Kimlik doğrulamanın çalıştığını test et:

notebooklm auth check --test --json

Test çıktısında beklenen temel işaret, durumun başarılı görünmesidir. Hata alırsan önce hesabın NotebookLM'e erişebildiğini ve tarayıcı oturumunun tamamlandığını kontrol et.

Google hesabı ve NotebookLM erişimi

Kurulumun kritik noktası Google oturumudur. notebooklm-py, NotebookLM'e programatik erişim için oturum bilgisini kullanır.

Doğru hesabı seçmek için kontrol listesi:

• NotebookLM'i normal tarayıcıda açıp aynı Google hesabıyla notebook oluşturabildiğini kontrol et.
• Birden fazla Google hesabın varsa kurulum sırasında kullanılacak hesabı özellikle seç.
• Kurumsal hesap kullanıyorsan Workspace yöneticisinin NotebookLM erişimini kısıtlamadığından emin ol.
• Giriş tamamlandıktan sonra notebooklm auth check --test --json komutuyla bağlantıyı doğrula.

Sık görülen belirtiler ve muhtemel nedenleri:

• Notebook bulunamıyor — Yanlış Google hesabı seçilmiş olabilir.
• Login döngüye giriyor — Tarayıcı çerezleri, profil seçimi veya kurumsal güvenlik ayarları sorun çıkarıyor olabilir.
• Test başarısız — NotebookLM erişimi yok, oturum eksik veya paket sürümü değişmiş olabilir.

Gizlilik uyarısı: Google hesabı bilgilerini veya oturum dosyalarını herkese açık repolara, ekran kayıtlarına ya da paylaşılabilir klasörlere koyma.

Claude Code'a NotebookLM skill ekleme

notebooklm-py kurulduktan ve Google girişin doğrulandıktan sonra skill kurulumu yapılır.

notebooklm skill install

Alternatif npx kurulumu:

npx skills add teng-lin/notebooklm-py

Kurulumdan sonra durum kontrolü:

notebooklm skill status

Claude Code içinde örnek ilk komut:

NotebookLM bağlantısını kontrol et. Uygunsa yeni bir test notebook'u oluştur ve içine tek bir kaynak ekleyerek özet çıkar.

Skill kurulumu tamamlandıktan sonra yeni bir Claude Code oturumu açmak bazen daha temiz sonuç verir. Eski oturum, yeni skill dosyalarını hemen fark etmeyebilir.

İlk test: küçük başla

Kurulumdan sonra doğrudan 20 kaynaklık büyük bir araştırma yaptırma. Önce tek kaynakla çalışıp bağlantının gerçekten işlediğini gör.

1. NotebookLM içinde yeni bir test notebook'u oluştur.
2. Tek bir YouTube linki, makale URL'si veya kısa PDF kaynağı ekle.
3. Kaynağın eklenip eklenmediğini kontrol et.
4. Kaynağın üç maddelik özetini iste.
5. Aynı kaynak için podcast veya zihin haritası üretmeyi dene.

Claude Code içinde örnek test promptu:

NotebookLM'de "AI Test" adlı bir notebook oluştur.
Bu kaynağı ekle: [URL]
Kaynağın 3 maddelik özetini çıkar.
Sonra aynı kaynak için zihin haritası oluşturmayı dene.

Tek kaynakla sorunsuz çalışıyorsa ikinci aşamada 3-5 kaynaklık küçük bir araştırma dene. Büyük arşivleri en sona bırak.

Kullanım senaryoları

• Araştırma özeti — Bir konuya ait 5-10 kaynağı eklet, ana iddiaları ve karşıt görüşleri çıkart.
• Podcast üretimi — Kaynaklardan konuşma formatında Audio Overview üret ve sonrasında kısa paylaşım metni yazdır.
• Slide deck — Kaynaklardan sunum iskeleti, bölüm başlıkları ve konuşmacı notları çıkart.
• Zihin haritası — Bir konunun kavram ağını ve alt başlık ilişkilerini görsel düşünme için yapılandır.
• İçerik senaryosu — Araştırmadan kısa video metni, carousel akışı ve açıklama metni üret.
• Proje başlatma — Araştırma sonucu çıkan içgörüleri ürün fikri, landing page ya da prototip planına dönüştür.

En iyi sonuç için Claude'a sadece "araştır" deme. Çıktı formatını, hedef kitleyi, uzunluğu ve kullanım yerini net ver.

Hazır prompt örnekleri

Köşeli parantezli alanları kendi konuna göre değiştir.

1. Kaynak ekleyip podcast üretme

NotebookLM'de "[Konu] Araştırması" adlı bir notebook oluştur.
Şu kaynakları ekle: [URL 1], [URL 2], [PDF yolu]
Kaynaklardan önce kısa özet çıkar, sonra dinleyici dostu bir podcast taslağı üret.

2. Sunum iskeleti çıkarma

Bu notebook'taki kaynaklara dayanarak 10 slaytlık bir sunum iskeleti oluştur.
Her slayt için başlık, 3 madde, konuşmacı notu ve görsel önerisi ver.

3. İçerik üreticisi akışı

Bu kaynaklardan sosyal medya için 60 saniyelik video metni üret.
Hook güçlü olsun, dili Türkçe ve doğal olsun. Sonuna yorum CTA'sı ekle.

4. Karşılaştırmalı analiz

Notebook'taki kaynakları karşılaştır.
Aynı fikirleri, çelişen noktaları ve eksik kalan kanıtları tablo halinde çıkar.

Hızlı komut referansı

• Claude Code kur (macOS/Linux/WSL) — curl -fsSL https://claude.ai/install.sh | bash
• Sürüm kontrolü — claude --version
• Sağlık kontrolü — Claude Code içinde /doctor
• notebooklm-py kur — pip install "notebooklm-py[browser]"
• Chromium kur — playwright install chromium
• Google login — notebooklm login
• Auth test — notebooklm auth check --test --json
• Skill kur — notebooklm skill install
• Alternatif skill kur — npx skills add teng-lin/notebooklm-py
• Skill kontrol — notebooklm skill status

Komutlar zaman içinde değişebilir. Hata alırsan ilk iş proje reposunun README ve installation dokümanındaki güncel komutları kontrol et.

Sorun giderme

Kurulum hatalarında rastgele komut denemek yerine hatayı sınıflandır. Genellikle problem dört alandan birindedir: Claude Code, Python/Playwright, Google login veya NotebookLM erişimi.

• claude komutu tanınmıyor — Terminali kapatıp aç. PATH güncellenmemiş olabilir. claude --version ile tekrar test et.
• Playwright kurulumu takılıyor — İnternet bağlantısını ve sistem izinlerini kontrol et. Chromium kurulumu büyük dosya indirebilir.
• Google login tamamlanmıyor — Doğru tarayıcı profili, doğru Google hesabı ve kurumsal hesap kısıtlarını kontrol et.
• Auth test başarısız — Önce notebooklm login komutunu tekrar çalıştır, sonra tek hesapla test et.
• Skill görünmüyor — notebooklm skill status çalıştır ve Claude Code oturumunu yeniden başlat.
• Komutlar farklı davranıyor — notebooklm-py gayriresmi olduğu için güncel sürüm notlarını kontrol et.

Claude Code'a teşhis için verilebilecek prompt:

Kurulumda hata aldım. Terminal çıktısını analiz et.
Önce hatayı sınıflandır: Claude Code, Python, Playwright, Google login veya NotebookLM erişimi.
Sonra sadece en güvenli bir sonraki adımı öner.

Teknik uyarılar ve güvenli kullanım

Bu bağlantı akışı güçlüdür; fakat üretim sistemleri için resmi, garanti edilmiş bir Google API gibi düşünülmemelidir. En doğru yaklaşım; kişisel araştırma, prototip, içerik üretimi ve eğitim amaçlı akışlarda kontrollü kullanmaktır.

• notebooklm-py bir topluluk projesidir; Google veya Anthropic tarafından resmi entegrasyon olarak sunulmaz.
• Kullandığı NotebookLM uç noktaları değişirse bazı komutlar bozulabilir.
• Ağır kullanımda hız sınırları, oturum yenileme sorunları veya erişim kısıtları oluşabilir.
• Özel verileri, müşteri belgelerini ve gizli dokümanları yüklemeden önce izin ve gizlilik politikasını kontrol et.
• Önemli kararlar için NotebookLM çıktısını tek kaynak kabul etme; kritik iddiaları bağımsız kaynaklarla doğrula.

Bu rehber Mayıs 2026 itibarıyla kamuya açık bilgilere göre hazırlanmıştır. Özellikler, kurulum komutları ve erişim koşulları değişebilir.