مخصوص توسعه‌دهندگان

هوش مصنوعی آی‌کار در VS Code، Cursor و Claude Code

با یک کلید API، بیش از صد مدل (Claude، GPT، Gemini، DeepSeek، Grok، Kimi و …) را بدون تحریم در ابزار برنامه‌نویسی خودتان داشته باشید. پاسخ‌ها کلمه‌به‌کلمه (استریم واقعی) می‌رسند و حالت agent با فراخوانی ابزار کامل کار می‌کند.

Base URL سازگار با OpenAI (Cline، Cursor، Continue، Aider)
https://api.ai-kar.com/v1
Base URL سازگار با Anthropic (Claude Code)
https://api.ai-kar.com

بدون /v1 — خود برنامه /v1/messages را اضافه می‌کند

۱

ساخت کلید API

وارد پنل کاربری شوید و در بخش توسعه‌دهندگان (API) یک کلید بسازید. کلید با ak_ شروع می‌شود؛ آن را جایی امن نگه دارید.
ورود به پنل و ساخت کلید
۲

انتخاب ابزار و مدل

ابزار خود را از فهرست زیر انتخاب کنید. شناسه‌ی مدل (مثلاً claude-sonnet-5-5) را از بخش «مدل‌های پیشنهادی» یا برگه‌ی مدل‌ها کپی کنید.
مدل‌های پیشنهادی
۳

تنظیم و شروع

آدرس سرور، کلید و نام مدل را دقیقاً مطابق راهنمای همان ابزار وارد کنید. هزینه‌ی هر درخواست از کیف پول کسر و در «گزارش مصرف» ثبت می‌شود.
مشاهده‌ی تنظیمات

Cline، Roo Code و Kilo Code (افزونه‌های VS Code)

هر سه افزونه تنظیمات یکسانی دارند.

۱. API Provider را روی OpenAI Compatible بگذارید

در تنظیمات افزونه (آیکن چرخ‌دنده)، ارائه‌دهنده را OpenAI Compatible انتخاب کنید و Base URL را https://api.ai-kar.com/v1 و API Key را کلید خودتان بگذارید.

۲. Model ID

شناسه‌ی مدل را دقیقاً وارد کنید (مثلاً claude-sonnet-5-5). فهرست مدل‌ها هم از همین آدرس خوانده می‌شود. در بخش Model Configuration، اندازه‌ی Context Window را مطابق مدل بگذارید (مثلاً ۲۰۰۰۰۰ برای Claude).

استریم روشن بماند

برخلاف راهنمای قدیمی، گزینه‌ی Enable streaming حالا باید روشن باشد: پاسخ کلمه‌به‌کلمه می‌رسد، فراخوانی ابزار در لحظه انجام می‌شود و دکمه‌ی توقف، هزینه‌ی ادامه‌ی پاسخ را هم متوقف می‌کند.

برای مدل‌های Claude: گزینه‌ی Anthropic هم هست

می‌توانید ارائه‌دهنده را Anthropic بگذارید، تیک Use custom base URL را بزنید و آدرس https://api.ai-kar.com را وارد کنید. در این حالت افکار مدل (thinking) و کش پرامپت عیناً حفظ می‌شوند.
Providers
OpenAI Compatible▾
https://api.ai-kar.com/v1
ak_xxxxxxxxxxxxxxxxxxxxxxxx
claude-sonnet-5-5▾
Enable streaming
200000

Match the model (e.g. 200K for Claude, 1M for DeepSeek V4).

Claude Code (ترمینال و افزونه‌ی VS Code)

از مسیر بومی Anthropic استفاده می‌کند: استریم، فراخوانی ابزار، افکار با امضا و شمارش توکن.

ساده‌ترین روش: فایل تنظیمات

محتوای روبه‌رو را در ~/.claude/settings.json بگذارید (در ویندوز %USERPROFILE%\.claude\settings.json) و claude را اجرا کنید. با دستور /status باید نشانی api.ai-kar.com را ببینید.

هر مدلی، نه فقط Claude

ANTHROPIC_MODEL می‌تواند هر مدل چت سایت باشد (مثلاً deepseek/deepseek-v4-pro یا gpt-6-1-sol)؛ تبدیل فرمت سمت سرور انجام می‌شود. کارهای پس‌زمینه (عنوان جلسه و …) با ANTHROPIC_DEFAULT_HAIKU_MODEL ارزان‌تر تمام می‌شوند. نام‌های پیش‌فرض خود Claude Code (مثل sonnet و opus) هم به جدیدترین مدل همان خانواده وصل می‌شوند.

افزونه‌ی Claude Code در VS Code

متغیرها را در تنظیمات VS Code در claudeCode.environmentVariables بگذارید (نمونه‌ی پایین).

اگر خطای ۴۰۰ دیدید

Claude Code قابلیت‌های آزمایشی می‌فرستد. اگر خطایی با نام context_management یا Extra inputs دیدید،CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 را هم به env اضافه کنید.
~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ai-kar.com",
    "ANTHROPIC_AUTH_TOKEN": "ak_xxxxxxxxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-1-flash"
  }
}
Terminal
# macOS / Linux  (add these lines to ~/.zshrc or ~/.bashrc to keep them)
export ANTHROPIC_BASE_URL=https://api.ai-kar.com
export ANTHROPIC_AUTH_TOKEN=ak_xxxxxxxxxxxxxxxxxxxxxxxx
export ANTHROPIC_MODEL=claude-sonnet-5-5
claude
PowerShell
# Windows PowerShell
$env:ANTHROPIC_BASE_URL = "https://api.ai-kar.com"
$env:ANTHROPIC_AUTH_TOKEN = "ak_xxxxxxxxxxxxxxxxxxxxxxxx"
$env:ANTHROPIC_MODEL = "claude-sonnet-5-5"
claude
VS Code settings.json
// VS Code → Preferences: Open User Settings (JSON)
"claudeCode.environmentVariables": [
  { "name": "ANTHROPIC_BASE_URL", "value": "https://api.ai-kar.com" },
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "ak_xxxxxxxxxxxxxxxxxxxxxxxx" },
  { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5-5" }
]
تست اتصال (curl)
curl https://api.ai-kar.com/v1/messages \
  -H "Authorization: Bearer ak_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5-5", "max_tokens": 50, "messages": [{"role": "user", "content": "سلام"}]}'

Cursor

۱. کلید و آدرس

از Settings → Models (یا Cursor Settings → Models → API Keys)، گزینه‌ی OpenAI API Key را روشن کنید و کلید را بگذارید. سپس Override OpenAI Base URL را روشن کنید و https://api.ai-kar.com/v1 را وارد کنید و Verify را بزنید.

۲. افزودن مدل

با + Add Custom Model شناسه‌ی مدل را دقیقاً بنویسید (مثلاً claude-sonnet-5-5) و تیک آن را روشن کنید. با تغییر Base URL، مدل‌های پیش‌فرض Cursor از فهرست برداشته می‌شوند؛ مدل‌ها را خودتان اضافه کنید.

محدودیت‌های خود Cursor

پنل چت با کلید شما کار می‌کند؛ ولی تکمیل خودکار Tab و بعضی قابلیت‌های داخلی Cursor همیشه با مدل‌های خود Cursor اجرا می‌شوند. استفاده از کلید شخصی ممکن است به پلن پولی Cursor نیاز داشته باشد. درخواست‌ها از سرورهای Cursor به آی‌کار می‌رسند.
Models
ak_xxxxxxxxxxxxxxxxxxxxxxxx
https://api.ai-kar.com/v1
claude-sonnet-5-5
claude-sonnet-5-5

Continue (VS Code و JetBrains)

فایل config.yaml

از آیکن چرخ‌دنده‌ی Continue، فایل config.yaml را باز کنید و مدل‌ها را مثل نمونه اضافه کنید.provider: openai با apiBase یعنی «سرور سازگار با OpenAI».

تکمیل خودکار

برای نقش autocomplete یک مدل سریع و ارزان (مثل deepseek-v4-1-flash) بگذارید؛ این نقش درخواست‌های زیادی می‌فرستد.
config.yaml
# ~/.continue/config.yaml  (VS Code & JetBrains)
name: AI-Kar
version: 1.0.0
schema: v1
models:
  - name: Claude Sonnet 5.5 (AI-Kar)
    provider: openai
    model: claude-sonnet-5-5
    apiBase: https://api.ai-kar.com/v1
    apiKey: ak_xxxxxxxxxxxxxxxxxxxxxxxx
    roles: [chat, edit, apply]
  - name: DeepSeek V4.1 Flash (AI-Kar)
    provider: openai
    model: deepseek-v4-1-flash
    apiBase: https://api.ai-kar.com/v1
    apiKey: ak_xxxxxxxxxxxxxxxxxxxxxxxx
    roles: [chat, autocomplete]

Aider (برنامه‌نویس جفتی در ترمینال)

پیشوند openai/

در Aider نام مدل با پیشوند openai/ می‌آید تا از آدرس OPENAI_API_BASE استفاده شود. در ویندوز به‌جای export از setx یا $env: استفاده کنید.
Terminal
pip install aider-install && aider-install

# macOS / Linux
export OPENAI_API_BASE=https://api.ai-kar.com/v1
export OPENAI_API_KEY=ak_xxxxxxxxxxxxxxxxxxxxxxxx

# the openai/ prefix = an OpenAI-compatible server
aider --model openai/claude-sonnet-5-5

مدل‌های پیشنهادی برای کدنویسی

claude-sonnet-5-5

بهترین انتخاب برای کدنویسی agent (Cline، Claude Code)؛ ابزارها را دقیق صدا می‌زند.

claude-opus-5-5

قوی‌ترین Claude برای کارهای سخت و معماری؛ گران‌تر.

gpt-6-1-sol

مدل پرچم‌دار GPT برای کد و استدلال.

deepseek/deepseek-v4-pro

context یک میلیون توکنی با قیمت مناسب؛ برای پروژه‌های بزرگ.

deepseek-v4-1-flash

بسیار ارزان و سریع؛ برای کارهای روزمره و تست.

kimi-k3

context یک میلیونی و قوی در کد.

grok-4-7

سریع با context بزرگ.

gemini-3.1-pro-openai

context دو میلیونی برای خواندن کل مخزن.

moonshotai/kimi-k2.7-code

مخصوص کدنویسی.

برای agentها (Cline، Claude Code) مدلی با context حداقل ۱۲۸K انتخاب کنید. فهرست کامل و شناسه‌ی همه‌ی مدل‌ها در برگه‌ی مدل‌ها و قیمت‌ها در تعرفه‌ها.

سؤال‌های رایج و رفع اشکال

خطای 401 می‌گیرم.+
کلید را دوباره کپی کنید (بدون فاصله). در Claude Code اگر ANTHROPIC_API_KEY گذاشته‌اید، یک بار باید تأییدش کنید؛ ANTHROPIC_AUTH_TOKEN بدون تأیید کار می‌کند.
خطای «موجودی کافی نیست» یا «رزرو شده است».+
پیش از هر درخواست هزینه‌ی تقریبی بررسی می‌شود؛ درخواست‌های هم‌زمان هم سهمی از موجودی را رزرو می‌کنند. کیف پول را شارژ کنید یا منتظر پایان درخواست‌های قبلی بمانید.
خطای 429 (اشباع).+
سرویس‌دهنده‌ی آن مدل موقتاً شلوغ است. چند ثانیه بعد دوباره امتحان کنید یا مدل دیگری انتخاب کنید. برای این خطا هزینه‌ای کسر نمی‌شود.
Model not found.+
شناسه‌ی مدل باید دقیقاً همان شناسه‌ی برگه‌ی مدل‌ها باشد (حروف کوچک، با خط تیره).
پیام «prompt is too long».+
تاریخچه‌ی گفتگو از context مدل بیشتر شده است. Cline و Claude Code خودشان خلاصه می‌کنند؛ وگرنه گفتگوی تازه شروع کنید یا مدلی با context بزرگ‌تر بردارید.
اگر وسط پاسخ توقف بزنم چه می‌شود؟+
تولید پاسخ در سرور هم متوقف می‌شود و فقط هزینه‌ی همان بخشی که تولید شده کسر می‌شود.