دليل مستخدم Claude Code
دليل كامل لأداة CLI الخاصة بـ Claude Code، من التثبيت إلى الإتقان. ابدأ البرمجة بمساعدة الذكاء الاصطناعي وعزّز كفاءة تطويرك.
البدء السريع
ثلاث خطوات لبدء استخدام Claude Code
احصل على مفتاح API
أنشئ مفتاح API في لوحة تحكم QCode (يبدأ بـ cr_)؛ يستخدمه Claude Code لاستدعاء النماذج
ثبّت أداة CLI
نزّل أداة سطر الأوامر الخاصة بـ Claude Code وثبّتها
ابدأ البرمجة
اضبط متغيرات البيئة وابدأ رحلتك في البرمجة بمساعدة الذكاء الاصطناعي
دليل مستخدم مفصّل
التثبيت والإعداد
ثبّت Claude Code CLI وقم بإعداده بسرعة
مثال التثبيت
# ثبّت Claude Code باستخدام npm
npm install -g @anthropic-ai/claude-code
# إعداد نقطة نهاية API (باستخدام وكيل QCode)
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
# إعداد مفتاح API
export ANTHROPIC_AUTH_TOKEN="cr_your-key"
# تشغيل Claude Code
claude
الاستخدام الأساسي
أتقن الميزات الأساسية في Claude Code
مثال على الأوامر الأساسية
# بدء Claude Code في دليل المشروع
cd your-project && claude
# اسأل مباشرة
claude "explain what this function does"
# تابع الجلسة السابقة
claude --continue
ميزات متقدمة
استفد استفادة كاملة من قدرات Claude Code القوية
استكشاف الأخطاء وإصلاحها
حل مشكلات الاستخدام الشائعة
ميزات Claude Code المتقدمة
أتقن أحدث الميزات لتعزيز كفاءة التطوير
Claude Fable 5.1
تضعه Anthropic كذكاء من الجيل التالي للاستدلال المتطلب والعمل الوكيلي طويل الأمد، مع نافذة سياق تبلغ 1M
وكلاء الخلفية
أطلق جلسات خلفية باستخدام claude agents: تستمر في العمل دون طرفية متصلة. تقول الوثائق الرسمية إن كل جلسة تستهلك حصة الاشتراك بشكل مستقل — أي حصة اشتراك claude.ai؛ ولا يزال agent view معاينة بحثية.
أتمتة Hooks
شغّل الأوامر تلقائيًا عند وقوع الأحداث: يغطي PreToolUse وPostToolUse كل استدعاء أداة في حلقة الوكيل.
الوكلاء الفرعيون المتوازون
فوّض المهام إلى وكلاء فرعيين: يعمل كل واحد في نافذة سياق خاصة به، ولا يعيد سوى ملخص، وتُحتسب طلباته ضمن حدود الاستخدام نفسها.
نصائح وأفضل الممارسات
نصائح لتحسين الكفاءة
استخدم ملف CLAUDE.md
اكتب ملف CLAUDE.md في جذر المشروع لتسجيل اصطلاحات المشروع؛ وعندما يستخدم المستودع AGENTS.md، يقرأ Claude ذلك بدلًا منه؛ تُقرأ هذه الملفات في بداية كل جلسة
استفد من Hooks
اضبط أحداث hook: يُطلق SessionStart وSessionEnd مرة واحدة لكل جلسة، ويُطلق UserPromptSubmit وStop مرة واحدة لكل دور، ويُطلق PreToolUse وPostToolUse عند كل استدعاء أداة في حلقة الوكيل.
استخدم Background Agents
افتح عرض الوكيل باستخدام claude agents لإطلاق جلسات خلفية: تستمر كل جلسة في العمل دون طرفية متصلة، وتستهلك حصة الاشتراك بشكل مستقل — وتصف الوثائق الرسمية تلك الحصة بأنها حصة اشتراك claude.ai.
استكشاف الأخطاء وإصلاحها
مفتاح API غير صالح
تحقق من تطابق متغير البيئة مع المفتاح: يوضع مفتاح cr_ الخاص بـ QCode في ANTHROPIC_AUTH_TOKEN، ويرسله Claude Code كـ Bearer token.
انتهاء مهلة الاتصال
تحقق من اتصال شبكتك وتأكد من أن ANTHROPIC_BASE_URL هو https://api.qcode.cc/api؛ ومن داخل البر الرئيسي للصين، يُعد https://asia.qcode.cc/api البديل الموصى به.
جودة شيفرة ضعيفة
قدّم متطلبات أكثر تفصيلًا، واستخدم CLAUDE.md لتحديد مواصفات المشروع.
QCode يدعم أيضًا OpenAI Codex / GPT-5.6
تعمل حصتك في QCode عبر Claude Code وOpenAI Codex CLI — رصيد واحد مشترك، دون أي إنفاق مكرر.
ابدأ استخدام Claude Code
أنشئ حسابًا في QCode.cc وفعّل خدمة Claude Code API. تتم المحاسبة لكل token؛ وأسعار كل نموذج مدرجة على /models. هل تريد تشغيل Claude Code على خادم لفترات طويلة، أو منح فريقك بيئة ثابتة؟ لكل خادم سحابي من QCode عنوان IPv4 عام مخصص ووصول root كامل؛ نفّذ curl -fsSL https://qcode.cc/install/claude-code.sh | bash -s -- --lang en على الجهاز لتثبيت Claude Code. تستمر استدعاءات النماذج عبر نقطة نهاية QCode باستخدام مفتاح QCode الخاص بك، وتتشارك خدمات الذكاء الاصطناعي والخوادم السحابية رصيدًا واحدًا. للاطلاع على الأسعار الابتدائية، راجع مقارنة الخطوط على qcode.cc/en/cloud.