OpenCode

Genel Bakış

Tür: Kodlama aracıBirincil yol: OpenAI ile uyumluDestek seviyesi: Desteklenen yol

OpenCode, terminalinizde çalışan açık kaynaklı bir AI kodlama asistanıdır. Birden fazla LLM sağlayıcısını destekler ve yüzlerce modele erişim için TokenLab API’sini kullanacak şekilde yapılandırılabilir.

Kurulum

Kurulum Script'i
Homebrew
Go

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

brew install opencode-ai/tap/opencode

Veya topluluk tap’ini kullanın (daha sık güncellemeler):

brew install anomalyco/tap/opencode

go install github.com/opencode-ai/opencode@latest

Kurulumu doğrulayın:

opencode --version

Yapılandırma

Adım 1: Environment Variable’ları Ayarlayın

export OPENAI_API_KEY="sk-your-tokenlab-key"

Kalıcı yapılandırma için, ~/.bashrc veya ~/.zshrc dosyanıza ekleyin:

echo 'export OPENAI_API_KEY="sk-your-tokenlab-key"' >> ~/.zshrc
source ~/.zshrc

Adım 2: OpenCode’u Yapılandırın

OpenCode’un mevcut dokümantasyonu, sağlayıcıların opencode.json veya opencode.jsonc üzerinden yapılandırılmasını önerir. TokenLab için, yerleşik openai sağlayıcısını aşırı yüklemek yerine özel bir sağlayıcı kullanı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:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5-mini": {
          "name": "GPT-5 Mini"
        }
      }
    }
  },
  "model": "tokenlab/gpt-5.4"
}

Sohbet tamamlama tarzı uyumluluk için @ai-sdk/openai-compatible kullanın. Özellikle /v1/responses üzerine kurulu bir sağlayıcı yoluna ihtiyacınız varsa, OpenCode’un sağlayıcı dokümantasyonu paketi @ai-sdk/openai olarak değiştirmenizi önerir.

Temel Kullanım

Etkileşimli modu başlatın:

opencode

Bir prompt ile çalıştırın:

opencode "Explain this codebase"

Model belirtin:

opencode --model tokenlab/gpt-5.4 "Fix the bugs in main.py"

Kullanılabilir Modeller

Model	En Uygun Olduğu Alan
`gpt-5.4`	Karmaşık görevler, kod mimarisi
`gpt-5-mini`	Hızlı düzeltmeler, basit sorgular
`claude-sonnet-4-6`	Kod inceleme, dokümantasyon
`claude-opus-4-6`	Karmaşık muhakeme
`gemini-3.5-flash`	Hızlı yanıtlar
`deepseek-r1`	Algoritma tasarımı

Yaygın Komutlar

Kodu analiz edin:

opencode "What does this function do?" < src/utils.ts

Kod üretin:

opencode "Create a REST API with Express"

Değişiklikleri inceleyin:

git diff | opencode "Review these changes"

Hataları düzeltin:

opencode "Fix the TypeScript errors in this project"

Etkileşimli Komutlar

Komut	Açıklama
`/help`	Kullanılabilir komutları göster
`/model <name>`	Farklı bir modele geç
`/clear`	Konuşma geçmişini temizle
`/exit`	OpenCode’dan çık

Sorun Giderme

Bağlantı Hatası

options.baseURL değerinin https://api.tokenlab.sh/v1 olarak ayarlandığını doğrulayın
Ağ bağlantısını kontrol edin
Test etmek için curl https://api.tokenlab.sh/v1/models komutunu deneyin

Kimlik Doğrulama Başarısız Oldu

OPENAI_API_KEY environment variable’ının ayarlandığını doğrulayın
options.apiKey değerinin {env:OPENAI_API_KEY} veya başka bir geçerli secret kaynağına başvurduğunu doğrulayın
Anahtarın sk- ile başladığını kontrol edin
Anahtarın TokenLab dashboard’unda aktif olduğundan emin olun

Model Bulunamadı

Yapılandırmadaki model adının tam olarak eşleştiğini kontrol edin
Modelin kullanılabilirliğini tokenlab.sh/en/models adresinde doğrulayın

En İyi Uygulamalar

Proje bağlamını kullanın

Kod tabanınızı daha iyi anlaması için OpenCode’u proje kök dizininizden çalıştırın.

Uygun modelleri seçin

Basit görevler için daha hızlı modelleri (gpt-5-mini), karmaşık görevler için ise daha güçlü modelleri (gpt-5.4, claude-sonnet-4-6) kullanın.

Üretilen kodu inceleyin

Projenize değişiklik uygulamadan önce AI tarafından üretilen kodu her zaman inceleyin.

Uyumluluk matrisi

Kodlama araçları

Native SDK'lar

Framework'ler ve platformlar

Sohbet uygulamaları

Genel Bakış

Kurulum

Yapılandırma

Adım 1: Environment Variable’ları Ayarlayın

Adım 2: OpenCode’u Yapılandırın

Temel Kullanım

Kullanılabilir Modeller

Yaygın Komutlar

Etkileşimli Komutlar

Sorun Giderme

En İyi Uygulamalar

​Genel Bakış

​Kurulum

​Yapılandırma

​Adım 1: Environment Variable’ları Ayarlayın

​Adım 2: OpenCode’u Yapılandırın

​Temel Kullanım

​Kullanılabilir Modeller

​Yaygın Komutlar

​Etkileşimli Komutlar

​Sorun Giderme

​En İyi Uygulamalar

Genel Bakış

Kurulum

Yapılandırma

Adım 1: Environment Variable’ları Ayarlayın

Adım 2: OpenCode’u Yapılandırın

Temel Kullanım

Kullanılabilir Modeller

Yaygın Komutlar

Etkileşimli Komutlar

Sorun Giderme

En İyi Uygulamalar