# مقدمة إلى Claude Code

Claude Code هو مساعد برمجة وكيلي رسمي من Anthropic يعمل بواجهة سطر الأوامر (CLI). منذ إتاحته العامة في مايو 2025، أصبح أداة بالغة الأهمية لأبرز مؤسسات العالم، بما فيها Netflix وSpotify وKPMG وL'Oreal وSalesforce. وخلال 6 أشهر فقط، حقق Claude Code إنجازًا ببلوغ إيراداته السنوية بمعدل التشغيل $1 مليار.

## ما هو Claude Code؟

Claude Code ليس أداة تقليدية لإكمال الشيفرة، بل هو **مساعد برمجة وكيلي حقيقي**. يعمل مثل مطوّر خبير، فيفهم المهام البرمجية المعقدة ويخطط لها وينفذها باستقلالية.

### القدرات الأساسية

- **التخطيط المستقل**: يفهم المهام المعقدة ويضع خطط تنفيذ دون إرشاد خطوة بخطوة

- **عمليات الشيفرة**: يقرأ أي ملفات في مشروعك ويحررها وينشئها مباشرة

- **التنفيذ في الطرفية**: يشغّل الاختبارات ويثبّت التبعيات وينفّذ عمليات البناء والمزيد

- **فهم عميق للسياق**: نافذة سياق بسعة 200K token، قابلة للتوسيع إلى 1M tokens لوعي شامل بقاعدة الشيفرة

- **تعاون الوكلاء الفرعيين**: ينشئ وكلاء فرعيين متخصصين لمعالجة مهام محددة بكفاءة

### التحديثات الرئيسية في 2025

- **Plan Mode**: يحلل ويبحث أولًا، ثم ينشئ خطط تنفيذ لتقليل الأخطاء

- **Subagents**: وكلاء في الخلفية لمراجعة الشيفرة والاختبار والمهام المتخصصة

- **نظام الذاكرة CLAUDE.md**: ملفات إعدادات على مستوى المشروع تتذكر تفضيلاتك ومعاييرك

- **بروتوكول امتداد MCP**: يربط الأدوات والخدمات الخارجية عبر بروتوكول سياق النموذج (MCP)

- **نموذج Opus 4.8 / 4.7**: أحدث نموذج برمجي وأقواه (4.8 هو الطراز الرائد الحالي)، مع تحسين كبير في توليد الشيفرة

## المقارنة مع المنافسين

### Claude Code مقابل OpenAI Codex CLI

| الميزة | Claude Code | Codex CLI |
|---------|-------------|-----------|
| النموذج الأساسي | Claude Opus 5 / Sonnet 5 (لا يزال 4.x معروضًا للبيع) | GPT-5.5 / GPT-5.4 / GPT-5.3-Codex |
| نظام الوكلاء الفرعيين | دعم أصلي وقوي | يتطلب امتداد MCP |
| Plan Mode | مدمج | لا يوجد دعم أصلي |
| أسلوب التفاعل | شروح مفصلة، وبرمجة ثنائية | مخرجات موجزة، وأتمتة أكبر |
| فهم النية | ممتاز، ونادرًا ما يسيء التفسير | جيد، ويتجاهل التعليمات أحيانًا |
| نافذة السياق | 200K-1M tokens | 400K tokens |
| الأسعار | الدفع حسب الاستخدام / الاشتراك | الدفع حسب الاستخدام / الاشتراك |

**الخلاصة**: يتفوق Claude Code في جودة الشيفرة وتجربة التفاعل وفهم النية؛ ومع خيار سياق 1M، فإنه يضاهي Codex أيضًا في حجم نافذة السياق.

> **QCode.cc يدعم Codex أيضًا!** يستخدم Claude Code وCodex المفتاح نفسه في QCode، لذا يمكنك اختيار الأداة التي تريد استخدامها بحرية. راجع [تكامل Codex](/docs/ide/codex) لمعرفة كيفية إعداده.

### Claude Code مقابل Google Gemini CLI

| الميزة | Claude Code | Gemini CLI |
|---------|-------------|------------|
| الأسعار | الدفع حسب الاستخدام / الاشتراك | مجاني (مع حدود) |
| نافذة السياق | 200K-1M tokens | 1M tokens |
| القدرة على البرمجة | رائدة في المجال | أضعف بشكل ملحوظ |
| ميزات الوكيل | ناضجة وشاملة | وظائف أساسية |
| متعدد الوسائط | فهم الصور | متعدد الوسائط أصليًا |
| المنظومة | مستقل | تكامل عميق مع منظومة Google |

**الخلاصة**: توقفت طبقتا Pro والمستهلك في Gemini CLI في 2026-06-18؛ والخلف هو Antigravity CLI. من حيث القدرات، يمتلك Gemini CLI نافذة سياق ضخمة لكنه أضعف في البرمجة من Claude Code — ولا يزال بعيدًا عن أن يكون الخيار المفضل للتطوير الاحترافي. يمكن لمفاتيح المؤسسات المدفوعة مواصلة استخدام Gemini CLI.

> **ملاحظة**: توقف Gemini CLI عن خدمة حسابات Pro والمستهلكين في 2026-06-18 ([إعلان Google](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/))؛ والخلف هو Google Antigravity CLI. لا تتأثر مفاتيح المؤسسات المدفوعة. لا يوفر QCode نماذج Gemini في الوقت الحالي.

### لماذا يعد Claude Code الخيار الأفضل


1. **أعلى جودة للشيفرة**: تتصدر نماذج Claude باستمرار في معايير البرمجة

2. **أفضل تجربة للمطوّر**: شروح مفصلة، وتخطيط واضح، وفهم دقيق للنية

3. **مُجرَّب في المؤسسات**: الأداة المفضلة لدى Netflix وSpotify وغيرهما من كبرى المؤسسات

4. **تكرار سريع**: 176 تحديثًا صدرت في 2025، مع تطوير مستمر
## لماذا تختار QCode.cc؟

Claude Code أداة قوية، لكن الأسعار الرسمية مرتفعة:

- اشتراكات Anthropic: Max بسعر **$100/month**، وUltra بسعر **$200/month** (أُعيدت تسمية Max 20x إلى Ultra في 2026-10-30)

- API بالدفع حسب الاستخدام: Opus 4.8 / 4.7 بسعر **$5/$25 لكل مليون token** (الإدخال/الإخراج، السعر نفسه)

### مزايا QCode.cc

عبر QCode.cc تحصل على الوظائف نفسها التي يوفرها Claude Code. تُحتسب التكلفة حسب الـ token؛ وتُدرَج أسعار كل نموذج على qcode.cc/models:

| المقارنة | Anthropic الرسمي | QCode.cc |
|------------|-------------------|----------|
| الفوترة | اشتراك / دفع حسب الاستخدام | تُحتسب التكلفة حسب الـ token؛ وأسعار كل نموذج على qcode.cc/models |
| الميزات | كاملة | كاملة |
| الدعم | الإنجليزية فقط | دعم متعدد اللغات |

### ضمانات الخدمة

- **محسّن لمنطقة آسيا والمحيط الهادئ**: عُقد في كوريا / تايوان / هونغ كونغ للوصول من آسيا، إضافة إلى عقدة في الولايات المتحدة (`us.qcode.cc`، لوس أنجلوس) لأمريكا الشمالية / أوروبا

- **انتقال سلس**: متوافق مع API، ما عليك سوى تغيير متغيرات البيئة

- **استعادة في اليوم نفسه**: إذا تعطّلت الخدمة، نستعيدها في اليوم نفسه — دون حاجة إلى الشراء مرة أخرى

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

### اختر خطة واحصل على مفتاحك

اختر أولًا أحد الخيارات في [كيفية اختيار خطة](/docs/getting-started/choose-a-plan) (خطة شخصية، أو باقات الدفع حسب الاستخدام، أو خطة الفرق، أو برنامج الشركاء)، ثم احصل على مفتاحك من نوع `cr_` في لوحة التحكم. وأيًّا كان الخيار الذي تختاره، يُستخدم المفتاح بالطريقة نفسها والخطوات أدناه متطابقة.

### ثبّت Claude Code

```bash
npm install -g @anthropic-ai/claude-code

# Or install via Homebrew (macOS)
brew install --cask claude-code
```

### اضبط QCode.cc

```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="your-api-key"
```

### ابدأ الاستخدام

```bash
cd your-project
claude
```

بعد ذلك يمكنك التواصل مع Claude Code باللغة الطبيعية:

```
> Analyze this project's architecture and find areas for optimization
> Write comprehensive unit tests for the UserService
> Refactor src/utils.js to improve code readability
```

## متطلبات النظام

- **نظام التشغيل**: Windows 10+، macOS 10.15+، Linux

- **Node.js**: الإصدار 18.0 أو أحدث (يُنصح بـ 22 LTS)

- **الشبكة**: اتصال إنترنت مستقر

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

هل أنت مستعد لتجربة أقوى مساعد للبرمجة بالذكاء الاصطناعي؟

1. [اختر خطة واحصل على مفتاحك](/docs/getting-started/choose-a-plan) أولًا

2. راجع [دليل التثبيت](/docs/getting-started/installation) لإكمال الإعداد

3. اقرأ [البدء السريع](/docs/getting-started/quick-start) لتتعلم الاستخدام الأساسي

4. استكشف [نصائح الاستخدام](/docs/usage/cli-tips) لتعزيز إنتاجيتك

5. هل تخطط لتشغيل الوكلاء على خادم خارجي؟ راجع [الخوادم السحابية: الاختيار والشراء والاستخدام](/docs/getting-started/cloud-servers)