Kurulum rehberleri

Değişen tek şey adres ve anahtar. Anahtarını konsoldan oluştur, aşağıdaki örneklerde yerine koy.

Base URL: https://api-kervan.poly1.funÖrneklerde anahtar yerine sk-XXXXXXXXXXXXXXXX yazıyor. Konsoldan oluşturduğun anahtarla değiştir.

Claude Code

Anthropic'in resmi Claude Code CLI'ı ve VS Code eklentisi, iki ortam değişkeniyle Kervan üzerinden çalışır.

macOS / Linux

Terminalde çalıştır ya da kalıcı olması için ~/.zshrc veya ~/.bashrc dosyana ekle:

export ANTHROPIC_BASE_URL="https://api-kervan.poly1.fun"
export ANTHROPIC_AUTH_TOKEN="sk-XXXXXXXXXXXXXXXX"
claude

Windows (PowerShell)

Geçerli oturum için PowerShell'de çalıştır:

$env:ANTHROPIC_BASE_URL = "https://api-kervan.poly1.fun"
$env:ANTHROPIC_AUTH_TOKEN = "sk-XXXXXXXXXXXXXXXX"
claude

settings.json

Kalıcı ayar için ~/.claude/settings.json dosyasını düzenle:

// ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api-kervan.poly1.fun",
    "ANTHROPIC_AUTH_TOKEN": "sk-XXXXXXXXXXXXXXXX"
  }
}

Model seçmek için Claude Code içinde /model komutunu kullan.

CC Switch

CC Switch yüklüyse konsoldaki "CC Switch'e aktar" düğmesi sağlayıcıyı tek tıkla ekler. Bağlantı yalnızca senin tarayıcında oluşturulur.

Codex

~/.codex/config.toml dosyasına bir sağlayıcı ekle ve anahtarını ortam değişkeni olarak ver:

# ~/.codex/config.toml
model = "gpt-6-sol"
model_provider = "kervan"

[model_providers.kervan]
name = "Kervan"
base_url = "https://api-kervan.poly1.fun/v1"
env_key = "KERVAN_API_KEY"
wire_api = "responses"

Anahtarı ortam değişkenine koy:

export KERVAN_API_KEY="sk-XXXXXXXXXXXXXXXX"
codex

Cursor, Cline, OpenCode

Editörünün API sağlayıcı ayarlarını aç ve şu değerleri gir:

Base URL:  https://api-kervan.poly1.fun/v1
API key:   sk-XXXXXXXXXXXXXXXX
Model:     claude-sonnet-5

Cursor: Ayarlar → Models → OpenAI API Key alanına anahtarı yaz, "Override OpenAI Base URL" alanına adresi gir.

Cline: API Provider olarak "Anthropic" seç, "Use custom base URL" ile adresi gir (sonunda /v1 olmadan).

OpenCode: opencode.json içinde özel bir sağlayıcı tanımla:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "kervan": {
      "npm": "@ai-sdk/anthropic",
      "name": "Kervan",
      "options": { "baseURL": "https://api-kervan.poly1.fun/v1", "apiKey": "sk-XXXXXXXXXXXXXXXX" },
      "models": { "claude-sonnet-5": {}, "claude-opus-5-5": {} }
    }
  }
}

SDK örnekleri

Resmi SDK'lar değişmeden çalışır; yalnızca base_url ve api_key değişir.

Python · Anthropic SDK

from anthropic import Anthropic

client = Anthropic(base_url="https://api-kervan.poly1.fun", api_key="sk-XXXXXXXXXXXXXXXX")
msg = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Merhaba"}],
)
print(msg.content[0].text)

Node.js · OpenAI SDK

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api-kervan.poly1.fun/v1", apiKey: "sk-XXXXXXXXXXXXXXXX" });
const res = await client.responses.create({ model: "gpt-6-sol", input: "Merhaba" });
console.log(res.output_text);

cURL

curl https://api-kervan.poly1.fun/v1/messages \
  -H "x-api-key: sk-XXXXXXXXXXXXXXXX" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":256,"messages":[{"role":"user","content":"Merhaba"}]}'

llms.txt

Yapay zekâ asistanlarının okuyabileceği özet kurulum dosyası: /llms.txt

Asistanına şunu yapıştır:

kervan.com.tr/llms.txt adresini oku ve Claude Code'u Kervan ile çalışacak şekilde yapılandır.

Önemli notlar

Başarısız istekler ücretlendirilmez.
/v1/messages/count_tokens desteklenmez; Claude Code bunu gerektirmez.
Deneme kredisindeyken yalnızca deneme modelleri açıktır; ilk yüklemeyle tüm modeller açılır.