آموزش راه‌اندازی Claude Code با یک دستور
Claude Code یکی از بهترین ایجنت‌های برنامه‌نویسی است: پروژه را می‌خواند، برنامه‌ریزی می‌کند، فایل‌ها را ویرایش می‌کند، تست‌ها را اجرا می‌کند و تا تمام شدن کار ادامه می‌دهد. اما راه‌اندازی آن با یک API غیر از Anthropic معمولاً یعنی ویرایش دستی settings.json، پیدا کردن متغیرهای درست و حدس زدن آدرس‌ها.
در llmapi این کار با یک دستور انجام می‌شود. در این مطلب از صفر تا اولین درخواست را با هم پیش می‌رویم.
Claude Code با llmapi چه فرقی دارد؟
خود Claude Code همان ابزار رسمی است؛ فقط درخواست‌هایش به‌جای Anthropic به https://llmapi.cheap می‌رود. نتیجه:
- با یک کلید به Gemini 3.8 Flash، Gemini 3.1 Pro، Claude Sonnet 4.6 و Claude Opus 4.6 دسترسی دارید.
- مدل پیش‌فرض Gemini 3.8 Flash (high) است که بزرگ‌ترین سهمیه را در همهٔ پلن‌ها دارد.
- هزینه ثابت و ماهانه است: از ۲ دلار در ماه، با پرداخت USDT.
قدم ۱: ثبت‌نام
به صفحهٔ ثبت‌نام بروید و با ایمیل و رمز عبور حساب بسازید. همان لحظه یک کلید API برایتان ساخته می‌شود؛ کلیدهای llmapi با sk-llm- شروع می‌شوند.
حساب جدید یک دورهٔ آزمایشی رایگان دارد: ۲ میلیون کردیت روی همهٔ مدل‌های Gemini، به مدت یک ساعت. این یک ساعت از اولین درخواست شروع می‌شود، نه از لحظهٔ ثبت‌نام؛ پس با خیال راحت اول همه چیز را راه بیندازید.
قدم ۲: اجرای دستور
ترمینال را باز کنید و یکی از این دو دستور را اجرا کنید.
macOS و Linux:
curl -fsSL https://llmapi.cheap/install.sh | sh
Windows (در PowerShell):
irm https://llmapi.cheap/install.ps1 | iex
در داشبورد همین دستور را با کلید خودتان آماده می‌بینید؛ اگر آن نسخه را کپی کنید، اسکریپت دیگر کلید را نمی‌پرسد.
به Node.js نیاز دارم؟
نه. اسکریپت اول بررسی می‌کند Node.js نسخهٔ ۱۸ یا بالاتر دارید یا نه. اگر نداشته باشید، یک نسخهٔ خصوصی از سایت رسمی Node.js دانلود می‌کند، checksum آن را بررسی می‌کند و فقط برای همین راه‌اندازی از آن استفاده می‌کند. چیزی روی سیستم نصب سراسری نمی‌شود و دسترسی admin هم لازم نیست.
اسکریپت چه کار می‌کند؟
- کلید شما را با یک درخواست به API بررسی می‌کند.
- ابزارهای برنامه‌نویسی نصب‌شده را پیدا می‌کند: Claude Code، Codex، Gemini CLI، OpenCode، Cline، Roo Code، Kilo Code، GitHub Copilot، اپ دسکتاپ Claude و بیش از ده ابزار دیگر.
- برای هر ابزار از شما تأیید می‌گیرد و فقط تنظیمات مربوط به llmapi را اضافه می‌کند.
- از هر فایلی قبل از تغییر، نسخهٔ پشتیبان با پسوند
.llmapi-backupمی‌سازد.
اگر فقط Claude Code را می‌خواهید (macOS/Linux):
curl -fsSL https://llmapi.cheap/install.sh | sh -s -- --only claude
قدم ۳: باز کردن Claude Code
Claude Code را ببندید و دوباره باز کنید:
claude
اگر قبلاً با حساب claude.ai وارد شده بودید و پیام تداخل احراز هویت دیدید، یک بار /logout را بزنید. حالا یک سؤال ساده بپرسید؛ جواب از Gemini 3.8 Flash می‌آید.
دقیقاً چه چیزی در Claude Code تغییر کرد؟
اسکریپت فایل ~/.claude/settings.json را ویرایش می‌کند:
ANTHROPIC_BASE_URLرویhttps://llmapi.cheapوANTHROPIC_AUTH_TOKENروی کلید شما.- مدل پیش‌فرض و مدل‌های داخلی Claude Code (برای sub-agentها و کارهای پس‌زمینه) روی Gemini 3.8 Flash.
- بلوک
modelPickerتا دستور/modelهمهٔ مدل‌های llmapi را با اسم نشان دهد.
اگر VS Code نصب باشد، افزونهٔ Claude Code هم تنظیم می‌شود. نسخهٔ دستی همین تنظیمات در راهنمای Claude Code آمده است.
انتخاب مدل با /model
داخل Claude Code بنویسید /model. فهرستی شبیه این می‌بینید:
| مدل | کی استفاده کنیم |
|---|---|
| Gemini 3.8 Flash (high) | پیش‌فرض؛ بیشتر کارهای روزمره |
| Gemini 3.1 Pro | باگ‌های سخت، طراحی و استدلال طولانی |
| Claude Sonnet 4.6 | کار ایجنتی دقیق با سبک Claude |
| Claude Opus 4.6 | سخت‌ترین مسائل، با صرفه‌جویی |
| Gemini 3.8 Flash (low) | ویرایش‌های ساده و سریع |
مدل‌های Claude و GPT-OSS فقط در پلن‌های پولی فعال‌اند و سهمیهٔ جداگانه و کوچک‌تری دارند. در دورهٔ آزمایشی کنار آن‌ها نوشته شده «needs a paid plan». بعد از خرید پلن، همین مدل‌ها بدون اجرای دوبارهٔ دستور فعال می‌شوند.
یک الگوی خوب: برنامه‌ریزی یک تغییر سخت با Claude یا Gemini 3.1 Pro، و پیاده‌سازی آن با Gemini 3.8 Flash.
مشکلات رایج
«that is not an llmapi key»: کلید کامل کپی نشده. کلیدها با sk-llm- شروع می‌شوند.
«the API answered 401»: کلید اشتباه یا حذف‌شده است. از داشبورد یک کلید تازه بگیرید.
درخواست‌ها هنوز به Anthropic می‌روند: احتمالاً ANTHROPIC_API_KEY در فایل‌هایی مثل ~/.zshrc یا ~/.bashrc ست شده و اولویت دارد. آن خط را حذف کنید و ترمینال جدید باز کنید.
«no terminal available»: اسکریپت جایی اجرا شده که نمی‌تواند سؤال بپرسد (مثلاً داخل CI). کلید را مستقیم بدهید:
curl -fsSL https://llmapi.cheap/install.sh | sh -s -- --key YOUR_API_KEY --yes
خطای usage limit: سهمیهٔ پنج‌ساعته یا هفتگی تمام شده. پیام خطا زمان شارژ دوباره را می‌گوید؛ اگر سهمیهٔ Claude تمام شده، با /model به Gemini بروید و ادامه دهید.
برگرداندن تنظیمات
اگر خواستید به حالت قبل برگردید، فایل ~/.claude/settings.json.llmapi-backup را جایگزین settings.json کنید.
جمع‌بندی
سه قدم: ثبت‌نام، یک دستور، باز کردن Claude Code. همین. حساب رایگان بسازید و دستور زیر را اجرا کنید:
curl -fsSL https://llmapi.cheap/install.sh | sh
برای انتخاب پلن مناسب بخش قیمت‌ها را ببینید و اگر می‌خواهید بدانید چرا Gemini 3.8 Flash پیش‌فرض است، این مطلب را بخوانید.
