# البدء السريع

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

> ليس لديك مفتاح بعد؟ أولًا [اختر خطة واحصل على مفتاحك](/docs/getting-started/choose-a-plan): يعمل المفتاح بالطريقة نفسها أيًّا كان الخيار الذي تختاره، لذا لا تتغير الخطوات أدناه.

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

## تشغيل Claude Code

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

```bash
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 للتحليل:

```bash
# 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"
```
## أوامر الشرطة المائلة الشائعة

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

| الأمر | الوصف |
|---------|-------------|
| `/help` | عرض معلومات المساعدة وجميع الأوامر المتاحة |
| `/clear` | مسح سجل المحادثة الحالي |
| `/compact` | ضغط سجل المحادثة لتوفير tokens |
| `/model` | عرض النماذج أو تبديلها (مثل opus، sonnet) |
| `/memory` | تحرير ملف ذاكرة المشروع CLAUDE.md |
| `/init` | إنشاء إعدادات المشروع تلقائيًا |
| قل فقط: «commit these changes» | يراجع Claude التغييرات، ويكتب رسالة إيداع وينفذ الإيداع (`/commit` يحتاج إلى أمر مخصص أو مهارة توفرها أنت أو إحدى الإضافات؛ وهو غير مدمج) |
| `/review` | مراجعة الشيفرة |
| `/cost` | عرض تكلفة الجلسة الحالية |
| `/doctor` | تشخيص مشكلات التثبيت والإعدادات |
| `/config` | عرض الإعدادات أو تحريرها |
| `/mcp` | عرض حالة خادم MCP |
| `/loop` | تشغيل Claude Code في وضع الحلقة المستقلة |
| `/bug` | الإبلاغ عن مشكلة |

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

| الاختصار | الوظيفة |
|----------|----------|
| `Tab` | إكمال مسارات الملفات تلقائيًا |
| `Esc` | مقاطعة الإخراج الحالي |
| `Ctrl+C` | إلغاء العملية الحالية |
| `↑` / `↓` | تصفح سجل الأوامر |

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

عند الاستخدام الأول، شغّل `/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 المحادثة السابقة في الجلسة نفسها

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

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

| الإعداد | ما الذي يفعله | الموضع |
|---|---|---|
| `ANTHROPIC_BASE_URL` | يشير إلى QCode: `https://api.qcode.cc/api` (استخدم `https://asia.qcode.cc/api` في البر الرئيسي للصين)، دون شرطة مائلة لاحقة | متغير بيئة، أو كتلة `env` في `~/.claude/settings.json` |
| `ANTHROPIC_AUTH_TOKEN` | مفتاح QCode الخاص بك الذي يبدأ بـ `cr_` | كما هو مذكور أعلاه |
| `/model` | يعرض النموذج أو يغيّره في الجلسة، مثل `claude-sonnet-5` | أمر داخل الجلسة |
| `CLAUDE.md` | ملاحظات المشروع التي تُقرأ تلقائيًا عند كل بدء | جذر المشروع، يُنشأ بواسطة `/init` |

تجد قائمة المتغيرات الكاملة في [متغيرات البيئة](/docs/getting-started/environment)؛ وللإعداد بخطوة واحدة راجع [سكربت الإعداد بنقرة واحدة](/docs/getting-started/one-click-install).

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

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

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

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

| العَرَض | السبب المحتمل | الإصلاح |
|---|---|---|
| `401` / `Invalid API key` | مفتاح خاطئ أو محشو بمسافات، أو `ANTHROPIC_API_KEY` قديم في البيئة يستحوذ على المصادقة | شغّل `env \| grep -i anthropic` للعثور على البقايا، ثم أزلها وأعد فتح الطرفية |
| `402` / `insufficient_quota` | نفدت الحصة (اليومية أو الإجمالية أو الأسبوعية)؛ المفتاح نفسه سليم | افحص `code` في الاستجابة: يُعاد ضبط الحصة اليومية عند 00:00 بتوقيت بكين، وباقات التعزيز متاحة؛ راجع [رموز الأخطاء](/docs/reference/errors#402-quota-exhausted) |
| 404 | إضافة `/v1` إلى Base URL، أو وجود شرطة مائلة لاحقة | اضبطه مجددًا على `https://api.qcode.cc/api` |
| `model_not_available_on_endpoint` | تم اختيار نموذج GPT داخل Claude Code | يستخدم Claude Code واجهة Anthropic، لذا لا تعمل إلا نماذج Claude والنماذج الصينية؛ استخدم [Codex](/docs/ide/codex) مع GPT |
| ردود بطيئة، `E015` / 429 | المحادثة طويلة جدًا والسياق قريب من حدّه | شغّل `/compact` أولًا، وأعد تشغيل الجلسة إذا فشل ذلك؛ راجع [إدارة السياق](/docs/usage/context-management) |
| تعذّر الاتصال كليًا | تداخل متغيرات الشبكة أو متغيرات الوكيل على مستوى النظام | جرّب `asia.qcode.cc`، ثم راجع البند 6 من [استكشاف الأخطاء وإصلاحها](/docs/reference/troubleshooting) |

إذا لم تكن متأكدًا من الطبقة التي تفشل، فشغّل اختبار curl من القسم 5 في [نقاط النهاية وصيغ API](/docs/getting-started/endpoints-and-api-paths): يعني 400 أو 401 أن المسار قابل للوصول.
## الأسئلة الشائعة

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

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

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

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

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

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

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

استخدم `claude-sonnet-5` للبرمجة اليومية وبدّل إلى نموذج أقوى عبر `/model` للمهام الأصعب؛ راجع [اختيار النموذج](/docs/usage/model-selection) للمقارنة.

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

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

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

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

1. استكشف [نصائح CLI](/docs/usage/cli-tips) للحصول على 34 نصيحة عملية

2. تعلّم [نصائح سير العمل](/docs/usage/workflow-tips) لزيادة الإنتاجية

3. اطّلع على [تكامل Codex](/docs/ide/codex) لاستخدام أداة ذكاء اصطناعي أخرى