Ana içeriğe atla

OpenCode'i kurun ve kullanın

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

AI-School, OpenCode’u özellikle çok programlama deneyimine sahip öğretmenler, yöneticiler ve öğrenciler için önerir. OpenCode, Aider’dan daha bağımsız çalışabilir ve bu nedenle daha hızlı çok sayıda değişiklik yapabilir.

Daha fazla information için OpenCode web sitesinde bulunabilir: OpenCode-websitesi ve resmi OpenCode belgelerinde.

Ne zaman OpenCode kullanırsınız?​

Kullanıcı için OpenCode 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 kontrol edebilir
  • daha karmaşık programlama görevlerini geliştirmek ister

Başlangıç seviyesindeki grup için, sınıf içi kodlama genellikle Aider için daha uygundur.

Kurulum​

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

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

OpenCode’u ayrıca Node.js ile de kurabilirsiniz:

npm install -g opencode-ai

Veya macOS ve Linux üzerinde Homebrew ile:

brew install anomalyco/tap/opencode

Kodlama ile Bağlantı​

OpenCode, OpenAI uyumlu özel sağlayıcıları destekler. Proje klasöründe bir dosya oluşturun: opencode.json.

İçindeki Kodlama 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.6-luna": {
          "name": "GPT-5.6 Luna"
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol"
        }
      }
    }
  },
  "model": "ai-school-coderen/gpt-5.6-luna",
  "small_model": "ai-school-coderen/gpt-5.6-luna"
}

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

Bunu proje klasöründe bir .env dosyası kullanarak da yapabilirsiniz:

AI_SCHOOL_CODEREN_API_KEY=ais.jouw-api-sleutel

Yeni bir terminal açtığınızda OpenCode’in bu değişkeni okuyabildiğini kontrol edin. OpenCode anahtar göndermiyorsa, AI-School yetkilendirme başlığı için Bearer token zorunlu olduğunu hatalı bir mesaj verir.

macOS ve Linux​

export AI_SCHOOL_CODEREN_API_KEY="ais.jouw-api-sleutel"

Windows​

setx AI_SCHOOL_CODEREN_API_KEY "ais.jouw-api-sleutel"

Sonra yeni bir terminal açın.

OpenCode'i başlatma​

Proje klasörüne gidin:

cd pad/naar/je/project

OpenCode’i başlatın:

opencode

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

Problemleri çözme​

Bearer token ile Authorization başlığı zorunludur​

Bu uyarı genellikle OpenCode’in API anahtarını göndermediği anlamına gelir. Kontrol edin:

  • AI_SCHOOL_CODEREN_API_KEY değerinin tam olarak bu şekilde yazılmış olması
  • değerin ais. ile başlaması
  • setx komutundan sonra yeni bir terminal açmış olmak
  • proje klasörünüzde OpenCode’i başlattığınız dizinde .env dosyasının bulunması

Unknown parameter​

Bazı araçlar ek sağlayıcıya özgü ek parametreler iletebilir. Böyle bir uyarı alırsanız, OpenCode yapılandırmasındaki bu ayarı kaldırın veya daha basit bir sağlayıcı yapılandırması kullanın. Kodlama uç noktası, model, mesajlar ve temel ayarlarla OpenAI uyumlu sohbet isteklerini bekler.

OpenCode ile güvenli çalışma​

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

Önerilen çalışma yöntemi:

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

Daha az deneyime sahip öğrenciler için, bir öğretmen gözetiminde önce OpenCode’u gösterişli bir şekilde kullanmak akıllıca olur.

WhatsApp