Cursor, Claude Code, Codex için LLM API Kurulumu

# pip install anthropic from anthropic import Anthropic client = Anthropic( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io", ) message = client.messages.create( model="claude-opus-5", max_tokens=1024, messages=[ {"role": "user", "content": "Write a fizzbuzz in Python."} ], ) print(message.content)

# pip install anthropic from anthropic import Anthropic client = Anthropic( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io", ) with client.messages.stream( model="claude-opus-5", max_tokens=1024, messages=[ {"role": "user", "content": "Tell me a short story."} ], ) as stream: for text in stream.text_stream: print(text, end="", flush=True) print()

# pip install openai from openai import OpenAI client = OpenAI( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io/v1", ) response = client.chat.completions.create( model="gpt-5.4", messages=[ {"role": "user", "content": "Hello from CKEY"} ], ) print(response.choices[0].message.content)

# pip install openai from openai import OpenAI client = OpenAI( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io/v1", ) stream = client.chat.completions.create( model="gpt-5.4", stream=True, messages=[ {"role": "user", "content": "Write a short poem."} ], ) for chunk in stream: delta = chunk.choices[0].delta.content or "" if delta: print(delta, end="", flush=True) print()

// npm install @anthropic-ai/sdk import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io", }); const message = await client.messages.create({ model: "claude-opus-5", max_tokens: 1024, messages: [{ role: "user", content: "Write a fizzbuzz in Python." }], }); console.log(message.content);

// npm install @anthropic-ai/sdk import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io", }); const stream = client.messages .stream({ model: "claude-opus-5", max_tokens: 1024, messages: [{ role: "user", content: "Tell me a short story." }], }) .on("text", (text) => { process.stdout.write(text); }); await stream.finalMessage(); process.stdout.write("\n");

// npm install openai import OpenAI from "openai"; const client = new OpenAI({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io/v1", }); const response = await client.chat.completions.create({ model: "gpt-5.4", messages: [{ role: "user", content: "Hello from CKEY" }], }); console.log(response.choices[0]?.message?.content);

// npm install openai import OpenAI from "openai"; const client = new OpenAI({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io/v1", }); const stream = await client.chat.completions.create({ model: "gpt-5.4", stream: true, messages: [{ role: "user", content: "Write a short poem." }], }); for await (const chunk of stream) { const delta = chunk.choices[0]?.delta?.content ?? ""; if (delta) { process.stdout.write(delta); } } process.stdout.write("\n");

curl https://api.xah.io/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: sk-YOUR_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model":"claude-opus-5", "max_tokens":1024, "messages":[ {"role":"user","content":"Write a fizzbuzz in Python."} ] }'

curl https://api.xah.io/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: sk-YOUR_API_KEY" \ -H "anthropic-version: 2023-06-01" \ --no-buffer \ -d '{ "model":"claude-opus-5", "max_tokens":1024, "stream":true, "messages":[ {"role":"user","content":"Tell me a short story."} ] }'

curl https://api.xah.io/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ -d '{ "model":"gpt-5.4", "messages":[ {"role":"user","content":"Hello from CKEY"} ] }'

curl https://api.xah.io/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ --no-buffer \ -d '{ "model":"gpt-5.4", "stream":true, "messages":[ {"role":"user","content":"Write a short poem."} ] }'

curl "https://api.xah.io/v1beta/models/gemini-2.5-flash-lite:generateContent" \ -H "Content-Type: application/json" \ -H "x-goog-api-key: sk-YOUR_API_KEY" \ -d '{ "contents":[ {"role":"user","parts":[{"text":"Write a fizzbuzz in Python."}]} ] }'

curl https://api.xah.io/api/chat \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ -d '{ "model":"glm-5.2", "stream":false, "messages":[ {"role":"user","content":"Hello from CKEY"} ] }'

curl https://api.xah.io/api/generate \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ -d '{ "model":"glm-5.2", "prompt":"Hello from CKEY", "stream":false }'

OpenAI-compatible chat/completions /v1

Cursor

Cursor, özel API anahtarı ve özel base URL ile OpenAI uyumlu modu kullanmalıdır.

Gerekli değerler

Sağlayıcı: OpenAI-compatible
API Anahtarı: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: deepseek-v4-flash-0731
Rota: chat/completions
Paket gereksinimi: Özel API endpoint'lerini destekleyen bir Cursor paketi gerektirir.

Önerilen adımlar

1Cursor Ayarları'nı açın ve AI / Models / API Keys bölümüne gidin.
2Cursor sürümünüz farklı bir ad kullanıyorsa özel OpenAI anahtarı veya özel sağlayıcı seçeneğini etkinleştirin.
3Aşağıda gösterilen API anahtarını ve Base URL'i yapıştırın.
4Önerilen modeli veya fiyat listesinde aktif olan başka bir modeli seçin.

Kopyalamaya hazır blok

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: deepseek-v4-flash-0731
Route: chat/completions

Denenmesi önerilen modeller

gpt-5.4
claude-opus-5
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-4.6

Notlar

Cursor OpenAI uyumlu akışı kullandığından Base URL `/v1` içermelidir.
Bir model Cursor içinde çalışmazsa aktif listedeki başka bir OpenAI uyumlu modele geçin.
Kaydettikten sonra `chat/completions` rotasının çalıştığını doğrulamak için kısa bir prompt gönderin.

Anthropic-compatible messages root URL

Claude Code

Claude Code, Anthropic ortam değişkenleriyle yapılandırılmalıdır ancak Base URL kök alan adında kalmalıdır.

Claude Code Kurulumu

macOS / Linux / Windows (Node 18+): npm install -g @anthropic-ai/claude-code
Kurulumdan sonra doğrulamak için `claude` komutunu çalıştırın. Ayarlar `~/.claude/settings.json` dosyasında saklanır.
Linux / macOS: `~/.claude/settings.json`
Windows: `%USERPROFILE%\\.claude\\settings.json`

Gerekli değerler

API Anahtarı: sk-YOUR_API_KEY
Base URL: https://api.xah.io
Model: claude-opus-5
Rota: messages
Max tokens: 1024

Notlar

`ANTHROPIC_BASE_URL` `/v1` içermemelidir.
`messages` rotasını destekleyen bir modeli tercih edin.
Claude Code sizden önce oturum açmanızı isterse, bu oturum açma akışını bir kez tamamlayın ve aşağıdaki ortam değişkenleriyle yeniden başlatın.
`messages` rotası üzerinden gönderilen istekler `max_tokens` alanını içermelidir.

Geçici terminal oturumu

export ANTHROPIC_BASE_URL="https://api.xah.io"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_API_KEY"
claude --bare

Geçici PowerShell oturumu

$env:ANTHROPIC_BASE_URL = "https://api.xah.io"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_API_KEY"
claude --bare

Kalıcı ayarlar

{
    "env": {
        "ANTHROPIC_BASE_URL": "https://api.xah.io",
        "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_API_KEY",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
    }
}

Denenmesi önerilen modeller

claude-opus-5
gpt-5.4
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-4.6

OpenAI-compatible VS Code /v1

VS Code Eklentileri

VS Code eklentilerinin çoğu özel base URL ile OpenAI uyumlu modda en iyi şekilde çalışır.

Gerekli değerler

Sağlayıcı: OpenAI-compatible
API Anahtarı: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: claude-opus-5
Rota: messages or chat/completions
Max tokens: 1024

Continue

name: CKEY API
version: 1.0.0
schema: v1
models:
  - name: claude-opus-5
    provider: anthropic
    model: claude-opus-5
    apiBase: https://api.xah.io/v1
    apiKey: sk-YOUR_API_KEY
    roles:
      - chat
      - edit
      - apply

Cline

OpenAI uyumlu sağlayıcıyı, `/v1` içeren Base URL'i ve Konsol'dan aldığınız API anahtarını kullanın.

Roo Code

OpenAI uyumlu sağlayıcıyı, `/v1` içeren Base URL'i ve Konsol'dan aldığınız API anahtarını kullanın.

Kilo Code

OpenAI uyumlu sağlayıcıyı, `/v1` içeren Base URL'i ve Konsol'dan aldığınız API anahtarını kullanın.

Denenmesi önerilen modeller

gpt-5.4
claude-opus-5
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-4.6

Notlar

OpenAI uyumlu sağlayıcıyı, `/v1` içeren Base URL'i ve Konsol'dan aldığınız API anahtarını kullanın.
Cursor OpenAI uyumlu akışı kullandığından Base URL `/v1` içermelidir.
Kaydettikten sonra `chat/completions` rotasının çalıştığını doğrulamak için kısa bir prompt gönderin.
`messages` rotası üzerinden gönderilen istekler `max_tokens` alanını içermelidir.

OpenAI-compatible ~/.codex /v1

Codex CLI

VS Code için Codex eklentisi, özel base URL ve API anahtarıyla OpenAI uyumlu API'yi destekler.

Codex CLI Kurulumu

macOS / Linux / Windows (Node 18+): npm install -g @openai/codex
Kurulumdan sonra doğrulamak için `codex` komutunu çalıştırın. Codex, kimlik doğrulamayı `~/.codex/auth.json` ve config'i `~/.codex/config.toml` dosyasından okur.
Config: `~/.codex/config.toml` (Windows: `%USERPROFILE%\\.codex\\config.toml`)
Auth: `~/.codex/auth.json` (Windows: `%USERPROFILE%\\.codex\\auth.json`)

Gerekli değerler

Sağlayıcı: OpenAI-compatible
API Anahtarı: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: deepseek-v4-flash-0731
Rota: chat/completions

Önerilen adımlar

1Codex eklentisini VS Code Marketplace'ten kurun.
2VS Code Ayarları'nı açın ve Codex yapılandırmasını arayın.
3Codex ayarlarına API Anahtarınızı ve Base URL'i girin.
4Aktif modeller listesinden bir model seçin.

`~/.codex/config.toml` içeriği

model = "deepseek-v4-flash-0731"
model_reasoning_effort = "high"
personality = "pragmatic"

openai_base_url = "https://api.xah.io/v1"

`~/.codex/auth.json` içeriği

{
    "auth_mode": "apikey",
    "OPENAI_API_KEY": "sk-YOUR_API_KEY"
}

Denenmesi önerilen modeller

gpt-5.4
claude-opus-5
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-4.6

Notlar

Codex OpenAI uyumlu endpoint kullandığından Base URL `/v1` içermelidir.
Yapılandırmadan sonra değişikliklerin uygulanması için VS Code'u yeniden yükleyin.
Bir kod dosyası açıp Codex ile sohbet etmeyi deneyerek test edin.

OpenAI-compatible ~/.factory /v1

Factory Droid

Factory Droid, `settings.json` dosyası üzerinden özel model yapılandırmasına izin veren bir CLI asistanıdır.

Droid CLI Kurulumu

macOS / Linux: curl -fsSL https://app.factory.ai/cli | sh
Windows (PowerShell): iwr -useb https://app.factory.ai/cli/install.ps1 | iex
Kurulumdan sonra doğrulamak için `droid` komutunu çalıştırın.
Linux / macOS: `~/.factory/settings.json`
Windows: `%USERPROFILE%\\.factory\\settings.json`

Gerekli değerler

Sağlayıcı: openai
API Anahtarı: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: deepseek-v4-flash-0731
Rota: chat/completions

Notlar

`customModels` içindeki her kayıt benzersiz bir `id` ve artan bir `index` (0, 1, 2...) gerektirir.
Droid'in OpenAI uyumlu akışı kullanması için `provider` alanını `openai` olarak ayarlayın.
Dizideki nesneyi çoğaltıp `model` + `id` değerlerini değiştirerek daha fazla model ekleyebilirsiniz.

`~/.factory/settings.json` içeriği

{
    "customModels": [
        {
            "model": "deepseek-v4-flash-0731",
            "id": "custom:ckey-0",
            "index": 0,
            "baseUrl": "https://api.xah.io/v1",
            "apiKey": "sk-YOUR_API_KEY",
            "displayName": "deepseek-v4-flash-0731",
            "maxOutputTokens": 131072,
            "noImageSupport": false,
            "provider": "openai"
        }
    ]
}

Denenmesi önerilen modeller

gpt-5.4
claude-opus-5
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-4.6

Anthropic-compatible JSONC /v1

OpenCode

OpenCode, Anthropic sağlayıcısını endpoint'inize yönlendirebilir ve aynı API anahtarını kullanabilir.

OpenCode Kurulumu

npm ile kurun: npm install -g opencode-ai
Kurulumdan sonra doğrulamak için `opencode` komutunu çalıştırın. Config `~/.config/opencode/opencode.json` (veya `.jsonc`) içindedir.

Config yolu

Windows: `%USERPROFILE%\\.config\\opencode\\opencode.json`
Linux / macOS: `~/.config/opencode/opencode.json`

Gerekli değerler

API Anahtarı: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: claude-opus-5
Rota: messages
Max tokens: 1024

Kopyalamaya hazır blok

{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "ckey": {
            "npm": "@ai-sdk/openai-compatible",
            "options": {
                "baseURL": "https://api.xah.io/v1",
                "apiKey": "sk-YOUR_API_KEY"
            },
            "models": {
                "claude-opus-5": {
                    "name": "claude-opus-5"
                },
                "gpt-5.4": {
                    "name": "gpt-5.4"
                },
                "deepseek-v4-flash": {
                    "name": "deepseek-v4-flash"
                },
                "gpt-5.5": {
                    "name": "gpt-5.5"
                },
                "claude-haiku-4.5": {
                    "name": "claude-haiku-4.5"
                },
                "claude-opus-4.6": {
                    "name": "claude-opus-4.6"
                }
            }
        }
    },
    "model": "ckey/claude-opus-5",
    "agent": {
        "explorer": {
            "description": "Fast explorer subagent for codebase exploration",
            "mode": "subagent",
            "model": "ckey/claude-opus-5"
        }
    }
}

Denenmesi önerilen modeller

claude-opus-5
gpt-5.4
deepseek-v4-flash
gpt-5.5
claude-haiku-4.5
claude-opus-4.6

Notlar

OpenCode, `/v1` içeren endpoint'i işaret etmelidir.
İş akışınız Anthropic tarzı araçlar bekliyorsa aktif bir Claude modelini tercih edin.
Config'in başka bir yerinde modeli değiştirirseniz Base URL ve API anahtarı değerlerini aynı tutun.
`messages` rotası üzerinden gönderilen istekler `max_tokens` alanını içermelidir.

OpenAI-compatible openclaw.json /v1

OpenClaw

OpenClaw, `openclaw.json` dosyasında `ckey` sağlayıcı takma adıyla OpenAI uyumlu bir sağlayıcı kullanabilir.

Config yolu

Proje kökü: `./openclaw.json`
Windows: `%USERPROFILE%\\.openclaw\\openclaw.json`
Linux / macOS: `~/.openclaw/openclaw.json`

Gerekli değerler

Sağlayıcı: ckey / OpenAI-compatible
API Anahtarı: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: ckey/gpt-5.4
Rota: chat/completions

Kopyalamaya hazır blok

{
    "agents": {
        "defaults": {
            "model": {
                "primary": "ckey/gpt-5.4"
            }
        }
    },
    "models": {
        "providers": {
            "ckey": {
                "baseUrl": "https://api.xah.io/v1",
                "apiKey": "sk-YOUR_API_KEY",
                "api": "openai-completions",
                "models": [
                    {
                        "id": "gpt-5.4",
                        "name": "gpt-5.4"
                    },
                    {
                        "id": "claude-opus-5",
                        "name": "claude-opus-5"
                    },
                    {
                        "id": "deepseek-v4-flash",
                        "name": "deepseek-v4-flash"
                    },
                    {
                        "id": "gpt-5.5",
                        "name": "gpt-5.5"
                    },
                    {
                        "id": "claude-haiku-4.5",
                        "name": "claude-haiku-4.5"
                    },
                    {
                        "id": "claude-opus-4.6",
                        "name": "claude-opus-4.6"
                    }
                ]
            }
        }
    }
}

Denenmesi önerilen modeller

ckey/gpt-5.4
ckey/claude-opus-5
ckey/deepseek-v4-flash
ckey/gpt-5.5
ckey/claude-haiku-4.5
ckey/claude-opus-4.6

Notlar

OpenClaw, `/v1` içeren `baseUrl` kullanmalıdır.
OpenAI uyumlu akışı izlemek için `api` değerini `openai-completions` olarak bırakın.
Listeden model ekleyip çıkarabilirsiniz, ancak `ckey/` takma adını ve API anahtarını örnekle aynı bırakın.

Her istemciyi doğru şekilde yapılandırın

Yapılandırmadan önce hazırlık

Base URL kuralları

SDK'lar

Anthropic API isteği

Anthropic API streaming

OpenAI uyumlu istek

OpenAI uyumlu streaming

Anthropic API isteği

Anthropic API streaming

OpenAI uyumlu istek

OpenAI uyumlu streaming

Anthropic API isteği

Anthropic API streaming

OpenAI uyumlu istek

OpenAI uyumlu streaming

Gemini (Google) isteği

Ollama isteği

Ollama Generate (/api/generate)

Yerel görseli base64 olarak gönderin

Görsel URL'si gönderin

Base URL

Model

API Anahtarı

Cursor

Gerekli değerler

Önerilen adımlar

Kopyalamaya hazır blok

Denenmesi önerilen modeller

Notlar

Claude Code

Claude Code Kurulumu

Gerekli değerler

Notlar

Geçici terminal oturumu

Geçici PowerShell oturumu

Kalıcı ayarlar

Denenmesi önerilen modeller

VS Code Eklentileri

Gerekli değerler

Continue

Cline

Roo Code

Kilo Code

Denenmesi önerilen modeller

Notlar

Codex CLI

Codex CLI Kurulumu

Gerekli değerler

Önerilen adımlar

`~/.codex/config.toml` içeriği

`~/.codex/auth.json` içeriği

Denenmesi önerilen modeller

Notlar

Factory Droid

Droid CLI Kurulumu

Gerekli değerler

Notlar

`~/.factory/settings.json` içeriği

Denenmesi önerilen modeller

OpenCode

OpenCode Kurulumu

Config yolu

Gerekli değerler

Kopyalamaya hazır blok

Denenmesi önerilen modeller

Notlar

OpenClaw

Config yolu

Gerekli değerler

Kopyalamaya hazır blok

Denenmesi önerilen modeller

Notlar