ตั้งค่า LLM API สำหรับ Cursor, Claude Code, Codex

ตั้งค่าไคลเอนต์แต่ละตัวอย่างถูกต้อง

เลือกไคลเอนต์ทางซ้ายเพื่อเปิดคู่มือแบบเต็ม ตัวอย่างด้านล่างใช้คีย์ API ปัจจุบันของคุณและ base URL จริงของระบบ

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 ควรใช้เส้นทางที่เข้ากันได้กับ OpenAI พร้อมคีย์ API แบบกำหนดเองและ base URL แบบกำหนดเอง

ค่าที่จำเป็น

ผู้ให้บริการ: OpenAI-compatible
คีย์ API: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
โมเดล: gpt-5.4
เส้นทาง: chat/completions
ข้อกำหนดแผน: ต้องมีแผน Cursor ที่รองรับ endpoint API แบบกำหนดเอง

ขั้นตอนที่แนะนำ

1เปิด Cursor Settings และไปที่ AI / Models / API Keys
2เปิดใช้งานตัวเลือกคีย์ OpenAI แบบกำหนดเองหรือผู้ให้บริการแบบกำหนดเองสำหรับบิลด์ของคุณ
3วางคีย์ API และ base URL ที่แสดงด้านล่าง
4เลือกโมเดลที่แนะนำหรือโมเดลที่ใช้งานอยู่ในขณะนี้

บล็อกพร้อมคัดลอก

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

โมเดลที่แนะนำ

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

หมายเหตุ

Cursor ใช้โฟลว์ที่เข้ากันได้กับ OpenAI ดังนั้น base URL ต้องมี `/v1`
หากโมเดลล้มเหลวใน Cursor ให้สลับไปโมเดล OpenAI ที่ใช้งานอยู่ตัวอื่น
หลังบันทึก ส่ง prompt สั้น ๆ เพื่อยืนยันว่า `chat/completions` ทำงาน

Anthropic-compatible messages root URL

Claude Code

Claude Code ควรตั้งค่าผ่านตัวแปรสภาพแวดล้อม Anthropic แต่ base URL ต้องอยู่ที่โดเมนราก

ติดตั้ง Claude Code

macOS / Linux / Windows (Node 18+): npm install -g @anthropic-ai/claude-code
หลังติดตั้ง รัน `claude` เพื่อตรวจสอบ ตั้งค่าอยู่ที่ `~/.claude/settings.json`
Linux / macOS: `~/.claude/settings.json`
Windows: `%USERPROFILE%\.claude\settings.json`

ค่าที่จำเป็น

คีย์ API: sk-YOUR_API_KEY
Base URL: https://api.xah.io
โมเดล: claude-opus-5
เส้นทาง: messages
Max tokens: 1024

หมายเหตุ

`ANTHROPIC_BASE_URL` ไม่ควรมี `/v1`
ควรใช้โมเดลที่รองรับเส้นทาง `messages`
หาก Claude Code ขอให้คุณอนุญาตก่อน ทำการเข้าสู่ระบบครั้งเดียวให้เสร็จแล้วเปิดใหม่ด้วย env vars เหล่านี้
คำขอที่ส่งผ่านเส้นทาง `messages` ต้องรวมช่อง `max_tokens`

เซสชัน shell ชั่วคราว

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

เซสชัน PowerShell ชั่วคราว

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

การตั้งค่าถาวร

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

โมเดลที่แนะนำ

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

ส่วนขยาย VS Code ส่วนใหญ่ทำงานดีที่สุดในโหมดที่เข้ากันได้กับ OpenAI พร้อม base URL แบบกำหนดเอง

ค่าที่จำเป็น

ผู้ให้บริการ: OpenAI-compatible
คีย์ API: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
โมเดล: claude-opus-5
เส้นทาง: messages or chat/completions
Max tokens: 1024

ดำเนินการต่อ

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, base URL `/v1` และคีย์ API ของคุณจาก Console

Roo Code

ใช้ผู้ให้บริการที่เข้ากันได้กับ OpenAI, base URL `/v1` และคีย์ API ของคุณจาก Console

Kilo Code

ใช้ผู้ให้บริการที่เข้ากันได้กับ OpenAI, base URL `/v1` และคีย์ API ของคุณจาก Console

โมเดลที่แนะนำ

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

หมายเหตุ

ใช้ผู้ให้บริการที่เข้ากันได้กับ OpenAI, base URL `/v1` และคีย์ API ของคุณจาก Console
Cursor ใช้โฟลว์ที่เข้ากันได้กับ OpenAI ดังนั้น base URL ต้องมี `/v1`
หลังบันทึก ส่ง prompt สั้น ๆ เพื่อยืนยันว่า `chat/completions` ทำงาน
คำขอที่ส่งผ่านเส้นทาง `messages` ต้องรวมช่อง `max_tokens`

OpenAI-compatible ~/.codex /v1

Codex CLI

ส่วนขยาย Codex สำหรับ VS Code รองรับ API ที่เข้ากันได้กับ OpenAI พร้อม base URL และคีย์ API แบบกำหนดเอง

ติดตั้ง Codex CLI

macOS / Linux / Windows (Node 18+): npm install -g @openai/codex
หลังติดตั้ง รัน `codex` เพื่อตรวจสอบ Codex อ่าน auth จาก `~/.codex/auth.json` และ config จาก `~/.codex/config.toml`
Config: `~/.codex/config.toml` (Windows: `%USERPROFILE%\.codex\config.toml`)
Auth: `~/.codex/auth.json` (Windows: `%USERPROFILE%\.codex\auth.json`)

ค่าที่จำเป็น

ผู้ให้บริการ: OpenAI-compatible
คีย์ API: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
โมเดล: gpt-5.4
เส้นทาง: chat/completions

ขั้นตอนที่แนะนำ

1ติดตั้งส่วนขยาย Codex จาก VS Code Marketplace
2เปิด VS Code Settings และค้นหาการกำหนดค่า Codex
3กรอกคีย์ API และ Base URL ในส่วนตั้งค่า Codex
4เลือกโมเดลจากรายการโมเดลที่ใช้งานอยู่

เนื้อหา `~/.codex/config.toml`

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

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

เนื้อหา `~/.codex/auth.json`

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

โมเดลที่แนะนำ

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

หมายเหตุ

Codex ใช้ endpoint ที่เข้ากันได้กับ OpenAI ดังนั้น Base URL ต้องมี /v1
หลังการกำหนดค่า โหลด VS Code ใหม่เพื่อใช้การเปลี่ยนแปลง
ทดสอบโดยเปิดไฟล์โค้ดและลองแชทกับ Codex

OpenAI-compatible ~/.factory /v1

Factory Droid

Factory Droid เป็นผู้ช่วย CLI ที่อนุญาตการกำหนดค่าโมเดลแบบกำหนดเองผ่านไฟล์ `settings.json`

ติดตั้ง Droid CLI

macOS / Linux: curl -fsSL https://app.factory.ai/cli | sh
Windows (PowerShell): iwr -useb https://app.factory.ai/cli/install.ps1 | iex
หลังติดตั้ง รัน `droid` เพื่อตรวจสอบ
Linux / macOS: `~/.factory/settings.json`
Windows: `%USERPROFILE%\.factory\settings.json`

ค่าที่จำเป็น

ผู้ให้บริการ: openai
คีย์ API: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
โมเดล: gpt-5.4
เส้นทาง: chat/completions

หมายเหตุ

แต่ละรายการใน `customModels` ต้องมี `id` ที่ไม่ซ้ำและ `index` ที่เพิ่มขึ้น (0, 1, 2...)
ตั้ง `provider` เป็น `openai` เพื่อให้ Droid ใช้โฟลว์ที่เข้ากันได้กับ OpenAI
คุณสามารถเพิ่มโมเดลได้โดยทำซ้ำออบเจกต์ภายในอาร์เรย์และเปลี่ยน `model` + `id`

เนื้อหา `~/.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"
        }
    ]
}

โมเดลที่แนะนำ

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 ไปยัง endpoint ของคุณและใช้คีย์ API เดียวกัน

ติดตั้ง OpenCode

ติดตั้งผ่าน npm: npm install -g opencode-ai
หลังติดตั้ง รัน `opencode` เพื่อตรวจสอบ ตั้งค่าอยู่ที่ `~/.config/opencode/opencode.json` (หรือ `.jsonc`)

เส้นทาง config

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

ค่าที่จำเป็น

คีย์ API: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
โมเดล: claude-opus-5
เส้นทาง: messages
Max tokens: 1024

บล็อกพร้อมคัดลอก

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

โมเดลที่แนะนำ

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

หมายเหตุ

OpenCode ควรชี้ไปยัง endpoint พร้อม `/v1`
ควรใช้โมเดล Claude ที่ใช้งานอยู่ หากเวิร์กโฟลว์ของคุณคาดหวังเครื่องมือแบบ Anthropic
หากคุณเปลี่ยนโมเดลที่อื่นใน config ให้คงค่า base URL และคีย์ API เดียวกัน
คำขอที่ส่งผ่านเส้นทาง `messages` ต้องรวมช่อง `max_tokens`

OpenAI-compatible openclaw.json /v1

OpenClaw

OpenClaw ใช้ผู้ให้บริการที่เข้ากันได้กับ OpenAI ผ่าน `openclaw.json` โดยมี alias ผู้ให้บริการ `ckey`

เส้นทาง config

รากโครงการ: `./openclaw.json`
Windows: `%USERPROFILE%\.openclaw\openclaw.json`
Linux / macOS: `~/.openclaw/openclaw.json`

ค่าที่จำเป็น

ผู้ให้บริการ: ckey / OpenAI-compatible
คีย์ API: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
โมเดล: ckey/gpt-5.4
เส้นทาง: chat/completions

บล็อกพร้อมคัดลอก

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

โมเดลที่แนะนำ

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

หมายเหตุ

OpenClaw ควรใช้ `baseUrl` พร้อม `/v1`
คง `api` เป็น `openai-completions` สำหรับโฟลว์ที่เข้ากันได้กับ OpenAI
คุณสามารถเพิ่มหรือลบโมเดลในรายการได้ แต่คง alias `ckey/` และค่าคีย์ API ให้สอดคล้องกับตัวอย่าง

ตั้งค่าไคลเอนต์แต่ละตัวอย่างถูกต้อง

ก่อนคุณตั้งค่า

กฎของ Base URL

Endpoints and commands

Text / hội thoại

Images

Audio

Video (task / async)

Embeddings / ranking / safety / search

Native provider routes

Cursor

ค่าที่จำเป็น

ขั้นตอนที่แนะนำ

บล็อกพร้อมคัดลอก

โมเดลที่แนะนำ

หมายเหตุ

Claude Code

ติดตั้ง Claude Code

ค่าที่จำเป็น

หมายเหตุ

เซสชัน shell ชั่วคราว

เซสชัน PowerShell ชั่วคราว

การตั้งค่าถาวร

โมเดลที่แนะนำ

ส่วนขยาย VS Code

ค่าที่จำเป็น

ดำเนินการต่อ

Cline

Roo Code

Kilo Code

โมเดลที่แนะนำ

หมายเหตุ

Codex CLI

ติดตั้ง Codex CLI

ค่าที่จำเป็น

ขั้นตอนที่แนะนำ

เนื้อหา `~/.codex/config.toml`

เนื้อหา `~/.codex/auth.json`

โมเดลที่แนะนำ

หมายเหตุ

Factory Droid

ติดตั้ง Droid CLI

ค่าที่จำเป็น

หมายเหตุ

เนื้อหา `~/.factory/settings.json`

โมเดลที่แนะนำ

OpenCode

ติดตั้ง OpenCode

เส้นทาง config

ค่าที่จำเป็น

บล็อกพร้อมคัดลอก

โมเดลที่แนะนำ

หมายเหตุ

OpenClaw

เส้นทาง config

ค่าที่จำเป็น

บล็อกพร้อมคัดลอก

โมเดลที่แนะนำ

หมายเหตุ