ویژهٔ فارسی‌زبانانِ ساکن خارج از ایران. این سرویس در ایران ارائه نمی‌شود.

راهنماهای راه‌اندازی

فقط آدرس و کلید عوض می‌شود. کلیدتان را در کنسول بسازید و در نمونه‌های زیر جایگزین کنید.

Base URL: https://api-kervan.poly1.funدر نمونه‌ها به جای کلید sk-XXXXXXXXXXXXXXXX نوشته شده است. آن را با کلیدی که در کنسول ساخته‌اید جایگزین کنید.

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 عوض می‌شود.

Python · Anthropic SDK
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)
Node.js · OpenAI SDK
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
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 به آن نیازی ندارد.
  • تا وقتی با اعتبار آزمایشی کار می‌کنید، فقط مدل‌های آزمایشی در دسترس‌اند؛ با اولین شارژ همهٔ مدل‌ها فعال می‌شوند.