Claude Code Kullanim Rehberi: Terminalden Proje Yonetimine Eksiksiz Kilavuz

Bir muzisyen olarak yillarca MIDI klavyeler ve ses editorleri arasinda gidip geldim. 15 yillik bu yolculukta kod yazmayi da hep yan is olarak goturdum. Ama 2026'da isler degisti. thekai.co'da 50'den fazla projeyi Claude Code ile yonettikten sonra soyleyebilirim ki bu arac, terminal uzerinden calisan bir AI asistanindan cok daha fazlasi. Bu claude code kullanım rehberi, benim gercek deneyimlerime dayanarak hazirlandi. Amacim, sizi sifirdan alip, projelerinizi terminal uzerinden yonetecek seviyeye getirmek.

Claude Code Nedir ve Neden Terminalde Calisir?

Claude Code, Anthropic'in gelistirdigi, terminal tabanli bir AI kodlama asistanidir. Diger AI araclari gibi tarayici uzerinden calismaz; dogrudan yerel dosyalariniza erisir, proje yapinizi index'ler ve her dosya degisikligi icin sizden izin ister. Bu, bana ilk baslarda garip gelmisti. Neden bir sohbet arayuzu yerine terminal? Cevap basit: Terminal, dosyalara dogrudan mudahale edebileceginiz tek ortam. Ben thekai.co'da ilk Claude Code denememi yaptigimda, bir React projesinin tum state yapisini 15 dakikada degistirdim. Normalde bu islem saatlerimi alirdi.

Kaynaklarda da belirtildigi gibi, Claude Code'u bir chatbot'tan ayiran en onemli ozellik, projenizin tam baglamini anlamasi. Bir klasoru actiginizda, tum dosyalari tarar, bagimliliklari cozer ve size projenin butunsel bir resmini sunar. Bu, ozellikle buyuk olcekli projelerde inanilmaz bir zaman kazandiriyor. thekai.co'daki 72+ ajani yonetirken, her bir ajanin farkli bir kod tabani var. Claude Code sayesinde bu kod tabanlari arasinda gecis yapmak, hata ayiklamak ve yeni ozellikler eklemek artik cok daha kolay.

Kurulum ve Ilk Adimlar: Sifirdan Baslayanlar Icin

Kurulum aslinda sandiginizdan cok daha basit. Ilk olarak, AI ile web gelistirme surecinde anlattigim gibi, bir calisma klasoru olusturup Git'i yuklemeniz gerekiyor. Claude Code, Git ile entegre calisir ve her degisikligi versiyon kontrolu altinda tutar. Ardindan, Claude Code CLI'sini yukleyip terminalde 'claude' komutunu calistirmaniz yeterli. Ben ilk calistirdigimda, terminalin bir anda projemi taramaya baslamasi beni sasirtmisti. Hemen ardindan bir CLAUDE.md dosyasi olusturmanizi oneririm; bu dosya, projenizin baglamini ve sizin tercihlerinizi tanimlar.

Kaynaklardan birinde belirtildigi gibi, her Claude Code'u bir klasorde baslattiginizda, eger bir CLAUDE.md dosyasi varsa, onu otomatik okur ve proje baglamini aninda kavrar. Bu dosyaya projenizin amacini, kullandiginiz teknolojileri ve kodlama standartlarinizi yazabilirsiniz. Ben genellikle 'Bu proje Next.js ile yazilmistir, Tailwind CSS kullanir, state yonetimi icin Zustand tercih edilir' gibi bir tanim koyuyorum. Bu, Claude Code'un size cok daha dogru cozumler sunmasini sagliyor.

Plan Mode: Karmaşık Projelerde Akilli Calisma

Plan Mode, Claude Code'un en guclu ozelliklerinden biri. Normalde bir AI asistanina 'su ozelligi ekle' dediginizde dogrudan kod yazmaya baslar. Plan Mode'da ise once problemi analiz eder, adimlari siralar, mantigini aciklar ve sizin onayinizi bekler. Ben thekai.co'da bir API entegrasyonu yaparken bu ozelligi kullandim. Claude Code, once tum API dokumantasyonunu taradi, ardindan hangi endpoint'lerin kullanilacagini, hangi hata yonetim stratejisinin uygulanacagini ve veri akisinin nasil olacagini adim adim anlatti. Onay verdikten sonra kod yazmaya basladi.

Kaynaklardaki verilere gore, Plan Mode ozellikle coklu dosya refaktorizasyonu veya mimari kararlar icin ideal. Basit bir bug fix icin Plan Mode kullanmak gereksiz olabilir, ancak projenizin temelini degistirecek bir karar alirken bu modu kullanmak size haftalarca zaman kazandirabilir. Ben, Claude Code ile 50'den fazla projede calistigim icin soyleyebilirim ki, Plan Mode'u kullanmadiginizda bazen AI'nin yanlis yonlendirmesiyle karsilasabiliyorsunuz. Plan Mode bu riski neredeyse sifira indiriyor.

• Plan Mode'u acmak icin terminalde '/plan' komutunu kullanin veya Claude Code arayuzunden ilgili butona tiklayin.
• Karmaşik bir ozellik eklemeden once mutlaka Plan Mode'u calistirin.
• Plan Mode ciktisini dikkatlice inceleyin; mantik hatalarini bu asamada yakalamak cok daha kolay.
• Plan onaylandiktan sonra Claude Code otomatik olarak kod yazmaya baslar, ancak siz her adimi onaylayabilirsiniz.
• Plan Mode'u ozellikle buyuk refaktorizasyonlarda ve yeni mimari kararlarinda kullanin.

Slash Komutlar ve CLAUDE.md ile Verimliligi Artirma

Claude Code, bir dizi slash komutunu destekler. Bunlar, terminalde '/' ile baslayan ve size hizli erisim saglayan kisayollardir. Ornegin, '/test' komutu mevcut testleri calistirir, '/lint' kodunuzu lint'ler, '/commit' ise Git commit'i olusturur. Ben en cok '/explain' komutunu kullaniyorum. Karmaşik bir kod blogunu secip '/explain' dedigimde, Claude Code bana o kodun ne yaptigini, neden oyle yazildigini ve nasil iyilestirilebilecegini anlatiyor. Bu, ozellikle baska bir gelistiricinin yazdigi kodu anlamak icin harika.

CLAUDE.md dosyasi ise projenizin kimlik karti. Full-stack proje rehberimde de bahsettigim gibi, bu dosyaya projenizin kapsamini, kullandiginiz kutuphaneleri, tercih ettiginiz kodlama stillerini ve hatta kisisel tercihlerinizi yazabilirsiniz. Ben CLAUDE.md'ye 'Konsol log'lari kullanma, hata ayiklama icin debugger kullan' gibi kurallar ekledim. Bu sayede Claude Code, benim tarzima uygun kod yaziyor. Ayrica, projenin amacini da eklemek faydali: 'Bu proje, kucuk isletmeler icin bir envanter yonetim sistemidir.'

Sonnet ve Opus: Hangi Model Ne Zaman Kullanilmali?

Claude Code, iki farkli modeli destekliyor: Sonnet 4.6 ve Opus 4.6. Kaynaklardan birinde guzel bir oran verilmis: 'Sonnet for 80%, Opus for 20%'. Ben de bu orana katiliyorum. Sonnet, gunluk isler icin ideal: hizli, maliyet etkin ve basit gorevler icin yeterli. Opus ise daha karmasik, coklu dosya refaktorizasyonu veya mimari kararlar icin kullanilmali. thekai.co'da bir ajanin tum state yapisini degistirirken Opus'u kullandim ve sonuc mukemmeldi. Ancak basit bir CSS duzeltmesi icin Opus kullanmak, gereksiz bir maliyet.

Model secimi yaparken su kriterleri goz onunde bulundurun: Gorev karmasikligi, dosya sayisi, projenin buyuklugu ve butceniz. Sonnet, 1 milyon token baglam penceresiyle bile oldukca yetenekli. Opus ise ayni baglam penceresine sahip ancak daha derin analiz yapabiliyor. Ben genellikle su sekilde karar veriyorum: Eger islem 3-4 dosyayi asiyorsa veya mimari bir karar gerekiyorsa Opus'a gecis yapiyorum. Diger durumlarda Sonnet ile devam ediyorum.

Alt Ajanlar ve Otomasyon: Is Akisinizi Olusturun

Claude Code'un en heyecan verici ozelliklerinden biri, alt ajanlar (subagents) olusturma yetenegi. Bir ana gorevi alt gorevlere bolup, her bir alt gorev icin ayri bir ajan atayabilirsiniz. Bu ajanlar paralel olarak calisir ve sonuclari birlestirir. Ben thekai.co'da bir e-ticaret sitesi kurarken bu ozelligi kullandim. Bir ajan urun sayfasini yazarken, diger ajan odeme sistemini entegre ediyor, ucuncu ajan ise veritabani sorgularini optimize ediyordu. E-ticaret is akisi otomasyonu rehberimde bu sureci detaylica anlattim.

Otomasyon tarafinda ise 'Routines' ozelligi var. Belirli bir gorev icin bir rutin tanimlayabilir ve her seferinde ayni adimlari tekrarlamak zorunda kalmazsiniz. Ornegin, 'yeni bir API endpoint'i olustur' rutini tanimlayabilirsiniz: once schema'yi olustur, sonra controller'i yaz, ardindan testleri ekle, son olarak dokumantasyonu guncelle. Bu rutini her yeni endpoint'te calistirabilirsiniz. Ben bu ozelligi cok seviyorum cunku ayni seyleri defalarca anlatmak zorunda kalmiyorum.

MCP Baglantilari ve Araclarla Entegrasyon

MCP (Model Context Protocol), Claude Code'u harici araclarla baglamak icin kullanilan bir protokol. Bu sayede Claude Code, veritabaniniza, API'lerinize, hatta GitHub reposuna dogrudan erisebilir. Kaynaklarda belirtildigi gibi, MCP baglantilari sayesinde Claude Code, sadece bir kod yazma araci olmaktan cikip, tam bir isletim sistemine donusuyor. Ben thekai.co'da n8n otomasyonlarini Claude Code ile entegre ettim. Ornegin, bir e-posta geldiginde, Claude Code otomatik olarak ilgili kodu guncelliyor ve yeni bir deploy tetikliyor.

MCP baglantilari kurarken dikkat etmeniz gereken en onemli sey, izinler. Claude Code, her baglanti icin sizden izin ister. Bu guvenlik acisindan kritik. Ayrica, her baglanti icin bir 'tool permissions' ayari yapmaniz gerekiyor. Ornegin, veritabanina sadece okuma izni vermek istiyorsaniz, bunu ayarlayabilirsiniz. Ben genellikle once sadece okuma izni veriyorum, ardindan guvendikce yazma iznini de ekliyorum.

Sık Sorulan Sorular (FAQ)

Gercek Deneyim: thekai.co'da Claude Code ile Bir Hafta

Gecen ay thekai.co'da yeni bir ajan sistemi kuruyordum. Normalde bu islem iki hafta surerdi. Claude Code ile bu sureyi 3 gune indirdim. Ilk gun, Plan Mode ile tum mimariyi planladim. Ikinci gun, alt ajanlari paralel olarak calistirarak kod tabanini olusturdum. Ucuncu gun ise testleri yazip deploy ettim. Bu surecte en cok isime yarayan ozellik, Claude Code'un hata ayiklama yetenegi oldu. Bir yerde bir bug vardi, Claude Code once hatayi buldu, sonra cozumu onerdi ve ardindan cozumu uyguladi. Ben sadece onay verdim.

thekai.co'da 72'den fazla AI ajanini yonetiyorum. Her bir ajanin kendi kod tabani, kendi yapilandirmasi ve kendi amaci var. Claude Code sayesinde bu ajanlarin kod tabanlarini yonetmek, guncellemek ve hata ayiklamak artik cok daha kolay. Ozellikle CLAUDE.md dosyalari sayesinde, her ajanin baglamini ayri ayri tanimlayabiliyorum. Bu, projeler arasi gecis yaparken baglam kaybini onluyor.

Claude Code, sadece bir kod yazma araci degil; ayni zamanda bir proje yonetim platformu, bir hata ayiklama asistani ve bir otomasyon motoru. Ben 15 yillik muzisyenlik ve yazilimcilik kariyerimde bu kadar guclu bir arac gormedim. Eger siz de projelerinizi daha hizli, daha guvenilir ve daha verimli bir sekilde yonetmek istiyorsaniz, Claude Code'u denemelisiniz. thekai.co'da bu araci kullanarak elde ettigim sonuclar, beklentilerimin otesinde oldu. Sizin de deneyimlerinizi duymak isterim. Yorumlarda veya iletisim sayfamizdan bize ulasabilirsiniz.