إعداد LLM API لـ Cursor وClaude Code وCodex

# 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-4.6", 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-4.6", 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-4.6", 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-4.6", 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-4.6", "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-4.6", "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":"qwen3.8-27b", "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":"qwen3.8-27b", "prompt":"Hello from CKEY", "stream":false }'

OpenAI-compatible chat/completions /v1

Cursor

يجب أن يستخدم Cursor المسار المتوافق مع OpenAI بمفتاح API مخصص وURL أساسي مخصص.

القيم المطلوبة

المزود: OpenAI-compatible
مفتاح API: sk-YOUR_API_KEY
URL الأساسي: https://api.xah.io/v1
النموذج: gpt-5.4
المسار: chat/completions
متطلب الخطة: يتطلب خطة Cursor تدعم نقاط النهاية المخصصة.

الخطوات الموصى بها

1افتح إعدادات Cursor وانتقل إلى AI / Models / API Keys.
2فعّل خيار مفتاح OpenAI المخصص أو المزود المخصص لإصدارك.
3الصق مفتاح API و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-v4-flash

ملاحظات

يستخدم Cursor مسار التوافق مع OpenAI، لذا يجب أن يتضمن URL الأساسي `/v1`.
إذا فشل نموذج داخل Cursor، بدّل إلى نموذج نشط آخر متوافق مع OpenAI.
بعد الحفظ، أرسل مطالبة قصيرة للتأكد من أن `chat/completions` يعمل.

Anthropic-compatible messages root URL

Claude Code

يجب إعداد Claude Code عبر متغيرات بيئة Anthropic، لكن يجب أن يبقى 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
URL الأساسي: https://api.xah.io
النموذج: claude-opus-4.6
المسار: messages
الحد الأقصى للرموز: 1024

ملاحظات

يجب ألا يتضمن `ANTHROPIC_BASE_URL` قيمة `/v1`.
فضّل نموذجًا يدعم مسار `messages`.
إذا طلب منك Claude Code التفويض أولاً، أكمل تسجيل الدخول مرة واحدة وأعد الإطلاق مع متغيرات البيئة هذه.
الطلبات المرسلة عبر مسار `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-4.6",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
    }
}

النماذج الموصى بها

claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
gpt-5.4
deepseek-v4-flash

OpenAI-compatible VS Code /v1

إضافات VS Code

تعمل معظم إضافات VS Code بشكل أفضل في وضع التوافق مع OpenAI مع URL أساسي مخصص.

القيم المطلوبة

المزود: OpenAI-compatible
مفتاح API: sk-YOUR_API_KEY
URL الأساسي: https://api.xah.io/v1
النموذج: claude-opus-4.6
المسار: messages or chat/completions
الحد الأقصى للرموز: 1024

متابعة

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

Cline

استخدم المزود المتوافق مع OpenAI، وURL الأساسي `/v1`، ومفتاح API الخاص بك من لوحة التحكم.

Roo Code

استخدم المزود المتوافق مع OpenAI، وURL الأساسي `/v1`، ومفتاح API الخاص بك من لوحة التحكم.

Kilo Code

استخدم المزود المتوافق مع OpenAI، وURL الأساسي `/v1`، ومفتاح API الخاص بك من لوحة التحكم.

النماذج الموصى بها

gpt-5.4
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-v4-flash

ملاحظات

استخدم المزود المتوافق مع OpenAI، وURL الأساسي `/v1`، ومفتاح API الخاص بك من لوحة التحكم.
يستخدم Cursor مسار التوافق مع OpenAI، لذا يجب أن يتضمن URL الأساسي `/v1`.
بعد الحفظ، أرسل مطالبة قصيرة للتأكد من أن `chat/completions` يعمل.
الطلبات المرسلة عبر مسار `messages` يجب أن تتضمن حقل `max_tokens`.

OpenAI-compatible ~/.codex /v1

Codex CLI

تدعم إضافة Codex لـ VS Code API متوافقًا مع OpenAI مع URL أساسي ومفتاح API مخصصين.

تثبيت Codex CLI

macOS / Linux / Windows (Node 18+): npm install -g @openai/codex
بعد التثبيت، نفّذ `codex` للتحقق. يقرأ Codex المصادقة من `~/.codex/auth.json` والإعداد من `~/.codex/config.toml`.
الإعداد: `~/.codex/config.toml` (Windows: `%USERPROFILE%\.codex\config.toml`)
المصادقة: `~/.codex/auth.json` (Windows: `%USERPROFILE%\.codex\auth.json`)

القيم المطلوبة

المزود: OpenAI-compatible
مفتاح API: sk-YOUR_API_KEY
URL الأساسي: https://api.xah.io/v1
النموذج: gpt-5.4
المسار: chat/completions

الخطوات الموصى بها

1ثبّت إضافة Codex من سوق VS Code Marketplace.
2افتح إعدادات VS Code وابحث عن إعداد Codex.
3أدخل مفتاح API و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-v4-flash

ملاحظات

يستخدم Codex نقاط نهاية متوافقة مع OpenAI، لذا يجب أن يتضمن 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
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-v4-flash

Anthropic-compatible JSONC /v1

OpenCode

يمكن لـ OpenCode توجيه مزود Anthropic إلى نقطة النهاية الخاصة بك واستخدام نفس مفتاح API.

تثبيت OpenCode

التثبيت عبر npm: npm install -g opencode-ai
بعد التثبيت، نفّذ `opencode` للتحقق. يقع الإعداد في `~/.config/opencode/opencode.json` (أو `.jsonc`).

مسار الإعداد

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

القيم المطلوبة

مفتاح API: sk-YOUR_API_KEY
URL الأساسي: https://api.xah.io/v1
النموذج: claude-opus-4.6
المسار: messages
الحد الأقصى للرموز: 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-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-sonnet-4.6": {
                    "name": "claude-sonnet-4.6"
                },
                "gpt-5.4": {
                    "name": "gpt-5.4"
                },
                "deepseek-v4-flash": {
                    "name": "deepseek-v4-flash"
                }
            }
        }
    },
    "model": "ckey/claude-opus-4.6",
    "agent": {
        "explorer": {
            "description": "Fast explorer subagent for codebase exploration",
            "mode": "subagent",
            "model": "ckey/claude-opus-4.6"
        }
    }
}

النماذج الموصى بها

claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
gpt-5.4
deepseek-v4-flash

ملاحظات

يجب أن يشير OpenCode إلى نقطة النهاية مع `/v1`.
فضّل نموذج Claude نشطًا إذا كان سير عملك يتوقع أدوات بأسلوب Anthropic.
إذا غيّرت النموذج في أي مكان آخر من الإعداد، أبقِ نفس قيم URL الأساسي ومفتاح API.
الطلبات المرسلة عبر مسار `messages` يجب أن تتضمن حقل `max_tokens`.

OpenAI-compatible openclaw.json /v1

OpenClaw

يمكن لـ OpenClaw استخدام مزود متوافق مع OpenAI عبر `openclaw.json` مع اسم مزود `ckey`.

مسار الإعداد

جذر المشروع: `./openclaw.json`
Windows: `%USERPROFILE%\.openclaw\openclaw.json`
Linux / macOS: `~/.openclaw/openclaw.json`

القيم المطلوبة

المزود: ckey / OpenAI-compatible
مفتاح API: sk-YOUR_API_KEY
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-v4-flash",
                        "name": "deepseek-v4-flash"
                    }
                ]
            }
        }
    }
}

النماذج الموصى بها

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-v4-flash

ملاحظات

يجب أن يستخدم OpenClaw `baseUrl` مع `/v1`.
أبقِ `api` على `openai-completions` لمسار التوافق مع OpenAI.
يمكنك إضافة أو إزالة نماذج من القائمة، لكن أبقِ اسم المزود `ckey/` وقيم مفتاح API مطابقة للعينة.

اعدد كل عميل بالطريقة الصحيحة

قبل الإعداد

قواعد URL الأساسي

SDKs

طلب Anthropic API

بث Anthropic API

طلب متوافق مع OpenAI

بث متوافق مع OpenAI

طلب Anthropic API

بث Anthropic API

طلب متوافق مع OpenAI

بث متوافق مع OpenAI

طلب Anthropic API

بث Anthropic API

طلب متوافق مع OpenAI

بث متوافق مع OpenAI

طلب Gemini (Google)

طلب Ollama

Ollama Generate (/api/generate)

إرسال صورة محلية بصيغة base64

إرسال رابط صورة

URL الأساسي

النموذج

مفتاح API

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

مسار الإعداد

القيم المطلوبة

كتلة جاهزة للنسخ

النماذج الموصى بها

ملاحظات

OpenClaw

مسار الإعداد

القيم المطلوبة

كتلة جاهزة للنسخ

النماذج الموصى بها

ملاحظات