الأسئلة الشائعة

الأسئلة الشائعة حول 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…». ستحصل على مفتاح جديد، ويتوقف المفتاح القديم عن العمل خلال دقيقة واحدة، وتبقى حصتك واستخدامك وتاريخ انتهاء الصلاحية كما هي. تُفرض رسوم صغيرة على كل إعادة تعيين (يظهر المبلغ في وحدة التحكم)، ويمكن إعادة تعيين كل مفتاح مرة واحدة كل 3 أيام على الأكثر. إذا نسيت المفتاح فقط، فلا حاجة إلى إعادة التعيين — انقر على أيقونة 👁 المجاورة له. بعض المفاتيح يمكن إعادة تعيينها فقط بمساعدة الدردشة المباشرة أو hi@qcode.cc. اتبع أيضًا أفضل ممارسات الأمان للتحقق مما إذا كان المفتاح قد وصل إلى سجل Git أو السجلات لديك.
• token وصول Open API (يبدأ بـ qot_، شخصي): للقراءة فقط، يُنشأ في وحدة التحكم ضمن Open API (/dashboard/openapi-token)؛ أعد تعيينه أو ألغِه هناك. يتوقف token القديم عن العمل فورًا. راجع دليل لوحة التحكم.
• token وصول الشريك (يبدأ بـ rsk_، للموزّعين فقط): يُصدر في Partner Dashboard ضمن «Open API / Access Token»، وليس في وحدة التحكم الشخصية. انقر على Reset هناك. يتوقف 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 بالتناسب، ويُنجز ذلك خلال يوم عمل واحد. يمكن للفرق والموزّعين أيضًا التحقق من التكامل على 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 الخاص بالمستلم. تُنجز التحويلات خلال يوم عمل واحد.

قد يُمنح الاسترداد على أساس كل حالة على حدة فقط في الحالات التالية: انقطاع في المنصة يتسبب في توقف الخدمة أكثر من 24 ساعة؛ أو إنهاء المنصة للخدمة من جانب واحد مع بقاء رصيد؛ أو الإبلاغ عن شحن رصيد بالخطأ خلال 24 ساعة دون حدوث أي استخدام.

س: لدي اشتراك Claude Pro / ChatGPT Plus — هل يمكنني استخدامه مع QCode؟¶

ج: لا. الاشتراك هو عضوية في التطبيقات الرسمية ولا يتضمن أي حصة API؛ تحاسب QCode لكل token. النظامان مستقلان ويمكن أن يتواجدا معًا — التفاصيل في الاشتراكات مقابل مفاتيح 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 شهرًا)؛ أما خدمة الذكاء الاصطناعي فتُحاسب لكل token. يمكنك شراء خادم سحابي دون أي خطة ذكاء اصطناعي: ثبّت 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"

نوصي بإضافتها إلى ملف إعداد shell لديك (~/.zshrc أو ~/.bashrc). انظر → دليل التثبيت

س: كيف أدخل وضع الخطة؟¶

ج: اضغط Shift+Tab حتى يعرض مؤشر الوضع الخطة (ثلاث مرات من الوضع التلقائي الافتراضي، ومرتين من وضع default اليدوي). يمكنك أيضًا البدء باستخدام --permission-mode plan، أو ضبط الوضع الافتراضي في .claude/settings.json:

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

في وضع الخطة، يحلل Claude طلبك دون تنفيذ أي إجراءات.

س: كيف أبدّل النماذج؟¶

ج: استخدم الأمر /model:

/model opus
/model sonnet

س: كيف أجعل Claude ينشئ commit أو يراجع الشيفرة نيابة عني؟¶

ج: استخدم /commit لإنشاء commit و/review لإجراء مراجعة للشيفرة. ويمكنك ببساطة أن تقول لـ Claude مباشرة: «أنشئ commit لهذه التغييرات» أو «راجع طلب السحب هذا».

س: كيف أبلّغ عن خطأ؟¶

ج: زُر مشكلات GitHub وقدّم خطوات إعادة الإنتاج مع أي معلومات أخطاء ذات صلة.

س: هل يستطيع Claude إنشاء صور؟¶

ج: تستطيع نماذج Claude قراءة الصور لكنها لا تستطيع إنشاءها (لإدخال الصور راجع إدخال الصور).

لإنشاء الصور استخدم gpt-image-2 — فهو يشارك مفتاحك الحالي cr_، ومتوافق كليًا مع OpenAI، ويدعم التحويل من النص إلى الصورة وتحرير الصور معًا. انظر إنشاء الصور وتحريرها باستخدام gpt-image-2.

مزيد من المساعدة¶

لم تجد ما تبحث عنه؟ راجع هذه الوثائق المتخصصة بالموضوع:

تواصل مع الدعم: استخدم الدردشة المباشرة في الزاوية السفلية اليمنى من الموقع، أو أرسل بريدًا إلكترونيًا إلى hi@qcode.cc

المؤسسات ←