OpenCode'i kurun ve kullanın

OpenCode, ajan tabanlı bir kodlama aracıdır. Araç terminal uygulaması, masaüstü uygulama ve IDE eklentisi olarak mevcuttur.

AI-School, OpenCode'u özellikle çok deneyime sahip öğretmenler, yöneticiler ve öğrenciler için tavsiye eder. OpenCode, Aider'den daha bağımsız çalışabilir ve bu sayede birçok değişikliği daha hızlı gerçekleştirebilir.

Daha fazla bilgi için OpenCode web sitesinde ve resmi OpenCode belgelerinde bulunabilir.

Ne zaman OpenCode kullanmalısınız?

Kullanıcı olarak OpenCode'u seçin:

• terminal, kod düzenleyiciler ve git konusunda deneyim sahibi
• yerel dosyaların nasıl değiştirildiğini anlar
• değişiklikleri kullanmadan önce denetleyebilir
• daha karmaşık programlama görevlerini geliştirmek ister

Başlangıç düzeyinde programlama için sınıf ortamında genelde Aider daha uygundur.

Kurulum

OpenCode için en basit kurulum OpenCode belgelerine göre şu şekildedir:

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

Ayrıca Node.js ile OpenCode kurabilirsiniz:

npm install -g opencode-ai

Veya macOS ve Linux'ta Homebrew ile:

brew install anomalyco/tap/opencode

Coderen ile Bağlantı

OpenCode, özelleştirilmiş OpenAI uyumlu sağlayıcıları destekler. Proje klasörü içinde bir opencode.json dosyası oluşturun.

Bu dosyada Coderen uç noktasını ve izin verilen modelleri kullanın:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-school-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-School Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_SCHOOL_CODEREN_API_KEY}"
      },
      "models": {
        "gpt-5.4-mini": {
          "name": "GPT-5.4 mini"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  },
  "model": "ai-school-coderen/gpt-5.4-mini",
  "small_model": "ai-school-coderen/gpt-5.4-mini"
}

Daha sonra API anahtarını ortam değişkeni olarak ayarlayın.

Bunun için proje klasöründe bir .env dosyası da kullanabilirsiniz:

AI_SCHOOL_CODEREN_API_KEY=ais.sizin-api-anahtarınız

Yeni bir terminal açıp OpenCode'in bu değişkeni okuyabildiğini kontrol edin. OpenCode anahtar göndermiyorsa, AI-School Yetkilendirme header'ın Bearer token ile zorunlu olduğunu hata mesajı olarak verir.

macOS ve Linux

export AI_SCHOOL_CODEREN_API_KEY="ais.sizin-api-anahtarınız"

Windows

setx AI_SCHOOL_CODEREN_API_KEY "ais.sizin-api-anahtarınız"

Sonra yeni bir terminal açın.

OpenCode'i başlatma

Projeye gidin:

cd yol/nerede/oldugunuz/proje

OpenCode'i başlatın:

opencode

OpenCode içinde AI-School Coderen modelini seçmek için model seçimini kullanın; bu otomatik olarak yapılmıyorsa.

Sorunları çözme

Bearer token ile Authorization header zorunludur

Bu bildirim genellikle OpenCode'in API anahtarını göndermediğini gösterir. Aşağıdakileri kontrol edin:

• AI_SCHOOL_CODEREN_API_KEY tam olarak bu şekilde adlandırılmış mı
• değerin ais. ile başlayıp başlamadığı
• setx sonrası yeni bir terminal açıp açmadığınız
• OpenCode'i başlattığınız proje klasöründe .env dosyasının bulunduğu

Unknown parameter

Bazı araçlar ek sağlayıcıya özgü ek parametreler gönderir. Unknown parameter gibi bir ileti alırsanız, bu ayarı OpenCode yapılandırmasından kaldırın veya daha basit bir sağlayıcı yapılandırması kullanın. Coderen uç noktası, model, mesajlar ve temel ayarlarla OpenAI-uyumlu sohbet isteklerini bekler.

OpenCode ile Güvenli çalışma

OpenCode ajan tabanlı çalıştığından değişiklikleri kontrol etmek önemlidir.

Önerilen çalışma şekli:

1. Bir git deposunda çalışın.
2. Küçük görevlerle başlayın.
3. Kodu kullanmadan önce farkları kontrol edin.
4. Değişiklikleri test edin.
5. Sadece anladığınız değişiklikleri commit edin.

Düşük deneyime sahip öğrenciler için önce bir öğretmen gözetiminde OpenCode'u gösteri amaçlı kullanmak akıllıca olur.