# راهنمای داشبورد

در [qcode.cc](https://qcode.cc) وارد شوید و کنسول را در
[qcode.cc/dashboard](https://qcode.cc/dashboard) باز کنید. کنسول خود را در یک خط خلاصه می‌کند —
*«کلیدهای API، شارژ حساب و مصرف خود را مدیریت کنید»* — و یک صفحه واحد است: کلیدها، موجودی، پلن‌ها،
مصرف، پاداش‌های معرفی و پشتیبانی همگی در همان‌جا قرار دارند.

> مطمئن نیستید کلید QCode چه تفاوتی با اشتراک Claude / ChatGPT دارد؟ ابتدا
> [اشتراک‌ها در برابر کلیدهای API در برابر کلیدهای QCode](/docs/reference/subscription-vs-api-key) را بخوانید.
> خارج از سرزمین اصلی چین هستید؟ با [QCode برای کاربران خارج از سرزمین اصلی چین](/docs/getting-started/international-users) شروع کنید.

## کنسول شامل چه چیزهایی است

| بلوک | کاری که در آن انجام می‌دهید |
|---|---|
| نوار کاربر (بالا سمت راست) | ایمیل ورود و `ID: …` خود، موجودی به هر دو ارز، و دکمه‌های **شارژ حساب** / **خرید پلن** را می‌بینید |
| آدرس دسترسی API | آدرسی را که در `ANTHROPIC_BASE_URL` / `base_url` قرار می‌گیرد کپی می‌کنید |
| مدیریت کلید API | ساخت کلید، نمایش و کپی مقدار آن، تمدید آن، باز کردن کلیدهای منقضی‌شده |
| راه‌اندازی یک‌کلیکی (داخل کارت هر کلید) | فرمان نصب برای Claude Code یا Codex را کپی می‌کنید |
| Open API | توکن شخصی `qot_` خود را مدیریت می‌کنید — فقط‌خواندنی است و تاریخ انقضا و مصرف کلیدهای شما را گزارش می‌دهد |
| آمار مصرف | مصرف سهمیه به‌ازای هر کلید فعال، به‌همراه مجموع ماهانه |
| مستندات و منابع | یکپارچه‌سازی‌های IDE و راهنماهای پرکاربرد |
| راهنمای سرویس / پاداش‌های معرفی / پیوندهای سریع | قوانین عملیاتی، لینک معرفی شما، دریافت پاداش، مقالات راهنما، کدهای خطا، ساعات پشتیبانی |

## آدرس دسترسی API

عنوان این بلوک **آدرس دسترسی API** است و هر ردیف دکمه کپی مخصوص خود را دارد. **اینکه کدام ردیف
به‌عنوان پیشنهادی برجسته شود به زبان کنسولی بستگی دارد که با آن وارد شده‌اید**:

- **رابط چینی** — ردیف `https://asia.qcode.cc/api` به‌عنوان ردیف پیشنهادی برجسته می‌شود و زیر آن
  این یادداشت نمایش داده می‌شود: *«کاربران سرزمین اصلی چین باید از آدرس شتاب‌یافته استفاده کنند؛ دیگران
  از آدرس جهانی استفاده کنند. عملکرد هر دو یکسان است»*.
- **هر رابط غیرچینی** (در حال حاضر انگلیسی، ژاپنی، روسی) — ردیف `https://api.qcode.cc` برجسته
  می‌شود و ردیف‌های زیر آن با برچسب **پشتیبان** مشخص می‌شوند (ایالات متحده: `https://us.qcode.cc/api`،
  آسیا: `https://asia.qcode.cc/api`).

آدرسی که کپی می‌کنید هنوز باید **پیشوند مسیر** درست را برای ابزاری که استفاده می‌کنید داشته باشد — به
[نقاط پایانی و مسیرهای API](/docs/getting-started/endpoints-and-api-paths) مراجعه کنید. برای Claude Code این جفت
به این شکل است:

```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_key"
```

## کلیدهای API: ایجاد، مشاهده و کپی

**API Key Management** همان بخشی است که دکمه **Create Key & Activate Service** در آن قرار دارد. اگر هنوز
کلیدی ندارید، حالت خالی ترتیب عملیات را شرح می‌دهد: **Top Up Balance** → **Buy a Plan**
→ **Start Using**.

1. در [qcode.cc/recharge](https://qcode.cc/recharge) شارژ حساب کنید (به
   [نمای کلی روش‌های پرداخت](/docs/reference/payment-methods) مراجعه کنید).
2. در [qcode.cc/subscribe](https://qcode.cc/subscribe) یک پلن انتخاب کنید — یا **Recommended Plans**
   یا **Custom Configuration** — و تأیید کنید. خرید موفق این پیام را نشان می‌دهد:
   *«اشتراک فعال شد — کلید API شما ایجاد شده و آماده استفاده است»* و کلید را همراه با
   دکمه کپی و پیوند **Go to Dashboard** نمایش می‌دهد.
3. پس از بازگشت به کنسول، مقدار کلید به‌طور پیش‌فرض **نمایش داده نمی‌شود**: ردیف تا زمانی که
   دکمه چشم را برای آشکارسازی فشار ندهید *در حال بارگذاری…* نشان می‌دهد و سپس **Copy**. اگر پیش از
   بارگذاری مقدار کپی کنید، کنسول به شما اطلاع می‌دهد و رشته خالی کپی نمی‌شود.

موارد دیگر در همان بخش:

- کلیدی که تازه سفارش داده شده می‌تواند *«کلید API در حال فعال‌سازی است؛ در اسرع وقت آن را پردازش می‌کنیم»* را همراه با پیوندی به پشتیبانی آنلاین نشان دهد.
- کلیدی که از قبل دارید می‌تواند دکمه **Renew** را نشان دهد (تمدید سریعی که از موجودی شما محاسبه می‌شود).
- کلیدهایی که به پایان رسیده‌اند زیر فهرست جمع‌شده **Expired keys** نمایش داده می‌شوند و با
  *کلید منقضی شده یا غیرفعال شده* مشخص می‌شوند.
- حساب‌هایی که بسته‌های پرداخت به‌ازای مصرف خریداری کرده‌اند یک کارت اضافی **Pay-as-you-go Key** دریافت می‌کنند (فقط برای چنین حساب‌هایی نمایش داده می‌شود): وضعیت (Active / Quota used up / Expired)، سهمیه باقی‌مانده، تاریخ انقضا همراه با روزهای باقی‌مانده، تعداد درخواست‌های هم‌زمان، و دکمه‌های **Buy more** و **Upgrade to a personal plan**. هر حساب فقط یک کلید بسته دارد و تمدیدها روی آن انباشته می‌شوند؛ خرید دوباره پس از انقضا همان کلید را بازیابی می‌کند.
- هر کارت سه کلاینتی را که یک کلید به آن‌ها سرویس می‌دهد پیوند می‌دهد: Claude، Codex و Gemini (QCode در حال حاضر مدل‌های Gemini را ارائه نمی‌دهد).

## دستورات راه‌اندازی یک‌کلیکی

هر کارت کلید فعال یک بخش **One-Click Setup (Recommended)** دارد با تب **macOS / Linux**
و **Windows**، یک خط دستور برای Claude Code و یک خط برای Codex، که هر کدام دکمه
**Copy** مخصوص خود را دارند:

```bash
curl -fsSL https://qcode.cc/install/claude-code.sh | bash
curl -fsSL https://qcode.cc/install/codex.sh | bash
```

راهنمای کنسول زیر این بخش: *«وقتی اسکریپت کلید را درخواست کرد، کلید خود را در بالا جای‌گذاری کنید.»* در تب
Windows، دستورات معادل‌های `irm … | iex` هستند و یک بخش جمع‌شده در زیر آن یک دستور تک‌خطی CMD
و یک راه‌انداز قابل دانلود برای ماشین‌هایی اضافه می‌کند که `irm` در آن‌ها در دسترس نیست یا توسط
خط‌مشی اجرا مسدود شده است. راهنمای کامل،
از جمله نحوه اجبار زبان رابط اسکریپت، در
[اسکریپت راه‌اندازی یک‌کلیکی](/docs/getting-started/one-click-install) آمده است.
## آمار مصرف

بلوک **آمار مصرف** به کلید فعال شما گره خورده است (*«سهمیه مصرف برای کلید فعال فعلی»*) و می‌تواند به‌صورت زمان‌بندی‌شده (خاموش / 5 / 10 / 30 / 60 دقیقه) یا به‌صورت دستی با **بازخوانی** به‌روزرسانی شود.

| بخش | چه چیزی را گزارش می‌دهد |
|---|---|
| سقف هزینه روزانه | حداکثر هزینه در روز؛ در نیمه‌شب به وقت پکن بازنشانی می‌شود و API هنگام رسیدن به این حد موقتاً متوقف می‌شود و روز بعد از سر گرفته می‌شود |
| محدودیت بازه زمانی | تعداد درخواست و هزینه در یک بازه غلتان 4 ساعته. پلن‌های شخصی از ژوئیه 2026 دیگر بازه 4 ساعته ندارند، بنابراین این بخش *بازه 4 ساعته‌ای وجود ندارد* را نشان می‌دهد و سقفی را که واقعاً اعمال می‌شود نام می‌برد: سقف روزانه شما (بازنشانی در 00:00 به وقت پکن) یا سهمیه ماهانه در Ultimate |
| سقف هفتگی Opus | سقف هفتگی برای مدل‌های Claude که بر اساس چرخه تنظیم‌شده برای همان کلید بازنشانی می‌شود؛ پلن‌های بدون سقف هفتگی این موضوع را همین‌جا اعلام می‌کنند |
| نمای کلی مصرف ماهانه | کل توکن‌ها، کل درخواست‌ها، کل هزینه — از روز ساخت کلید شمارش می‌شود |
| فراخوانی‌های مدل امروز | توکن‌های ورودی / خروجی / نوشتن در کش / خواندن از کش به تفکیک مدل برای روز جاری |
| سهمیه پرداخت به‌ازای مصرف (فقط کلیدهای بسته) | سهمیه باقی‌مانده / موجود و تاریخ انقضا؛ پس از انقضا «منقضی شد — برای بازگرداندن، بسته بخرید» را نشان می‌دهد. وقتی سهمیه تمام شود، کارت کلید می‌گوید «سهمیه تمام شد: بسته بخرید تا کلید بلافاصله دوباره کار کند» و دکمه **خرید بیشتر** را ارائه می‌دهد |
| بسته تقویتی | این‌که آیا بسته تقویتی فعال است؛ پایین‌تر ببینید |

> با آن‌که هرگز `claude-sonnet-5` را انتخاب نکرده‌اید، آن را در فراخوانی‌های مدل امروز می‌بینید؟ به احتمال زیاد این‌ها درخواست‌های بررسی ایمنی هستند که Claude Code در حالت دسترسی `auto` ارسال می‌کند؛ [چرا Claude Sonnet 5 در آمار مصرف شما ظاهر می‌شود](/docs/reference/why-sonnet-5-in-usage) را ببینید.

سلب مسئولیت خود پنل: *«داده‌های نمایش‌داده‌شده در اینجا ممکن است کمی متفاوت باشد؛ حدود واقعی بر اساس پاسخ‌های Claude Code است.»* برای یک عدد تقریبی به‌ازای هر نشست از `/cost` در Claude Code استفاده کنید و برای نحوه محاسبه هزینه [شرح صورت‌حساب](/docs/reference/billing) را ببینید.

## شارژ حساب، پلن‌ها، بسته‌های تقویتی و ارتقا

- **موجودی به تفکیک ارز است.** *«موجودی CNY و USD جداگانه است. مبلغ شارژ به موجودی ارز متناظر اضافه می‌شود.»* نوار کاربر هر دو عدد را کنار هم نشان می‌دهد.
- **حدود شارژ حساب** که در صفحه شارژ نمایش داده می‌شود: حداقل **¥30** برای CNY، حداقل **$5** و حداکثر **$2,000** برای USD، به‌همراه سقف‌های هر روش پرداخت که صفحه هنگام رسیدن به آن‌ها توضیح می‌دهد.
- **بازگشت پس از شارژ حساب**: بنر کنسول این متن را نشان می‌دهد: *«موجودی دریافت شد — اکنون می‌توانید یک پلن را فعال کنید.»* همراه با دکمه **انتخاب پلن**. باقی‌مانده از بین نمی‌رود — *«هر موجودی‌ای که پس از شارژ حساب باقی بماند هدر نمی‌رود: بعداً آن را برای ارتقا یا یک بسته تقویتی استفاده کنید.»*
- **خرید چندماهه**: قیمت ماهانه کمتر با خرید از 3 ماه (−10% / −20% / −25%)؛ کنسول می‌نویسد: *«از 3 ماه، ماهانه 10% صرفه‌جویی کنید؛ 20% در 6 ماه و 25% در 12 — 12 ماه به قیمت 9 ماه. یک‌بار پرداخت، بدون تمدید خودکار.»*
- **بسته‌های تقویتی** (*Self-service Booster Pack*) را می‌توانید با موجودی از کنسول بخرید و سهمیه خود را فوراً افزایش دهید؛ آن‌ها ساعت 2 بامداد به وقت پکن (UTC+8) بازنشانی می‌شوند.
- **بسته‌های پرداخت به‌ازای مصرف**: تمدیدها روی همان کلید بسته انباشته می‌شوند و تاریخ انقضا، دیرترِ تاریخ انقضای فعلی و امروز + تعداد روزهای بسته است؛ اگر بعداً پلن شخصی می‌خواهید، فقط آن را بخرید و بسته تا زمان انقضا به کار خود ادامه می‌دهد. بسته‌ها غیرقابل بازپرداخت هستند؛ قواعد در [بسته‌های پرداخت به‌ازای مصرف](/docs/reference/payg-packs) آمده است.
- **ارتقاها** دکمه‌ای در کنسول نیستند: ابتدا پلن بالاتر را بخرید، سپس به [hi@qcode.cc](mailto:hi@qcode.cc) ایمیل بزنید تا پلن قدیمی بسته شود و ارزش استفاده‌نشده آن به موجودی شما برگردد.
## کلیدهای فرعی و قابلیت‌های تیمی

کنسول شخصی **یک کلید اصلی به‌ازای هر پلن** را مدیریت می‌کند (و یک کلید بسته به‌ازای هر حساب کاربری برای بسته‌های پرداخت به‌ازای مصرف) — هیچ صفحه خودخدمتی برای کلید فرعی در آن وجود ندارد. کلیدهای فرعی بخشی از محصولات تیمی هستند:

- صفحه **پلن تیمی** یک *مرکز مدیریت کلیدهای فرعی API* را با *«پیکربندی و مدیریت دقیق برای هر عضو تیم»* توصیف می‌کند و جدول مقایسه پلن‌ها *کلیدهای فرعی نامحدود، هر یک با سهمیه اختصاصی خود* را فهرست می‌کند. این نسخه همچنین **پشتیبانی از انتقال بانکی** و **توافق‌نامه‌های خدمات سفارشی** را فهرست می‌کند. مراحل: [راهنمای پلن تیمی](/docs/reference/enterprise-guide).
- در صفحه اشتراک، کارت تیمی *«مدیریت انعطاف‌پذیر سهمیه و کلید فرعی»* را تبلیغ می‌کند و به [hi@qcode.cc](mailto:hi@qcode.cc) ارجاع می‌دهد.
- خود کنسول تنها **معرفی** تیمی را ارائه می‌دهد — یک گزینه **تیمی / سازمانی** در پنجره خوش‌آمدگویی و یک پنجره *قابلیت‌های تیمی* برای پلن تیمی («مدیریت چند حساب کاربری برای همکاری تیمی»، «خدمات سفارشی…»، «پشتیبانی فنی اختصاصی…»).
- **نمایندگان فروش** یک داشبورد شرکای جداگانه با امکان صدور کلید فرعی دریافت می‌کنند که در [راهنمای Open API شرکا](/docs/reference/partner-api) پوشش داده شده است.

## توکن دسترسی Open API

کارت **Open API** می‌گوید: *«از یک توکن دسترسی برای استعلام برنامه‌ای تاریخ انقضا و مصرف روزانه کلیدهای API خود استفاده کنید.»* گزینه **مدیریت توکن** (Manage Token) صفحه `/dashboard/openapi-token` را باز می‌کند، جایی که می‌توانید توکن را تولید، بازنشانی یا باطل کنید:

```bash
curl -H "Authorization: Bearer qot_..." \
  https://qcode.cc/api/v1/openapi/keys
```

- دو نقطه پایانی فقط‌خواندنی در آن صفحه فهرست شده است: یکی برای تاریخ انقضا و مصرف همه کلیدهای فعال شما، و یکی برای خلاصه مصرف در سطح حساب کاربری.
- توکن فقط **یک بار** نمایش داده می‌شود: *«توکن جدید شما (فقط یک بار نمایش داده می‌شود) — همین حالا آن را کپی کنید»*، و *«ما فقط یک هش ذخیره می‌کنیم — اگر آن را گم کنید، بازنشانی کنید تا توکن جدیدی دریافت کنید (توکن قدیمی بلافاصله از کار می‌افتد).»*
- بازنشانی و باطل‌سازی هر دو درخواست تأیید می‌کنند، و باطل‌سازی دسترسی به Open API را تا زمانی که توکن جدیدی تولید کنید غیرفعال می‌کند.
- این توکن شخصی با `qot_` شروع می‌شود. این توکن نماینده فروش **نیست**: شرکا یک توکن `rsk_` در **داشبورد شرکا** زیر «Open API / Access Token» دریافت می‌کنند و آن توکن به Partner Open API (موجودی، مصرف، مدیریت کلید فرعی) مجوز می‌دهد. این دو قابل‌تبادل نیستند — به [راهنمای Open API شرکا](/docs/reference/partner-api) مراجعه کنید.

## پرسش‌های پشتیبانی و سفارش

- خط **پشتیبانی** کنسول: *«روزهای هفته 10:00 - 21:00 (UTC+8) پاسخ آنلاین»*، با پیام‌های خارج از ساعت کاری *«به‌صورت متناوب بررسی می‌شود، پاسخ‌ها ممکن است با تأخیر همراه باشد»*، و *«ایمیل در هر زمان در دسترس است: hi@qcode.cc»*.
- پشتیبانی زنده همان دکمه **تماس با ما** در گوشه پایین-راست است (Telegram یا ایمیل).
- **درخواست پردازش فوری** دلیل انتظار را توضیح می‌دهد: حساب‌های تازه‌تأمین‌شده در ساعات کاری یک تا دو ساعت زمان می‌برند تا اعمال و پیکربندی شوند.
- لینک‌های سریع همچنین شامل **راهنمای مصرف** (پایگاه دانش) و **کدهای خطای رایج** است؛ برای علائم و راه‌حل‌ها به [راهنمای عیب‌یابی](/docs/reference/troubleshooting) و [مرجع کدهای خطا](/docs/reference/errors) مراجعه کنید.

## صفحات مرتبط

- [مرور روش‌های پرداخت](/docs/reference/payment-methods) — کدام روش‌ها برای شارژ حساب پذیرفته می‌شوند
- [توضیحات صورت‌حساب](/docs/reference/billing) — چگونه مصرف به مبلغ تبدیل می‌شود
- [بسته‌های پرداخت به‌ازای مصرف](/docs/reference/payg-packs) — قیمت بسته‌ها، تمدید و انقضا
- [چگونه یک پلن انتخاب کنیم](/docs/getting-started/choose-a-plan) — چهار گزینه در کنار هم
- [نقاط پایانی و مسیرهای API](/docs/getting-started/endpoints-and-api-paths) — آدرس به‌همراه پیشوند مسیر
- [متغیرهای محیطی](/docs/getting-started/environment) — کجا قرار گیرند
- [اسکریپت نصب یک‌کلیکی](/docs/getting-started/one-click-install) — دستورهای کنسول چه کاری انجام می‌دهند
- [اشتراک‌ها در برابر کلیدهای API در برابر کلیدهای QCode](/docs/reference/subscription-vs-api-key)
- [راهنمای پلن تیمی](/docs/reference/enterprise-guide) — کلیدهای فرعی و انتقال سازمانی
- [راهنمای Open API شرکا](/docs/reference/partner-api)
- [پرسش‌های متداول](/docs/reference/faq)