پرسش‌های متداول

پرسش‌های متداول درباره Claude Code و QCode.cc

به کلید API نیاز دارید؟ ثبت‌نام ←·نقاط پایانی و Base URL ←

پلتفرم QCode.cc¶

پرسش: کلید API خود را از کجا دریافت می‌کنم؟¶

پاسخ: به داشبورد QCode.cc وارد شوید و کلید API خود را در صفحه «API Key Management» ایجاد یا مشاهده کنید.

پرسش: کلید API از چه پیشوندی استفاده می‌کند؟¶

پاسخ: کلیدهای API در QCode.cc با cr_ شروع می‌شوند، برای مثال cr_xxxxxxxxxxxxxx.

پرسش: چرا کلید API من کار نمی‌کند؟¶

پاسخ: دلایل رایج:

1. خطای کپی: فاصله‌های اضافی یا کاراکترهای جاافتاده را بررسی کنید
2. اشتراک منقضی شده: وضعیت حساب کاربری خود را در داشبورد بررسی کنید
3. متغیر محیطی اعمال نشده: ترمینال را دوباره باز کنید یا source ~/.zshrc را اجرا کنید
4. نقطه پایانی API نادرست: مطمئن شوید ANTHROPIC_BASE_URL روی https://api.qcode.cc/api تنظیم شده است

پرسش: کلید API من لو رفته است — چگونه آن را جایگزین کنم؟¶

پاسخ: بستگی دارد به این که کدام کلید باشد:

• کلید API اصلی (با cr_ شروع می‌شود): آن را خودتان در کنسول بازنشانی کنید — روی کارت کلید، روی «⋯» در سمت راست خط «API Key:» کلیک کنید → «Reset API Key…». یک کلید جدید دریافت می‌کنید، کلید قدیمی ظرف 1 دقیقه از کار می‌افتد، و سهمیه، مصرف و تاریخ انقضای شما ثابت می‌ماند. برای هر بازنشانی هزینه کمی دریافت می‌شود (مبلغ در کنسول نمایش داده می‌شود)، و هر کلید حداکثر هر 3 روز یک بار قابل بازنشانی است. اگر فقط کلید را فراموش کرده‌اید، نیازی به بازنشانی نیست — روی نماد 👁 کنار آن کلیک کنید. چند کلید فقط با کمک گفت‌وگوی زنده یا hi@qcode.cc قابل بازنشانی هستند. همچنین بهترین شیوه‌های امنیتی را دنبال کنید تا بررسی کنید آیا کلید به تاریخچه Git یا لاگ‌های شما رسیده است یا نه.
• توکن دسترسی Open API (با qot_ شروع می‌شود، شخصی): فقط‌خواندنی است، در کنسول زیر Open API (/dashboard/openapi-token) تولید می‌شود؛ آن را همان‌جا بازنشانی یا باطل کنید. توکن قدیمی بلافاصله از کار می‌افتد. راهنمای داشبورد را ببینید.
• توکن دسترسی نمایندگان فروش (با rsk_ شروع می‌شود، فقط برای نمایندگان فروش): در داشبورد نمایندگان فروش زیر «Open API / Access Token» صادر می‌شود، نه در کنسول شخصی. همان‌جا روی بازنشانی کلیک کنید. توکن قدیمی بلافاصله از کار می‌افتد. Open API نمایندگان فروش را ببینید.

مصرف و پلن‌ها¶

پرسش: چگونه مصرف نشست فعلی خود را بررسی کنم؟¶

پاسخ: دو روش وجود دارد:

داشبورد (توصیه‌شده): به داشبورد وارد شوید و تعداد فراخوانی مدل، تفکیک هزینه و مصرف پلن را در صفحه «آمار مصرف» ببینید.

بررسی سریع در CLI: از فرمان /cost برای دیدن خلاصه نشست فعلی استفاده کنید:

/cost

محاسبه هزینه داشبورد بر اساس جدول قیمت‌گذاری qcode.cc/models است که دقیق‌تر از نمایش CLI است.

پرسش: آیا سقف سهمیه ماهانه برای Ultimate و پلن تیمی وجود دارد؟¶

پاسخ: بله. هر پلن Ultimate و هر واحد از پلن تیمی، سقف $4,000 در ماه دارد (بازنشانی ماهانه؛ سهمیه استفاده‌نشده منتقل نمی‌شود). اکثریت قاطع کاربران هرگز به این سقف نمی‌رسند. برای نیازهای مصرف غیرعادی بالا، با پشتیبانی تماس بگیرید.

پرسش: محدودیت‌های درخواست‌های هم‌زمان و بازه زمانی برای هر پلن چیست؟¶

پاسخ:

محدودیت‌های درخواست‌های هم‌زمان:

• پلن‌های شخصی: 5 درخواست هم‌زمان به ازای هر کلید API؛ Ultimate: 10 درخواست هم‌زمان به ازای هر کلید API
• بسته‌های پرداخت به‌ازای مصرف: 5 درخواست هم‌زمان به ازای هر کلید API
• پلن تیمی: 35 درخواست هم‌زمان به ازای هر واحد؛ 3–5 کاربر برای هر واحد توصیه می‌شود

محدودیت بازه زمانی 4 ساعته:

• پلن‌های شخصی: از ژوئیه 2026 کاملاً حذف شده است — هیچ‌گونه محدودیت بازه زمانی وجود ندارد؛ سقفی که اعمال می‌شود سقف روزانه شماست (بازنشانی در 00:00 به وقت پکن)، یا سهمیه ماهانه در Ultimate
• پلن تیمی: هیچ محدودیت بازه زمانی ندارد و از توسعه پیوسته پشتیبانی می‌کند

پرسش: مطمئن نیستم کدام سطح را بخرم — اگر با سطح پایین‌تر شروع کنم، می‌توانم ارتقا دهم؟¶

پاسخ: بله. اگر مطمئن نیستید چقدر سهمیه نیاز دارید، با پلن Starter ($9/mo) شروع کنید. هر زمان آماده بودید، پلنی با سهمیه بالاتر بخرید و برای بستن پلن قدیمی به hi@qcode.cc ایمیل بزنید — زمان استفاده‌نشده آن به‌نسبت به موجودی QCode شما برگشت داده می‌شود و ظرف 1 روز کاری انجام می‌شود. تیم‌ها و نمایندگان فروش نیز می‌توانند ابتدا یکپارچه‌سازی را روی Starter اعتبارسنجی کنند و بعداً ارتقا دهند.

پرسش: تفاوت بین بسته پرداخت به‌ازای مصرف و پلن شخصی چیست؟¶

پاسخ: پلن شخصی یک سهمیه روزانه دارد که در 00:00 به وقت پکن بازنشانی می‌شود و برای استفاده روزانه مناسب است؛ بسته یک سهمیه کل برای مدت اعتبار آن است (بسته Small / Medium / Large / XL، همه به مدت 7 روز معتبر)، تا زمانی که تمام شود استفاده می‌شود و برای دوره‌های استفاده مناسب است. کلید به همان شکل کار می‌کند، با هم‌زمانی 5 و همان مدل‌ها. تا زمانی که پلن شخصی فعال دارید نمی‌توانید بسته بخرید (وقتی سهمیه روزانه پلن شخصی کافی نیست، از بسته تقویتی استفاده کنید). برای مقایسه کامل چگونه یک پلن انتخاب کنیم را ببینید و برای قوانین، بسته‌های پرداخت به‌ازای مصرف را ببینید.

پرسش: وقتی سهمیه تمام شود چه اتفاقی می‌افتد؟¶

پاسخ: پاسخ HTTP 402 است با error.type = insufficient_quota، و code مشخص می‌کند کدام سهمیه است: daily_cost_limit_exceeded سهمیه روزانه است که در 00:00 به وقت پکن بازنشانی می‌شود (بسته تقویتی هم کمک می‌کند)؛ total_cost_limit_exceeded سهمیه کل است (بسته‌های پرداخت به‌ازای مصرف، سهمیه ماهانه Ultimate)، و برای یک بسته کافی است آن را تمدید کنید؛ سقف هفتگی مدل‌های Claude نیز 402 برمی‌گرداند. یک کلید منقضی 401 برمی‌گرداند، نه 402، و تمدید یک بسته آن را بازیابی می‌کند. کدهای خطا را ببینید.

پرسش: آیا بازپرداخت وجود دارد؟¶

پاسخ: ما کالای دیجیتال شبکه‌ای می‌فروشیم. پس از فعال‌سازی، منابع اشغال می‌شوند، بنابراین از بازپرداخت پشتیبانی نمی‌شود. بسته‌های پرداخت به‌ازای مصرف نیز قابل بازپرداخت نیستند و سهمیه باقی‌مانده پس از انقضا باطل می‌شود.

تنها استثنا ارتقا است: پس از خرید پلنی با سهمیه بالاتر، به hi@qcode.cc ایمیل بزنید تا زمان استفاده‌نشده پلن قدیمی به‌نسبت به موجودی QCode شما برگشت داده شود (به موجودی شما، نه به روش پرداخت اصلی).

جایگزین انتقال موجودی: انتقال بین اعضای QCode پشتیبانی می‌شود. پس از یافتن خریدار، ایمیلی به hi@qcode.cc با مبلغ انتقال و آدرس ایمیل حساب QCode گیرنده بفرستید. انتقال‌ها ظرف 1 روز کاری تکمیل می‌شوند.

بازپرداخت ممکن است فقط در شرایط زیر و به‌صورت موردبه‌مورد ارائه شود: قطعی پلتفرم که بیش از 24 ساعت وقفه در سرویس ایجاد کند؛ خاتمه یک‌جانبه سرویس توسط پلتفرم در حالی که موجودی باقی مانده است؛ یا گزارش یک شارژ حساب اشتباه ظرف 24 ساعت بدون این که مصرفی رخ داده باشد.

پرسش: من اشتراک Claude Pro / ChatGPT Plus دارم — آیا می‌توانم از آن با QCode استفاده کنم؟¶

پاسخ: خیر. اشتراک، عضویت در اپلیکیشن‌های رسمی است و هیچ سهمیه API ندارد؛ QCode بر اساس توکن صورت‌حساب می‌کند. این دو سیستم مستقل هستند و می‌توانند هم‌زمان وجود داشته باشند — جزئیات در اشتراک‌ها در مقابل کلیدهای API در مقابل کلیدهای QCode.

پرسش: کدام ابزارها پشتیبانی می‌شوند؟¶

پاسخ: Claude Code، Codex، افزونه‌های IDE / CLI و کلاینت‌های دسکتاپ همگی صفحه‌های راه‌اندازی زیر «Connect Your Tool» دارند؛ برای این که هر ابزار با کدام پروتکل صحبت می‌کند و آیا مدل‌های Claude با آن کار می‌کنند، نمای کلی سازگاری ابزارها را ببینید.

پرسش: آیا از انتقال بانکی شرکتی پشتیبانی می‌کنید؟¶

پاسخ: پلن تیمی از انتقال بانکی شرکتی و قرارداد خدمات رسمی پشتیبانی می‌کند. راهنمای پلن تیمی را ببینید.

پرسش: خطای daily_cost_limit_exceeded (HTTP 402) دریافت کردم — حالا چه کار کنم؟¶

پاسخ: سقف روزانه سقف هزینه API در هر روز است و در 00:00 به وقت پکن بازنشانی می‌شود. دو راه حل وجود دارد:

1. خرید بسته تقویتی: خودتان آن را در کنسول بخرید تا سهمیه امروز بلافاصله افزایش یابد. بسته‌های تقویتی جداگانه در 02:00 به وقت پکن روز بعد بازنشانی می‌شوند — دو ساعت پس از سقف روزانه، که اگر بعد از نیمه‌شب کار کنید یک حاشیه امن باقی می‌گذارد.
2. افزایش سقف روزانه: پلن خود را در qcode.cc/pricing تنظیم کنید.

این خطا به‌صورت HTTP 402 با error.type = insufficient_quota و code = daily_cost_limit_exceeded می‌آید (کدهای خطا را ببینید).

محدودیت بازه غلتان 4 ساعته در ژوئیه 2026 از همه پلن‌های شخصی حذف شد، بنابراین این پیام فقط می‌تواند از سقف روزانه بیاید، هرگز از یک محدودیت بازه زمانی.

پرسش: «محدودیت هزینه کل» (total_cost_limit_exceeded) به چه معناست؟¶

پاسخ: سهمیه کل شما تمام شده است: HTTP 402 با error.type = insufficient_quota و code = total_cost_limit_exceeded. سهمیه کل برای کلیدهایی اعمال می‌شود که بر اساس سهمیه کل صورت‌حساب می‌شوند، برای مثال بسته‌های پرداخت به‌ازای مصرف و سهمیه ماهانه پلن Ultimate. مبلغ داخل پرانتز در پیام (برای مثال $100) سقف تجمعی کلید است، نه مقدار باقی‌مانده.

نحوه بازیابی آن به قوانین پلن شما بستگی دارد: برای یک بسته، تمدید کافی است؛ برای مثال سهمیه ماهانه Ultimate در هر بازنشانی ماهانه شارژ می‌شود. اگر پیش از بازنشانی تمام شده باشد، یا مطمئن نیستید کدام نوع برای شما اعمال می‌شود، به hi@qcode.cc ایمیل بزنید یا از گفت‌وگوی زنده استفاده کنید. این نوع 402 با ارسال مجدد از بین نمی‌رود، بنابراین حلقه تلاش مجدد فایده‌ای ندارد. کدهای خطا را ببینید.

پرسش: آیا سرورهای ابری و سرویس هوش مصنوعی یک چیز هستند؟ آیا باید یک پلن هوش مصنوعی هم بخرم؟¶

پاسخ: آن‌ها محصولات جداگانه‌ای هستند که مستقل فروخته می‌شوند و فقط یک موجودی حساب کاربری مشترک دارند. سرور ابری یک ماشین خارج از کشور با IPv4 عمومی اختصاصی و دسترسی کامل root است که برای مدت انتخابی شما (1، 3، 6 یا 12 ماه) شارژ می‌شود؛ سرویس هوش مصنوعی بر اساس توکن صورت‌حساب می‌شود. می‌توانید بدون هیچ پلن هوش مصنوعی یک سرور ابری بخرید: Claude Code یا Codex را روی آن نصب کنید و مدل‌ها را با کلید QCode خود فراخوانی کنید. انتخاب ماشین در سرورهای ابری: انتخاب، خرید و استفاده، قوانین صورت‌حساب و بازپرداخت سمت سرور در صورت‌حساب و قوانین سرور ابری، و راه‌اندازی به‌همراه عامل‌های طولانی‌مدت در اجرای عامل‌ها روی سرور ابری توضیح داده شده است.

مرجع سریع¶

پرسش: من همین حالا یک پلن خریدم — چگونه شروع به استفاده از آن کنم؟¶

پاسخ: سه مرحله، حدود 60 ثانیه:

1. دریافت کلید: وارد داشبورد شوید → «API Key Management» و کلیدی را که با cr_ شروع می‌شود کپی کنید.
2. پیکربندی: اسکریپت راه‌اندازی یک‌کلیکی را اجرا کنید، یا ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN را به‌صورت دستی تنظیم کنید (نقاط پایانی و قالب‌های API را ببینید).
3. ابزار خود را انتخاب کنید: IDE یا CLI خود را در اتصال ابزار شما پیدا کنید و آن صفحه را دنبال کنید.

یک کلید هم‌زمان Claude Code، Codex، Gemini و مدل‌های چینی را راه می‌اندازد و همه در همان سهمیه پلن مشترک‌اند.

پرسش: چگونه Claude Code را نصب کنم؟¶

پاسخ: به‌صورت سراسری با npm نصب کنید، سپس متغیرهای محیطی را پیکربندی کنید:

npm install -g @anthropic-ai/claude-code

مراحل تفصیلی (شامل دستورالعمل‌های هر سه پلتفرم) → راهنمای نصب

پرسش: چگونه پروکسی QCode.cc را پیکربندی کنم؟¶

پاسخ: متغیرهای محیطی زیر را تنظیم کنید:

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_api_key"

توصیه می‌کنیم این‌ها را به فایل پیکربندی شل خود (~/.zshrc یا ~/.bashrc) اضافه کنید. ببینید → راهنمای نصب

پرسش: چگونه وارد حالت Plan Mode می‌شوم؟¶

پاسخ: Shift+Tab را فشار دهید تا نشانگر حالت عبارت plan را نشان دهد (سه بار از حالت خودکار پیش‌فرض، دو بار از حالت دستی default). همچنین می‌توانید با --permission-mode plan شروع کنید، یا حالت پیش‌فرض را در .claude/settings.json تنظیم کنید:

{ "permissions": { "defaultMode": "plan" } }

در حالت Plan Mode، Claude درخواست شما را بدون اجرای هیچ اقدامی تحلیل می‌کند.

پرسش: چگونه مدل را تغییر دهم؟¶

پاسخ: از فرمان /model استفاده کنید:

/model opus
/model sonnet

پرسش: چگونه از Claude بخواهم تغییرات را ثبت یا کد را بازبینی کند؟¶

پاسخ: از /commit برای ایجاد یک کامیت و از /review برای انجام بازبینی کد استفاده کنید. همچنین می‌توانید مستقیماً به Claude بگویید: «این تغییرات را کامیت کن» یا «این PR را بازبینی کن».

پرسش: چگونه یک باگ را گزارش کنم؟¶

پاسخ: به GitHub Issues مراجعه کنید و مراحل بازتولید را همراه با هر اطلاعات خطای مرتبط ارائه دهید.

پرسش: آیا Claude می‌تواند تصویر تولید کند؟¶

پاسخ: مدل‌های Claude می‌توانند تصاویر را بخوانند اما آن‌ها را تولید نکنند (برای ورودی تصویر، ورودی تصویر را ببینید).

برای تولید تصویر از gpt-image-2 استفاده کنید — این مدل از کلید cr_ موجود شما استفاده می‌کند، کاملاً با OpenAI سازگار است و هم از تبدیل متن به تصویر و هم از ویرایش تصویر پشتیبانی می‌کند. تولید و ویرایش تصویر با gpt-image-2 را ببینید.

کمک بیشتر¶

چیزی که به دنبال آن هستید پیدا نمی‌کنید؟ این مستندات موضوع‌محور را بررسی کنید:

تماس با پشتیبانی: از چت زنده در گوشه پایین‌راست وب‌سایت استفاده کنید، یا به hi@qcode.cc ایمیل بزنید.

سازمانی ←