Ana içeriğe atla

​
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 300+‘dan fazla modele erişim için LemonData API’sini kullanacak şekilde yapılandırılabilir.

​
Kurulum

curl -fsSL https://opencode.ai/install | bash
Kurulumu doğrulayın: 
opencode --version

​
Yapılandırma

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

export OPENAI_API_KEY="sk-your-lemondata-key"
Kalıcı yapılandırma için, ~/.bashrc veya ~/.zshrc dosyanıza ekleyin: 
echo 'export OPENAI_API_KEY="sk-your-lemondata-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. LemonData 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": {
    "lemondata": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LemonData",
      "options": {
        "baseURL": "https://api.lemondata.cc/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5-mini": {
          "name": "GPT-5 Mini"
        }
      }
    }
  },
  "model": "lemondata/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 lemondata/gpt-5.4 "Fix the bugs in main.py"

​
Kullanılabilir Modeller

ModelEn Uygun Olduğu Alan
gpt-5.4Karmaşık görevler, kod mimarisi
gpt-5-miniHızlı düzeltmeler, basit sorgular
claude-sonnet-4-6Kod inceleme, dokümantasyon
claude-opus-4-6Karmaşık muhakeme
gemini-2.5-flashHızlı yanıtlar
deepseek-r1Algoritma 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

KomutAçıklama
/helpKullanılabilir komutları göster
/model <name>Farklı bir modele geç
/clearKonuşma geçmişini temizle
/exitOpenCode’dan çık

​
Sorun Giderme

  • options.baseURL değerinin https://api.lemondata.cc/v1 olarak ayarlandığını doğrulayın
  • Ağ bağlantısını kontrol edin
  • Test etmek için curl https://api.lemondata.cc/v1/models komutunu deneyin
  • 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 LemonData dashboard’unda aktif olduğundan emin olun
  • Yapılandırmadaki model adının tam olarak eşleştiğini kontrol edin
  • Modelin kullanılabilirliğini lemondata.cc/en/models adresinde doğrulayın

​
En İyi Uygulamalar

Kod tabanınızı daha iyi anlaması için OpenCode’u proje kök dizininizden çalıştırın.
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.
Projenize değişiklik uygulamadan önce AI tarafından üretilen kodu her zaman inceleyin.