# اشتراک‌ها در برابر کلیدهای API در برابر کلیدهای QCode

خلاصه ماجرا: **اشتراک یعنی عضویت در اپ‌های رسمی کلاینت، کلید API رسمی یعنی اعتبارنامه پرداخت به‌ازای مصرف در پلتفرم‌های توسعه‌دهنده، و کلید QCode (با پیشوند `cr_`) یعنی یک کلید دروازه که از چند پروتکل پشتیبانی می‌کند.** هر سه مستقل‌اند: هیچ‌کدام دیگری را مصرف نمی‌کند و می‌توانند روی یک ماشین هم‌زمان وجود داشته باشند.

## هر یک از این سه در واقع چیست

| | چیست | چگونه صورت‌حساب می‌شود | کجا کار می‌کند |
|---|---|---|---|
| **اشتراک** (Claude Pro / Claude Max، ChatGPT Plus و غیره) | عضویت در اپ‌های رسمی چت و محصولات رسمی کدنویسی | هزینه ثابت ماهانه (به [claude.com/pricing](https://claude.com/pricing) / [chatgpt.com/pricing](https://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](https://qcode.cc/models) برای نرخ‌ها)؛ پلن‌های شخصی سقف روزانه دارند؛ بسته‌های پرداخت به‌ازای مصرف یک سهمیه کلی برای مدت اعتبارشان دارند | Claude Code، Codex، افزونه‌های IDE، کلاینت‌های چت |

هر دو ارائه‌دهنده صراحتاً اعلام می‌کنند که **مصرف API جدا از اشتراک صورت‌حساب می‌شود**:

> «اشتراک پولی Claude تجربه چت شما را بهبود می‌بخشد، و Claude API جداگانه صورت‌حساب می‌شود.»
> —— [مرکز راهنمای Claude](https://support.claude.com/en/articles/9876003) (بررسی‌شده در 2026-10-15)

> «شامل نمی‌شود: مصرف API جداگانه است و به‌طور مستقل صورت‌حساب می‌شود.»
> —— [مرکز راهنمای OpenAI، «ChatGPT Plus چیست؟»](https://help.openai.com/en/articles/6950777-what-is-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](/docs/ide/cc-switch) روش توصیه‌شده برای جابه‌جایی بین آن‌ها است.

### آیا Claude Desktop می‌تواند از اشتراک GPT من استفاده کند؟

**خیر.** قابلیت استنتاج شخص ثالث Claude Desktop فقط دروازه‌هایی را می‌پذیرد که **Anthropic Messages API را پیاده‌سازی می‌کنند** — عبارت رسمی: *«دروازه باید Anthropic Messages API را پیاده‌سازی کند: POST /v1/messages با استریمینگ و استفاده از ابزار الزامی است.»* ([مستندات رسمی](https://claude.com/docs/third-party/claude-desktop/gateway)). پروتکل OpenAI خارج از محدوده آن است و اشتراک GPT قطعاً با آن سازگار نیست. برای مدل‌های GPT / چینی روی دسکتاپ، کلاینتی انتخاب کنید که با پروتکل OpenAI کار می‌کند (به [نمای کلی سازگاری ابزارها](/docs/ide/tool-compatibility) مراجعه کنید).

### اگر در حالی که با اشتراک وارد Claude Code شده‌اید، متغیر محیطی `ANTHROPIC_API_KEY` را تنظیم کنید چه اتفاقی می‌افتد؟

**این کار جایگزین ورود با اشتراک می‌شود و هزینه را بر اساس هر توکن API از شما دریافت می‌کند.** از مرکز راهنمای Anthropic:

> «مهم: اگر متغیر محیطی ANTHROPIC_API_KEY روی سیستم شما تنظیم شده باشد، Claude Code برای احراز هویت از این کلید API به‌جای اشتراک Claude شما (پلن‌های Pro، Max، Team یا Enterprise) استفاده می‌کند و در نتیجه هزینه‌های مصرف API اعمال می‌شود، نه استفاده از مصرف شامل‌شده در اشتراک شما.»
> —— [استفاده از Claude Code با پلن Pro یا Max خود](https://support.claude.com/en/articles/11145838) (بررسی‌شده در 2026-10-15)

این رایج‌ترین علت «دیروز کار می‌کرد، امروز پول می‌خواهد» یا «وارد شده‌ام اما 401 می‌گیرم» است: یک کلید قدیمی در پیکربندی شل شما مسیر احراز هویت را تصاحب می‌کند. مرحله 2 از [راهنمای عیب‌یابی](/docs/reference/troubleshooting) دقیقاً همین را بررسی می‌کند.

## به کدام‌یک نیاز دارم؟

- فقط گفت‌وگو / نوشتن در برنامه‌های رسمی: **اشتراک** کافی است و QCode در کار نیست.
- فراخوانی مدل‌ها از اسکریپت‌های خودتان: یک کلید API رسمی یا یک کلید QCode — QCode چندین پروتکل و مدل چینی را با یک کلید پوشش می‌دهد.
- Claude، GPT، GLM، Kimi در کنار هم در Claude Code / Codex / افزونه‌های IDE: **کلید QCode**؛ ماتریس پروتکل و Base URL در [نقاط پایانی و مسیرهای API](/docs/getting-started/endpoints-and-api-paths) است.
- جابه‌جایی بین ورود با اشتراک و دروازه: [CC Switch](/docs/ide/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](https://qcode.cc/models) است |

وقتی چند مورد هم‌زمان وجود دارد، اینکه کدام اعمال می‌شود به مسیر احراز هویت فعال بستگی دارد؛ برای پی بردن به اینکه کدام یک در حال استفاده است، ابتدا ببینید کدام متغیرهای `ANTHROPIC_*` در محیط شما وجود دارند.

## خطاهای رایج و نحوه عیب‌یابی

| نشانه | علت احتمالی | راه‌حل |
|---|---|---|
| وقتی کلید API رسمی در QCode وارد شود، `Invalid API key` می‌دهد | کلیدهای رسمی و کلیدهای QCode قابل تبادل نیستند | یک کلید `cr_` در [کنسول QCode](https://qcode.cc/dashboard) ایجاد کنید |
| با اشتراک وارد شده‌اید اما به‌عنوان مصرف API صورت‌حساب می‌شوید، یا خطای 401 دریافت می‌کنید | یک `ANTHROPIC_API_KEY` قدیمی در محیط باقی مانده است | آن را با `env \| grep -i anthropic` پیدا کنید، حذفش کنید و ترمینال را دوباره باز کنید |
| می‌خواهید از QCode استفاده کنید اما Claude Code هنوز از اشتراک استفاده می‌کند | `ANTHROPIC_BASE_URL` / `ANTHROPIC_AUTH_TOKEN` تنظیم نشده‌اند یا در جای اشتباه تنظیم شده‌اند | آن را با [متغیرهای محیطی](/docs/getting-started/environment) بررسی کنید؛ جابه‌جایی با [CC Switch](/docs/ide/cc-switch) توصیه می‌شود |
| Claude Desktop به QCode متصل نمی‌شود | استنتاج شخص ثالث Desktop فقط دروازه‌هایی را می‌پذیرد که Anthropic Messages API را پیاده‌سازی می‌کنند | از [Claude Desktop](/docs/ide/claude-desktop) پیروی کنید؛ برای مدل‌های GPT یا چینی، کلاینتی انتخاب کنید که با پروتکل OpenAI کار می‌کند |
| 404 | Base URL اشتباه است | آن را با [نقاط پایانی و قالب‌های API](/docs/getting-started/endpoints-and-api-paths) مقایسه کنید |
| `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](/docs/ide/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 نیاز دارید؟

خیر. برای چت و نوشتن اسناد در اپ‌های رسمی، اشتراک کافی است.

## مستندات مرتبط

- [پرسش‌های متداول](/docs/reference/faq)
- [نقاط پایانی و مسیرهای API](/docs/getting-started/endpoints-and-api-paths)
- [صورت‌حساب](/docs/reference/billing)
- [راه‌اندازی CC Switch](/docs/ide/cc-switch)
- [مرور سازگاری ابزارها](/docs/ide/tool-compatibility)