Claude Code Eğitim Serisi 6: Kimlik Doğrulama - Tarayıcı Girişi ve Manuel API Anahtarı Yapılandırması

Kimlik Doğrulama Süreci: Tarayıcı Girişi ve Manuel API Anahtarı Yapılandırması

Claude Code'u kurduktan sonra kullanmak için kimlik doğrulama yapmanız gerekir. Aracı Anthropic hesabınıza bağlamanız gerekir. İki bağlama yöntemi vardır: Tarayıcı Girişi ve Manuel API Anahtarı Yapılandırması. Her iki yöntem de aynı sonucu verir; size uygun olanı seçin.

Yöntem 1: Tarayıcı Girişi (Önerilen)

Claude Code, claude login otomatik kimlik doğrulama komutunu sağlar. Bu komut tarayıcınızı açar, web üzerinde yetkilendirme yapmanızı sağlar ve ardından kimlik bilgilerini otomatik olarak terminale yazar.

Adımlar:

1. Terminale şunu girin:

bash claude login

1. Sistem bir bilgi satırı görüntüler ve varsayılan tarayıcınızda Anthropic yetkilendirme sayfasını otomatik olarak açar.
   Otomatik açılmazsa, terminalde yazdırılan bağlantıyı manuel olarak kopyalayıp tarayıcıda açabilirsiniz.

2. Tarayıcıda Anthropic hesabınıza giriş yapın (zaten giriş yapmışsanız sayfa doğrudan yetkilendirme isteyecektir).

3. "İzin Ver" veya "Yetkilendir" düğmesine tıklayın; tarayıcı sayfası "Yetkilendirme başarılı, bu sayfayı kapatabilirsiniz" mesajını gösterecektir.

4. Terminale dönün ve kimlik doğrulamanın tamamlandığını belirten bir bildirim göreceksiniz. Artık claude komutunu çalıştırdığınızda hesabınızla ilişkilendirilmiş olacaktır.

Yöntem 2: Manuel API Anahtarı Yapılandırması

Grafik arayüzü olmayan bir sunucu, konteyner kullanıyorsanız veya tarayıcı yetkilendirmesi yapmak istemiyorsanız, doğrudan Anthropic konsolundan bir API anahtarı alıp Claude Code'a yapılandırabilirsiniz.

Adımlar:

1. Tarayıcıyı açın, https://console.anthropic.com adresine gidin ve Anthropic hesabınıza giriş yapın.

2. API Anahtarları sayfasına gidin (genellikle Ayarlar veya Geliştirici Seçenekleri altında) ve "API Anahtarı Oluştur"a tıklayın.

3. Anahtara bir ad verin (örneğin claude-code-local) ve oluşturulduktan sonra hemen kopyalayın.
   Dikkat: Bu anahtar yalnızca bir kez gösterilir; sayfayı kapatırsanız bir daha göremezsiniz. Kaydetmeyi unuttuysanız, eski anahtarı silip yenisini oluşturabilirsiniz.

4. Terminale dönün ve anahtarı Claude Code'a vermek için iki yöntem vardır:

A. Ortam Değişkeni Yöntemi:

bash export ANTHROPIC_API_KEY=你的-api-key

Bu satırı ~/.bashrc veya ~/.zshrc dosyanıza ekleyin, böylece her seferinde otomatik olarak etkin olur.

B. Yapılandırma Dosyasına Yazma:

Claude Code kendi yapılandırma dosyasını da okur. ~/.claude/config.json dosyasını manuel olarak düzenleyin (yoksa oluşturun) ve şunu yazın:

json { "apiKey": "你的-api-key" }

Dikkat: Bu dosyanın izinlerini 600 olarak ayarlamanız önerilir (chmod 600 ~/.claude/config.json), böylece diğer kullanıcılar okuyamaz.

1. Bağlantıyı test edin:

bash claude "Merhaba, lütfen 'OK' yanıtı ver"

Normal bir yanıt alırsanız, anahtar doğru şekilde yapılandırılmıştır.

Manuel yapılandırmada sık yapılan hatalar:

• Anahtar sk-ant- veya sk- ile başlamaz mı? Hayır, Anthropic API anahtarı sk-ant-api03- ile başlayan uzun bir dizedir. Kopyalarken karakter eksiltmeyin.
• Aynı anda hem ortam değişkeni hem de dosya ayarladıysanız, ortam değişkeni daha yüksek önceliğe sahiptir. Karmaşayı önlemek için yalnızca birini kullanın.
• Anahtar ücretli bir kimlik bilgisidir; Git deposuna eklemeyin. Tüm ~/.claude dizinini veya yapılandırma dosyasını .gitignore ile hariç tutmanız önerilir.

Hesap Değiştirme veya Çıkış Yapma

Hesabı değiştirmek veya yerel kimlik bilgilerini temizlemek isterseniz:

• claude login kullandıysanız: claude logout komutunu çalıştırın, ardından yeniden claude login yapın.
• Manuel anahtar yapılandırdıysanız: Ortam değişkenini veya yapılandırma dosyasındaki eski anahtarı silin ve yenisiyle değiştirin.

Kimlik Doğrulamanın Normal Çalıştığını Test Etme

claude "Geçerli dizinin ne işe yaradığını açıkla"

Projenizin özetini okuyabiliyorsa, ortam hazırdır.