OpenCode'u CometAPI ile kullanın

Bu kılavuzu kullanarak OpenCode’u CometAPI ile kullanın. Yapılandırma, ayrı özel sağlayıcılar aracılığıyla dört API biçimini sunar. Bu yapılandırma OpenCode 1.18.16 ile test edilmiştir. Resmî kaynaklar:

Her bir your-model-id değerini, CometAPI Models sayfasındaki bir model kimliğiyle değiştirin. Çevredeki sağlayıcı girdisinin API biçimini kabul eden bir model seçin.

Ön koşullar

Node.js ve npm ya da OpenCode kılavuzundaki başka bir yükleme yöntemi
Etkin API anahtarına sahip bir CometAPI hesabı; anahtarınızı şuradan alın: dashboard
Bir veya daha fazla model kimliği için şu sayfaya bakın: CometAPI Models sayfası

API biçimlerini anlayın

Her sağlayıcı kimliği, bir SDK adaptörü ve bir API biçimi seçer.

Sağlayıcı kimliği	OpenCode adaptörü	Temel URL	API biçimi
`cometapi-chat`	`@ai-sdk/openai-compatible`	`https://api.cometapi.com/v1`	Chat Completions
`cometapi-responses`	`@ai-sdk/openai`	`https://api.cometapi.com/v1`	Responses
`cometapi-messages`	`@ai-sdk/anthropic`	`https://api.cometapi.com/v1`	Anthropic Messages
`cometapi-gemini`	`@ai-sdk/google`	`https://api.cometapi.com/v1beta`	Gemini generateContent

Bu kılavuz, normal bir OpenCode agent turu sırasında kullanılan Gemini Streaming işlemini doğrular. Google adaptörü, :streamGenerateContent?alt=sse ifadesini model yoluna ekler. /chat/completions, /responses, /messages ya da bir Gemini model yolunu baseURL öğesine eklemeyin. Her adaptör, gerekli işlem yolunu ekler.

Çalışma zamanı izinlerini anlayın

OpenCode, onu başlatan sürecin izinleriyle çalışır. Çalıştırmak için OpenCode’u hedeflenen proje dizininde başlatın ve örneğin git gibi bir geri alma yolu bulundurun. Daha güçlü dosya sistemi, süreç, ağ veya API anahtarı sınırlarına ihtiyacınız olduğunda container ya da sandbox kullanın.

OpenCode’u yapılandırma

OpenCode'u yükleme

OpenCode’u resmi npm paketiyle yükleyin:

npm install -g opencode-ai

CLI’nin kullanılabilir olduğunu doğrulayın:

opencode --version

Şuraya bakın: OpenCode yükleme kılavuzu Homebrew, Windows, Docker ve diğer yükleme yöntemleri için.

CometAPI API anahtarınızı ayarlama

CometAPI API anahtarınızı COMETAPI_KEY ortam değişkeninde saklayın.

macOS / Linux / WSL
Windows PowerShell

API anahtarını terminalde görüntülemeden okuyun:

read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY

API anahtarını geçerli PowerShell oturumuna okuyun:

$secureKey = Read-Host "CometAPI API key" -AsSecureString
$env:COMETAPI_KEY = [System.Net.NetworkCredential]::new(
  "",
  $secureKey
).Password

OpenCode’u başlatan her kabuk oturumunda değişkeni ayarlayın. API anahtarlarını sürüm denetimine işlemeyin.

Yapılandırma konumu seçme

Desteklenen şu konumlardan birini kullanın:

Genel yapılandırma: ~/.config/opencode/opencode.json
Proje yapılandırması: proje kök dizinindeki opencode.json

OpenCode, yapılandırma dosyalarını birleştirir. Proje yapılandırması, genel yapılandırmadaki çakışan değerleri geçersiz kılar.Sağlayıcıların her projede kullanılmasını istediğinizde genel dosyayı kullanın. Bir deponun kendi model girişlerine ihtiyaç duyduğu durumlarda proje dosyasını kullanın.

CometAPI sağlayıcılarını ekleme

Seçilen yapılandırma dosyasını oluşturun. Dosya zaten bir provider nesne içeriyorsa bu dört girişi söz konusu nesneyle birleştirin:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "cometapi-chat": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CometAPI Chat Completions",
      "options": {
        "baseURL": "https://api.cometapi.com/v1",
        "apiKey": "{env:COMETAPI_KEY}"
      },
      "models": {
        "your-model-id": {
          "name": "CometAPI Chat model"
        }
      }
    },
    "cometapi-responses": {
      "npm": "@ai-sdk/openai",
      "name": "CometAPI Responses",
      "options": {
        "baseURL": "https://api.cometapi.com/v1",
        "apiKey": "{env:COMETAPI_KEY}"
      },
      "models": {
        "your-model-id": {
          "name": "CometAPI Responses model"
        }
      }
    },
    "cometapi-messages": {
      "npm": "@ai-sdk/anthropic",
      "name": "CometAPI Anthropic Messages",
      "options": {
        "baseURL": "https://api.cometapi.com/v1",
        "apiKey": "{env:COMETAPI_KEY}"
      },
      "models": {
        "your-model-id": {
          "name": "CometAPI Messages model"
        }
      }
    },
    "cometapi-gemini": {
      "npm": "@ai-sdk/google",
      "name": "CometAPI Gemini",
      "options": {
        "baseURL": "https://api.cometapi.com/v1beta",
        "apiKey": "{env:COMETAPI_KEY}"
      },
      "models": {
        "your-model-id": {
          "name": "CometAPI Gemini model"
        }
      }
    }
  }
}

Her your-model-id anahtarını ayrı ayrı değiştirin. Dört giriş farklı model kimlikleri kullanabilir.Yapılandırma, üst düzey bir model ayarlamaz. Bu sayede gerekli API biçimini ve modeli /models üzerinden seçebilirsiniz.

Bu yapılandırma için /connect kullanmayın. apiKey alanları COMETAPI_KEY ortamdan okunur. Ayarlanmamış bir değişken, saklanan /connect API anahtarı yerine boş bir değere çözümlenir.

Her sağlayıcıyı seçme ve doğrulama

OpenCode’u erişmesini istediğiniz projede başlatın:

opencode

/models komutunu çalıştırın, ardından bir provider/model girişi seçin. Bu kılavuzdaki dört doğrulama çalıştırmasında her model turu, seçilen girişin eşleşen API biçimini kullandı. Biçimler arası istek çoğaltması veya otomatik API biçimi anlaşması gözlemlenmedi.Chat Completions’ı komut satırından doğrulamak için şunu çalıştırın:

opencode run \
  --model cometapi-chat/your-model-id \
  "Reply exactly with: COMETAPI_CHAT_OK"

Responses’ı komut satırından doğrulamak için şunu çalıştırın:

opencode run \
  --model cometapi-responses/your-model-id \
  "Reply exactly with: COMETAPI_RESPONSES_OK"

Anthropic Messages’ı komut satırından doğrulamak için şunu çalıştırın:

opencode run \
  --model cometapi-messages/your-model-id \
  "Reply exactly with: COMETAPI_MESSAGES_OK"

Gemini generateContent’i komut satırından doğrulamak için şunu çalıştırın:

opencode run \
  --model cometapi-gemini/your-model-id \
  "Reply exactly with: COMETAPI_GEMINI_OK"

Sorun giderme

OpenCode bir CometAPI modelini göstermiyor

Yapılandırmanın geçerli JSON olduğunu doğrulayın. Her özel giriş üst düzey provider nesnesinin içinde, her model ID’si ise eşleşen models nesnesinin içinde olmalıdır. OpenCode’u yeniden başlatın, ardından /models öğesini tekrar açın.

OpenCode bir API anahtarı veya kimlik doğrulama hatası bildiriyor

COMETAPI_KEY değerinin OpenCode’u başlatan kabukta ayarlandığını doğrulayın. Ayarlanmamış bir {env:COMETAPI_KEY} başvurusu boş bir değer olur. Yeni bir kabuk profili değiştirdikten sonra yeni bir kabuk açın.

Bir model ID'si kullanılamıyor

Şuradaki CometAPI Models sayfasını kontrol edin, ardından model ID’sini seçili sağlayıcı girişinde değiştirin. Modelin söz konusu sağlayıcının API biçimini kabul ettiğini doğrulayın.

İstekler yanlış bir yol kullanıyor

Chat Completions, Responses ve Messages için baseURL değerini /v1 olarak tutun. Gemini için /v1beta kullanın. baseURL içine bir işlem yolu eklemeyin.

Bir sağlayıcı çalışıyor ancak başka bir sağlayıcı başarısız oluyor

Seçili sağlayıcının API biçimini kabul eden bir model ID’si kullanın. Bir model ID’sinin dört biçimin tümünü kabul ettiğini varsaymayın.

Proje yapılandırması genel bir sağlayıcıyı değiştiriyor

OpenCode, genel ve proje yapılandırmalarını birleştirir. Proje sağlayıcısının ID’sini yeniden adlandırın veya genel sağlayıcı girişinin değişmeden kalmasını istediğinizde çakışan değerlerini kaldırın.

OpenCode beklenenden daha fazla erişime sahip

OpenCode, onu başlatan işlemin izinlerini kullanır. OpenCode’u daha güçlü erişim sınırlarına ihtiyaç duyduğunuzda bir container veya sandbox içinde çalıştırın.

Genel Bakış

AI kodlama ajanları

AI ajanları

AI sohbet istemcileri

Çeviri ve dil

Otomasyon platformları

Gözlemlenebilirlik ve değerlendirme

AI framework'leri

Ön koşullar

API biçimlerini anlayın

Çalışma zamanı izinlerini anlayın

OpenCode’u yapılandırma

Sorun giderme

İlgili kaynaklar

​Ön koşullar

​API biçimlerini anlayın

​Çalışma zamanı izinlerini anlayın

​OpenCode’u yapılandırma

​Sorun giderme

​İlgili kaynaklar

Ön koşullar

API biçimlerini anlayın

Çalışma zamanı izinlerini anlayın

OpenCode’u yapılandırma

Sorun giderme

İlgili kaynaklar