اشتراک‌ها در برابر کلیدهای API در برابر کلیدهای QCode
اینکه اشتراک Claude Pro / ChatGPT Plus، کلید API رسمی و کلید cr_ QCode در واقع چه هستند، هرکدام چگونه صورتحساب می‌شوند و هرکدام کجا کار می‌کنند — سه چیز مستقل که می‌توانند هم‌زمان وجود داشته باشند
به کلید API نیاز دارید؟ ثبت‌نام ←نقاط پایانی و Base URL ←
در این صفحه
- هر یک از این سه در واقع چیست
- ترکیب‌های رایج
- به کدام‌یک نیاز دارم؟
- تنظیمات کلیدی توضیح داده شده: کدام متغیر مسیر را تعیین می‌کند
- خطاهای رایج و نحوه عیب‌یابی
- پرسش‌های متداول
- آیا می‌توانید از اعتبارهای API در پلن Claude Max یا Team در QCode استفاده کنید؟
- آیا می‌توانید هم‌زمان از اشتراک و QCode استفاده کنید؟ آیا با هم تعارض پیدا می‌کنند؟
- آیا QCode می‌تواند جایگزین اشتراک شود؟
- چرا نمی‌توانید از ChatGPT Plus خود برای فراخوانی GPT در ابزارهای شخص ثالث استفاده کنید؟
- اگر فقط در اپ‌های رسمی چت می‌کنید، آیا به QCode نیاز دارید؟
- مستندات مرتبط
خلاصه ماجرا: اشتراک یعنی عضویت در اپ‌های رسمی کلاینت، کلید API رسمی یعنی اعتبارنامه پرداخت به‌ازای مصرف در پلتفرم‌های توسعه‌دهنده، و کلید QCode (با پیشوند cr_) یعنی یک کلید دروازه که از چند پروتکل پشتیبانی می‌کند. هر سه مستقل‌اند: هیچ‌کدام دیگری را مصرف نمی‌کند و می‌توانند روی یک ماشین هم‌زمان وجود داشته باشند.
هر یک از این سه در واقع چیست¶
| چیست | چگونه صورتحساب می‌شود | کجا کار می‌کند | |
|---|---|---|---|
| اشتراک (Claude Pro / Claude Max، ChatGPT Plus و غیره) | عضویت در اپ‌های رسمی چت و محصولات رسمی کدنویسی | هزینه ثابت ماهانه (به claude.com/pricing / chatgpt.com/pricing مراجعه کنید) | اپ‌های Claude / ChatGPT؛ ورود به Claude Code با پلن Pro / Max |
| کلید API رسمی | کلید توسعه‌دهنده از Anthropic Console / OpenAI Platform | به‌ازای هر توکن، با شارژ حساب در پلتفرم رسمی | برنامه‌هایی که مستقیماً APIهای رسمی را فراخوانی می‌کنند |
کلید QCode (پیشوند cr_) |
کلید دروازه این سایت — یک کلید، چند پروتکل (Anthropic / OpenAI Chat / Responses؛ مسیر پروتکل Gemini در حال حاضر در دسترس نیست) | به‌ازای هر توکن (qcode.cc/models برای نرخ‌ها)؛ پلن‌های شخصی سقف روزانه دارند؛ بسته‌های پرداخت به‌ازای مصرف یک سهمیه کلی برای مدت اعتبارشان دارند | Claude Code، Codex، افزونه‌های IDE، کلاینت‌های چت |
هر دو ارائه‌دهنده صراحتاً اعلام می‌کنند که مصرف API جدا از اشتراک صورتحساب می‌شود:
«اشتراک پولی Claude تجربه چت شما را بهبود می‌بخشد، و Claude API جداگانه صورتحساب می‌شود.» —— مرکز راهنمای Claude (بررسی‌شده در 2026-10-15)
«شامل نمی‌شود: مصرف API جداگانه است و به‌طور مستقل صورتحساب می‌شود.» —— مرکز راهنمای OpenAI، «ChatGPT Plus چیست؟» (بررسی‌شده در 2026-10-14)
بنابراین اشتراک Anthropic / OpenAI شما نمی‌تواند از طریق QCode به کار رود و هرگز توسط آن مصرف نمی‌شود؛ به همین ترتیب، مصرف QCode به سهمیه اشتراک شما دست نمی‌زند. دو سیستم موازی.
ترکیب‌های رایج¶
Claude Pro / ChatGPT Plus دارم — آیا می‌توانم آن را با QCode یا ابزارهای شخص ثالث استفاده کنم؟¶
خیر. اشتراک فقط برنامه‌های رسمی را پوشش می‌دهد — ورود به آن‌ها و استفاده از آن‌ها (مثلاً Claude Code که با Pro / Max وارد شده است). هیچ سهمیه API در اختیار نمی‌گذارد که چیز دیگری بتواند از آن استفاده کند. اجرای مدل‌های Claude / GPT روی QCode از طریق پلن‌های پرداخت به‌ازای توکن خودمان انجام می‌شود، مستقل از اشتراک شما.
این دو می‌توانند هم‌زمان وجود داشته باشند: همان نصب Claude Code می‌تواند یا با اشتراک شما وارد شود یا ANTHROPIC_BASE_URL را با یک کلید cr_ به QCode اشاره دهد — هر اعتبارنامه‌ای که در آن لحظه فعال باشد تعیین‌کننده است. CC Switch روش توصیه‌شده برای جابه‌جایی بین آن‌ها است.
آیا Claude Desktop می‌تواند از اشتراک GPT من استفاده کند؟¶
خیر. قابلیت استنتاج شخص ثالث Claude Desktop فقط دروازه‌هایی را می‌پذیرد که Anthropic Messages API را پیاده‌سازی می‌کنند — عبارت رسمی: «دروازه باید Anthropic Messages API را پیاده‌سازی کند: POST /v1/messages با استریمینگ و استفاده از ابزار الزامی است.» (مستندات رسمی). پروتکل OpenAI خارج از محدوده آن است و اشتراک GPT قطعاً با آن سازگار نیست. برای مدل‌های GPT / چینی روی دسکتاپ، کلاینتی انتخاب کنید که با پروتکل OpenAI کار می‌کند (به نمای کلی سازگاری ابزارها مراجعه کنید).
اگر در حالی که با اشتراک وارد Claude Code شده‌اید، متغیر محیطی ANTHROPIC_API_KEY را تنظیم کنید چه اتفاقی می‌افتد؟¶
این کار جایگزین ورود با اشتراک می‌شود و هزینه را بر اساس هر توکن API از شما دریافت می‌کند. از مرکز راهنمای Anthropic:
«مهم: اگر متغیر محیطی ANTHROPIC_API_KEY روی سیستم شما تنظیم شده باشد، Claude Code برای احراز هویت از این کلید API به‌جای اشتراک Claude شما (پلن‌های Pro، Max، Team یا Enterprise) استفاده می‌کند و در نتیجه هزینه‌های مصرف API اعمال می‌شود، نه استفاده از مصرف شامل‌شده در اشتراک شما.» —— استفاده از Claude Code با پلن Pro یا Max خود (بررسی‌شده در 2026-10-15)
این رایج‌ترین علت «دیروز کار می‌کرد، امروز پول می‌خواهد» یا «وارد شده‌ام اما 401 می‌گیرم» است: یک کلید قدیمی در پیکربندی شل شما مسیر احراز هویت را تصاحب می‌کند. مرحله 2 از راهنمای عیب‌یابی دقیقاً همین را بررسی می‌کند.
به کدام‌یک نیاز دارم؟¶
- فقط گفت‌وگو / نوشتن در برنامه‌های رسمی: اشتراک کافی است و QCode در کار نیست.
- فراخوانی مدل‌ها از اسکریپت‌های خودتان: یک کلید API رسمی یا یک کلید QCode — QCode چندین پروتکل و مدل چینی را با یک کلید پوشش می‌دهد.
- Claude، GPT، GLM، Kimi در کنار هم در Claude Code / Codex / افزونه‌های IDE: کلید QCode؛ ماتریس پروتکل و Base URL در نقاط پایانی و مسیرهای API است.
- جابه‌جایی بین ورود با اشتراک و دروازه: CC Switch.
تنظیمات کلیدی توضیح داده شده: کدام متغیر مسیر را تعیین می‌کند¶
| چه چیزی را تنظیم می‌کنید | اثر | یادداشت‌ها |
|---|---|---|
| ورود با اشتراک رسمی (درون Claude Code) | از سهمیه اشتراک استفاده می‌کند | در برابر محدودیت‌های مصرف اشتراک حساب می‌شود و ارتباطی با QCode ندارد |
ANTHROPIC_API_KEY (یک کلید API رسمی) |
به‌عنوان مصرف API رسمی صورتحساب می‌شود | بر اساس متن رسمی: وقتی تنظیم شود، بر ورود با اشتراک اولویت می‌یابد و هزینه‌های API را ایجاد می‌کند |
ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN (یک کلید cr_) |
از QCode عبور می‌کند و به‌ازای هر توکن صورتحساب می‌شود | از https://api.qcode.cc/api استفاده کنید؛ نرخ‌های هر مدل در qcode.cc/models است |
وقتی چند مورد هم‌زمان وجود دارد، اینکه کدام اعمال می‌شود به مسیر احراز هویت فعال بستگی دارد؛ برای پی بردن به اینکه کدام یک در حال استفاده است، ابتدا ببینید کدام متغیرهای ANTHROPIC_* در محیط شما وجود دارند.
خطاهای رایج و نحوه عیب‌یابی¶
| نشانه | علت احتمالی | راه‌حل |
|---|---|---|
وقتی کلید API رسمی در QCode وارد شود، Invalid API key می‌دهد |
کلیدهای رسمی و کلیدهای QCode قابل تبادل نیستند | یک کلید cr_ در کنسول QCode ایجاد کنید |
| با اشتراک وارد شده‌اید اما به‌عنوان مصرف API صورتحساب می‌شوید، یا خطای 401 دریافت می‌کنید | یک ANTHROPIC_API_KEY قدیمی در محیط باقی مانده است |
آن را با env \| grep -i anthropic پیدا کنید، حذفش کنید و ترمینال را دوباره باز کنید |
| می‌خواهید از QCode استفاده کنید اما Claude Code هنوز از اشتراک استفاده می‌کند | ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN تنظیم نشده‌اند یا در جای اشتباه تنظیم شده‌اند |
آن را با متغیرهای محیطی بررسی کنید؛ جابه‌جایی با CC Switch توصیه می‌شود |
| Claude Desktop به QCode متصل نمی‌شود | استنتاج شخص ثالث Desktop فقط دروازه‌هایی را می‌پذیرد که Anthropic Messages API را پیاده‌سازی می‌کنند | از Claude Desktop پیروی کنید؛ برای مدل‌های GPT یا چینی، کلاینتی انتخاب کنید که با پروتکل OpenAI کار می‌کند |
| 404 | Base URL اشتباه است | آن را با نقاط پایانی و قالب‌های API مقایسه کنید |
model_not_available_on_endpoint |
عدم تطابق پروتکل و مدل (مثلاً ارسال Claude به نقطه پایانی OpenAI) | نقطه پایانی یا مدل را تغییر دهید؛ این مشکل کلید نیست |
پرسش‌های متداول¶
آیا می‌توانید از اعتبارهای API در پلن Claude Max یا Team در QCode استفاده کنید؟¶
خیر. در تاریخ 2026-10-15، همان صفحه Claude Help Center می‌گوید پلن‌های Max و Team شامل اعتبارهای ماهانه برای Claude API هستند، اما آن اعتبارها به حساب API خود Anthropic تعلق دارند و نمی‌توان آن‌ها را به یک دروازه شخص ثالث واگذار کرد. کلید cr_ QCode به‌صورت جداگانه به‌ازای هر توکن صورتحساب می‌شود و این دو هرگز به یکدیگر تبدیل نمی‌شوند.
آیا می‌توانید هم‌زمان از اشتراک و QCode استفاده کنید؟ آیا با هم تعارض پیدا می‌کنند؟¶
می‌توانید هر دو را داشته باشید و هیچ‌کدام سهمیه دیگری را مصرف نمی‌کند. تعارض فقط درون یک کلاینت زمانی رخ می‌دهد که یک مسیر احراز هویت دیگری را جایگزین کند؛ برای مثال، یک ANTHROPIC_API_KEY قدیمی بر ورود با اشتراک اولویت پیدا کند. جابه‌جایی پیکربندی‌ها با CC Switch ساده‌ترین راه برای اجتناب از آن است.
آیا QCode می‌تواند جایگزین اشتراک شود؟¶
آن‌ها دو نوع محصول متفاوت هستند. اشتراک، عضویت در اپ‌های رسمی است؛ QCode یک دروازه API به‌ازای هر توکن است. قابلیت‌های چت و اسناد درون اپ‌های رسمی چیزی نیست که QCode ارائه دهد. اگر عمدتاً در Claude Code، Codex یا افزونه‌های IDE کد می‌نویسید، یک کلید QCode تمام چیزی است که نیاز دارید.
چرا نمی‌توانید از ChatGPT Plus خود برای فراخوانی GPT در ابزارهای شخص ثالث استفاده کنید؟¶
OpenAI Help Center بیان می‌کند که Plus شامل مصرف API نیست و مصرف API جداگانه صورتحساب می‌شود. برای استفاده از GPT در ابزارهای شخص ثالث، از یک کلید cr_ QCode با نقطه پایانی OpenAI استفاده کنید که به‌ازای هر توکن صورتحساب می‌شود.
اگر فقط در اپ‌های رسمی چت می‌کنید، آیا به QCode نیاز دارید؟¶
خیر. برای چت و نوشتن اسناد در اپ‌های رسمی، اشتراک کافی است.
مستندات مرتبط¶
با QCode شروع کنید
یک کلید API برای Claude Code، Codex و بیشتر — بر اساس توکن، قیمت هر مدل در qcode.cc/models