GELİŞTİRİCİ REHBERİ · BELGE GÖZDEN GEÇİRME: 1 KASIM 2026

Cline ve OpenCode'u Wold API'ye bağlama: kurulum ve test

Cline ve OpenCode, özel OpenAI uyumlu sağlayıcı ayarlarıyla Wold'a yönlendirilebilir. Bu sayfa Cline ile OpenCode v1/v2 yapılandırma biçimlerini ve güvenli ilk kontrolleri anlatır; gerçek araç bağlantısının çalıştığını iddia etmez.

Yayın: 31 Ekim 2026 · Güncelleme: 1 Kasım 2026

Gerekenler

Her araçta aynı üç bilgiyi gireceksin:

Model kimliğini Console'daki etkin model listesinden veya aşağıdaki kimlik doğrulamalı liste isteğinden al. Yanıttaki data[].id değerini aynen kullan; OpenCode'da ayrıca yapılandırmada model olarak tanımlaman gerekir. Kodlama ajanlarının araç çağrısı desteği modele bağlıdır, model özelliklerini Console'dan kontrol et. Daha fazla bilgi: API model listesi rehberi.

# Bash / zsh: WOLD_API_KEY'i güvenli biçimde kendi oturumunda tanımla
curl -sS "https://api.wold.cloud/v1/models" \
  -H "Authorization: Bearer $WOLD_API_KEY"

# Windows PowerShell: curl takma adı yerine curl.exe kullan
curl.exe -sS "https://api.wold.cloud/v1/models" `
  -H "Authorization: Bearer $env:WOLD_API_KEY"

Bu GET isteği model üretmez; yine de anahtar, güncel şart kabulü ve beta istek limitleri geçerlidir. Anahtarı komutun içine yapıştırma veya geçmişe kaydetme.

Cline ayarları

1. VS Code'da Cline panelini aç ve ayarlar (⚙️) simgesine tıkla.
2. API Provider listesinden OpenAI Compatible seç.
3. Base URL alanına https://api.wold.cloud/v1 yaz.
4. API Key alanına Wold API anahtarını yapıştır.
5. Model alanına model listesinden aldığın kimliği aynen yaz. Cline'ın resmi belgesindeki alan adı sürüme göre değişebilir.
6. Gerekirse Model Configuration bölümünde bağlam penceresi ve en fazla çıktı token değerlerini modelin Console'daki bilgilerine göre ayarla.

Kurulu Cline sürümünü VS Code'un Extensions görünümündeki Cline ayrıntılarından kontrol et. Menü adları değişebilir; güncel alan adları ve OpenAI Compatible sağlayıcısı için Cline'ın resmi OpenAI Compatible belgesine bak. Temel URL'ye /chat/completions ekleme.

OpenCode v1/v2 ayarları

Önce kurulu sürümü opencode --version ile kontrol et. Bu rehberdeki provider/npm biçimi OpenCode v1 içindir; resmi v1 sağlayıcı belgesindeki sohbet tamamlamaları örneğidir. Proje kökünde veya genel yapılandırma klasöründe (~/.config/opencode/opencode.json) kullan:

OpenCode v1 yapılandırması

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "wold": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Wold",
      "options": {
        "baseURL": "https://api.wold.cloud/v1",
        "apiKey": "{env:WOLD_API_KEY}"
      },
      "models": {
        "listeden_sectigin_model_id": {
          "name": "Wold modeli"
        }
      }
    }
  }
}

listeden_sectigin_model_id yerine Console'dan veya /v1/models yanıtından aldığın gerçek model kimliğini yaz. {env:WOLD_API_KEY} anahtarı ortam değişkeninden okur; anahtarı yapılandırma dosyasına koyma. Bu v1 şemasıdır, v2 ayarına kopyalama. Ayrıntılar için OpenCode v1 sağlayıcı belgesine bak.

# Bash / zsh: gizli giriş geçmişe yazılmaz
read -rsp "Wold API key: " WOLD_API_KEY
printf '\\n'
export WOLD_API_KEY
opencode

# Windows PowerShell
$secureKey = Read-Host "Wold API key" -AsSecureString
$env:WOLD_API_KEY = [System.Net.NetworkCredential]::new("", $secureKey).Password
Remove-Variable secureKey
opencode

OpenCode açılınca /models komutuyla Wold modelini seç. Anahtar örneğini kendi güvenli oturumuna göre ayarla; gerçek anahtarı sohbete, kaynak koduna veya depoya ekleme.

OpenCode v2 yapılandırması

OpenCode v2 ayrı bir şema kullanır: çoğul providers, package, settings.baseURL ve env. Aşağıdaki örnek yalnızca v2 içindir; kurulu sürümün v2 olduğunu doğruladıysan kullan. Model anahtarını gerçek model kimliğiyle değiştir:

{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "wold": {
      "name": "Wold",
      "env": ["WOLD_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://api.wold.cloud/v1"
      },
      "models": {
        "listeden_sectigin_model_id": {
          "name": "Wold modeli"
        }
      }
    }
  }
}

v2'de model referansı wold/model-kimliği biçimindedir. Yapılandırma ayrıntıları için OpenCode v2 resmi sağlayıcı belgesine bak. v1 ve v2 örnekleri birbirinin yerine kullanılamaz; v1 paketi @ai-sdk/openai-compatible, v2 paketi @opencode/ai/providers/openai-compatible biçimindedir. Her ikisi de Chat Completions uyumluluğunu hedefler, Responses API ile aynı entegrasyon değildir.

Güvenli ilk kontrol

1. Önce uygulama sürümünü ve ona karşılık gelen resmi belgeyi doğrula; doğru v1/v2 yapılandırma biçimini seç. Bu sayfadaki örnekler statik olarak gözden geçirilmiştir, kurulu uygulamada açıldıkları veya ağa bağlandıkları doğrulanmamıştır.
2. Yukarıdaki GET /v1/models isteğinde HTTP 200 ve data dizisini gör. Buradan bir etkin modelin id değerini kopyala; bu kontrol model yanıtı üretmez.
3. İsteğe bağlı gerçek bağlantı kontrolünü yalnızca davetli hesabın ve açık test onayın varsa yap. Kod içermeyen boş bir klasörde, kısa ve zararsız bir istem kullan: Yalnızca READY yaz; dosya okuma/değiştirme veya komut çalıştırma. Otomatik izin/onay modlarını kapalı tut; araç dosya veya komut izni isterse reddet. Tek yanıt isteği de beta limitini tüketebilir.
4. Sonucu “denendi” diye kaydedeceksen tarih, araç sürümü, işletim sistemi, kontrol edilen özellik ve sonucu belirt; anahtarı, ham başlıkları veya kişisel verileri paylaşma. Bu rehber hazırlanırken Cline/OpenCode üzerinden canlı model çağrısı yapılmadı.

Bilinmesi gerekenler

• Uyumluluk her şey demek değil: Araçların her özelliği, her model ve her sürümde çalışmayabilir. Örneğin görsel girişi veya uzun bağlam modele bağlıdır.
• Beta ve test limiti: Kodlama ajanları tek görevde çok sayıda istek gönderebilir. Ücretsiz beta davetlidir, erişim veya davet kabulü garanti edilmez. Test limitini Console'dan kontrol et.
• Anahtar ve veri: Anahtarı OS/shell ortam değişkeninde tut; asla koda, paylaşılan config'e, ekran görüntüsüne ya da sohbete koyma. Ajanlar proje dosyalarını modele gönderebilir. Hassas kod veya müşteri verisi içeren projede önce gizlilik aydınlatmasını ve kullanım şartlarını incele.
• Resmi entegrasyon değil: Wold, Cline veya OpenCode ekiplerinin resmi sağlayıcısı değildir. Bu ayarlar araçların genel özel sağlayıcı desteğini kullanır.

Claude Code kullanıyorsan ayarlar farklıdır ve resmi destek sınırları vardır. Bunları Claude Code'u açık modellerle kullanma rehberinde anlattık.

Sorun giderme

Aşağıdaki HTTP eşleştirmeleri Wold sunucu kodundaki API davranışından çıkarılmıştır; canlı araç isteğiyle sınanmış hata raporları değildir. Yanıttaki hata kodunu ve varsa Retry-After başlığını kontrol et.