Tek endpoint · Tüm modeller · Otomatik fallback

Bixcod AI Gateway'i
her yerde kullan.

Bixcod AI Gateway; Claude, GPT, Kimi, GLM ve daha fazlasını tek bir OpenAI-uyumlu adres arkasında toplayan akıllı bir AI router. Cursor, Claude Code, VS Code ya da kendi kodun — hepsini aynı adrese bağla, gerisini gateway halletsin.

API Adresi (Base URL)
https://aiserver.bixcod.dev/v1
Aynı ağdaysan yerel: http://localhost:20128/v1 · /v1 soneki zorunlu.
API Anahtarı
BIXCOD_API_KEY
Kendi anahtarını panelden al.
01 — Temel

Üç şeyi bilmen yeterli

Hangi aracı kullanırsan kullan, gateway'e bağlanmak her zaman aynı üç bilgiye dayanır.

🔗

Base URL

https://aiserver.bixcod.dev/v1 — tüm araçlarda “OpenAI uyumlu adres” alanına bunu yazarsın.

🔑

API Key

Bixcod erişim anahtarın. “OpenAI API Key” alanına bunu koyarsın; gerçek OpenAI anahtarı gerekmez.

🧠

Model adı

Örn. Claude Opus 4.8, Kimi K2.7 Code, GPT 5.5 High. Tam liste aşağıda.

En hızlı test: aşağıdaki curl'ü çalıştır. Cevap gelirse bağlantın hazır demektir.

terminalbash
curl https://aiserver.bixcod.dev/v1/chat/completions \
  -H "Authorization: Bearer $BIXCOD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Claude Opus 4.8",
    "messages": [{"role": "user", "content": "Merhaba!"}]
  }'
02 — Editörler

Editör & araç rehberleri

Sekmeni seç, adımları takip et. Her araçta mantık aynı: “OpenAI Compatible” sağlayıcı seç, Base URL + API Key + model adını gir.

Cursor
Claude Code
Cline (VS Code)
Continue
Roo / Kilo
Codex

Cursor Chat panelini gateway'e bağla

  1. Ayarları aç
    Cursor → Settings (⌘ + ,) → Models.
  2. Base URL'i değiştir
    “Override OpenAI Base URL” seçeneğini aç ve şunu gir: https://aiserver.bixcod.dev/v1
  3. API Key gir
    “OpenAI API Key” alanına Bixcod anahtarını yaz.
  4. Model ekle
    Cursor otomatik keşif yapmaz — “Models” altına elle ekle: Claude Opus 4.8, Kimi K2.7 Code.
  5. Test et
    Chat panelini aç (⌘ + L) ve bir mesaj yaz.
⚠️

Özel Base URL yalnızca Chat panelini besler. Composer, satır-içi düzenleme (⌘K) ve otomatik tamamlama Cursor'un kendi altyapısını kullanmaya devam eder.

💡

Cursor ayarları uygulamanın kapalı veritabanında tutulur; bu yüzden dosyaya yazılamaz, adımları arayüzden elle uygularsın.

Claude Code'u gateway üzerinden çalıştır

İki ortam değişkeni yeterli — Claude Code'un tüm istekleri gateway'den geçer:

~/.zshrcbash
export ANTHROPIC_BASE_URL="https://aiserver.bixcod.dev"
export ANTHROPIC_AUTH_TOKEN="$BIXCOD_API_KEY"

# ardından normal başlat
claude

Tek seferlik denemek için de aynı satırları terminale yapıştırıp claude yazman yeterli.

Kalıcı ayar + model keşfi

Ayarları ~/.claude/settings.json'a yazarsan her oturumda geçerli olur. auto/best-coding ile gateway senin için en iyi kodlama modelini seçer:

~/.claude/settings.jsonjson
{
  "model": "auto/best-coding",
  "env": {
    "ANTHROPIC_BASE_URL": "https://aiserver.bixcod.dev",
    "ANTHROPIC_AUTH_TOKEN": "BIXCOD_API_KEY",
    "ANTHROPIC_MODEL": "auto/best-coding",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}
💡

CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY açıkken Claude Code gateway'deki tüm modelleri otomatik keşfeder; ANTHROPIC_AUTH_TOKEN yerine kendi Bixcod anahtarını yaz.

Cline (VS Code eklentisi)

  1. API Provider
    Cline ayarları → API Provider → OpenAI Compatible.
  2. Base URL
    https://aiserver.bixcod.dev/v1
  3. API Key
    Bixcod anahtarın.
  4. Model ID
    Örn. Claude Opus 4.8 ya da Kimi K2.7 Code.
  5. Kaydet & kullan
    Cline panelinden bir görev ver, istekler gateway'den akar.

Continue — config.yaml

Continue yapılandırma dosyasına gateway'i OpenAI sağlayıcısı olarak ekle:

~/.continue/config.yamlyaml
models:
  - name: Claude Opus 4.8 (Bixcod)
    provider: openai
    model: Claude Opus 4.8
    apiBase: https://aiserver.bixcod.dev/v1
    apiKey: $BIXCOD_API_KEY
  - name: Kimi K2.7 Code (Bixcod)
    provider: openai
    model: Kimi K2.7 Code
    apiBase: https://aiserver.bixcod.dev/v1
    apiKey: $BIXCOD_API_KEY

Roo Code

  1. Provider
    Ayarlar → API Provider → OpenAI Compatible.
  2. Base URL
    https://aiserver.bixcod.dev/v1
  3. API Key + Model
    Bixcod anahtarın · Claude Opus 4.8

Kilo Code

  1. Provider
    Ayarlar → OpenAI Compatible.
  2. Base URL
    https://aiserver.bixcod.dev/v1
  3. API Key + Model
    Bixcod anahtarın · istediğin model adı.
🧩

Aynı “OpenAI Compatible” mantığı opencode, Aider ve OpenAI uyumlu diğer tüm istemciler için de geçerli: Base URL + API Key + model adı.

Codex CLI — config.toml

Gateway'i özel bir model sağlayıcısı olarak tanımla:

~/.codex/config.tomltoml
model = "Claude Opus 4.8"
model_provider = "bixcod"

[model_providers.bixcod]
name = "Bixcod AI Gateway"
base_url = "https://aiserver.bixcod.dev/v1"
env_key = "BIXCOD_API_KEY"

BIXCOD_API_KEY ortam değişkenini anahtarınla export et, sonra codex'i normal çalıştır.

03 — Kod

Kendi kodundan çağır

Gateway, OpenAI API'siyle bire bir uyumlu. Mevcut OpenAI SDK'nı kullan, sadece base_url ve api_key'i değiştir.

🐍 Python
Node.js
cURL
app.pypython
from openai import OpenAI

client = OpenAI(
    base_url="https://aiserver.bixcod.dev/v1",
    api_key="BIXCOD_API_KEY",   # Bixcod anahtarın
)

resp = client.chat.completions.create(
    model="Claude Opus 4.8",
    messages=[{"role": "user", "content": "Bir haiku yaz."}],
)
print(resp.choices[0].message.content)
app.mjsjavascript
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://aiserver.bixcod.dev/v1",
  apiKey: process.env.BIXCOD_API_KEY,
});

const r = await client.chat.completions.create({
  model: "Kimi K2.7 Code",
  messages: [{ role: "user", content: "quicksort yaz" }],
});
console.log(r.choices[0].message.content);
terminalbash
# Kullanılabilir modelleri listele
curl https://aiserver.bixcod.dev/v1/models \
  -H "Authorization: Bearer $BIXCOD_API_KEY"

# Sohbet (stream)
curl https://aiserver.bixcod.dev/v1/chat/completions \
  -H "Authorization: Bearer $BIXCOD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"GPT 5.5 High","stream":true,
       "messages":[{"role":"user","content":"Selam!"}]}'
04 — Katalog

Kullanılabilir modeller

Model adını olduğu gibi model alanına yaz. Güncel liste için /v1/models ucunu çağırabilirsin.

ModelAileNot
Claude Opus 4.8Claudeen güçlü
Claude Sonnet 5Claudedengeli
Claude 4.5 HaikuClaudehızlı
Claude Fable 5Claude
Kimi K2.7 CodeKimikod
Kimi K2.6 ThinkingKimimuhakeme
GPT 5.5 HighGPTyüksek çaba
GPT 5.5 MediumGPTdengeli
Composer 2.5Composerhızlı
Auto (Server Picks)Otomatikgateway seçer
🔀

Otomatik fallback: Bir sağlayıcı hata verirse ya da kotası dolarsa gateway isteği sessizce uygun bir alternatife yönlendirir. Sen tek bir model adı yazarsın, arkada dayanıklılık katmanı çalışır.

05 — SSS

Sık sorulanlar

Gerçek OpenAI / Anthropic anahtarı gerekiyor mu?
Hayır. İstemcilere yalnızca Bixcod anahtarını verirsin. Gerçek sağlayıcı anahtarları gateway sunucusunda saklıdır; istemciler onları hiç görmez.
“401 Unauthorized” alıyorum.
API anahtarın eksik ya da yanlış. İsteğe Authorization: Bearer <anahtar> başlığını eklediğinden ve anahtarın geçerli olduğundan emin ol. Yeni anahtarı panelden alabilirsin.
“404” ya da “model not found”.
İki numaralı sebep: (1) Base URL'in sonundaki /v1'i unutmuşsundur. (2) Model adını birebir yazmadın — Claude Opus 4.8 gibi katalogdaki adı aynen kullan.
Yerel ağ ile internet adresi arasındaki fark ne?
Aynı makinede/ağdaysan http://localhost:20128/v1 daha hızlıdır. Dışarıdan (farklı ağ, mobil, bulut) erişim için https://aiserver.bixcod.dev/v1 adresini kullan.
Cursor'da otomatik tamamlama neden gateway kullanmıyor?
Cursor'un özel Base URL ayarı yalnızca Chat panelini yönlendirir. Composer, ⌘K ve autocomplete Cursor'un kendi sunucularını kullanır; bu Cursor'un mimari kısıtı, gateway ile ilgili değil.
Bu servis nerede çalışıyor?
Bu rehber aisetup.bixcod.dev, API ise aiserver.bixcod.dev adresinde yayınlanıyor. İkisi de kalıcı servisler sayesinde cihaz yeniden başlasa bile otomatik ayağa kalkar.