Cara setup API LLM untuk Cursor, Claude Code, Codex

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 sebaiknya menggunakan jalur kompatibel OpenAI dengan API key dan base URL khusus.

Informasi yang perlu diisi

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: gpt-5.4
Route: chat/completions
Persyaratan paket: Membutuhkan paket Cursor yang mendukung custom API endpoint.

Langkah yang disarankan

1Buka Cursor Settings lalu masuk ke area AI / Models / API Keys.
2Aktifkan opsi custom OpenAI key atau custom provider untuk build Cursor Anda.
3Tempel API key dan Base URL di bawah.
4Pilih model yang disarankan atau model aktif lainnya di daftar harga.

Blok konfigurasi contoh

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: gpt-5.4
Route: chat/completions

Model yang disarankan

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

Catatan

Cursor menggunakan alur kompatibel OpenAI, jadi Base URL harus mengandung `/v1`.
Jika suatu model gagal di Cursor, coba ganti ke model kompatibel OpenAI lain yang aktif.
Setelah disimpan, uji dengan prompt singkat untuk memastikan route `chat/completions` berfungsi.

Anthropic-compatible messages root URL

Claude Code

Claude Code sebaiknya dikonfigurasi melalui variabel lingkungan Anthropic, tetapi Base URL harus tetap root domain.

Instal Claude Code

macOS / Linux / Windows (Node 18+): npm install -g @anthropic-ai/claude-code
Setelah instalasi, jalankan `claude` untuk memastikan. Pengaturan disimpan di `~/.claude/settings.json`.
Linux / macOS: `~/.claude/settings.json`
Windows: `%USERPROFILE%\.claude\settings.json`

Informasi yang perlu diisi

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

Catatan

`ANTHROPIC_BASE_URL` tidak perlu menyertakan `/v1`.
Utamakan model yang mendukung route `messages`.
Jika Claude Code meminta Anda login dulu, selesaikan login sekali lalu buka lagi dengan env di bawah.
Request yang melalui route `messages` harus menyertakan kolom `max_tokens`.

Sesi terminal sementara

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

Sesi PowerShell sementara

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

Pengaturan permanen

{
    "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"
    }
}

Model yang disarankan

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

Ekstensi VS Code

Kebanyakan ekstensi VS Code paling stabil saat menggunakan mode kompatibel OpenAI dengan custom base URL.

Informasi yang perlu diisi

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: claude-opus-5
Route: 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

Gunakan provider kompatibel OpenAI, Base URL dengan `/v1`, dan API key dari Console.

Roo Code

Gunakan provider kompatibel OpenAI, Base URL dengan `/v1`, dan API key dari Console.

Kilo Code

Gunakan provider kompatibel OpenAI, Base URL dengan `/v1`, dan API key dari Console.

Model yang disarankan

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

Catatan

Gunakan provider kompatibel OpenAI, Base URL dengan `/v1`, dan API key dari Console.
Cursor menggunakan alur kompatibel OpenAI, jadi Base URL harus mengandung `/v1`.
Setelah disimpan, uji dengan prompt singkat untuk memastikan route `chat/completions` berfungsi.
Request yang melalui route `messages` harus menyertakan kolom `max_tokens`.

OpenAI-compatible ~/.codex /v1

Codex CLI

Ekstensi Codex untuk VS Code mendukung API kompatibel OpenAI dengan custom base URL dan API key.

Instal Codex CLI

macOS / Linux / Windows (Node 18+): npm install -g @openai/codex
Setelah instalasi, jalankan `codex` untuk memeriksa. Codex membaca auth dari `~/.codex/auth.json` dan config dari `~/.codex/config.toml`.
Config: `~/.codex/config.toml` (Windows: `%USERPROFILE%\.codex\config.toml`)
Auth: `~/.codex/auth.json` (Windows: `%USERPROFILE%\.codex\auth.json`)

Informasi yang perlu diisi

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: gpt-5.4
Route: chat/completions

Langkah yang disarankan

1Pasang ekstensi Codex dari VS Code Marketplace.
2Buka VS Code Settings dan cari bagian konfigurasi Codex.
3Isi API Key dan Base URL di bagian pengaturan Codex.
4Pilih model dari daftar model yang aktif.

Isi `~/.codex/config.toml`

model = "gpt-5.4"
model_reasoning_effort = "xhigh"
personality = "pragmatic"

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

Isi `~/.codex/auth.json`

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

Model yang disarankan

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

Catatan

Codex menggunakan endpoint kompatibel OpenAI, jadi Base URL harus mengandung /v1.
Setelah konfigurasi selesai, muat ulang VS Code agar perubahan diterapkan.
Uji dengan membuka file kode dan coba chat dengan Codex.

OpenAI-compatible ~/.factory /v1

Factory Droid

Factory Droid adalah asisten CLI yang memungkinkan konfigurasi model kustom melalui file `settings.json`.

Instal Droid CLI

macOS / Linux: curl -fsSL https://app.factory.ai/cli | sh
Windows (PowerShell): iwr -useb https://app.factory.ai/cli/install.ps1 | iex
Setelah instalasi, jalankan `droid` untuk memeriksa.
Linux / macOS: `~/.factory/settings.json`
Windows: `%USERPROFILE%\.factory\settings.json`

Informasi yang perlu diisi

Provider: openai
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: gpt-5.4
Route: chat/completions

Catatan

Setiap entry di `customModels` memerlukan `id` unik dan `index` yang terus naik (0, 1, 2...).
Atur `provider` ke `openai` agar Droid menggunakan alur kompatibel OpenAI.
Anda bisa menambah model dengan menggandakan object di dalam array dan mengganti `model` + `id`.

Isi `~/.factory/settings.json`

{
    "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"
        }
    ]
}

Model yang disarankan

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 dapat menunjuk provider Anthropic ke endpoint Anda untuk memakai API key yang sama.

Instal OpenCode

Instal melalui npm: npm install -g opencode-ai
Setelah instalasi, jalankan `opencode` untuk memeriksa. Config berada di `~/.config/opencode/opencode.json` (atau `.jsonc`).

Lokasi config

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

Informasi yang perlu diisi

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

Blok konfigurasi contoh

{
    "$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"
        }
    }
}

Model yang disarankan

claude-opus-5
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-opus-5-5
claude-sonnet-4.6

Catatan

OpenCode sebaiknya menunjuk ke endpoint dengan `/v1`.
Utamakan model Claude yang aktif jika workflow Anda menggunakan tooling gaya Anthropic.
Jika Anda mengganti model di tempat lain pada config, pertahankan nilai base URL dan API key seperti di bawah.
Request yang melalui route `messages` harus menyertakan kolom `max_tokens`.

OpenAI-compatible openclaw.json /v1

OpenClaw

OpenClaw dapat memakai provider kompatibel OpenAI melalui file `openclaw.json` dengan alias provider `ckey`.

Lokasi config

Project root: `./openclaw.json`
Windows: `%USERPROFILE%\.openclaw\openclaw.json`
Linux / macOS: `~/.openclaw/openclaw.json`

Informasi yang perlu diisi

Provider: ckey / OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: ckey/gpt-5.4
Route: chat/completions

Blok konfigurasi contoh

{
    "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"
                    }
                ]
            }
        }
    }
}

Model yang disarankan

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

Catatan

OpenClaw sebaiknya menggunakan `baseUrl` dengan `/v1`.
Pertahankan `api` sebagai `openai-completions` untuk mengikuti alur kompatibel OpenAI.
Anda dapat menambah atau mengurangi model dalam daftar, tetapi alias `ckey/` dan API key sebaiknya tetap sesuai contoh.

Konfigurasi klien sesuai alatnya

Persiapan sebelum konfigurasi

Aturan Base URL

Endpoints and commands

Text / hội thoại

Images

Audio

Video (task / async)

Embeddings / ranking / safety / search

Native provider routes

Cursor

Informasi yang perlu diisi

Langkah yang disarankan

Blok konfigurasi contoh

Model yang disarankan

Catatan

Claude Code

Instal Claude Code

Informasi yang perlu diisi

Catatan

Sesi terminal sementara

Sesi PowerShell sementara

Pengaturan permanen

Model yang disarankan

Ekstensi VS Code

Informasi yang perlu diisi

Continue

Cline

Roo Code

Kilo Code

Model yang disarankan

Catatan

Codex CLI

Instal Codex CLI

Informasi yang perlu diisi

Langkah yang disarankan

Isi `~/.codex/config.toml`

Isi `~/.codex/auth.json`

Model yang disarankan

Catatan

Factory Droid

Instal Droid CLI

Informasi yang perlu diisi

Catatan

Isi `~/.factory/settings.json`

Model yang disarankan

OpenCode

Instal OpenCode

Lokasi config

Informasi yang perlu diisi

Blok konfigurasi contoh

Model yang disarankan

Catatan

OpenClaw

Lokasi config

Informasi yang perlu diisi

Blok konfigurasi contoh

Model yang disarankan

Catatan