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

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/chat/completions \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "messages": [{"role": "user", "content": "Hello"}], "stream": false }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/completions \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "Hello", "max_tokens": 256 }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/messages \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \ -d '{ "model": "MODEL", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}] }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/images/generations \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "A red fox in snow", "n": 1, "size": "1024x1024" }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/images/generations \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "Turn the reference into a watercolor illustration", "image_url": "https://example.com/reference.png", "n": 1, "size": "1024x1024" }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/audio/speech \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "input": "Hello from CKEY", "voice": "alloy", "response_format": "mp3" }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/videos/generations \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "A gentle camera move across a mountain", "seconds": 8 } # Poll: GET https://api.xah.io/v1/videos/JOB_ID'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v2/video_generation \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "content": [{"type": "text", "text": "A gentle camera move across a mountain"}], "duration": 6, "ratio": "16:9" } # Poll: GET https://api.xah.io/v2/query/video_generation/JOB_ID # Cancel: DELETE https://api.xah.io/v2/video_generation/JOB_ID'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/embeddings \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "input": ["first text", "second text"] }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/rerank \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "query": "latest AI news", "documents": ["doc A", "doc B"], "top_n": 2 }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/moderations \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "input": "Text to classify" }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/search \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "query": "latest AI news", "max_results": 5 }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1beta/models/MODEL:generateContent \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "contents": [{"role": "user", "parts": [{"text": "Hello"}]}] }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/api/chat \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "messages": [{"role": "user", "content": "Hello"}], "stream": false }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/api/generate \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "Hello", "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: gpt-5.4
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: gpt-5.4
Route: chat/completions

Denenmesi önerilen modeller

gpt-5.4
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-4.1-flash-ckey

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
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-opus-5-5
claude-sonnet-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-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-4.1-flash-ckey

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: gpt-5.4
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 = "gpt-5.4"
model_reasoning_effort = "xhigh"
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-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-4.1-flash-ckey

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: gpt-5.4
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": "gpt-5.4",
            "id": "custom:ckey-0",
            "index": 0,
            "baseUrl": "https://api.xah.io/v1",
            "apiKey": "sk-YOUR_API_KEY",
            "displayName": "gpt-5.4",
            "maxOutputTokens": 131072,
            "noImageSupport": false,
            "provider": "openai"
        }
    ]
}

Denenmesi önerilen modeller

gpt-5.4
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-4.1-flash-ckey

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"
                },
                "claude-opus-4.6": {
                    "name": "claude-opus-4.6"
                },
                "claude-opus-4.7": {
                    "name": "claude-opus-4.7"
                },
                "claude-opus-4.8": {
                    "name": "claude-opus-4.8"
                },
                "claude-opus-5-5": {
                    "name": "claude-opus-5-5"
                },
                "claude-sonnet-4.6": {
                    "name": "claude-sonnet-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
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-opus-5-5
claude-sonnet-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-4.6",
                        "name": "claude-opus-4.6"
                    },
                    {
                        "id": "claude-opus-4.7",
                        "name": "claude-opus-4.7"
                    },
                    {
                        "id": "claude-opus-4.8",
                        "name": "claude-opus-4.8"
                    },
                    {
                        "id": "claude-sonnet-4.6",
                        "name": "claude-sonnet-4.6"
                    },
                    {
                        "id": "deepseek-4.1-flash-ckey",
                        "name": "deepseek-4.1-flash-ckey"
                    }
                ]
            }
        }
    }
}

Denenmesi önerilen modeller

ckey/gpt-5.4
ckey/claude-opus-4.6
ckey/claude-opus-4.7
ckey/claude-opus-4.8
ckey/claude-sonnet-4.6
ckey/deepseek-4.1-flash-ckey

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ı

Endpoints and commands

Text / hội thoại

Images

Audio

Video (task / async)

Embeddings / ranking / safety / search

Native provider routes

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