İçeriğe atla
← Hazır setler ve kurulum rehberleri

Kurulum rehberi · son kontrol 17 Ekim 2026

Kod asistanına projeni doğru ve kontrollü tanıtan bağlam düzeni

Asistana her seferinde projeyi baştan anlatmak yerine: kalıcı proje talimatı, göreve özel dosya seçimi, o kapsamdan Repomix paketi (sohbet asistanı için), değişiklik incelemesi ve kullanım takibi.

Resmî belgelerden düzenlendi. Her adımın dayanağı altında yazılı.

Ne elde edersin

Projende talimat dosyası, görev için seçilmiş küçük bir bağlam paketi ve paketin hangi commit'ten üretildiğini gösteren adı olur; asistanın yaptığı değişikliği sen incelersin.

Nasıl çalışır

Sen başlatırsın. Paketi ve kullanım raporunu sen terminalden çalıştırırsın; hiçbir şey kendiliğinden çalışmaz. Paket yalnız bilgisayarında bir dosya olarak oluşur; onu bir asistana vermek ayrı ve senin kararındır.

Nerede çalışır

Windows · macOS · Linux

Maliyet neye bağlı

Abonelik · API kullanımı · Ücret yok · Kurulum hizmeti

Kime uygun

  • Claude Code ya da Codex ile kendi projesinde çalışan ve asistanın projeyi yanlış anlamasından yorulanlar
  • Küçük ve orta büyüklükte bir depoyu bir sohbet asistanına kontrollü biçimde göstermek isteyenler

Kime uygun değil

  • Kodunu hiçbir üçüncü taraf modele göndermek istemeyenler (paket, kullandığın asistanın modeline gider)
  • Terminal açmadan yalnız tarayıcıdan çalışmak isteyenler

Sistem nasıl bağlanıyor

Proje talimatı (CLAUDE.md / AGENTS.md) → görev için dosya seçimi → Repomix ile seçtiğin kapsamın paketi → asistanla çalışma → değişiklik incelemesi → ccusage ile kullanım gözlemi.

  • Claude Code gerekli

    Proje talimatını okuyan ve bağlamla çalışan kod asistanı

    Araç rehberi

  • Codex isteğe bağlı

    AGENTS.md dosyasını okuyan alternatif kod asistanı

    Alternatif: Claude Code yerine Codex kullanıyorsan

    Araç rehberi

  • Repomix gerekli

    Seçtiğin dosyaları tek bir bağlam dosyasında toplar, gizli anahtar benzeri dosyaları dışarıda bırakır, token sayısını gösterir

    Araç rehberi

  • ccusage isteğe bağlı

    Yerel Claude Code kayıtlarından kullanım ve tahmini maliyet raporu

    Alternatif: Harcamayı izlemek istemiyorsan bu adımı atla

    Araç rehberi

  • Serena isteğe bağlı

    Büyük depoda sembol düzeyinde kod arama (MCP sunucusu)

    Alternatif: Yalnız ana yol yetmediğinde, indeksli dalda

    Araç rehberi

  • codebase-memory-mcp isteğe bağlı

    Büyük depoda kod bilgi grafiği (MCP sunucusu); Serena'ya alternatif

    Alternatif: Serena yerine bunu tercih edersen; kurulumu üreticinin README'sinden izle

    Araç rehberi

  • Spec Kit isteğe bağlı

    Büyük bir özelliği şartnameden göreve bölerek planlar; kod indeksinin yerine geçmez

    Alternatif: Bağlam sorunu değil, görev planlama sorunun varsa

    Araç rehberi

Araçlar arası bağlantılar

  • Proje talimat dosyası (CLAUDE.md / AGENTS.md) Claude Code / Codex · Dosya ile · Proje klasöründeki Markdown dosyası; asistan oturum başında kendisi okur
  • Proje klasörü Repomix · Dosya ile · Terminalden verilen --include ve --ignore kalıplarına uyan dosyalar
  • Repomix çıktı dosyası Kod asistanı · Elle aktarım · Sen dosyayı sohbete yüklersin ya da yolunu söylersin; iki araç arasında otomatik bağlantı yoktur
  • Claude Code yerel kullanım kayıtları ccusage · Dosya ile · Bilgisayardaki ~/.claude/projects/ altındaki kayıt dosyaları okunur

Başlamadan önce

Bilgisayar ve yazılım

  • İşletim sistemi: Windows, macOS, Linux
  • Node.js: 22.0.0 ve üzeri (Repomix için)
  • Git: Herhangi güncel sürüm; paketin hangi commit'ten üretildiğini adlandırmak için
  • Claude Code: En az 2.1.277 (AGENTS.md'yi doğrudan okuması için); Amazon Bedrock ya da telemetri kapalı oturumlarda 2.1.281 ve üzeri. Sürümü claude --version ile gör. Yalnız CLAUDE.md kullanıyorsan bu koşul gerekmez
  • ccusage çalıştırıcısı: ccusage belgesi Node sürümü belirtmiyor; Bun 1.3+ öneriliyor, npx de kullanılabilir

Hesaplar

  • Kullandığın kod asistanının hesabı (Claude Code ya da Codex) — Bağlamı okuyacak ve çalışacak asistan. İki yol var: abonelik (Pro, Max, Team, Enterprise; kullanım plana dahil ve plan limitlidir) ya da API/Console hesabı (token tüketimine göre ücret). Abonelik fiyatları için Anthropic fiyat sayfasına bakılır. Codex için kendi planının koşulu OpenAI sayfasındadır

Adım adım kurulum

Hangisini yapmak istiyorsun?

İşaretlediğin adımlar yalnız bu tarayıcıda kalır; kurulumun çalıştığını doğrulamaz. 0/9 adımı bitirdin.

  1. 1. adım · Kod editöründe

    Projeye kalıcı talimat dosyası ekle

    Ne için: Asistan her oturumda proje kurallarını, komutlarını ve yasaklarını kendiliğinden okusun.

    1. Claude Code kullanıyorsan proje klasörünün köküne CLAUDE.md, Codex kullanıyorsan AGENTS.md dosyası aç. Claude Code'da oturumda /init yazarsan başlangıç dosyasını asistan çıkarır; sen düzeltirsin.
    2. İçine yalnız asistanın kodu okuyarak çıkaramayacağı şeyleri yaz: derleme ve test komutları, dokunulmayacak klasörler, adlandırma kuralı, projeye özel tuzaklar.
    3. Dosyayı kısa tut: Claude Code belgesi dosya başına 200 satırın altını hedefliyor. Gizli anahtar ve parola yazma.
    4. Projende zaten AGENTS.md varsa ve Claude Code'da da kullanmak istiyorsan iki yol var: CLAUDE.md dosyasına tek satır @AGENTS.md yaz (içe aktarma), ya da Claude Code'da /config > Project instructions ayarını claude-md-and-agents-md yap. Claude Code'un AGENTS.md'yi doğrudan okuması 2.1.277+ ister.
    Windows · macOS · LinuxKlasör: Proje klasörü
    › codex --ask-for-approval never "Summarize the current instructions."
    AGENTS.md · md
    # Proje kuralları
    
    ## Komutlar
    - Geliştirme sunucusu: npm run dev
    - Test: npm test
    - Derleme: npm run build
    
    ## Dokunulmayacaklar
    - dist/ ve node_modules/ klasörleri
    - .env dosyaları
    
    ## Çalışma biçimi
    - Önce ilgili dosyayı oku, sonra değiştir.
    - Her değişiklikten sonra testi çalıştır ve sonucu söyle.

    Codex belgesindeki örnek AGENTS.md yapısına göre sadeleştirilmiş şablon; komutları kendi projene göre değiştir. Claude Code için aynı içerik CLAUDE.md adıyla durabilir.

    Doğru yaptığını şuradan anlarsın

    • Proje kökünde CLAUDE.md ya da AGENTS.md dosyası vardır.
    • Claude Code'da CLAUDE.md varsa /context komutunun Memory files listesinde görünür. Yalnız AGENTS.md okunuyorsa belgedeki işaret, oturum başında konuşmada görünen 'no CLAUDE.md found; AGENTS.md loaded: <yol>' benzeri satırdır.
    • Codex kullanıyorsan belgedeki kontrol komutu yüklenen talimatları özetler; bu bir model isteği gönderir ve plan kotanı ya da ücretini harcar. Codex yolu Codex belgesine göre yazıldı.
    Takılırsan: bu adıma özgü sorunlar
    • Projede hem CLAUDE.md hem AGENTS.md var, Claude Code yalnız birini okuyor
      Claude Code varsayılan olarak CLAUDE.md varken AGENTS.md'yi okumaz. CLAUDE.md içine @AGENTS.md satırı ekle ya da /config > Project instructions ayarını claude-md-and-agents-md yap. CLAUDE.local.md dosyan varsa o da AGENTS.md'nin okunmasını engeller.
    • Codex büyük talimat dosyasının sonunu görmüyor
      Codex birleşik talimat boyutunu project_doc_max_bytes sınırında keser (varsayılan 32 KiB). Dosyayı kısalt ya da alt klasörlere böl.
    • /config içinde 'Project instructions' ayarı görünmüyor
      Belgeye göre bu, oturumun AGENTS.md okuyamadığı anlamına gelir: Claude Code 2.1.277'den eski; /plugin ile AGENTS.md'yi okuyan yerleşik eklenti kapatılmış; ya da 2.1.276 ve öncesinden yükseltmenin ilk oturumundasın (sonraki oturumda okunur); Bedrock/telemetri kapalı oturumlar için 2.1.281 altı da etkilenir. Her durumda CLAUDE.md içine @AGENTS.md içe aktarmasını koy.
  2. 2. adım · Kod ajanında

    Görev için gereken dosyaları seç

    Ne için: Bağlam paketine bütün depoyu değil, yalnız görevle ilgili klasörleri koymak.

    Burada sen kontrol edersin; sistem bu adımı senin onayın olmadan ilerletmemeli.

    1. Görevi bir cümleyle yaz: ne değişecek, hangi sayfa ya da modül.
    2. Asistana 'Bu görev için hangi dosya ve klasörlere bakmak gerekir? Yalnız liste ver, hiçbir dosyayı değiştirme.' diye sor.
    3. Gelen listeyi sen oku. Gereksiz klasörü çıkar, eksik gördüğünü ekle. Sonraki adımdaki --include kalıpları bu listeden çıkar.

    Doğru yaptığını şuradan anlarsın

    • Elinde, görevle ilgili klasörleri gösteren onaylanmış kısa bir liste olur.
    Takılırsan: bu adıma özgü sorunlar
    • Asistan her seferinde çok geniş bir liste veriyor
      Görev cümleni somutlaştır. Claude Code maliyet belgesi, belirsiz isteklerin geniş tarama başlattığını, belirli isteklerin az dosya okutturduğunu söylüyor.
  3. 3. adım · Terminalde

    Node sürümünü ve Repomix'i kontrol et

    Ne için: Aracın çalışacağı ortamı pakete başlamadan görmek.

    1. Terminali proje klasöründe aç.
    2. Önce Node sürümüne bak. 22 ya da üstü olmalı.
    3. Sonra sürüme sabitlenmiş Repomix'in sürüm bilgisini iste. Repomix ilk çalıştırmada paketi kendisi indirir; ayrıca kurulum gerekmez. npx, paketi indirmeden önce onay (y) isteyebilir; sorunsa y yaz.
    Windows · macOS · LinuxKlasör: Proje klasörü
    › node --version
    Windows · macOS · LinuxKlasör: Proje klasörü
    › npx repomix@1.18.1 --version

    Sürüm sabit (17 Ekim 2026 itibarıyla). Yeni sürüme geçmeden önce üreticinin belgesine bak.

    Doğru yaptığını şuradan anlarsın

    • node --version v22 ya da daha yüksek bir sürüm yazar.
    • Repomix komutu 1.18.1 sürümünü yazar.
    Takılırsan: bu adıma özgü sorunlar
    • Node 22'den eski çıkıyor
      Repomix Node 22.0.0 ve üstünü ister. Node'u güncellemeden önce projenin kendi Node sürümü kuralını (ör. .nvmrc) kontrol et; projenin sürümünü Repomix yüzünden değiştirme.
    • npx onay soruyor ya da etkileşimsiz kabukta komut iptal oluyor
      npx, yerelde olmayan paketi indirmeden önce onay sorar; --yes bayrağı bu soruyu atlar. Komutu npx --yes repomix@1.18.1 --version biçiminde çalıştır.
  4. 4. adım · Terminalde

    Yalnız seçtiğin kapsamı Repomix ile paketle

    Ne için: Görev için kontrollü, token sayısı görünen tek bir bağlam dosyası üretmek.

    1. Önceki adımdaki liste src/pages ve docs klasörleriyse komuttaki --include kalıbını ona göre yaz; kalıplar virgülle ayrılır.
    2. --ignore ile loglar, derleme çıktısı ve yedek gibi gereksiz yolları dışla. Repomix .gitignore, .ignore ve .repomixignore dosyalarına da uyar; kalıcı dışlamalar için proje köküne .repomixignore koy.
    3. --token-count-tree dosya bazında token sayısını ağaç olarak gösterir; sondaki sayı (500) bir eşiktir: yalnız 500 token ve üstü dosyalar listelenir, küçük dosyalar listede görünmez. Beklenenden büyük dosya görürsen kapsamı daralt.
    4. Güvenlik denetimini kapatma. Repomix gizli anahtar biçimindeki dosyaları çıktıdan bırakır ve bunları terminalde listeler; yine de çıktı dosyasını paylaşmadan önce göz at.
    Windows · macOS · LinuxKlasör: Proje klasörü
    › npx repomix@1.18.1 --include "src/pages/**,docs/**" --ignore "**/*.log,dist/**" --token-count-tree 500 -o repomix-gorev.xml

    Sürüm sabit (17 Ekim 2026 itibarıyla). Yeni sürüme geçmeden önce üreticinin belgesine bak.

    Doğru yaptığını şuradan anlarsın

    • Proje klasöründe repomix-gorev.xml oluşur.
    • Terminalde token sayıları ve güvenlik denetiminin sonucu görünür.
    • Dosya içerikleri yalnız --include ile seçtiğin yollardan gelir (ignore kurallarındakiler hariç). Çıktıda ayrıca dosya özeti ve dizin yapısı bölümleri de bulunur.
    Takılırsan: bu adıma özgü sorunlar
    • Paket beklenenden çok büyük çıkıyor
      --token-count-tree çıktısındaki en büyük dosyaları bul ve --ignore listesine ekle. Üreticinin belgelediği --compress seçeneği ise kodun yalnız yapısını (sınıf, fonksiyon imzaları) çıkarır; ayrıntıya ihtiyaç varsa kullanma.
    • Güvenlik denetimi bir dosyayı çıktıdan çıkardı
      Dosyayı zorla ekleme. Gizli anahtar içeriyorsa anahtarı dosyadan ayır; içermiyorsa görevin ihtiyacı için gerekip gerekmediğine karar ver. Repomix sayfası denetimin yaygın biçimleri hedeflediğini söylüyor, yani her sırrı yakalamayabilir.
  5. 5. adım · Kod ajanında

    Paketi asistana ver ve görevi iste

    Ne için: Seçtiğin bağlamı, tanımlı bir görevle asistana vermek ve kapsamı sen belirlemek.

    1. Önce şunu bil: Repomix paketi, dosya sistemine erişimi olan bir kod ajanının (Claude Code, Codex) neyi okuyabileceğini SINIRLAMAZ; ajan paket dışındaki dosyaları da okuyabilir. Paket asıl olarak, projeni dosya yükleyen bir sohbet asistanına göstermek için işe yarar. Claude Code ya da Codex ile çalışıyorsan çoğu zaman paketi vermen gerekmez; büyük bir XML dosyası ayrıca token da harcar.
    2. Sohbet asistanı kullanıyorsan repomix-gorev.xml dosyasını yükle (panoya kopyalamak için Repomix'in --copy seçeneği de var). Kod ajanı kullanıyorsan görev cümlende seçtiğin klasörleri ve dokunulmayacak yerleri adıyla yaz; bu sınırı talimat dosyasına da ekleyebilirsin.
    3. Asistana değişiklikten önce ne yapacağını anlatmasını söyle. Plan yanlışsa ya da paket dışı dosyalara uzanıyorsa görevi daralt, yanlış planla başlatma.

    Doğru yaptığını şuradan anlarsın

    • Asistan, görev cümlenle ve verdiğin dosyalarla uyumlu bir plan sunar.
    • Plan beklemediğin klasörlere uzanıyorsa bunu görür ve görevi daraltırsın; Repomix bunu kendiliğinden engellemez.
    Takılırsan: bu adıma özgü sorunlar
    • Asistan paketin dışındaki bir dosyaya ihtiyaç duyduğunu söylüyor ya da orayı okumak istiyor
      Kod ajanları paket dışını da okuyabilir. İhtiyaç gerçekse o yolu --include listesine ekleyip paketi yeniden üret; değilse görev cümlene açık bir sınır yaz.
  6. 6. adım · Terminalde

    Asistanın yaptığı değişikliği incele

    Ne için: Hiçbir değişiklik, sen görmeden projene kalıcı girmesin.

    Burada sen kontrol edersin; sistem bu adımı senin onayın olmadan ilerletmemeli.

    1. Hangi dosyaların değiştiğine bak, sonra satır satır farkı oku.
    2. Beklemediğin bir dosya değişmişse asistana nedenini sor ya da o değişikliği geri al.
    3. Projenin testlerini kendin çalıştır ve sonucu gör. Asistanın 'test geçti' demesi yetmez.
    Windows · macOS · LinuxKlasör: Proje klasörü
    › git status
    Windows · macOS · LinuxKlasör: Proje klasörü
    › git diff

    Doğru yaptığını şuradan anlarsın

    • Değişen dosyalar görevle uyumlu bir listedir.
    • Fark çıktısında anlamadığın ya da istemediğin değişiklik kalmamıştır.
    Takılırsan: bu adıma özgü sorunlar
    • Çok sayıda ilgisiz dosya değişmiş görünüyor
      Değişiklikleri kaydetme. Asistana görevi yalnız pakettaki dosyalarla sınırlamasını söyleyip yeniden dene; gerekirse değişiklikleri git ile geri al.
  7. 7. adım · Terminalde

    Paketi commit adıyla üret, eski paketi tanı

    Ne için: Kod değişince eski paketi yanlışlıkla yeni sanmamak.

    1. Repomix paketi bir fotoğraf gibidir: kod değişince kendiliğinden yenilenmez. Her yeni görevde paketi yeniden üret.
    2. repomix-*.xml dosyalarını önce .gitignore'a ekle; paketleri depoya kaydetme. Aksi hâlde önceki paketler git status --short çıktısında görünür ve çıktı hiç boş çıkmaz.
    3. Çıktı dosyasının adına paketin üretildiği commit kimliğini yaz. Önce kimliği öğren (ör. a1b2c3d), sonra dosya adını elle bu kimlikle yaz: repomix-a1b2c3d.xml. Bu adlandırma DijiKoçum'un önerisidir, Repomix'in bir özelliği değildir.
    4. UYARI: commit kimliği commit EDİLMEMİŞ değişiklikleri yakalamaz. Paketi üretmeden önce git status --short çıktısı boş olmalı; boş değilse paket adı yanlış güvence verir.
    5. Eski paketin güncel olup olmadığına bakmak için paket adındaki kimlikle şimdiki commit arasındaki commitleri listele: çıktı boşsa commit olarak güncel, doluysa paketi yenile. Commit edilmemiş değişiklikleri git status --short gösterir.
    6. Komutlardaki surum_tarihi sürümün yayın tarihi değil, sürümün kontrol edildiği gündür (2026-10-17). Yayın tarihleri iddialarda yazılı.
    Windows · macOS · LinuxKlasör: Proje klasörü
    › git rev-parse --short HEAD
    Windows · macOS · LinuxKlasör: Proje klasörü
    › git status --short
    Windows · macOS · LinuxKlasör: Proje klasörü
    › npx repomix@1.18.1 --include "src/pages/**,docs/**" --ignore "**/*.log,dist/**" -o repomix-a1b2c3d.xml

    Sürüm sabit (17 Ekim 2026 itibarıyla). Yeni sürüme geçmeden önce üreticinin belgesine bak.

    Windows · macOS · LinuxKlasör: Proje klasörü
    › git log --oneline a1b2c3d..HEAD

    Doğru yaptığını şuradan anlarsın

    • Bir kısa commit kimliği görürsün; çıktı dosyası adında a1b2c3d yerine senin kimliğin olur.
    • git status --short boşsa ve git log çıktısı boşsa paket şimdiki koda uyar.
    Takılırsan: bu adıma özgü sorunlar
    • Asistan silinmiş ya da taşınmış bir dosyadan söz ediyor
      Eski paket kullanıyor olabilirsin. Paket adındaki kimlikle git log --oneline <kimlik>..HEAD komutunu çalıştır, git status --short'a da bak ve paketi yeniden üret.
  8. 8. adım · Terminalde

    ccusage ile kullanımı gözlemle

    Ne için: Bağlam düzenini değiştirince Claude Code kullanımının nasıl değiştiğini görmek.

    1. ccusage, bilgisayarında Claude Code'un tuttuğu yerel kayıtları (JSONL dosyaları) okur.
    2. Görünen dolar tutarı bir tahmindir; Anthropic faturan ya da abonelik ücretin değildir. Varsayılan auto kipinde kayıtta Claude Code'un yazdığı maliyet varsa o kullanılır, yoksa token sayısından model fiyatıyla hesaplanır.
    3. Hesaplama için ccusage fiyat verisini LiteLLM ve models.dev gibi kaynaklardan kullanır; CCUSAGE_OFFLINE=1 değişkeni çevrimdışı çalışmayı zorlar. display kipi yalnız kayıttaki maliyeti gösterir, olmayana $0.00 yazar. Belge, varsayılanda hangi isteklerin ağa çıktığını açıklamıyor; bu yüzden ccusage'ın internete hiç çıkmadığını varsayma.
    4. Kayıtlar Claude Code'un varsayılan ayarında 30 gün saklanır. Saklama süresini cleanupPeriodDays ayarı belirler; bu ayarı Claude Code'un ayar dosyasında (settings.json) yükseltirsin (en az 1). Daha eski kullanımı görmek istiyorsan önce bu ayarı yükselt.
    Windows · macOS · LinuxKlasör: Herhangi bir klasör
    › npx ccusage@20.0.34 claude daily

    Sürüm sabit (17 Ekim 2026 itibarıyla). Yeni sürüme geçmeden önce üreticinin belgesine bak.

    Windows · macOS · LinuxKlasör: Herhangi bir klasör
    › npx ccusage@20.0.34 claude session

    Sürüm sabit (17 Ekim 2026 itibarıyla). Yeni sürüme geçmeden önce üreticinin belgesine bak.

    Doğru yaptığını şuradan anlarsın

    • Tarih ya da oturum bazında token sayıları ve tahmini maliyet tablosu çıkar.
    • Tablodaki oturumlar senin Claude Code çalışmalarınla uyuşur.
    Takılırsan: bu adıma özgü sorunlar
    • Rapor boş geliyor
      ccusage kayıtları ~/.config/claude/projects/ ve ~/.claude/projects/ yollarında arar. Claude Code'u farklı bir veri klasörüyle çalıştırıyorsan CLAUDE_CONFIG_DIR değişkeni bu klasörü göstermelidir.
  9. 9. adım · Terminalde

    Büyük depoda ileri seçenek: Serena ile kod indeksi

    Ne için: Dosya seçimi yetmeyen büyük depoda asistanın kodu sembol düzeyinde aramasını sağlamak.

    1. Bu adım yalnız ana yol yetmediğinde gerekir. Serena, uv aracıyla kurulur; önce uv'yi üreticinin sayfasından kur.
    2. Serena'yı sabit sürümle kur, serena init ile başlat, sonra Claude Code'a bağlamak için serena setup claude-code komutunu çalıştır (Codex için serena setup codex). Setup komutunu Serena belgesi otomatik yapılandırma yolu olarak veriyor.
    3. Serena'nın projeni tanıması için gerekirse asistana 'Activate the project <proje yolu>' gibi bir istek yaz (Serena iş akışı sayfası bu biçimi örnek veriyor ve ilk etkinleştirmede projenin otomatik oluşturulduğunu söylüyor). Global yapılandırmanın oturumla ilişkisi için Serena'nın yapılandırma sayfasına bak.
    4. Proje klasöründe serena project index komutuyla bir kez indeksle. Üretici, kullanım sırasında dosyalar değiştikçe indeksin kendiliğinden güncellendiğini söylüyor; Serena kapalıyken yaptığın değişikliklerin ne olacağı o sayfada anlatılmıyor.
    5. Serena'nın dosya kapsamı ve kurulum notları için üreticinin kullanım kılavuzuna bak. codebase-memory-mcp alternatifi için üreticinin README'si macOS ve Linux'ta indirip çalıştıran bir kurulum betiği, Windows'ta önce indirip incele sonra çalıştır yolu veriyor. Bu rehber indirip doğrudan çalıştıran satırları kullanmaz; o aracı seçersen README'yi okuyup kendi kararını ver.
    Windows · macOS · LinuxKlasör: Herhangi bir klasör
    › uv tool install -p 3.13 serena-agent==2.0.0

    Sürüm sabit (17 Ekim 2026 itibarıyla). Yeni sürüme geçmeden önce üreticinin belgesine bak.

    Windows · macOS · LinuxKlasör: Herhangi bir klasör
    › serena init
    Windows · macOS · LinuxKlasör: Proje klasörü
    › serena setup claude-code
    Windows · macOS · LinuxKlasör: Proje klasörü
    › serena project index

    Doğru yaptığını şuradan anlarsın

    • Serena komutları hatasız biter.
    • İstemcinin MCP sunucu listesinde serena görünür (belgeye göre setup bunu kaydeder).
    Takılırsan: bu adıma özgü sorunlar
    • İstemci serena komutunu bulamıyor
      Üretici belgesi, istemcinin komutu PATH'te olsa bile bulamayabileceğini söylüyor; istemci ayarında serena çalıştırılabilir dosyasının tam yolunu ver.
    • Serena'yı bir MCP ya da eklenti mağazasından kurmak istiyorsun
      Serena README'si bunu yapma uyarısı veriyor: mağazalardaki kurulum komutları eski kalmış olabilir. Doğrudan README'deki uv komutunu kullan.

Kurulum çalışıyor mu? Şunlara bak

  • Proje kökünde talimat dosyası var ve asistan onu yüklediğini gösteriyor.
  • Repomix paketinin dosya içerikleri yalnız seçtiğin yollardan geliyor; terminalde token sayıları ve güvenlik denetimi sonucu görünüyor.
  • Paket adındaki commit kimliğiyle şimdiki commit'i karşılaştırıyor ve git status --short ile commit edilmemiş değişiklik olup olmadığına bakıyorsun; ikisi de boşsa paket güncel.
  • ccusage raporunda Claude Code oturumların tahmini maliyetiyle birlikte listeleniyor.

Neye para ödenir

Kalemler ayrıdır ve toplam değildir; hangilerinin sana gerektiği kurduğun yola bağlıdır. Fiyatlar değişir, her kalemin kaynağına bak.

  • AbonelikKod asistanı — abonelik yolu

    Pro, Max, Team ve Enterprise aboneliklerinde Claude Code kullanımı plana dahildir ve plan limitine tabidir; fiyat Anthropic fiyat sayfasındadır. Codex için kendi planının koşulları OpenAI tarafında. kaynak

  • API kullanımıKod asistanı — API yolu

    API/Console hesabıyla Claude Code token tüketimine göre ücretlenir. ccusage'ın gösterdiği tahmin bu fatura yerine geçmez. kaynak

  • Ücret yokRepomix ve ccusage

    İkisi de MIT lisanslı açık kaynak komut satırı araçları; kendileri ücret istemez. Çalışma sırasında asistana gönderdiğin bağlam, asistanın token tüketimini artırır. kaynak

  • Ücret yokSerena (isteğe bağlı)

    Serena GPL-3.0-or-later lisanslıdır. JetBrains eklentisi ayrı ve ücretlidir (deneme sürümü var); bu rehberdeki dil sunucusu yolu onu gerektirmez. kaynak

  • Kurulum hizmetiKurulum hizmeti

    İstersen proje talimat dosyası ve bağlam düzeni kurulumunu bizden alabilirsin; kapsam görüşmeyle belli olur. kaynak

Kaynaklar

Kendin kurabilirsin; takıldığın adımı birlikte yapalım

İstediğin adımları işaretle. İstek formuna sistemin adı ve seçtiğin adımlar görünür bir özet olarak geçer; sen değiştirebilirsin. Şifre ya da API anahtarı paylaşmana gerek yok.

Yardım istediğin adımlar
Kurulum ihtiyacımı görüşelim Projene uygun talimat dosyasının yazılması, Repomix kapsam kalıplarının ve dışlama listesinin kurulması, değişiklik inceleme düzeni ve gerekirse büyük depo için indeksli seçenek. Kesin kapsam ve fiyat görüşmede belli olur.

Başka bir yol arıyorsan

Rehber ücretsiz ve üyeliksiz; buradaki adımları kendin uygulayabilirsin. Bir noktada profesyonel destek istersen ihtiyacına uygun yolu seç. Rehberdeki sıralama bundan etkilenmez.