Claude Code Başlangıç Rehberi: Terminal, Proje Bağlamı ve İzin Yönetimi

Claude Code Nedir ve Neden Terminalde Çalışır?

Claude Code, Anthropic tarafından geliştirilen ve terminal üzerinden çalışan bir yapay zeka kodlama asistanıdır. Geleneksel IDE eklentilerinden farklı olarak, doğrudan komut satırından çağrılır ve proje dizininizdeki dosyalara erişerek kod yazma, düzenleme, hata ayıklama gibi görevleri yerine getirir. Bu yaklaşım, geliştiricilere mevcut iş akışlarını bozmadan, hızlı ve bağlam duyarlı yardım sağlar.

Terminal tabanlı olması, özellikle uzak sunucularda veya SSH oturumlarında çalışan geliştiriciler için büyük avantaj sunar. Ayrıca, Claude Code'un yetenekleri proje bağlamına ve izin verdiğiniz işlemlere göre şekillenir. Bu rehberde, kurulumdan başlayarak proje bağlamını nasıl yapılandıracağınızı ve izinleri nasıl yöneteceğinizi adım adım ele alacağız.

Kurulum ve İlk Çalıştırma

Claude Code'u kullanmaya başlamak için öncelikle Node.js ve npm'in sisteminizde kurulu olması gerekir. Ardından, resmi npm paketi aracılığıyla global olarak kurabilirsiniz:

npm install -g @anthropic-ai/claude-code

Kurulum tamamlandıktan sonra, terminalde claude komutunu çalıştırarak aracı başlatabilirsiniz. İlk çalıştırmada, Anthropic hesabınızla kimlik doğrulama yapmanız istenir. API anahtarınızı veya oturum bilgilerinizi girerek devam edebilirsiniz.

Claude Code, etkileşimli bir oturum başlatır. Bu oturumda doğal dilde komutlar verebilir, dosya oluşturabilir, mevcut kodları düzenleyebilir ve terminal komutları çalıştırabilirsiniz. Örneğin, "src/utils/helpers.js dosyasına bir tarih formatlama fonksiyonu ekle" gibi bir istekte bulunabilirsiniz.

Proje Bağlamını Anlama ve Yapılandırma

Claude Code, çalıştığınız dizini otomatik olarak proje kökü olarak algılar. Ancak, bağlamı daha verimli kullanmak için birkaç önemli nokta vardır:

1. Proje Kök Dizini

Claude Code'u her zaman projenizin kök dizininde başlatın. Böylece araç, tüm alt dizinleri ve dosyaları tarayabilir. Örneğin:

cd /path/to/your/project
claude

2. .claude Dizini ve Yapılandırma Dosyaları

Proje kökünde bir .claude dizini oluşturarak Claude Code'a özel talimatlar verebilirsiniz. Bu dizin içinde settings.json dosyası ile izinleri, ortam değişkenlerini ve diğer ayarları tanımlayabilirsiniz. Ayrıca, CLAUDE.md dosyası oluşturarak projenize özgü bağlam bilgilerini (örneğin, kullanılan teknolojiler, kodlama standartları) Claude'a iletebilirsiniz.

Örnek bir CLAUDE.md içeriği:

# Proje: E-ticaret API
- Node.js ve Express kullanılıyor.
- Veritabanı: PostgreSQL.
- Kod stili: Airbnb JavaScript Style Guide.
- Testler: Jest ile yazılıyor.

Bu dosya, Claude'un projeye dair daha isabetli önerilerde bulunmasını sağlar.

3. Bağlamı Genişletme ve Sınırlama

Claude Code, varsayılan olarak proje kökündeki tüm dosyalara erişebilir. Ancak, büyük projelerde bağlamı daraltmak performansı artırır. .claude/settings.json içinde ignore kuralları tanımlayarak belirli dizinleri (örneğin, node_modules, dist) hariç tutabilirsiniz.

{
  "ignore": ["node_modules", "dist", "*.log"]
}

İzinleri Yönetme

Claude Code, güvenlik açısından önemli olan izin mekanizmalarına sahiptir. Varsayılan olarak, dosya yazma veya terminal komutu çalıştırma gibi işlemler için sizden onay ister. Bu izinleri proje bazında veya genel olarak yapılandırabilirsiniz.

İzin Türleri

• Dosya Okuma: Genellikle otomatik izin verilir.
• Dosya Yazma/Düzenleme: Onay gerektirir.
• Terminal Komutu Çalıştırma: Onay gerektirir.

İzinleri Yapılandırma

.claude/settings.json dosyasında permissions anahtarı altında izinleri tanımlayabilirsiniz. Örneğin, belirli komutlara otomatik izin vermek için:

{
  "permissions": {
    "allow": ["Bash(npm run test)", "Bash(git status)"],
    "deny": ["Bash(rm -rf *)"]
  }
}

Bu yapılandırma, npm run test ve git status komutlarının onay istemeden çalışmasını sağlarken, tehlikeli rm -rf * komutunu engeller.

Etkileşimli Onay

İzin verilmeyen bir işlem talep edildiğinde, Claude Code terminalde size bir onay sorusu gösterir. Burada "Evet" diyerek tek seferlik izin verebilir veya "Her zaman izin ver" seçeneğiyle kalıcı hale getirebilirsiniz. Bu mekanizma, yanlışlıkla yapılabilecek istenmeyen değişikliklerin önüne geçer.

Uygulamalı Örnek: Basit Bir Görev

Diyelim ki bir Node.js projeniz var ve src/utils/string.js dosyasına bir fonksiyon eklemek istiyorsunuz. Terminalde Claude Code oturumunu başlattıktan sonra şu komutu verebilirsiniz:

src/utils/string.js dosyasına, bir string'i ters çeviren bir fonksiyon ekle.

Claude, dosyayı okuyacak, uygun yeri bulacak ve fonksiyonu ekleyecektir. Dosya yazma izni olmadığı için sizden onay isteyecektir. Onayladıktan sonra değişiklik uygulanır. Ardından, test etmek için:

node -e "console.log(require('./src/utils/string').reverseString('merhaba'))"

komutunu çalıştırmasını isteyebilirsiniz. Bu komut da onay gerektirecektir.

Sonuç

Claude Code, terminal üzerinden yapay zeka destekli kodlama deneyimi sunan güçlü bir araçtır. Proje bağlamını doğru yapılandırmak ve izinleri dikkatli yönetmek, hem verimliliği artırır hem de güvenliği sağlar. CLAUDE.md ve .claude/settings.json dosyalarını kullanarak projenize özel ayarlar yapabilir, tekrarlayan görevlerde otomatik izinler tanımlayarak zaman kazanabilirsiniz. Unutmayın, her yeni özellik veya sürüm için resmi Anthropic dokümantasyonunu takip etmek en doğrusudur.