Visual Studio Code

Genel bakışCopy Anchor Link

VS Code sohbeti, Custom Endpoint (kendi anahtarını getir, BYOK) üzerinden kendi model sağlayıcınızı kullanabilir. Bu sayfa TokenLab'i Chat Completions API'si üzerinden bağlar.

• Sohbet için Copilot planı gerekmez. VS Code'un BYOK modelleri GitHub'da oturum açmadan çalışır.
• Bazı özellikler yine de GitHub gerektirir: satır içi öneriler (kod tamamlama), anlamsal arama ve embedding tabanlı diğer özellikler BYOK modelleri tarafından sunulmaz. TokenLab anahtarı bunların yerini tutmaz.
• Copilot Business veya Enterprise kullanıcıları: yöneticinizin Bring Your Own Language Model Key in VS Code ilkesine izin vermesi gerekir.

GereksinimlerCopy Anchor Link

• Chat görünümüne sahip güncel ve kararlı bir VS Code sürümü.
• Bir TokenLab API anahtarı (anahtar alın).
• openai_chat_completions kabul eden ve araç çağırmayı destekleyen bir model (ajan modu yalnızca araç çağırabilen modelleri listeler). Modelin sayfası ikisini de gösterir: API biçimi altında Chat Completions API, yetenekler altında Tool use; örneğin GPT-5.6 Luna.

TokenLab'i ekleyinCopy Anchor Link

1. Chat görünümünde model seçiciyi açıp Manage Language Models (dişli simgesi) seçeneğini seçin veya Komut Paleti'nden Chat: Manage Language Models komutunu çalıştırın.
2. Add Models → Custom Endpoint seçeneğini seçin.
3. VS Code bir Group Name ister. Alan Custom Endpoint ile önceden doldurulmuştur; bunu TokenLab olarak değiştirip Enter'a basın.
4. Hemen ardından TokenLab: API Key başlıklı bir giriş kutusu açılır. TokenLab API anahtarınızı yapıştırıp Enter'a basın. VS Code anahtarı gizli depolama alanında (secret storage) saklar.
5. VS Code bir API türü sorarsa Chat Completions seçeneğini seçin. Bu adım görünmeyebilir; aşağıdaki dosyadaki apiType her durumda bunu belirler.
6. VS Code chatLanguageModels.json dosyasını açar. Sihirbazın oluşturduğu apiKey satırını koruyun (gizli depolamadaki anahtarı gösterir), apiType değerinin chat-completions olduğundan emin olun, models listesini aşağıdaki girdiyle eşleşecek şekilde düzenleyin ve kaydedin.

Anahtarı sihirbaza girin. Doğrudan chatLanguageModels.json dosyasına yazılan anahtar gönderilmez ve istekler eksik Authorization başlığı nedeniyle başarısız olur.

[
  {
    "name": "TokenLab",
    "vendor": "customendpoint",
    "apiKey": "${input:tokenlabApiKey}",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "gpt-5.6-luna",
        "name": "GPT-5.6 Luna (TokenLab)",
        "url": "https://api.tokenlab.sh/v1/chat/completions",
        "toolCalling": true,
        "vision": true,
        "maxInputTokens": 200000,
        "maxOutputTokens": 32000
      },
      {
        "id": "claude-sonnet-5-5",
        "name": "Claude Sonnet 5.5 (TokenLab)",
        "url": "https://api.tokenlab.sh/v1/chat/completions",
        "toolCalling": true,
        "vision": true,
        "maxInputTokens": 200000,
        "maxOutputTokens": 32000
      },
      {
        "id": "gpt-6.1-sol",
        "name": "GPT-6.1 Sol (TokenLab)",
        "url": "https://api.tokenlab.sh/v1/chat/completions",
        "toolCalling": true,
        "vision": false,
        "maxInputTokens": 200000,
        "maxOutputTokens": 32000
      }
    ]
  }
]

Notlar:

• URL'yi /chat/completions dahil eksiksiz yazın. VS Code, açık bir API yolu içeren URL'yi olduğu gibi kullanır.
• Chat Completions türünde VS Code Authorization: Bearer <key> gönderir; TokenLab'in beklediği de budur. Özel bir kimlik doğrulama başlığı eklemeyin.
• id, istekte gönderilen TokenLab model kimliğidir. accepted_request_formats alanı openai_chat_completions içeren herhangi bir etkin modeli kullanabilirsiniz.
• Token sınırları: VS Code maxInputTokens + maxOutputTokens toplamını bağlam penceresi olarak kabul eder. Yukarıdaki değerler temkinlidir; bunları model sayfasındaki sınırlara kadar yükseltebilirsiniz. Daha büyük bağlamlar istek başına daha pahalıdır.
• Model seçicide görünmüyorsa VS Code'u yeniden başlatın.

GitHub oturumu olmadanCopy Anchor Link

Başlık oluşturma, commit mesajları ve diğer arka plan "utility" görevleri varsayılan olarak GitHub Copilot modellerini kullanır. Copilot oturumu yoksa chat.utilityModel ve chat.utilitySmallModel ayarlarını bir TokenLab modeline (küçük model için hızlı ve ucuz bir model) ayarlayın veya chat.byokUtilityModelDefault ayarını Main Agent Model yapın. Bu arka plan çağrıları TokenLab bakiyenizden ücretlendirilir.

DoğrulamaCopy Anchor Link

1. Model seçicide GPT-5.6 Luna (TokenLab) modelini seçin (ilk test için uygun, düşük maliyetli bir model).
2. Önce salt okunur bir soru sorun, örneğin: Summarize the top-level structure of this workspace. Do not modify files.
3. Ajan görevleri çalıştırmadan önce yanıtı ve ona karşılık gelen istek kaydını kontrol edin.

Yapılandırmayı kaydetmek veya modelleri listelemek anahtarın çalıştığını kanıtlamaz. Her istem TokenLab bakiyesi harcar.

Sorun gidermeCopy Anchor Link

• Authorization başlığı eksik: anahtar gizli depolamada değil. Add Models → Custom Endpoint adımlarını yeniden çalıştırın ve anahtarı JSON dosyası yerine sihirbaza girin.
• 401 / kimlik doğrulama başarısız: anahtarı Manage Language Models → TokenLab grubunun yanındaki dişli simgesinden yeniden girin.
• Model bulunamadı: id tam olarak bir TokenLab model kimliği olmalıdır; model sayfasını kontrol edin.
• Model ajan modunda görünmüyor: "toolCalling": true ayarlayın ve araç kullanımını destekleyen bir model kullanın.
• Messages veya Responses API türleri: bu sayfada henüz ele alınmıyor; Chat Completions kullanın.

API anahtarlarını chatLanguageModels.json dosyasına veya Git tarafından izlenen herhangi bir dosyaya commit etmeyin; dosyada ${input:...} kalsın.