البدء السريع

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

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

⚡ لم تُجرِ الإعداد بعد؟ أمر واحد يفعل كل شيء: curl -fsSL https://qcode.cc/install/claude-code.sh | bash (Windows: irm https://qcode.cc/install/claude-code.ps1 | iex). راجع سكربت الإعداد بنقرة واحدة.

ليس لديك مفتاح بعد؟ أولًا اختر خطة واحصل على مفتاحك: يعمل المفتاح بالطريقة نفسها أيًّا كان الخيار الذي تختاره، لذا لا تتغير الخطوات أدناه.

بعد إكمال التثبيت وإعداد البيئة، لنتقن الميزات الأساسية لـ Claude Code خلال 5 دقائق.

تشغيل Claude Code¶

انتقل إلى دليل مشروعك في الطرفية ثم شغّل:

cd /path/to/your/project
claude

سترى واجهة Claude Code التفاعلية جاهزة لبدء محادثة.

التفاعلات الأساسية¶

1. فهم الشيفرة¶

> What's the architecture of this project?
> Explain how src/auth/login.ts works
> Find all places that call the database

2. توليد الشيفرة¶

> Write a user registration API endpoint
> Add unit tests for the UserService class
> Create a React login form component

3. تعديل الشيفرة الموجودة¶

> Refactor utils.js to improve readability
> Fix the memory leak in handleSubmit function
> Add TypeScript types to all public functions

4. تصحيح المشكلات¶

> Why is the user redirected to 404 after login?
> Analyze this error: TypeError: Cannot read property 'id' of undefined
> Investigate why the API response is slow

5. عمليات Git¶

> Show me what files I've modified
> Commit these changes with a good commit message
> Create a PR description

الإشارة إلى الملفات باستخدام @¶

استخدم الرمز @ للإشارة بدقة إلى ملفات محددة، مع السماح لـ Claude بقراءة محتوياتها مباشرةً:

> Review @src/components/Header.tsx and optimize performance
> Compare @src/v1/api.js with @src/v2/api.js
> Analyze project dependencies based on @package.json

نصيحة: اضغط Tab بعد كتابة @ لإكمال مسارات الملفات تلقائيًا.

تمرير الإدخال¶

مرّر الإخراج من أوامر أخرى إلى Claude Code للتحليل:

# Explain git changes
git diff | claude "explain these code changes"

# Analyze log errors
cat error.log | claude "analyze these errors and provide solutions"

# Review PR changes
gh pr diff 123 | claude "review this PR for code quality"

أوامر الشرطة المائلة الشائعة¶

استخدم أوامر / أثناء الجلسة:

اختصارات لوحة المفاتيح¶

تهيئة إعدادات المشروع¶

عند الاستخدام الأول، شغّل /init لتمكين Claude من تحليل مشروعك وإنشاء الإعدادات:

> /init

ينشئ هذا ملف CLAUDE.md يتضمن:

• نظرة عامة على حزمة تقنيات المشروع وبنيته

• أوامر البناء والاختبار الشائعة

• إرشادات أسلوب الشيفرة

• اصطلاحات خاصة بالمشروع

الغرض من CLAUDE.md: يقرأ Claude Code هذا الملف تلقائيًا عند بدء التشغيل، مما يساعد الذكاء الاصطناعي على فهم سياق مشروعك بشكل أفضل.

أمثلة عملية¶

المثال 1: إضافة ميزة جديدة¶

> I need to add a user avatar upload feature with:
  1. Support for JPG/PNG formats
  2. 2MB file size limit
  3. Auto-crop to 200x200 after upload
  4. Store in S3

المثال 2: إصلاح خلل¶

> User feedback: Page freezes after clicking "Save" button
> Please investigate the issue in @src/pages/EditProfile.tsx

المثال 3: مراجعة الشيفرة¶

> /review
> Focus on security issues and performance bottlenecks

المثال 4: الإيداع الذكي¶

> Commit these changes and write a good commit message

سيقوم Claude تلقائيًا بما يلي:

1. تحليل جميع التغييرات

2. إنشاء رسالة إيداع مناسبة

3. إتمام الإيداع

نصائح لتحسين الكفاءة¶

1. كن محددًا: صف بوضوح ما تريده، بما في ذلك القيود

2. قسّم المهمة: جزّئ المهام المعقدة إلى خطوات أصغر

3. قاطع مبكرًا: اضغط Esc فورًا إذا لم يكن الإخراج كما تريد

4. استخدم المراجع: استخدم @ لتحديد الملفات بدلًا من ترك الذكاء الاصطناعي يخمّن

5. حافظ على السياق: يتذكر Claude المحادثة السابقة في الجلسة نفسها

شرح الإعدادات الأساسية¶

لبدء سريع، تحتاج إلى أربعة مواضع فقط؛ راجع الباقي عند الحاجة إليه:

تجد قائمة المتغيرات الكاملة في متغيرات البيئة؛ وللإعداد بخطوة واحدة راجع سكربت الإعداد بنقرة واحدة.

إدارة الجلسات: بعض الأوامر الرسمية¶

حتى 2026-10-15، وفقًا لوثائق Claude Code:

• يعرض /usage تكلفة الجلسة واستخدامها، و/cost اسم مستعار له؛
• يستأنف claude --continue أحدث جلسة في الدليل الحالي، ويسرد claude --resume الجلسات للاختيار منها، ويعمل /resume داخل الجلسة؛
• لمعاينة خطة دون السماح بتعديل الملفات، اضغط Shift+Tab للتنقل بين أوضاع الأذونات؛ عندما يعرض شريط الحالة ⏸ plan mode on تكون في وضع الخطة ولا يُعدَّل أي شيء حتى توافق على الخطة.

الأخطاء الشائعة وكيفية استكشافها وإصلاحها¶

إذا لم تكن متأكدًا من الطبقة التي تفشل، فشغّل اختبار curl من القسم 5 في نقاط النهاية وصيغ API: يعني 400 أو 401 أن المسار قابل للوصول.

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

كيف أتأكد من أن الطلبات تمر فعلاً عبر QCode؟¶

أدخل مفتاح API الخاص بك في probe.qcode.cc لرؤية النموذج وtokens أحدث طلباتك. إذا لم يظهر أي شيء، فهذا يعني أن الطلبات لم تصل إلى QCode قط، لذا أعد التحقق من متغيرات البيئة لديك.

أين يمكنني رؤية تكلفة جلسة؟¶

داخل جلسة، يعرض /usage (أو /cost) استخدام الجلسة الحالية. يظهر الاستهلاك على مستوى الحساب في وحدة تحكم QCode. تتقاضى QCode رسومًا لكل token؛ وتُدرج أسعار كل نموذج في qcode.cc/models.

هل يمكنني متابعة محادثة الأمس بعد إغلاق الطرفية؟¶

نعم. شغّل claude --continue في دليل المشروع نفسه لاستئناف أحدث جلسة، أو claude --resume لاختيار جلسة من قائمة.

بأي نموذج ينبغي أن أبدأ؟¶

استخدم claude-sonnet-5 للبرمجة اليومية وبدّل إلى نموذج أقوى عبر /model للمهام الأصعب؛ راجع اختيار النموذج للمقارنة.

ماذا لو أردت استخدام GPT أو النماذج الصينية؟¶

يستخدم Claude Code نفسه واجهة Anthropic، لذا يمكن اختيار النماذج الصينية مباشرة. أما نماذج GPT فاستخدم لها Codex CLI؛ الإعداد موجود في دليل Codex الكامل.

الخطوات التالية¶

تهانينا على إتقان أساسيات Claude Code! تابع بما يلي:

1. استكشف نصائح CLI للحصول على 34 نصيحة عملية

2. تعلّم نصائح سير العمل لزيادة الإنتاجية

3. اطّلع على تكامل Codex لاستخدام أداة ذكاء اصطناعي أخرى

المؤسسات ←