En İyi Uygulama Rehberleri

1. Claude Code ile Terminalde Eşli Programlama

Claude Code, terminalinizde çalışan, yerel git deponuzu analiz edebilen, dosyaları okuyup yazabilen ve test komutlarınızı doğrudan çalıştırabilen otonom bir mühendislik CLI aracıdır. Vangu Anthropic protokolü üzerinden tek ortam değişkeniyle çalıştırılır.

Kurulum ve Ortam Yapılandırması

Önce resmi CLI aracını kurun, ardından Vangu Anthropic uç noktasını ve geliştirici API anahtarınızı tanımlayın:

# 1. Claude Code CLI aracını küresel olarak yükleyin
npm install -g @anthropic-ai/claude-code

      # 2. Vangu Anthropic ortam değişkenlerini dışa aktarın
export ANTHROPIC_BASE_URL="https://api.vangu.dev/anthropic"
export ANTHROPIC_AUTH_TOKEN="vgu_live_sample_token_67b8a901"

# 3. Projenizin kök dizinine gidip Claude Code'u başlatın
cd ~/projelerim/backend
claude

# Windows PowerShell için ortam değişkeni tanımları
$env:ANTHROPIC_BASE_URL = "https://api.vangu.dev/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "vgu_live_sample_token_67b8a901"

# Claude Code CLI oturumunu başlatın
claude

Önerilen Modeller ve İpuçları

• Hızlı ve Dengeli Kodlama: Günlük refactoring ve test yazımları için <code>gpt-5.6-sol</code> (1.2x çarpan) tercih edin.
• Karmaşık Mimari ve Çok Adımlı Görevler: Büyük sistem tasarımları, monorepo geçişleri ve derin hata ayıklama için <code>gpt-6-astra</code> (2.0x çarpan) amiral gemisi modelini kullanın.
• .claudeignore Kullanımı: <code>.env</code>, derleme çıktıları (dist, node_modules) ve hassas anahtarları CLI bağlamından hariç tutarak token tasarrufu sağlayın.

2. Codex & Aider CLI ile Git Tabanlı İş Akışları

Aider, doğrudan terminalinizdeki git deposuyla çalışan ve yapay zekâ tarafından yapılan her kod düzenlemesini anlamlı bir commit mesajıyla kaydeden bir kodlama asistanıdır. Vangu Codex uç noktası (<code>https://api.vangu.dev/codex/v1</code>) üzerinden tam uyumluluk sağlar.

Aider Kurulumu ve Vangu Codex Bağlantısı

# 1. Python pip üzerinden Aider CLI aracını yükleyin
pip install aider-chat

# 2. Vangu Codex uyumlu uç noktayı ve API anahtarını tanımlayın
export OPENAI_API_BASE="https://api.vangu.dev/codex/v1"
export OPENAI_API_KEY="vgu_live_sample_token_67b8a901"

# 3. Sol veya Astra modeliyle otomatik commit modunda başlatın
aider --model openai/gpt-5.6-sol --auto-commits

Verimli Çalışma Taktikleri

• /add Komutu: Yalnızca ilgili dosyaları bağlama ekleyin (<code>/add src/auth.js src/db.js</code>). Tüm depoyu bağlama sokmamak kotanızı korur.
• /test Komutu: <code>/test npm test</code> çalıştırarak test hatalarını Aider'ın otomatik okuyup düzeltmesini sağlayın.
• Gece 00.00 Kota Yenilenmesi: Günlük paketlerde kotanız her gece 00.00'da yenilenir. Büyük refactor işlerinizi günlük kotalarınıza yayarak sıfır ek maliyetle tamamlayabilirsiniz.

3. Üçlü Protokol Gateway Mimarisi

Vangu mimarisi, tek bir API anahtarıyla hem OpenAI hem Anthropic hem de Codex formatındaki çağrıları kabul eden evrensel bir akıllı ağ katmanıdır. Kodunuzu baştan yazmak veya bağımlılıklarınızı değiştirmek zorunda kalmazsınız.

Protokol Karşılaştırma Matrisi

Python Çoklu Protokol İstemcisi Örneği

import os
from openai import OpenAI
from anthropic import Anthropic

API_KEY = os.environ.get("VANGU_API_KEY", "vgu_live_sample_token_67b8a901")

# 1. OpenAI İstemcisi (Luna / Terra / Sol / Astra)
openai_client = OpenAI(
    base_url="https://api.vangu.dev/v1",
    api_key=API_KEY
)

# 2. Anthropic İstemcisi (Claude SDK Uyumlu)
anthropic_client = Anthropic(
    base_url="https://api.vangu.dev/anthropic",
    api_key=API_KEY
)

print("Vangu çoklu protokol geçidi hazır.")

4. Üstel Geri Çekilme (Exponential Backoff) ve Hata Yönetimi

Yüksek eşzamanlı üretim sistemlerinde ağ dalgalanmaları veya anlık kota aşımları durumunda istemcinizin üstel gecikmelerle tekrar deneme (jittered exponential backoff) yapması kritik öneme sahiptir.

HTTP Durum Kodları ve Yenilenme Politikası

• HTTP 429 (Kota Sınırı): Günlük paket kotası dolduğunda dönülür. Günlük paketler her gece 00.00'da (UTC+3) otomatik olarak yenilenir. Başlıktaki <code>X-RateLimit-Reset</code> alanında sıfırlanma zamanı yer alır.
• HTTP 429 (Eşzamanlılık Sınırı): Anlık aktif eşzamanlı istek limitinize (aynı anda 10 istek) ulaşıldığında dönülür. Aktif isteklerden biri yanıtlandığında hemen yeni istek gönderebilirsiniz.
• HTTP 503 (Servis Yoğunluğu): Geçici model kümesi yeniden dengelenmesi durumunda döner, üstel geri çekilme ile hızla çözülür.

Python Dayanıklı Retry Fonksiyonu

import time
import random
import requests

def call_vangu_resilient(payload, max_retries=5):
    url = "https://api.vangu.dev/v1/chat/completions"
    headers = {
        "Authorization": "Bearer vgu_live_sample_token_67b8a901",
        "Content-Type": "application/json"
    }

    for attempt in range(max_retries):
        resp = requests.post(url, json=payload, headers=headers, timeout=30)
        
        if resp.status_code == 200:
            return resp.json()
            
        if resp.status_code == 429:
            # Retry-After başlığını kontrol et veya üstel bekleme süresi hesapla
            retry_after = float(resp.headers.get("Retry-After", 2 ** attempt))
            jitter = random.uniform(0.1, 0.5)
            sleep_time = retry_after + jitter
            print(f"[Vangu] 429 Alındı. Yeniden deneniyor (Deneme {attempt + 1}/{max_retries})...")
            time.sleep(sleep_time)
            continue
            
        if resp.status_code >= 500:
            time.sleep((2 ** attempt) + random.uniform(0.1, 0.3))
            continue
            
        resp.raise_for_status()

    raise RuntimeError("Vangu isteği maksimum deneme sayısına ulaştı.")

5. Server-Sent Events (SSE) ile Anlık Yanıt Akışı

Kullanıcı arayüzlerinde veya terminal araçlarında toplam yanıt süresini beklemek yerine, ilk kelimenin ekrana düşme süresini (Time-To-First-Token) 120 milisaniyeye kadar düşürmek için SSE akışını etkinleştirin.

Vanilla JavaScript (Fetch & ReadableStream)

async function streamVangu(prompt) {
  const res = await fetch("https://api.vangu.dev/v1/chat/completions", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer vgu_live_sample_token_67b8a901"
    },
    body: JSON.stringify({
      model: "gpt-5.6-luna", // Hızlı yanıtlar için en ekonomik model
      stream: true,
      messages: [{ role: "user", content: prompt }]
    })
  });

  const reader = res.body.getReader();
  const decoder = new TextDecoder();

  while (true) {
    const { done, value } = await reader.read();
    if (done) break;

    const chunk = decoder.decode(value);
    const lines = chunk.split("\n");

    for (const line of lines) {
      if (line.startsWith("data: ") && !line.includes("[DONE]")) {
        const json = JSON.parse(line.slice(6));
        const token = json.choices[0]?.delta?.content || "";
        process.stdout.write(token);
      }
    }
  }
}

// streamVangu("Asenkron programlama nedir?");

6. Token ve Kota Tasarrufu: Model Hiyerarşisi Stratejisi

Her iş yükü için en pahalı modeli kullanmak yerine, görev türüne göre model sınıflandırması yaparak ve sistem istemlerini sadeleştirerek günlük kotanızdan %40’a varan tasarruf sağlayabilirsiniz.

Vangu Model Hiyerarşisi ve Kullanım Matrisi