OpenCode

Açık Kaynaklı AI Kodlama Ajanı

OpenCode, güçlü bir açık kaynak AI kodlama ajanıdır. Tek bir config dosyasıyla ustaGPT'ye yönlendirin ve katalogdaki her modeli kullanın.

Adım 1: OpenCode'u Yükleyin

curl -fsSL https://opencode.ai/v2/install | bash

# Verify the installation
opencode --version

OpenCode v2 ile v1 farklı config şemaları kullanır — opencode --version çıktısına bakın ve Adım 2'de sürümünüze uyan sekmeyi seçin.

Adım 2: Sağlayıcıyı yapılandırın

OpenCode yapılandırmasını tek bir JSON dosyasından okur. Windows'ta aynı yol kullanıcı klasörünüzün altındadır (C:\Users\kullanıcı-adınız\.config\opencode\opencode.json); orada WSL önerilir.

Config dosyası konumu (tüm platformlar)

~/.config/opencode/opencode.json

ustaGPT'yi işaret eden bir custom provider bloğu ekleyin, kullanmak istediğiniz modelleri tanımlayın ve varsayılan modelinizi ayarlayın. OpenCode sürümünüze uyan sekmeyi seçin:

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "ustagpt": {
      "name": "UstaGPT",
      "package": "@opencode/ai/providers/openai-compatible",
      "env": ["USTAGPT_API_KEY"],
      "settings": {
        "baseURL": "https://api.ustagpt.com.tr/v1"
      },
      "models": {
        "kimi-k3": {
          "name": "Kimi K3",
          "limit": {
            "context": 1024576,
            "output": 262144
          }
        }
      }
    }
  },
  "model": "ustagpt/kimi-k3"
}

Alanların anlamı:

baseURL /v1 içermelidir — OpenCode sonuna /chat/completions ekler. Anahtar Authorization: Bearer olarak gönderilir.
models, seçebileceğiniz kimlikleri gerçek context ve çıktı sınırlarıyla (ustaGPT katalog değerleri) listeler.
model, provider/model-id biçiminde varsayılanınızdır.
v2 anahtarı env içinde adı geçen değişkenden okur; v1 aynı ortam değişkenini OpenCode'un env ikamesiyle apiKey alanından okur. İkisi de Authorization: Bearer olarak gönderir.

Adım 3: API anahtarınızı ayarlayın

Config'deki env dizisi, OpenCode'un anahtarı okuyacağı değişkeni adlandırır. Her oturumda hazır olsun diye shell profilinizde (veya PowerShell profilinde) export edin:

~/.bashrc or ~/.zshrc

export USTAGPT_API_KEY="sk-ustagpt-your-api-key"

Adım 4: Başlatın ve model seçin

Sağlayıcınızın ve modellerinizin kayıtlı olduğunu kontrol edin, sonra OpenCode'u projenizde başlatın:

# List the models your config exposes
opencode models

# Start OpenCode in your project
cd your-project-directory
opencode

Oturum içindeyken /models, yapılandırmanızdaki — ustagpt sağlayıcınız dahil — tüm modelleri listeler. Seçim geçerli oturuma uygulanır.

/models

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ı

Özellikler

Herkese açık bağlantılarla sohbetleri paylaşın
VS Code ve Cursor için IDE entegrasyonları
GitHub iş akışı entegrasyonu