راهنماهای راهاندازی
فقط آدرس و کلید عوض میشود. کلیدتان را در کنسول بسازید و در نمونههای زیر جایگزین کنید.
Claude Code
Claude Code CLI رسمی Anthropic و افزونهٔ VS Code با دو متغیر محیطی از طریق Kervan کار میکنند.
macOS / Linux
در ترمینال اجرا کنید، یا برای دائمی شدن به فایل ~/.zshrc یا ~/.bashrc اضافه کنید:
export ANTHROPIC_BASE_URL="https://api-kervan.poly1.fun" export ANTHROPIC_AUTH_TOKEN="sk-XXXXXXXXXXXXXXXX" claude
Windows (PowerShell)
برای نشست فعلی در PowerShell اجرا کنید:
$env:ANTHROPIC_BASE_URL = "https://api-kervan.poly1.fun" $env:ANTHROPIC_AUTH_TOKEN = "sk-XXXXXXXXXXXXXXXX" claude
settings.json
برای تنظیم دائمی، فایل ~/.claude/settings.json را ویرایش کنید:
// ~/.claude/settings.json { "env": { "ANTHROPIC_BASE_URL": "https://api-kervan.poly1.fun", "ANTHROPIC_AUTH_TOKEN": "sk-XXXXXXXXXXXXXXXX" } }
برای انتخاب مدل، در Claude Code از دستور /model استفاده کنید.
CC Switch
اگر CC Switch نصب باشد، دکمهٔ «انتقال به CC Switch» در کنسول ارائهدهنده را با یک کلیک اضافه میکند. لینک فقط در مرورگر خودتان ساخته میشود.
Codex
یک ارائهدهنده به فایل ~/.codex/config.toml اضافه کنید و کلیدتان را بهصورت متغیر محیطی بدهید:
# ~/.codex/config.toml model = "gpt-6-sol" model_provider = "kervan" [model_providers.kervan] name = "Kervan" base_url = "https://api-kervan.poly1.fun/v1" env_key = "KERVAN_API_KEY" wire_api = "responses"
کلید را در یک متغیر محیطی قرار دهید:
export KERVAN_API_KEY="sk-XXXXXXXXXXXXXXXX" codex
Cursor، Cline، OpenCode
تنظیمات ارائهدهندهٔ API را در ویرایشگرتان باز کنید و این مقادیر را وارد کنید:
Base URL: https://api-kervan.poly1.fun/v1 API key: sk-XXXXXXXXXXXXXXXX Model: claude-sonnet-5
Cursor: در Settings → Models، کلید را در فیلد OpenAI API Key و آدرس را در «Override OpenAI Base URL» وارد کنید.
Cline: «Anthropic» را بهعنوان API Provider انتخاب کنید و آدرس را در «Use custom base URL» وارد کنید (بدون /v1 در انتها).
OpenCode: در opencode.json یک ارائهدهندهٔ سفارشی تعریف کنید:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"kervan": {
"npm": "@ai-sdk/anthropic",
"name": "Kervan",
"options": { "baseURL": "https://api-kervan.poly1.fun/v1", "apiKey": "sk-XXXXXXXXXXXXXXXX" },
"models": { "claude-sonnet-5": {}, "claude-opus-5-5": {} }
}
}
}نمونههای SDK
SDKهای رسمی بدون تغییر کار میکنند؛ فقط base_url و api_key عوض میشود.
from anthropic import Anthropic client = Anthropic(base_url="https://api-kervan.poly1.fun", api_key="sk-XXXXXXXXXXXXXXXX") msg = client.messages.create( model="claude-opus-5-5", max_tokens=1024, messages=[{"role": "user", "content": "Merhaba"}], ) print(msg.content[0].text)
import OpenAI from "openai"; const client = new OpenAI({ baseURL: "https://api-kervan.poly1.fun/v1", apiKey: "sk-XXXXXXXXXXXXXXXX" }); const res = await client.responses.create({ model: "gpt-6-sol", input: "Merhaba" }); console.log(res.output_text);
curl https://api-kervan.poly1.fun/v1/messages \ -H "x-api-key: sk-XXXXXXXXXXXXXXXX" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{"model":"claude-sonnet-5","max_tokens":256,"messages":[{"role":"user","content":"Merhaba"}]}'
llms.txt
فایل خلاصهٔ راهاندازی که دستیارهای هوش مصنوعی میتوانند بخوانند: /llms.txt
این را در دستیارتان بچسبانید:
لطفاً kervan.com.tr/llms.txt را بخوانید و Claude Code را طوری پیکربندی کنید که با Kervan کار کند.
نکتههای مهم
- درخواستهای ناموفق هزینه ندارند.
- /v1/messages/count_tokens پشتیبانی نمیشود؛ Claude Code به آن نیازی ندارد.
- تا وقتی با اعتبار آزمایشی کار میکنید، فقط مدلهای آزمایشی در دسترساند؛ با اولین شارژ همهٔ مدلها فعال میشوند.