Dokümantasyona Dön

Claude Code

Anthropic'in resmi CLI aracı

Claude Code, Anthropic'in resmi AI destekli kodlama CLI aracıdır. ustaGPT'ye yönlendirin ve tek bir yapılandırmayla 100+ modelin tamamını — Anthropic olmayanlar dahil — kullanın.

Adım 1: Claude Code'u Yükleyin

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

# Verify the installation (prints a version number)
claude --version
Native kurulum önceden yüklenmiş bir şey gerektirmez ve arka planda kendi kendini güncelleştirir. npm tercih ediyorsanız aşağıdaki alternatifi kullanın.
# Alternative: install via npm (requires Node.js 22 or newer)
npm install -g @anthropic-ai/claude-code

Adım 2: ustaGPT'yi Yapılandırın

1

API Anahtarı Alın

  • ustaGPT'ye kayıt olun veya giriş yapın
  • Dashboard'dan API Anahtarları sayfasına gidin
  • Yeni bir API anahtarı oluşturun ve kopyalayın
2

Ayarlar dosyasını düzenleyin

Aşağıdaki dosyayı açın (yoksa oluşturun) ve env bloğunu ekleyin. Bu önerilen yöntemdir: her oturuma, her platformda uygulanır — shell profili gerekmez.

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ustagpt.com.tr",
    "ANTHROPIC_AUTH_TOKEN": "sk-ustagpt-your-api-key",
    "ANTHROPIC_MODEL": "kimi-k3",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1024576",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "262144"
  }
}

Alanların işlevi:

  • ANTHROPIC_BASE_URL — ustaGPT API kökü, yazıldığı gibi — /v1 eki olmadan (yolu Claude Code kendisi ekler).
  • ANTHROPIC_AUTH_TOKEN — ustaGPT API anahtarınız; Authorization: Bearer olarak gönderilir. ANTHROPIC_API_KEY değil, bu değişkeni kullanın.
  • ANTHROPIC_MODEL — Claude Code'un her istekte kullanacağı model. ustaGPT kataloğundaki herhangi bir model kimliği çalışır.
  • CLAUDE_CODE_MAX_CONTEXT_TOKENS — modelin gerçek context penceresi — Claude Code varsayılan yerine doğru zamanda sıkıştırma (compact) yapar.
  • CLAUDE_CODE_MAX_OUTPUT_TOKENS — modelin gerçek çıktı (output) sınırı.
ANTHROPIC_BASE_URL'e /v1 eklemeyin ve ANTHROPIC_API_KEY kullanmayın — ustaGPT Bearer token bekler. Yanlış base URL veya yanlış başlıkta bir anahtar, 401 hatalarının en yaygın nedenidir.

Alternatif: shell export

Aynı değişkenleri ayarlar dosyası yerine shell profilinizde de tanımlayabilirsiniz. Bu yalnızca profili yüklemiş terminallere uygulanır; bu yüzden yukarıdaki ayarlar dosyası önerilir.

export ANTHROPIC_BASE_URL="https://api.ustagpt.com.tr"
export ANTHROPIC_AUTH_TOKEN="sk-ustagpt-your-api-key"
export ANTHROPIC_MODEL="kimi-k3"

Adım 3: Bağlantıyı doğrulayın

Claude Code'u başlatmadan önce ustaGPT'ye doğrudan tek token'lık bir istek gönderin. msg_ ile başlayan bir kimliğe sahip JSON yanıtı, URL'nin ve anahtarın çalıştığını kanıtlar:

curl -sS -X POST "https://api.ustagpt.com.tr/v1/messages" \
  -H "Authorization: Bearer sk-ustagpt-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "kimi-k3", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Adım 4: Claude Code'u Başlatın

Yapılandırma tamamlandı. Proje dizininizde bir oturum başlatın:

cd your-project-directory
claude

# Or pick a model for a single run
claude --model kimi-k3

Çalışan bir oturumun içindeyken /model komutuyla istediğiniz zaman model değiştirebilirsiniz (Enter seçimi yeni oturumlar için kaydeder, s kaydetmeden değiştirir):

/model
/model kimi-k3
Yukarıdaki örnekteki model kimliği ve token sınırları tek bir modele aittir. Her modelin gerçek context ve çıktı sınırları şu sayfada listelenir: Modeller sayfası

SSS

Yapılandırma Çalışmıyor mu?

  • Claude Code içinde /status çalıştırın: Anthropic base URL satırında https://api.ustagpt.com.tr görünmeli ve Auth token satırı ANTHROPIC_AUTH_TOKEN'ı adlandırmalı.
  • claude doctor çalıştırın — oturum başlatmadan kurulum sağlığını, ayarlar dosyasındaki JSON hatalarını ve yapılandırma uyarılarını raporlar.
  • Dosyayı bir oturum açıkken düzenlediyseniz oturumu yeniden başlatın. JSON'un geçerli olduğunu kontrol edin — eksik virgül, yorum satırı olmamalı.

Önerilen Sürüm

Native kurulumlar arka planda kendi kendini güncelleştirir. Elle kontrol etmek veya güncellemek için:

# Check installation and configuration health
claude doctor

# Check current version / upgrade to latest
claude --version
claude update