OpenCode kurulum ve kullanımı

OpenCode, ajanssal kodlama aracı. Araç, terminal uygulaması, masaüstü uygulaması ve IDE eklentisi olarak mevcuttur.

AI-Corporate, geliştiriciler, yöneticiler ve diğer ileri kullanıcılar için OpenCode önerir. OpenCode bağımsız olarak dosyaları değiştirebilir ve görevleri yürütebilir. Bu nedenle önerilen değişiklikleri her zaman kontrol edin.

Daha fazla bilgi için OpenCode web sitesinde ve resmi OpenCode belgelerinde bulabilirsiniz: OpenCode-web sitesi ve resmi OpenCode belgeleri.

Kurulum

En kolay kurulum, OpenCode belgeleri tarafından önerildiği gibi ş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 için Homebrew ile:

brew install anomalyco/tap/opencode

Kodlama ile Bağlantı

OpenCode, özelleştirilmiş OpenAI-üyru providerlarını destekler. Proje klasöründe bir opencode.json dosyası oluşturun.

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

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-corporate-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-Corporate Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-corporate.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_CORPORATE_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-corporate-coderen/gpt-5.4-mini",
  "small_model": "ai-corporate-coderen/gpt-5.4-mini"
}

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

macOS ve Linux

export AI_CORPORATE_CODEREN_API_KEY="aic.jouw-api-sleutel"

Windows

setx AI_CORPORATE_CODEREN_API_KEY "aic.jouw-api-sleutel"

Ardından yeni bir terminal açın.

OpenCode başlatma

Projeye gidin:

cd pad/naar/je/project

OpenCode’i başlatın:

opencode

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

OpenCode ile güvenli çalışma

OpenCode ajanssal çalıştığı için değişiklikleri kontrol etmek önemlidir.

Önerilen çalışma biçimi:

1. Bir git deposunda çalışın.
2. Küçük görevlerle başlayın.
3. Koddaki diffleri kullanmadan önce kontrol edin.
4. Değişikliklerden sonra uygulamayı test edin.
5. Anlayacağınız değişiklikleri yalnızca commit edin.

Ortam Değişkenleri ve OpenCode

OpenCode için Coderen API anahtarını proje klasöründeki yerel bir .env dosyasına kaydedebilirsiniz:

AI_SCHOOL_CODEREN_API_KEY=ais.jouw-api-sleutel

OpenCode’nin bu ortam değişkenini gerçekten yüklediğinden emin olun. PowerShell’de değişkeni mevcut terminal için geçici olarak da ayarlayabilirsiniz:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.jouw-api-sleutel"

Authorization header with Bearer token is required mesajı görürseniz, araç anahtarı Authorization: Bearer ... olarak göndermemektedir. Unknown parameter görürseniz, AI-Corporate’ın Coderen uç noktasını desteklemeyen sağlayıcı özel ayarlarını kaldırın.