رله API Claude Code: با دو متغیر به آن وصل شوید
از 2026-11-04، منظور از رله API Claude Code این است که ANTHROPIC_BASE_URL در Claude Code را به یک نقطه پایانی سازگار با Anthropic از طرف شخص ثالث اشاره دهید و مدل‌های Claude را فراخوانی کنید که هزینه آنها با کلید API همان سرویس محاسبه میشود؛ در QCode این کار به دو متغیر محیطی خلاصه میشود: ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN.
به‌روزرسانی شده 2026-11-14
این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT و مدل‌های چینی.
- صورتحساب بهازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- بهصورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار نکته کلیدی
پروتکل و Base URL
مدل‌های Claude فقط از طریق Anthropic Messages API ارائه میشوند. مقدار مستندشده https://api.qcode.cc/api است؛ خود SDK مسیر /v1/messages را اضافه میکند، پس اسلش انتهایی نگذارید. سه دامنه دسترسی یکسان رفتار میکنند و مستندات برای چین سرزمین اصلی asia.qcode.cc را توصیه میکند.
کلید و محاسبه هزینه
کلید را در کنسول QCode می‌سازید و آن را بهعنوان ANTHROPIC_AUTH_TOKEN در هدر Bearer می‌فرستید. محاسبه هزینه بر اساس توکن است و نرخ هر مدل در /models فهرست شده است؛ مدل‌های Claude که در 2026-11-04 در /models عرضه می‌شدند شامل claude-sonnet-5-5، claude-opus-5-5 و claude-haiku-5-5 بود.
پرداخت و واریز
صفحه شارژ حساب از Alipay، WeChat Pay، کارتهای بانکی (Visa / Mastercard)، Apple Pay / Google Pay، SBP و کارتهای روسی و ارز دیجیتال (USDT · USDC · BTC · ETH و موارد دیگر) پشتیبانی میکند. Alipay، WeChat Pay، کارتها، Apple Pay و Google Pay معمولاً کمتر از یک دقیقه واریز میشوند؛ SBP و کارتهای روسی ممکن است چند دقیقه طول بکشند؛ ارزهای دیجیتال بهصورت دستی بررسی و ظرف یک روز واریز میشوند.
کدام قابلیت‌ها کار میکنند
هر کاری که CLI محلی Claude Code انجام میدهد همچنان کار میکند: گفت‌وگو، خواندن و نوشتن فایل‌ها، Bash، MCP، Skills، Hooks، افزونه‌ها و زیرعامل‌ها، همراه با قواعد پروژه در CLAUDE.md. قابلیت‌هایی که به ورود به claude.ai نیاز دارند — نشستهای ابری، Remote Control، دیکته صوتی — کار نمی‌کنند.
اشتراک، API رسمی و کلید گیت‌وی سه چیز متفاوت‌اند
اشتراک یعنی عضویت در اپهای رسمی؛ کلید API رسمی یعنی یک اعتبارنامه مصرف‌محور در پلتفرم توسعه‌دهندگان؛ و کلید cr_ در QCode یعنی یک کلید گیت‌وی که چند پروتکل را پشتیبانی میکند: این سه مستقل‌اند، هرگز سهمیه یکدیگر را مصرف نمی‌کنند و میتوانند همزمان وجود داشته باشند — همان Claude Code میتواند با یک پلن وارد شده باشد یا به QCode اشاره کند، بسته به اینکه کدام اعتبارنامه در حال حاضر فعال است. رله با API رسمی در این تفاوت دارد که چه کسی از شما صورتحساب می‌گیرد و از کدام اعتبارنامه استفاده میکنید، نه در مدل: Claude همچنان فقط روی پروتکل Anthropic Messages کار میکند و نقاط پایانی سازگار با OpenAI مدل‌های Claude را ارائه نمی‌دهند.
مستندات رسمی و مستندات QCode چه میگویند
مستندات Claude Code از Anthropic، LLM gateway را پروکسی‌ای تعریف میکند که سازمان شما بین Claude Code و ارائه‌دهنده مدل اجرا میکند و Base URL و اعتبارنامه را دو متغیری می‌داند که هر اتصال گیت‌وی به آن نیاز دارد؛ آن صفحه در 2026-10-27 به‌روزرسانی شد. همان مجموعه مستندات می‌گوید CLI و هر چیزی که محلی اجرا میشود روی همه ارائه‌دهنده‌ها کار میکند، در حالی که قابلیت‌هایی که به ورود به claude.ai نیاز دارند از یک ارائه‌دهنده شخص ثالث قابل دسترسی نیستند. در سمت QCode، صفحه نقاط پایانی و مسیرهای API در 2026-10-27، آموزش Claude Code در 2026-10-20 و جدول دسترسپذیری قابلیت‌ها در 2026-11-03 به‌روزرسانی شد.
گاه‌شمار
Anthropic نسخه 2026-10-21 API را منتشر کرد و SDKهایی که همان روز منتشر شدند (Python SDK 2.0.0، TypeScript SDK 1.0.0 و دیگران) بهطور پیشفرض آن را می‌فرستند؛ اگر Messages API را بدون SDK فراخوانی میکنید، هدر anthropic-version را روی 2026-10-21 تنظیم کنید.
صفحه رسمی گیت‌وی Claude Code به‌روزرسانی شد: Base URL و اعتبارنامه را دو متغیر لازم نام می‌برد و بیان میکند تا زمانی که ANTHROPIC_BASE_URL به میزبان غیر Anthropic اشاره کند، Remote Control غیرفعال است.
Anthropic در Claude API رسمی، حداکثر اندازه درخواست را برای Messages API و Token Counting API از 32 MB به 128 MB افزایش داد.
موارد تأییدشده در برابر باورهای نادرست رایج
تأییدشده (قابل بررسی واژه‌به‌واژه)
در مستندات QCode، BASE_URL مستندشده برای Claude Code به /api ختم میشود و SDK مسیر /v1/messages را به آن اضافه میکند؛ کلیدها با cr_ شروع میشوند و در Console ساخته میشوند؛ صورتحساب بهازای هر توکن محاسبه میشود. مستندات Anthropic: CLI و هر چیزی که بهصورت محلی اجرا میشود روی همه ارائه‌دهنده‌ها کار میکند، اما ویژگی‌هایی که به ورود به claude.ai نیاز دارند، با کلید API مربوط به Console یا از طریق ارائه‌دهنده شخص ثالث قابل دسترسی نیستند.
باورهای نادرست رایج
یک: سرویس رله ویژگی‌های حساب کاربری claude.ai مانند Projects، حافظه یا نشستهای ابری را باز نمیکند — مستندات رسمی آنها را نیازمند ورود با claude.ai می‌داند و معادل محلی آن در Claude Code فایل CLAUDE.md است. دو: Base URL نه /v1 می‌گیرد و نه اسلش انتهایی — /api یک پیشوند مسیر است، SDK مسیر /v1/messages را اضافه میکند و یک اسلش اضافه به //v1/messages و خطای 404 منجر میشود. سه: Claude را نمی‌توان از طریق نقطه پایانی سازگار با OpenAI فراخوانی کرد — مستندات می‌گوید نقاط پایانی سازگار با OpenAI مدل‌های Claude را ارائه نمی‌کنند، بنابراین model_not_available_on_endpoint یعنی پروتکل اشتباه بوده است، در حالی که کلید اشتباه خطای Invalid API key را برمی‌گرداند. چهار: اگر ANTHROPIC_API_KEY در محیط شما تنظیم شده باشد، مستندات رسمی می‌گوید Claude Code با همان کلید به‌جای اشتراک شما احراز هویت میکند و مصرف API را صورتحساب میکند.
اشتراک رسمی در برابر کلید API پرداخت بهازای مصرف
اشتراک Anthropic (Pro / Max / Ultra)
claude.com/pricing و مرکز راهنما، ثبت‌شده در 2026-11-04: Pro در صورت پرداخت ماهانه $20 است، Max ماهانه $100 و Ultra ماهانه $200. پلن‌ها بر پایه بازه 5 ساعته و سقفهای هفتگی محاسبه میشوند و وب، دسکتاپ و Claude Code که با این پلن وارد شده‌اند، یک سهمیه مشترک دارند.
کلید API پرداخت بهازای مصرف (QCode یا Anthropic Console)
صورتحساب بهازای هر توکن، بدون پلن ماهانه: QCode نرخ هر مدل را در /models فهرست میکند؛ API رسمی از موجودی Console شما کم میکند. این روش برای کسانی مناسب است که مصرفشان نامنظم است، تعهد ماهانه نمی‌خواهند، یا یک کلید را بین Claude Code و Codex به اشتراک می‌گذارند.
سه گام
① ثبت‌نام در qcode.cc و ساخت کلید cr_ در کنسول. ② پرداخت در صفحه شارژ حساب؛ کاملاً خودخدمت است — پس از شارژ، فعال‌سازی فوری انجام میشود. ③ دو متغیر را تنظیم کنید: export ANTHROPIC_BASE_URL=https://api.qcode.cc/api و export ANTHROPIC_AUTH_TOKEN=your cr_ key؛ سپس claude را اجرا کنید، یک پیام بفرستید و از /status استفاده کنید تا ببینید کدام Base URL و کدام کلید در حال استفاده است. برای ماندگاری، هر دو خط را در بلوک env یک فایل تنظیمات قرار دهید؛ مستندات رسمی هشدار میدهد که کلید را در settings.json پروژه که commit میشود نگه ندارید. برای بررسی مسیر، ابتدا یک POST مطابق مستندات بفرستید: 400 یا 401 یعنی مسیر و شبکه درست است، 404 یعنی پیشوند اشتباه است. CC Switch میتواند بین ارائه‌دهنده‌ها جابه‌جا شود.
شروع در QCode
سه گام: ثبت‌نام و ساخت کلید cr_، شارژ حساب، سپس تنظیم ANTHROPIC_BASE_URL روی https://api.qcode.cc/api و قرار دادن کلید در ANTHROPIC_AUTH_TOKEN. صورتحساب بهازای هر توکن است و نرخ هر مدل در /models آمده است. برای پلن ماهانه آماده نیستید؟ بسته‌های پرداخت بهازای مصرف از $4 شروع میشوند و یک سهمیه یک‌باره در اختیار شما می‌گذارند که ظرف 7 روز مصرف میکنید؛ اگر از قبل پلن شخصی دارید، هر زمان به سهمیه بیشتری نیاز داشتید یک بسته تقویتی اضافه کنید.
پرسش‌های متداول
تفاوت سرویس رله API برای Claude Code با API رسمی چیست؟
اینکه چه کسی صورتحساب میدهد و از کدام کلید استفاده میکنید — نه مدل. API رسمی از کلید Anthropic Console استفاده میکند که در پلتفرم رسمی شارژ میشود؛ کلید cr_ در QCode کلید اختصاصی همین درگاه است و نرخها در /models آمده است. سه نوع کلید مستقل از هم هستند، هرگز به هم تبدیل نمیشوند و میتوانند همزمان وجود داشته باشند: اینکه Claude Code از کدام استفاده میکند به کلید فعال فعلی بستگی دارد.
آیا باید /v1 یا اسلش انتهایی به Base URL اضافه کرد؟
خیر. مقدار مستندشده به /api ختم میشود و SDK مسیر /v1/messages را اضافه میکند؛ با اسلش انتهایی، //v1/messages به دست میآید و خطای 404. هر دو مسیر /api و /claude به پروتکل Anthropic Messages هدایت میشوند و مستندات بهطور پیشفرض /api را مینویسد.
کدام روشهای پرداخت کار میکنند و موجودی چقدر سریع میرسد؟
Alipay، WeChat Pay، کارتها، Apple Pay و Google Pay معمولاً ظرف یک دقیقه واریز میشوند؛ SBP و کارتهای روسی ممکن است چند دقیقه طول بکشند؛ ارز دیجیتال بهصورت دستی بررسی میشود و ظرف یک روز شارژ میشود.
آیا CLAUDE.md، MCP، Skills و Hooks کار میکنند؟
بله — اینها قابلیتهای محلی هستند و جدول دسترسپذیری قابلیتهای QCode آنها را بهعنوان قابلیتهای فعال فهرست میکند (نسخه بهروزشده در 2026-11-03، CLAUDE.md و Hooks را آزمودهشده ثبت کرده است). آنچه کار نمیکند، گروهی است که به ورود در claude.ai نیاز دارد: نشستهای ابری، Remote Control، دیکته صوتی.
اشتراک یا API پرداخت بهازای مصرف — کدام را انتخاب کنم؟
اشتراک بر پایه یک بازه 5 ساعته محاسبه میشود و سقفهای هفتگی میان چت و ترمینال مشترکاند؛ API پرداخت بهازای مصرف بر اساس توکن صورتحساب میشود و تنها با درخواستهای شما انباشته میشود، بدون بازنشانی روزانه. مصرف روزانه با یک پلن بهتر پوشش داده میشود؛ مصرف جهشی یا پرهیز از تعهد ماهانه با یک کلید API پرداخت بهازای مصرف سازگار است — مستندات دقیقاً به همین مورد اشاره میکنند. اگر فقط درون اپهای رسمی چت میکنید و سند مینویسید، به هیچ کلید API نیاز ندارید.
آیا یک کلید میتواند به چند ابزار و چند نفر خدمت کند؟
در میان ابزارها، بله: مستندات QCode میگویند Codex و Claude Code از همان کلید API QCode استفاده میکنند؛ Codex از طریق نقطه پایانی OpenAI Responses و Claude Code از طریق نقطه پایانی Anthropic — Responses به Claude خدمت نمیدهد. برای یک تیم، شکل مستندشده پلن سازمانی است: 35 درخواست همزمان بهازای هر منبع حساب کاربری، 3 نفر بهازای هر حساب کاربری توصیه میشود و حداکثر 7 نفر میتوانند یک حساب را به اشتراک بگذارند.
منابع
مستندات Claude Code از Anthropic (راه‌اندازی درگاه و دسترسپذیری قابلیت‌ها، با تاریخ آرشیو 2026-10-27 و 2026-10-30)؛ claude.com/pricing و پنج مقاله support.claude.com درباره Max، Ultra، اعتبار مصرف، اعتبار ماهانه API و محدودیت‌های مصرف (با تاریخ خودشان 2026-10-30)؛ یادداشت‌های انتشار پلتفرم و راهنمای مهاجرت API نسخه 2026-10-21 — همه در 2026-11-04 ثبت شده‌اند. همچنین صفحات qcode.cc شامل /models، /pricing، /recharge و /pay-as-you-go، و صفحات docs.qcode.cc درباره نقاط پایانی و مسیرهای API، آموزش Claude Code، CC Switch، Codex، دسترسپذیری قابلیت‌ها، انتخاب پلن، روشهای پرداخت و صورتحساب، ثبت‌شده در 2026-11-04.
ابتدا یک کلید را پیکربندی کنید
روشهای پرداخت و زمان‌های واریز در صفحه شارژ حساب آمده است؛ دسترسپذیری مدل‌ها تابع /models است.
مطالب مرتبط
سهمیه یک‌باره Claude Code: بدون اشتراک، 7 روز
سهمیه یک‌باره بدون اشتراک؛ هر چه بخرید به همان کلید افزوده میشود. شکل این سهمیه و هم‌زمانی آن در صفحه انتخاب پلن QCode آمده است.
چگونه تشخیص دهیم یک سرویس رله API هوش مصنوعی ارزش استفاده دارد یا نه
معیارهای انتخاب قابل‌بررسی عمومی: سازگاری پروتکل، انتشار نرخ‌های هر مدل و واحد صورتحساب، روشهای پرداخت و زمان‌های واریز.
Claude Code روی API شخص ثالث: چه چیزی کار میکند و چه چیزی نه
قابلیتهای محلی CLI در برابر قابلیت‌هایی که به حساب کاربری claude.ai نیاز دارند، مورد به مورد.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
جزئیات QCode در این صفحه در 2026-11-04 با qcode.cc و docs.qcode.cc ثبت‌شده در همان روز بررسی شده است؛ صفحات Anthropic نیز همان روز ثبت شده‌اند و تاریخ خودشان 2026-10-27 تا 2026-10-30 است. صفحات رسمی اولویت دارند، دسترسپذیری مدل‌ها تابع /models است.