وثائق QCode

مقدمة إلى Claude Code

تعرّف على Claude Code، وكيف يقارن بالمنافسين، وكيف تستخدمه عبر QCode.cc

كيف تختار خطة

كيف تختلف الخطط الأربع في الحصة والصلاحية والتزامن وإعادة البيع، بالإضافة إلى سؤالين لاختيار خطة واحدة: الخطة الشخصية، أو الباقات، أو خطة الفرق، أو الشريك.

خوادم السحابة: الاختيار والشراء والاستخدام

خادم السحابة الأول لك: عنوان IPv4 مخصص، وصول root كامل، خطوط في خمس دول، كيفية اختيار الخط، التجربة لمدة يوم واحد، وكيفية عمل التسليم.

QCode للمستخدمين خارج البر الرئيسي للصين

إنشاء حساب، والدفع بالدولار الأمريكي، واختيار نطاق الوصول المناسب، وتبديل لغة الوثائق للمطورين خارج البر الرئيسي للصين

سكربت الإعداد بنقرة واحدة

أمر واحد لإعداد Claude Code / Codex بالكامل: اختيار نقطة النهاية حسب زمن الاستجابة، وكتابة الإعدادات، وتثبيت CLI، والتحقق من الاتصال — دون الحاجة إلى sudo أو صلاحيات المدير

نقاط النهاية ومسارات API

بروتوكولا API لكل من Anthropic وOpenAI في QCode.cc (مسار Gemini غير متاح حاليًا)، وثلاثة نطاقات وصول، وكيفية تعبئة BASE_URL

التثبيت

ثبّت Claude Code واضبط إعداداته على Windows وmacOS وLinux

متغيرات بيئة Claude Code (2026)

عيّن ANTHROPIC_BASE_URL وANTHROPIC_AUTH_TOKEN لـ Claude Code على QCode.cc، واطّلع على كيفية اختلاف ANTHROPIC_API_KEY، إضافةً إلى إعدادات كل أداة والتحقق منها.

البدء السريع

تعلّم أساسيات Claude Code في 5 دقائق

بدء سريع مع Codex CLI (2026): الإعداد في 5 دقائق

ثبّت Codex CLI ووصّله بـ QCode.cc في نحو 5 دقائق: سكربت بنقرة واحدة أو إعداد يدوي عبر config.toml + auth.json، ثم أول مهمة. المفتاح نفسه المستخدم في Claude Code.

دليل Claude Code التعليمي: التثبيت والتشغيل (2026)

أقصر مسار من التثبيت إلى أول تشغيل: أمر واحد يهيئ Claude Code مع QCode، ثم أضف مفتاحك cr_ وابدأ. دليل تعليمي كامل لعام 2026.

Codex مقابل Claude Code 2026: متى تستخدم كلًا منهما

Codex CLI مقابل Claude Code في 2026: وكيل مستقل داخل بيئة معزولة مقابل برمجة ثنائية تفاعلية عبر 15+ بُعدًا، ومتى تختار كلًا منهما، وكيف تجمعهما.

نظرة عامة على توافق الأدوات

مصفوفة التوافق الكامنة خلف كل صفحة تكامل في هذا الموقع: البروتوكول الذي تستخدمه كل أداة، وما إذا كانت نماذج Claude تعمل معها، وأين يوجد إعدادها، ومتى جرى آخر تحقق من كل صفحة

تنزيل CC Switch: أحدث إصدار v4.0.28 والإعداد

CC Switch v4.0.28 (2026-11-08): ccswitch.io هو الموقع الرسمي الوحيد. نزّل من GitHub Releases، ثم أضف QCode.cc إلى Claude Code أو Codex CLI.

إعداد magpie مع QCode: Claude Code وCodex

وجّه magpie إلى QCode: املأ عناوين anthropic وchat وresponses، وأضف المزوّد عبر رابط استيراد أو أمر واحد، ثم اختر النماذج.

Codex CLI 0.167.0: التثبيت وconfig.toml

Codex CLI 0.167.0 (2026-11-06): ثبّته، واربط QCode.cc عبر ~/.codex/config.toml وauth.json، ثم استخدم AGENTS.md والموافقات وملفات التعريف وMCP.

إعداد API الطرف الثالث في Claude Desktop (2026)

Claude Desktop دون تسجيل الدخول: مكّن وضع المطور، وافتح تكوين الاستدلال من طرف ثالث، وأضف QCode.cc بوصفه البوابة؛ حصة واحدة مشتركة مع واجهات CLI لديك.

إعداد OpenCode 2.1.4: Claude وGPT (2026)

OpenCode 2.1.4 (2026-10-23): ربط QCode.cc في opencode.json عبر إدخالات anthropic وopenai baseURL، ثم حفظ المفتاح من خلال /connect.

تكامل OpenClaw

اضبط QCode.cc كمزوّدات نماذج لـ OpenClaw: كتلة models.providers في openclaw.json، ومعالج إعداد المزوّد المخصص، وكيفية التحقق من الاتصال

إعداد LobsterAI مع QCode (نموذج مخصص)

أضف QCode إلى LobsterAI كنموذج مخصص: Settings → Custom Model، وأي API Format تختار، وBase URL الدقيق لنماذج Claude وGPT والنماذج الصينية.

إعداد AutoClaw مع QCode (نموذج مخصص)

أضف QCode.cc إلى AutoClaw من Zhipu كنموذج مخصص ببروتوكول OpenAI: أين تنقر، وBase URL، وأمثلة حية لمعرّفات النماذج، واختبار الاتصال.

تكامل Hermes Agent

وجّه Hermes Agent (Nous Research) نحو QCode.cc عبر مزوّدين مخصصين في config.yaml: قيم النقل الثلاث، والمفاتيح في .env، وتبديل النماذج أثناء الجلسة

إعداد نموذج مخصص في WorkBuddy مع QCode

كيفية إضافة QCode.cc كنموذج مخصص في WorkBuddy: نقاط الدخول في الصين والعالم، ومسارات models.json، ورابط نقطة النهاية، والخطأ 4100، ومعرّفات نماذج GPT والنماذج الصينية.

نماذج CodeBuddy المخصصة مع QCode

أضف QCode.cc إلى CodeBuddy عبر models.json: تم اختبار Chat وResponses مع CodeBuddy Code CLI 2.182.0، دون الحاجة إلى تسجيل الدخول؛ JSON جاهز للنسخ ومتغيرات البيئة.

إعداد Antigravity CLI (agy): مفتاح API (2026)

اضبط Google Antigravity CLI (agy) باستخدام مفتاح QCode.cc: عيّن modelProvider في settings.json، ثم وجّه GEMINI_API_KEY وGOOGLE_GEMINI_BASE_URL إلى نقطة نهاية Gemini لدى QCode

إعداد DeepSeek-TUI (CodeWhale 0.10.2) 2026

CodeWhale v0.10.2 (2026-10-24)، سابقًا DeepSeek-TUI: الملف التنفيذي codewhale، وملف الإعدادات ~/.codewhale/config.toml. اربط QCode.cc عبر مزوّد anthropic أو openai.

إعداد T3 Code مع QCode.cc

اربط T3 Code v0.1.7 بـ QCode.cc: عيّن ANTHROPIC_BASE_URL وANTHROPIC_AUTH_TOKEN على مثيل Claude، وأضف نموذجًا مخصصًا، ثم تحقّق.

إعداد DeepSeek Harness (dsh) مع QCode

اربط DeepSeek Harness (dsh) 0.2.2-rc.1 بـ QCode.cc عبر واجهة API المخصصة للنماذج: OpenAI Chat Completions لـ GPT والنماذج الصينية، وAnthropic Messages لـ Claude.

إعداد Zed + Claude Code عبر ACP (v1.27.0)

Zed 1.27.0 (2026-11-04): شغّل Claude Code في لوحة الوكيل عبر ACP، أو أضف QCode.cc كمزوّد anthropic_compatible / openai_compatible في settings.json.

نظرة عامة على ACP

بروتوكول Agent Client Protocol: إعداد واحد يعمل عبر Zed وDevin Desktop وJetBrains — شغّل Claude Code بصفته وكيل ACP مع توجيه بيئته إلى QCode

تكامل VS Code

استخدام إضافة Claude Code ونقاط النهاية المخصصة في GitHub Copilot داخل VS Code: تثبيت الإضافة، وإعداد primaryApiKey، وتوصيل QCode عبر chatLanguageModels.json

تكامل GitHub Copilot

استخدم QCode.cc عبر نقاط النهاية المخصصة في GitHub Copilot: chatLanguageModels.json في VS Code 1.122+ مع قيم apiType الثلاث (messages / chat-completions / responses)، ومتغيرات BYOK في Copilot CLI، ونطاق الدعم في JetBrains

إعداد إضافة Claude Code في Trae

2026: ثبّت إضافة Claude Code في Trae IDE، واضبط primaryApiKey في ~/.claude/config.json، واتصل بـ QCode.cc؛ يغطي مسار .vsix دون اتصال الخاص بـ Trae CN.

إعداد مزوّد مخصص لـ ZCode (سطح المكتب وCLI)

اربط ZCode بـ QCode.cc كمزوّد مخصص: خطوات سطح المكتب وفق الوثائق الرسمية، وZCode CLI 0.17.1 مُختبَر على Anthropic وOpenAI Chat وResponses.

إعداد Qoder مع QCode (BYOK)

أضف QCode إلى إعدادات النماذج المخصصة في Qoder: OpenAI Compatible (Chat Completions أو Responses) لنماذج GPT والنماذج الصينية، وAnthropic Compatible لـ Claude.

إعداد Base URL ومفتاح API المخصصين في Cursor

اربط QCode بـ Cursor باستخدام Base URL مخصص من OpenAI أو Anthropic ومفتاح API: الإعداد، ومعرّفات النماذج، والميزات التي تبقى على نماذج Cursor المدمجة.

تكامل Cline

استخدم API QCode.cc مع إضافة Cline في VS Code

تكامل Cherry Studio

أضف QCode.cc كمزوّد مخصص في Cherry Studio: مسار الإعدادات إلى خدمات النماذج، وعنوان URL الذي يحتاجه كل نوع من أنواع المزوّدين الأربعة، ولماذا تتطلب ميزة Agent نقطة نهاية من نوع Anthropic

تكامل JetBrains IDE

استخدم Claude Code عبر QCode في IntelliJ IDEA وWebStorm وPyCharm وGoLand وغيرها من بيئات JetBrains IDE

إعداد Devin Desktop (المعروف سابقًا بـ Windsurf)

أصبح Windsurf الآن Devin Desktop ويقوم على ACP: أرفق Claude Code كوكيل ACP مع توجيه بيئته إلى QCode

دليل تكامل Gemini CLI

تهيئة Google Gemini CLI باستخدام مفتاح API من QCode.cc — مفاتيح المؤسسات المدفوعة؛ أُوقفت فئات Pro / المستهلكين في 2026-06-18 (لا يوفّر QCode Gemini في الوقت الحالي؛ للرجوع فقط)

إعداد Kilo Code

اربط QCode.cc في إضافة Kilo Code لـ VS Code: الإعدادات -> Providers -> Custom provider، مع ضبط Provider API على Anthropic Messages لـ Claude

إعداد Crush

أضف QCode.cc بصفته مزوّدًا مخصصًا في Charm Crush: type=anthropic مع base_url في crush.json، واستخدم Claude من الطرفية

إعداد Droid (Factory)

أضف QCode.cc كنموذج مخصص BYOK في Droid CLI من Factory: provider=anthropic مع baseUrl في ~/.factory/settings.json

دمج Aider

إعداد Aider مع QCode.cc: Claude عبر نقطة نهاية Anthropic (بادئة anthropic/)، وGPT والنماذج الصينية عبر نقطة النهاية المتوافقة مع OpenAI

إعداد API مخصص في SillyTavern (Claude، GPT)

اربط QCode بـ SillyTavern عبر وكيل Claude العكسي أو نقطة نهاية مخصصة متوافقة مع OpenAI: أسماء الحقول، والنماذج، وحدود توليد الصور (2026).

إعداد Roo Code

استخدم QCode.cc من إضافة Roo Code في VS Code: اختر مزوّد Anthropic، وحدّد Base URL المخصص، وسيعمل Claude

إعداد Qwen Code

اربط QCode بـ Qwen Code CLI عبر modelProviders في ~/.qwen/settings.json: عناوين Base URL المتوافقة مع Anthropic وOpenAI، و/model، و/doctor

إعداد Kimi Code CLI

اربط QCode.cc بـ Kimi Code CLI في ~/.kimi-code/config.toml: استخدم type anthropic مع Claude، وtype openai مع GPT والنماذج الصينية

إعداد MiniMax Code مع QCode (BYOK)

أضف QCode.cc إلى تطبيق MiniMax Code لسطح المكتب أو أداة mcode CLI: عناوين Base URL الخاصة بـ Anthropic وOpenAI Chat وResponses، والثلاثة جميعها مختبَرة مع mcode 0.7.6

إعداد المزوّد في Goose

توجيه مزوّدات goose المتوافقة مع Anthropic وOpenAI إلى QCode: أي حقل HOST يأخذ أي URL، وما لا يستطيع goose configure فعله

إعداد LobeChat

اربط QCode.cc في LobeChat / LobeHub: إدخالا المزوّد Anthropic وOpenAI، وحقل Proxy URL، ومتغيرات الاستضافة الذاتية.

تكامل Open WebUI

اربط QCode.cc بـ Open WebUI بوصفه اتصالًا متوافقًا مع OpenAI: صفحة الاتصالات في لوحة الإدارة، وقائمة معرّفات النماذج المسموح بها، وسبب عدم توفر Claude

دليل اختيار النموذج في Claude Code

اختر نموذج Claude لـ Claude Code حسب المهمة، إضافة إلى نماذج GPT عبر Codex CLI: معرّفات النماذج القابلة للاستدعاء، والتبديل عبر /model، والسيناريوهات؛ راجع qcode.cc/models (2026).

دليل تحسين التكلفة

أتقن تقنيات التحكم في تكلفة Claude Code لإنجاز المزيد باستخدام tokens أقل

إدارة السياق

فهم نافذة سياق Claude Code وإدارتها، واستخدام أوامر مثل /compact و/clear بفعالية

دليل إعداد CLAUDE.md

استخدام CLAUDE.md لتزويد Claude Code بسياق المشروع واصطلاحات البرمجة

دليل AGENTS.md: الإعداد وCLAUDE.md

AGENTS.md هو تنسيق التعليمات المفتوح لـ Codex وغيره من وكلاء البرمجة: مواقع الملفات، وقواعد التجاوز، والفروق عن CLAUDE.md، وخطوات الترحيل (2026).

إعدادات اللغة: جعل Claude Code وCodex يردّان بلغتك

اضبط لغة الردّ في Claude Code وCodex عبر CLAUDE.md وAGENTS.md، واكتب prompt بغير الإنجليزية دون إفساد الشيفرة، وتعامل مع ملفات UTF-8 والمحارف ذات اللكنات ومسارات CJK

نصائح CLI

34 نصيحة عملية لـ Claude Code CLI لتعزيز كفاءة التطوير

أفضل الممارسات

أفضل الممارسات لاستخدام Claude Code بكفاءة، دليل شامل من تهيئة المشروع إلى تعاون الفريق

نصائح سير العمل

سير عمل تطوير فعّال باستخدام Claude Code لتعزيز إنتاجية الفريق

Dynamic Workflows

استخدم Dynamic Workflows الخاصة بـ Claude Code لتنسيق عشرات إلى مئات من الوكلاء الفرعيين في الخلفية لمراجعة على مستوى المستودع، والترحيل، والبحث — تعمل عبر QCode

صيغة إخراج Claude Code: JSON والتدفق

استخدم claude -p --output-format مع json وstream-json وtext في السكربتات وCI: كائن JSON واحد، وأحداث NDJSON، و--json-schema، ووصفات jq (2026).

إعدادات الأذونات

اضبط أوضاع الأذونات في Claude Code للتحكم في العمليات التي تتطلب تأكيدًا بشريًا

التفكير التكيفي في Claude مقابل budget_tokens

التفكير التكيفي مقابل budget_tokens على Claude 4.6 / 4.7 / 4.8: اضبط التفكير على adaptive، واضبط الجهد، ولماذا يعيد Opus 4.8 خطأ 400 بسبب budget_tokens.

النماذج الصينية

استدعِ GLM / Kimi / DeepSeek / Qwen باستخدام نفس مفتاح cr_ في QCode.cc: المعرّفات المتاحة للبيع حاليًا، ومسارات البروتوكول، واختبار ذاتي عبر curl، والاقتران مع عائلة Claude 5

إدخال الصور (الرؤية)

أعطِ Claude Code صورًا باللصق أو السحب والإفلات أو عبر مسار ملف لقراءة لقطات الشاشة والنماذج التصميمية والمخططات والرسوم البيانية — مفتاح API واحد من QCode.cc يعمل على كل نقطة نهاية.

توليد الصور وتحريرها باستخدام gpt-image-2

واجهة API متوافقة مع OpenAI لتوليد الصور من النص وتحرير الصور عبر gpt-image-2: جاهزة للاستخدام بمجرد تبديل base_url، ونقاط نهاية متعددة المناطق، وفوترة موحّدة باستخدام مفتاح QCode الخاص بك

استخدام QCode مع 9router

أضف QCode.cc بصفته مزوّدًا مخصصًا في 9router، وهو موجّه محلي متعدد المزوّدين، لتحقيق التبديل الاحتياطي بين المزوّدين والإدارة الموحدة

تشغيل الوكلاء على خادم سحابي

شغّل Claude Code أو Codex على خادم سحابي: ثبّت الأدوات، واضبط المفتاح ونقطة النهاية، وأبقِ المهام حيّة باستخدام tmux، وانتقل إلى SSH المعتمد على المفتاح بأمان.

دليل مهارات Claude Code (SKILL.md)

أنشئ مهارات Claude Code واستخدمها: بنية SKILL.md، وحقول البيانات الأمامية، ومواضع التحميل، والاستدعاء التلقائي والاستدعاء عبر /skill-name، والمهارات المرفقة (2026).

التعمّق في وضع Plan Mode

إتقان وضع Plan Mode في Claude Code — خطّط أولًا ثم نفّذ لبرمجة بالذكاء الاصطناعي أكثر تحكمًا وكفاءة

نظام الخطافات

أتقن خطافات Claude Code — 17 حدثًا من أحداث دورة الحياة، و3 أنواع من المعالجات، و10 وصفات عملية أو أكثر، وإعدادات للمؤسسات

خوادم MCP

وسّع قدرات Claude Code باستخدام Model Context Protocol لربط الأدوات والخدمات الخارجية

وضع التعاون بين الوكلاء الفرعيين

فهم الوكلاء الفرعيين في Claude Code واستخدامهم — الاستكشاف المتوازي، والمهام الخلفية، والتنفيذ المعزول

نظام الإضافات

استخدم نظام إضافات Claude Code لإنشاء أوامر ووكلاء وسير عمل مخصصة

الأتمتة و CI/CD

أتقن الوضع بلا واجهة في Claude Code — مرجع كامل للخيارات، وخمس وصفات CI/CD، وعزل Docker، واستئناف الجلسة، ومقارنة مع Codex

Claude Agent SDK: Python وTypeScript

أنشئ وكلاء باستخدام Claude Agent SDK في Python وTypeScript: أسماء الحزم الرسمية، وquery()، وClaudeSDKClient، والتشغيل عبر QCode (2026).

أفضل ممارسات الأمان

إتقان آليات الأمان في Claude Code بالكامل — التحكم في الأذونات، وحماية الملفات الحساسة، واعتراض الأوامر، وإدارة مفاتيح API

ورقة مرجعية مختصرة لـ Claude Code

ورقة مرجعية مختصرة من صفحة واحدة لـ Claude Code — اختصارات لوحة المفاتيح، أوامر الشرطة المائلة، أعلام CLI، متغيرات البيئة، MCP، Skills، Agents، ومرجع CLAUDE.md

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

الأسئلة الشائعة حول Claude Code وQCode.cc

الاشتراكات مقابل مفاتيح API مقابل مفاتيح QCode

ما هي اشتراكات Claude Pro / ChatGPT Plus، ومفتاح API الرسمي، ومفتاح QCode من نوع cr_ في الواقع، وكيف تتم فوترة كل منها، وأين يعمل كل منها — ثلاثة أمور مستقلة يمكن أن تتعايش

دليل لوحة التحكم

استخدام لوحة تحكم QCode.cc: عنوان الوصول إلى API، وإنشاء مفاتيح API ونسخها، وإحصاءات الاستخدام، وشحن الرصيد، وشراء الخطة، والمفاتيح الفرعية للفريق، وtoken الوصول إلى Open API

لماذا يظهر Claude Sonnet 5 في الاستخدام لديك

اخترت Sonnet 5.5 لكنك ترى claude-sonnet-5 في الاستخدام لديك؟ وضع الأذونات التلقائي في Claude Code يرسل فحوص السلامة إلى Sonnet 5. لماذا، وكيف تتحقق، وكيف تقلل.

إشعار فوترة المصنّف في Claude Code

يقول Claude Code إن هذه الجلسة غير مؤهلة وإن نقطة النهاية لديك غير متوافقة؟ ماذا يعني الإشعار، وكيف يؤثر في الاستخدام والتكلفة، وكيفية إزالته.

مرجع رموز الأخطاء

مرجع لرموز أخطاء QCode.cc API: دلالات 400/401/402/403/429/500/502/503/529، والأسباب النموذجية والإصلاحات المجرّبة، بما في ذلك INSUFFICIENT_BALANCE

دليل استكشاف الأخطاء وإصلاحها

تشخيص مشكلات Claude Code الشائعة وحلولها، مما يساعدك على تحديد المشكلات وإصلاحها بسرعة

وصف الفوترة

فهم طرق الفوترة في QCode.cc ومصادر بيانات الأسعار ومنطق حساب الرسوم

باقات الدفع حسب الاستخدام: الأسعار والتجديد

أسعار الباقات الأربع وحصتها وصلاحيتها، وكيف يضيف التجديد الحصة ويحدد تاريخ انتهاء الصلاحية، والاستعادة بعد انتهاء الصلاحية، وأخطاء 402 و401، وعدم الاسترداد.

فوترة الخادم السحابي وقواعده

الشروط والسعر، والتجديد التلقائي، وتجربة اليوم الواحد، وقواعد الاسترداد، وسياسة الاستخدام المقبول، والدفع والرصيد، وتغيير الخط أو الحجم.

نظرة عامة على طرق الدفع

كل طريقة دفع تتيحها صفحة شحن الرصيد في QCode.cc، والعملة التي تعمل بها كل طريقة، وتكلفتها من الرسوم، ولمن تناسب، وكيف يندرج التحويل المصرفي للشركات ضمن ذلك

دليل خطة الفرق

الدليل الكامل إلى خطة فرق QCode: النطاق المخصص، وإدارة المفاتيح الفرعية، وضمان الخدمة، ودعم أدوات متعددة، والنشر والأمان

دليل الدفع بالعملات المشفرة

اشحن رصيد QCode.cc باستخدام USDT / USDC / BTC و6 عملات أخرى: اختيار الشبكة، والملاحظات، والحد الأدنى للإيداع، وما يجب فعله عندما لا تصل الأموال

توافر ميزات Claude Code

ما ميزات Claude Code التي تعمل مع مفتاح API من QCode وما لا يعمل — مع وسم كل صف بأنه مُقاس أو مُستنتَج

دليل Partner Open API

بعد الموافقة عليك كشريك في QCode، يمكنك إدارة حساب الموزّع الخاص بك برمجيًا باستخدام رمز وصول: تحقّق من الرصيد والاستخدام، وأنشئ مفاتيح API الفرعية التي تعيد بيعها وبدّل حالتها. يغطي المتطلبات المسبقة، وكيفية التقديم، والمصادقة، ومرجع نقاط النهاية، وحدود معدل الطلبات، والأمان.