Kodlama araçları

OpenCode

TokenLab API'sini kullanmak için OpenCode'u yapılandırın

Bırakın ajanım bunu ayarlasın

Bu görevi bilgisayarınızda halihazırda çalışan bir ajana kopyalayın:

Read this guide and help me connect OpenCode to TokenLab:
https://tokenlab.sh/docs/tr/integrations/opencode
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.

Genel Bakış

OpenCode, özel bir OpenAI uyumlu sağlayıcı aracılığıyla TokenLab'i kullanabilir. TokenLab API anahtarını, Base URL'i ve güncel bir model kimliğini ekleyin.

Kurulum

OpenCode

npm install -g opencode-ai@1.18.31

Kurulumu doğrulayın:

opencode --version

Yapılandırma

1. Adım: Ortam Değişkenlerini Ayarlayın

TOKENLAB_API_KEY değerini komut geçmişine eklemeden ayarlamak için macOS, Linux, WSL veya Windows PowerShell için Hızlı Başlangıç terminal talimatlarını kullanın. OpenCode'u bu terminalden başlatın. Kalıcı kullanım için yerel gizli yöneticinizi (secret manager) kullanın; kabuk profilinize düz metin olarak anahtar eklemeyin.

2. Adım: OpenCode'u Yapılandırın

Aşağıdaki yapılandırma OpenCode 1.18.31 ile kontrol edilmiştir. Diğer sürümlerin resmi belgelere göre kendi doğrulamalarını yapmaları gerekir.

Aşağıdaki yapılandırmayı içeren ayrı bir ~/.config/opencode/tokenlab.jsonc dosyası oluşturun. Eğer XDG_CONFIG_HOME ayarlıysa, bu dizin altındaki opencode/tokenlab.jsonc dosyasını kullanın. Normal opencode.json / opencode.jsonc dosyalarını, hesapları, varsayılan modeli ve izinleri değiştirmeden bırakın: bu ayrı dosya yalnızca onu seçen bir çağrı yapıldığında OPENCODE_CONFIG ile yüklenir. Eğer dosya veya sağlayıcı adı zaten başka bir kuruluma aitse, farklı bir dosya/ad seçin ve komutları buna göre ayarlayın.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenlab": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenLab",
      "options": {
        "baseURL": "https://api.tokenlab.sh/v1",
        "apiKey": "{env:TOKENLAB_API_KEY}"
      },
      "models": {
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna"
        }
      }
    }
  }
}

Bu yapılandırma, Sohbet Tamamlamaları (Chat Completions) için @ai-sdk/openai-compatible kullanır. Ayrıntıları Sohbet Tamamlamalarını ve ihtiyacınız olan araçları destekleyen güncel bir model seçin; bu örnekten başka bir protokol veya sürüm desteği çıkarmayın.

İsteğe bağlı: tersine çevrilebilir OpenCode kurulum yardımcısı, Python 3.11+ ile önizleme, uygulama ve orijinal dosya geri yükleme sağlar. TokenLab Skills eklentisi 0.1.2 bu betikleri içerir; bunları içeren bir sürüme güncelledikten sonra bağımsız bir Skill kurulumu da kullanılabilir. Mevcut bir eklenti veya bağımsız Skill kurulumu için README güncelleme talimatlarını izleyin ve betiğin mevcut olduğunu doğrulayın. Buradaki manuel yapılandırma, yardımcı olmadan da kullanılabilir durumdadır.

Temel Kullanım

Anahtarı Hızlı Başlangıç'ı kullanarak ayarlayın, ardından bu dosyayı yükleyin ve bu çağrı için modeli açıkça seçin. Özelleştirilmişse kendi gerçek yolunuzu ve sağlayıcı adınızı kullanın. Mevcut OPENCODE_CONFIG veya satır içi OPENCODE_CONFIG_CONTENT kurulumlarını ayrı bir başlatma ortamında tutun; proje ve yönetilen ayarlar hala öncelikli olabilir.

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode models tokenlab
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode --model tokenlab/gpt-5.6-terra

Model keşfi yerel yüklemeyi kontrol eder, anahtar geçerliliğini veya başarılı bir canlı isteği değil. Bir istem TokenLab bakiyesini kullanır ve OpenCode, başlık oluşturma gibi ayrı olarak ücretlendirilen yardımcı istekler gönderebilir. Yanıtı ve eşleşen istek kayıtlarını kontrol edin.

Normal kurulumunuzu kullanmak için bu katman olmadan başlatın. Bu kılavuz için OPENCODE_CONFIG değerini kabuk profilinizde kalıcı hale getirmeyin. Manuel kurulumu geri almak için yalnızca oluşturduğunuz ayrı dosyayı silin veya daha önceden mevcutsa yedeğini geri yükleyin.

Aynı ajanda görsel ve video oluşturun

OpenCode, TokenLab MCP sunucusu ile görseller ve kısa videolar da oluşturabilir. Her üretim aynı TokenLab bakiyesinden ödenir. Bu mcp girişini provider'ın yanına, aynı tokenlab.jsonc dosyasına birleştirin. OpenCode, {env:TOKENLAB_API_KEY} ifadesini terminalinizdeki değişkenle değiştirir, böylece anahtar dosyaya yazılmaz:

{
  "mcp": {
    "tokenlab": {
      "type": "local",
      "command": ["npx", "-y", "@tokenlabai/mcp-server@0.6.48"],
      "environment": {
        "TOKENLAB_MCP_TOOL_PROFILE": "core",
        "TOKENLAB_API_KEY": "{env:TOKENLAB_API_KEY}"
      },
      "timeout": 30000
    }
  }
}

Daha uzun timeout süresi, npx'e ilk başlatmada paketi indirmesi için zaman tanır. Aynı OPENCODE_CONFIG ile opencode mcp list komutunu çalıştırın ve tokenlab'in bağlı olduğunu kontrol edin. Ardından şunu deneyin:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video bir görev kimliği döndürür. Ajan, video hazır olana kadar get_task_status komutunu çağırır. Diğer ayarlar için OpenCode MCP sunucularına bakın.

Bir Model Seçin

Modeller sayfasından güncel bir kodlama modeli kimliğini kopyalayın. Varsayılanı ayarlamadan önce kendi deponuzda modelleri karşılaştırın.

Yaygın Komutlar

Kodu analiz et:

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "What does this function do?" < src/utils.ts

Kod oluştur:

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Create a REST API with Express"

Değişiklikleri gözden geçir:

git diff | OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Review these changes"

Hataları düzelt:

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Fix the TypeScript errors in this project"

Etkileşimli Komutlar

KomutAçıklama
/helpMevcut komutları göster
/modelsFarklı bir modele geçiş yap
/clearKonuşma geçmişini temizle
/exitOpenCode'dan çık

Sorun Giderme

İpuçları

Bu sayfada