OpenCode yapılandırması

OpenCode GUI istemcisi OpenAI uyumlu chat/completions protokolünü kullanır. Özel bir sağlayıcıyı 4AICode'a yönlendirdikten sonra OpenCode'da gpt-6-astra, gpt-5.6-sol, gpt-5.5, gpt-5.4, gpt-5.4-mini ve gpt-5.3-codex gibi modelleri kullanabilirsiniz.

Önkoşullar

• 4AICode token: Panel → Token yönetiminde oluşturun. Biçim sk-4ai-...
• Provider ID: 4aicode
• Base URL: https://relay.4aicode.com/v1
• Varsayılan model: gpt-5.4
• Kod modeli: gpt-5.3-codex

GUI istemci yapılandırması

Sol alttaki dişli ayarları açın, Provider / Models yapılandırma sayfasına gidin ve OpenAI uyumlu veya Custom bir sağlayıcı ekleyin.

Arayüz alanlarını şöyle doldurun:

Kaydettikten sonra ana arayüze dönün ve alttaki model seçiciden şunu seçin:

4AICode / GPT-5.4

Ardından yeni bir sohbet oluşturup gönderin:

Hello

Normal yanıt verirse GUI yapılandırması tamamdır.

GUI'de gösterilen zaman aşımı hataları

Şuna benzer bir hata gördüğünüzde GUI'deki zaman aşımı alanlarını kontrol etmeye odaklanın:

Provider response headers timed out after 10000ms

Bu, OpenCode GUI'nin sağlayıcı yanıt başlıklarını beklerken zaman aşımına uğradığı anlamına gelir. Codex üst sağlayıcısından ilk yanıt parçası ara sıra 10 saniyeden uzun sürebilir; bu yüzden GUI gelişmiş ayarlarında zaman aşımı değerlerini artırın:

GUI sürümünüz zaman aşımı giriş alanları sunmuyorsa aşağıdaki opencode.json yöntemini kullanın.

Yapılandırma dosyası yöntemi

Zaman aşımı değerlerinin doğrudan girilemediği GUI sürümleri için uygundur. Oluşturun veya düzenleyin:

~/.config/opencode/opencode.json

Ekleyin:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "4aicode": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "4AICode",
      "options": {
        "baseURL": "https://relay.4aicode.com/v1",
        "apiKey": "sk-4ai-xxxxxxxxxxxxxxxx",
        "timeout": 600000,
        "chunkTimeout": 120000
      },
      "models": {
        "gpt-6-astra": {
          "name": "GPT-6 Astra"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol"
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.4-mini": {
          "name": "GPT-5.4 Mini"
        },
        "gpt-5.3-codex": {
          "name": "GPT-5.3 Codex"
        }
      }
    }
  },
  "model": "4aicode/gpt-5.4",
  "small_model": "4aicode/gpt-5.4-mini"
}

OpenCode GUI'yi yeniden başlattıktan sonra model seçicide 4AICode / GPT-5.4 seçin.

Kimlik bilgilerini etkileşimli ekleme

Proje dizininize girip OpenCode'u başlatın:

opencode

OpenCode içinde şunu çalıştırın:

/connect

İstemlere göre şunu seçin ve girin:

Provider: Other
Provider ID: 4aicode
API key: sk-4ai-xxxxxxxxxxxxxxxx

Ardından proje kök dizininde opencode.json oluşturun veya düzenleyin; yukarıdaki “Yapılandırma dosyası yöntemi” bölümündeki içeriği referans alın.

OpenCode'a dönüp çalıştırın:

/models

4AICode altından bir model seçin.

Ortam değişkeni yöntemi

Token'ı bir ortam değişkeninde saklayın. Bu, opencode.json'ı ekip arasında paylaşmak için uygundur.

export FOURAICODE_API_KEY="sk-4ai-xxxxxxxxxxxxxxxx"

opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "4aicode": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "4AICode",
      "options": {
        "baseURL": "https://relay.4aicode.com/v1",
        "apiKey": "{env:FOURAICODE_API_KEY}",
        "timeout": 600000,
        "chunkTimeout": 120000
      },
      "models": {
        "gpt-6-astra": {
          "name": "GPT-6 Astra"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol"
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.4-mini": {
          "name": "GPT-5.4 Mini"
        },
        "gpt-5.3-codex": {
          "name": "GPT-5.3 Codex"
        }
      }
    }
  },
  "model": "4aicode/gpt-5.4",
  "small_model": "4aicode/gpt-5.4-mini"
}

Genel yapılandırma yolları

Kullanıcı düzeyi yapılandırmayı buraya koyun:

~/.config/opencode/opencode.json

Proje düzeyi yapılandırmayı proje köküne koyun:

opencode.json

Proje düzeyi yapılandırma önceliklidir ve belirli bir kod deposu için sağlayıcı ve modeli sabitlemek için uygundur.

Kullanılabilir modeller

Model alanları için tam OpenCode biçimini kullanın; örneğin 4aicode/gpt-5.3-codex. Arayüzdeki görünen ad GPT-5.3 Codex olabilir.

SSS

Provider response headers timed out after 10000ms

Bu, OpenCode GUI'nin sağlayıcı yanıt başlıklarını beklerken zaman aşımına uğradığı anlamına gelir. Codex üst sağlayıcısından ilk yanıt parçası ara sıra 10 saniyeden uzun sürebilir. Yapılandırmada timeout ve chunkTimeout değerlerini artırın:

{
  "provider": {
    "4aicode": {
      "options": {
        "baseURL": "https://relay.4aicode.com/v1",
        "timeout": 600000,
        "chunkTimeout": 120000
      }
    }
  }
}

Ardından hızlı bağlantı testi için gpt-5.4-mini ile Hello gönderin. Bağlantıyı doğruladıktan sonra gpt-5.4 veya gpt-5.3-codex'e geri dönün.

401 Unauthorized

API anahtarı süresi dolmuş veya yanlış kopyalanmış. Panel → Token yönetiminde yeni bir token oluşturun, ardından /connect kimlik bilgilerini veya ortam değişkenini güncelleyin.

400 Model Not Supported

Tabloda listelenen birebir model ID'lerini kullanın. Yaygın seçimler 4aicode/gpt-5.4 ve 4aicode/gpt-5.3-codex'tir.

Yapılandırmadan sonra model listesi görünmüyor

Şu üç maddeyi kontrol edin:

• /connect içinde girilen Provider ID 4aicode
• opencode.json içindeki sağlayıcı anahtarı "4aicode"
• model tam biçimi kullanıyor; örneğin 4aicode/gpt-5.4

Referanslar

• OpenCode Providers
• OpenCode Config