آموزش Claude Code با API سفارشی llmapi

به‌روزرسانی: 2026-10-06

Claude Code ایجنت برنامه‌نویسی Anthropic است که داخل ترمینال (و افزونه‌های VS Code و JetBrains) کد شما را می‌خواند، فایل‌ها را ویرایش می‌کند و دستور اجرا می‌کند. با llmapi می‌توانید Claude Code را به Gemini 3.8 Flash، Gemini 3.1 Pro، Claude Sonnet 4.6 و Claude Opus 4.6 وصل کنید؛ همه با یک کلید API.

راه‌اندازی با یک دستور

دستور زیر ابزارهای نصب‌شده روی سیستم را پیدا می‌کند و Claude Code را به llmapi وصل می‌کند. لازم نیست Node.js نصب داشته باشید؛ اگر نباشد، یک نسخهٔ خصوصی فقط برای همین راه‌اندازی دانلود می‌شود.

macOS و Linux:

curl -fsSL https://llmapi.cheap/install.sh | sh

Windows (PowerShell):

irm https://llmapi.cheap/install.ps1 | iex

اسکریپت کلید API را از شما می‌پرسد (کلیدها با sk-llm- شروع می‌شوند). در داشبورد همین دستور را با کلید خودتان آماده می‌بینید و فقط کافی است کپی کنید.

اگر فقط می‌خواهید Claude Code تنظیم شود (macOS/Linux):

curl -fsSL https://llmapi.cheap/install.sh | sh -s -- --only claude

این دستور چه چیزهایی را تغییر می‌دهد؟

فایل ~/.claude/settings.json: بلوک env با ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN اضافه می‌شود و مدل پیش‌فرض روی gemini-3.8-flash-high قرار می‌گیرد.
بلوک modelPicker: باعث می‌شود دستور /model همهٔ مدل‌های llmapi را با اسم نشان دهد.
متغیر ANTHROPIC_API_KEY (اگر در همین فایل باشد) حذف می‌شود، چون روی توکن llmapi اولویت می‌گیرد.
اگر VS Code نصب باشد، در settings.json آن مقدارهای claudeCode.environmentVariables و claudeCode.disableLoginPrompt تنظیم می‌شوند تا افزونهٔ Claude Code هم از llmapi استفاده کند.

بقیهٔ تنظیمات شما دست نمی‌خورد و از هر فایلی قبل از تغییر یک نسخهٔ پشتیبان با پسوند .llmapi-backup کنارش ساخته می‌شود.

راه‌اندازی دستی

اگر ترجیح می‌دهید خودتان فایل را ویرایش کنید، این را در ~/.claude/settings.json بگذارید (افزونه‌های VS Code و JetBrains هم از همین فایل استفاده می‌کنند) و Claude Code را دوباره باز کنید:

{
  "model": "gemini-3.8-flash-high",
  "env": {
    "ANTHROPIC_BASE_URL": "https://llmapi.cheap",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gemini-3.8-flash-high",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gemini-3.8-flash-high",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gemini-3.8-flash-high"
  },
  "modelPicker": {
    "replaceBuiltInOptions": true,
    "options": [
      { "model": "gemini-3.8-flash-high", "label": "Gemini 3.8 Flash (high)", "behavesAs": "claude-sonnet-4-6" },
      { "model": "gemini-3.1-pro-high", "label": "Gemini 3.1 Pro", "behavesAs": "claude-sonnet-4-6" },
      { "model": "claude-sonnet-4-6", "label": "Claude Sonnet 4.6", "behavesAs": "claude-sonnet-4-6" },
      { "model": "claude-opus-4-6", "label": "Claude Opus 4.6", "behavesAs": "claude-opus-4-6" }
    ]
  }
}

برای یک سشن موقت، بدون تغییر هیچ فایلی:

ANTHROPIC_BASE_URL=https://llmapi.cheap ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY claude

نکته: آدرس پایه برای Claude Code بدون /v1 است (https://llmapi.cheap)، چون Claude Code از پروتکل Anthropic Messages استفاده می‌کند.

تغییر مدل

داخل Claude Code دستور /model را بزنید. فهرستی که می‌بینید همان مدل‌های llmapi است:

مدل	شناسه	مناسب برای
Gemini 3.8 Flash (high)	`gemini-3.8-flash-high`	پیش‌فرض؛ بیشتر کارهای روزمره
Gemini 3.1 Pro	`gemini-3.1-pro-high`	مسائل سخت‌تر و استدلال طولانی
Claude Sonnet 4.6	`claude-sonnet-4-6`	کار ایجنتی دقیق با سبک Claude
Claude Opus 4.6	`claude-opus-4-6`	سخت‌ترین کارها

مدل‌های Claude فقط در پلن‌های پولی فعال‌اند و از سهمیهٔ جداگانهٔ «Claude & GPT-OSS» مصرف می‌کنند. می‌توانید هنگام اجرا هم مدل را مشخص کنید:

claude --model gemini-3.1-pro-high

مشکلات رایج

پیام تداخل احراز هویت (auth conflict): اگر قبلاً با حساب claude.ai وارد شده‌اید، یک بار داخل Claude Code دستور /logout را اجرا کنید.
خطای 401 یا «check the key»: کلید درست کپی نشده یا با sk-llm- شروع نمی‌شود. کلید را از داشبورد دوباره کپی کنید.
درخواست‌ها به Anthropic می‌روند نه llmapi: متغیر ANTHROPIC_API_KEY در shell شما (مثلاً در ~/.zshrc) ست شده و روی تنظیمات اولویت دارد. آن را حذف کنید و ترمینال را دوباره باز کنید.
آدرس پایهٔ اشتباه: https://llmapi.cheap/v1 برای Claude Code غلط است؛ از https://llmapi.cheap استفاده کنید.
مدل Claude کار نمی‌کند: در دورهٔ آزمایشی رایگان فقط مدل‌های Gemini فعال‌اند. در /model کنار این مدل‌ها «needs a paid plan» نوشته می‌شود.
خطای usage limit: به سقف بازهٔ پنج‌ساعته یا هفتگی رسیده‌اید. پیام خطا زمان شارژ دوباره را می‌گوید.

سؤالات متداول

آیا برای Claude Code به حساب Anthropic نیاز دارم؟

نه. فقط کلید llmapi لازم است. Claude Code درخواست‌ها را به https://llmapi.cheap می‌فرستد.

بعد از خرید پلن باید دوباره دستور را اجرا کنم؟

لازم نیست. اسکریپت همهٔ مدل‌ها را از اول در فهرست /model می‌گذارد و مدل‌های Claude بعد از خرید پلن خودبه‌خود باز می‌شوند. اجرای دوباره هم ضرری ندارد.

افزونهٔ Claude Code در VS Code و JetBrains هم کار می‌کند؟

بله. هر دو از ~/.claude/settings.json می‌خوانند و اسکریپت تنظیمات لازم VS Code را هم اضافه می‌کند.

چطور تنظیمات قبلی را برگردانم؟

فایل settings.json.llmapi-backup را جایگزین settings.json کنید.

شروع کنید

ثبت‌نام کنید، کلید API به‌طور خودکار ساخته می‌شود و یک ساعت آزمایش رایگان با ۲ میلیون کردیت روی همهٔ مدل‌های Gemini دارید. بعد فقط یک دستور:

curl -fsSL https://llmapi.cheap/install.sh | sh

برای مقایسهٔ پلن‌ها به بخش قیمت‌ها سر بزنید یا آموزش راه‌اندازی Claude Code با یک دستور را بخوانید.