استفاده رایگان از Claude Code
Claude Code یک عامل کدنویسی از Anthropic است. به یک Anthropic Messages API نیاز دارد. این راهنما نشان میدهد چگونه Claude Code را از طریق FreeLLMAPI به مدلهای رایگان وصل کنید. دو متغیر محیطی تنظیم میکنید. به کلید Anthropic نیاز ندارید.
کد، نام مدلها و برچسبهای زندهٔ کاتالوگ به زبان انگلیسی نمایش داده میشوند.
آنچه دریافت میکنید و آنچه دریافت نمیکنید
Claude Code هر درخواست را به یک API با قالب Anthropic میفرستد. FreeLLMAPI این قالب را روی /v1/messages میفهمد. هر درخواست را ترجمه میکند و به یک مدل رایگان میفرستد، برای مثال Gemini، GPT-OSS، Qwen یا GLM.
- آنچه دریافت میکنید: رابط Claude Code، ابزارهای آن، ویرایش فایلها و حلقه عامل، روی مدلهای رایگان.
- آنچه دریافت نمیکنید: مدلهای Claude از Anthropic. هیچ ارائهدهندهای مدلهای Claude را از طریق API رایگان نمیدهد. برای جزئیات، آیا API رایگان Claude وجود دارد؟ را بخوانید.
- هزینه: 0 دلار برای استنتاج. سطوح رایگان محدودیت نرخ دارند. وقتی یک محدودیت درخواستی را متوقف کند، FreeLLMAPI به ارائهدهنده بعدی میرود.
مرحله 1: نصب FreeLLMAPI
FreeLLMAPI متنباز است. در Docker روی رایانه شما اجرا میشود. کلیدهای ارائهدهندگان شما روی رایانه شما میمانند.
macOS یا Linux
curl -fsSL https://freellmapi.co/install.sh | bashداشبورد را در http://localhost:3001 باز کنید. حداقل دو کلید رایگان ارائهدهنده را در صفحه Keys اضافه کنید. Google AI Studio و Groq هر کدام در حدود یک دقیقه یک کلید رایگان میدهند. کلید یکپارچه خود را از همان صفحه کپی کنید.
مرحله 2: اتصال Claude Code
سریعترین روش دستور راهاندازی است. این دستور کاتالوگ زنده شما را میخواند، از ~/.claude/settings.json نسخه پشتیبان میگیرد و تنظیمات دروازه را اضافه میکند.
یک دستور
npx freellmapi setup-claude --url http://localhost:3001 --api-key <unified-key>برای راهاندازی دستی، دو متغیر محیطی تنظیم کنید و Claude Code را شروع کنید:
راهاندازی دستی (macOS یا Linux)
export ANTHROPIC_BASE_URL=http://localhost:3001
export ANTHROPIC_AUTH_TOKEN=<unified-key>
claudeراهاندازی دستی (Windows PowerShell)
$env:ANTHROPIC_BASE_URL="http://localhost:3001"
$env:ANTHROPIC_AUTH_TOKEN="<unified-key>"
claudeANTHROPIC_AUTH_TOKEN استفاده کنید. از ANTHROPIC_API_KEY استفاده نکنید. اگر ANTHROPIC_API_KEY تنظیم باشد، Claude Code یک اعتبار متناقض میبیند و شروع نمیشود.برای اطمینان از اینکه درخواستها به دروازه میروند، npx freellmapi doctor را اجرا کنید. هر پاسخ هم یک هدر X-Routed-Via دارد. این هدر ارائهدهنده و مدلی را نشان میدهد که پاسخ داده است.
مرحله 3: انتخاب مدلها برای کار عامل
Claude Code پرامپتهای بلند میفرستد. یک درخواست معمولی پرامپت سیستم بزرگ، تعریف ابزارها و محتوای فایلها را دارد. از مدلهایی با فراخوانی ابزار و پنجره زمینه بزرگ استفاده کنید. سطوح رایگان کوچک با توکن کم در دقیقه روی این درخواستها شکست میخورند.
در تب Keys, Anthropic، هر خانواده Claude (opus، sonnet، haiku) را به auto یا به یک مدل نگاشت کنید. با auto، مسیریاب برای هر درخواست یک مدل رایگان انتخاب میکند. جدول مدلهای رایگان با فراخوانی ابزار و حداقل 128K زمینه را از کاتالوگ امروز نشان میدهد.
| مدل | رایگان در | متن ورودی | محدودیتهای رایگان (بهترین پیشنهاد) | ابزارها | بینایی |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 درخواست در دقیقه 1 req/min per model | بله | خیر |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 درخواست در دقیقه 40 RPM | بله | بله |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | بله | بله |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | بله | خیر |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | بله | بله |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 درخواست در دقیقه 20 درخواست در روز 250,000 توکن در دقیقه ~3M | بله | بله |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | بله | بله |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 درخواست در دقیقه 50 درخواست در روز 50 req/day account-wide (1,000 after a $10 purchase) | بله | بله |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 درخواست در دقیقه 50 درخواست در روز Shared rate limit | بله | خیر |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 درخواست در دقیقه 250 درخواست در روز 70,000 توکن در دقیقه ~6M | بله | بله |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 درخواست در دقیقه 20 درخواست در روز 250,000 توکن در دقیقه ~3M | بله | بله |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | بله | بله |
نمایش 12 مدل رایگان مطابق از 109 مدل. مشاهده همه مدلها.
دادههای زنده از کاتالوگ FreeLLMAPI (نسخه 2026.11.19، بررسیشده در 2026-11-19). محدودیتهای رایگان اغلب تغییر میکنند. کاتالوگ هر روز بررسی میشود.
محدودیتهای نرخ و کمک جایگزینی
یک کار Claude Code میتواند 20 تا 100 درخواست بفرستد. یک سطح رایگان به تنهایی شما را سریع متوقف میکند. برای مثال، یک کلید رایگان Gemini Flash تعداد کمی درخواست در روز مجاز میکند. FreeLLMAPI شمارش سهمیه هر کلید را نگه میدارد. وقتی یک ارائهدهنده خطای 429 بفرستد، مسیریاب ارائهدهنده بعدی در گروه را امتحان میکند. جلسه Claude Code شما ادامه پیدا میکند.
- کلیدهای چهار ارائهدهنده یا بیشتر اضافه کنید. کلیدهای بیشتر، درخواستهای بیشتری در روز میدهند.
haikuرا به یک مدل کوچک و سریع نگاشت کنید. Claude Code آن را برای کارهای کوتاه پسزمینه استفاده میکند.- زمینه را کوچک نگه دارید. بین کارها از
/clearاستفاده کنید تا توکن کمتری بفرستید.
عیبیابی
| مشکل | علت | راهحل |
|---|---|---|
| Claude Code از شما ورود میخواهد | متغیرهای محیطی در این shell تنظیم نشدهاند | ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN را تنظیم کنید، سپس claude را دوباره اجرا کنید |
| «Conflicting credential» یا عدم شروع | ANTHROPIC_API_KEY تنظیم شده است | آن را با unset ANTHROPIC_API_KEY حذف کنید |
| خطای 429 روی هر درخواست | همه کلیدهای ارائهدهنده شما به حد خود رسیدهاند | کلیدهای ارائهدهندگان بیشتری را در صفحه Keys اضافه کنید |
| فراخوانی ابزار شکست میخورد یا عامل متوقف میشود | مدل از فراخوانی ابزار به خوبی پشتیبانی نمیکند | خانواده را به یک مدل از جدول بالا نگاشت کنید |
| درخواستها کند هستند | پرامپتهای بزرگ روی یک مدل رایگان کند | یک مدل سریع ثابت کنید، برای مثال یک مدل Groq یا Cerebras |
پرسشهای متداول
آیا استفاده از Claude Code رایگان است؟
برنامه Claude Code نصب آن رایگان است. برای کار کردن به یک API مدل نیاز دارد. با FreeLLMAPI از سطوح رایگان ارائهدهنده استفاده میکند، پس هزینه استنتاج صفر دلار است.
آیا مدلهای واقعی Claude را رایگان میگیرم؟
نه. Anthropic یک API رایگان Claude ارائه نمیدهد. Claude Code از طریق نقطه پایانی با قالب Anthropic روی مدلهای رایگان دیگر اجرا میشود، برای مثال Gemini، GPT-OSS، Qwen یا GLM.
چرا از ANTHROPIC_AUTH_TOKEN استفاده میکنیم و نه ANTHROPIC_API_KEY؟
Claude Code، ANTHROPIC_AUTH_TOKEN را به صورت Bearer token به دروازه شما میفرستد. اگر ANTHROPIC_API_KEY تنظیم باشد، Claude Code آن را یک اعتبار اولینطرف در نظر میگیرد و از شروع کار خودداری میکند.
کدام مدل رایگان برای Claude Code بهترین است؟
از مدلی با فراخوانی ابزار و پنجره زمینه 128K توکن یا بیشتر استفاده کنید. جدول این صفحه قویترین مدلهای رایگانی را نشان میدهد که امروز هر دو شرط را دارند.
آیا این روش روی Windows کار میکند؟
بله. دو متغیر را در PowerShell با $env:ANTHROPIC_BASE_URL و $env:ANTHROPIC_AUTH_TOKEN تنظیم کنید، سپس claude را اجرا کنید.
راهنماهای مرتبط
- آیا Claude API رایگان وجود دارد؟
- بهترین API مدلهای کدنویسی رایگان
- استفاده از Codex CLI با مدلهای رایگان
- Cline، Roo Code و Kilo Code با یک API رایگان
- محدودیت نرخ API رایگان LLM
منابع
- FreeLLMAPI docs: Anthropic and Claude clients (بررسیشده در 20 November 2026)
- FreeLLMAPI CLI generators (بررسیشده در 20 November 2026)
- Claude Code documentation: LLM gateway configuration (بررسیشده در 20 November 2026)