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

> تتبع الأوامر إصدار `claude --version` المحلي لديك و[الإصدارات الرسمية](https://github.com/anthropics/claude-code/releases). أضف هذه الصفحة إلى الإشارات المرجعية للرجوع السريع.

---

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

### عناصر التحكم العامة

| الاختصار | الوظيفة |
|--------|------|
| `Ctrl+C` | إلغاء الإدخال / مقاطعة التوليد |
| `Ctrl+D` | الخروج من الجلسة |
| `Ctrl+L` | مسح الشاشة |
| `Ctrl+O` | تبديل الإخراج المفصّل (عرض التفكير) |
| `Ctrl+R` | البحث العكسي في السجل |
| `Ctrl+G` | فتح prompt في المحرر |
| `Ctrl+B` | تشغيل المهمة الحالية في الخلفية |
| `Ctrl+T` | تبديل قائمة المهام |
| `Ctrl+V` | لصق صورة |
| `Ctrl+F` | إنهاء وكلاء الخلفية (اضغط مرتين) |
| `Esc` `Esc` | تراجع / رجوع |

### تبديل الأوضاع

| الاختصار | الوظيفة |
|--------|------|
| `Shift+Tab` | تدوير أوضاع الأذونات (auto → Normal → Auto-accept → Plan) |
| `Alt+P` | تبديل النموذج |
| `Alt+T` | تبديل وضع التفكير |

### نصائح الإدخال

| الاختصار | الوظيفة |
|--------|------|
| `\` + `Enter` | سطر جديد (اختصار) |
| `Ctrl+J` | سطر جديد (تسلسل تحكم) |

### رموز البادئة

| البادئة | الوظيفة |
|------|------|
| `/` | أوامر الشرطة المائلة |
| `!` | تنفيذ bash مباشرةً |
| `@` | الإشارة إلى ملف + الإكمال التلقائي |

### محدّد الجلسة

| الاختصار | الوظيفة |
|--------|------|
| `↑` `↓` | تنقّل |
| `←` `→` | توسيع / طي |
| `P` | معاينة |
| `R` | إعادة تسمية |
| `/` | بحث |
| `A` | كل المشاريع |
| `B` | الفرع الحالي |

---

## أوامر الشرطة المائلة

### إدارة الجلسات

| الأمر | الوظيفة |
|------|------|
| `/clear` | مسح المحادثة |
| `/compact [focus]` | ضغط السياق (مع إمكانية تحديد التركيز اختياريًا) |
| `/resume` | استئناف / تبديل الجلسة |
| `/rename [name]` | تسمية الجلسة الحالية |
| `/branch [name]` | تفريع المحادثة (مرادف `/fork`) |
| `/cost` | إحصاءات استخدام token |
| `/context` | عرض استخدام السياق بصريًا (شبكة) |
| `/diff` | عارض فروقات تفاعلي |
| `/copy` | نسخ الرد الأخير |
| `/export` | تصدير المحادثة |

### الإعدادات

| الأمر | الوظيفة |
|------|------|
| `/config` | فتح الإعدادات |
| `/model [model]` | تبديل النموذج (`←` `→` لضبط الجهد) |
| `/fast [on\|off]` | تبديل الوضع السريع |
| `/vim` | تبديل وضع vim |
| `/theme` | تغيير سمة الألوان |
| `/permissions` | عرض / تحديث الأذونات |
| `/effort [level]` | تعيين مستوى الجهد (low / med / high / max / auto) |
| `/color [color]` | تعيين لون شريط prompt |
| `/keybindings` | تخصيص ارتباطات المفاتيح |
| `/terminal-setup` | تهيئة اختصارات الطرفية |

### الأدوات

| الأمر | الوظيفة |
|------|------|
| `/init` | إنشاء CLAUDE.md |
| `/memory` | تحرير ملفات CLAUDE.md |
| `/mcp` | إدارة خوادم MCP |
| `/hooks` | إدارة hooks |
| `/skills` | عرض Skills المتاحة |
| `/agents` | إدارة الوكلاء |
| `/chrome` | تكامل Chrome |
| `/reload-plugins` | إعادة تحميل الإضافات فوريًا |
| `/add-dir <path>` | إضافة دليل عمل |

### الميزات الخاصة

| الأمر | الوظيفة |
|------|------|
| `/btw <question>` | سؤال جانبي (دون سياق، ودون تأثير على المحادثة الرئيسية) |
| `/plan [desc]` | وضع الخطة (+ بدء التحليل تلقائيًا) |
| `/loop [interval]` | جدولة مهمة متكررة (مثل `/loop 5m check deploy`) |
| `/voice` | وضع الصوت بالضغط للتحدث (20 لغة) |
| `/doctor` | تشخيص التثبيت |
| `/pr-comments [PR]` | جلب تعليقات PR من GitHub |
| `/stats` | سلسلة أيام الاستخدام والتفضيلات |
| `/insights` | تقرير تحليلات الجلسة |
| `/desktop` | المتابعة إلى تطبيق Desktop |
| `/remote-control` | الاتصال بـ claude.ai/code (مرادف `/rc`) |
| `/usage` | حصة الخطة وحالة حد المعدل |
| `/schedule` | المهام المجدولة السحابية |
| `/security-review` | تحليل أمني للتغييرات |
| `/help` | عرض المساعدة + كل الأوامر |
| `/feedback` | إرسال ملاحظات (مرادف `/bug`) |
| `/release-notes` | عرض سجل التغييرات الكامل |

---
## أوامر CLI وخياراتها

### الأوامر الأساسية

| الأمر | الوظيفة |
|------|------|
| `claude` | بدء تفاعلي |
| `claude "question"` | البدء بـ prompt أولي |
| `claude -p "query"` | وضع بلا واجهة (غير تفاعلي) |
| `claude -c` | متابعة المحادثة الأخيرة |
| `claude -r "name"` | استئناف الجلسة بالاسم |
| `claude update` | التحديث إلى أحدث إصدار |

### الخيارات الرئيسية

| الخيار | الوظيفة |
|------|------|
| `--model` | تعيين النموذج |
| `-w` | وضع شجرة عمل Git |
| `-n` / `--name` | اسم الجلسة |
| `--add-dir` | إضافة دليل إضافي |
| `--agent` | استخدام وكيل محدد |
| `--allowedTools` | الموافقة المسبقة على أدوات محددة |
| `--output-format` | تنسيق الإخراج（json / stream-json） |
| `--json-schema` | إخراج JSON منظم |
| `--max-turns` | تحديد عدد دورات التفاعل |
| `--max-budget-usd` | سقف التكلفة (USD) |
| `--console` | المصادقة عبر Anthropic Console |
| `--verbose` | إخراج مطوّل |
| `--bare` | وضع بلا واجهة بحد أدنى (بلا خطافات/LSP/إضافات) |
| `--channels` | تمرير الأذونات / دفع MCP |
| `--remote` | جلسة ويب |
| `--effort` | تعيين الجهد（low / med / high / max） |
| `--permission-mode` | وضع الأذونات (default / acceptEdits / plan / auto / dontAsk / bypassPermissions) |
| `--dangerously-skip-permissions` | تخطي كل مطالبات الأذونات |
| `--chrome` | تكامل Chrome |

---

## خوادم MCP

### إضافة خادم

| الخيار | النقل |
|------|---------|
| `--transport http` | HTTP عن بُعد (موصى به) |
| `--transport stdio` | عملية محلية |
| `--transport sse` | SSE عن بُعد |

### النطاق

| النطاق | ملف الإعدادات | الوصف |
|--------|---------|------|
| محلي | `.claude.json` | مشروع واحد |
| مشروع | `.mcp.json` | مشترك (إيداع في VCS) |
| مستخدم | `~/.claude.json` | عام |

### أوامر الإدارة

| الأمر | الوظيفة |
|------|------|
| `/mcp` | واجهة إدارة تفاعلية |
| `claude mcp list` | سرد كل الخوادم |
| `claude mcp serve` | كشف Claude Code نفسه كخادم MCP |

> **الاستيضاح**: يمكن لخوادم MCP طلب إدخال المستخدم أثناء المهمة.

---

## الذاكرة ونظام الملفات

### مواضع CLAUDE.md

| الموقع | النطاق |
|------|---------|
| `./CLAUDE.md` | مستوى المشروع (مشترك للفريق) |
| `~/.claude/CLAUDE.md` | مستوى المستخدم (كل المشاريع) |
| `/etc/claude-code/` | مُدار (على مستوى المؤسسة) |

### القواعد والاستيرادات

| المسار / الصيغة | الوصف |
|------------|------|
| `.claude/rules/*.md` | ملفات قواعد المشروع |
| `~/.claude/rules/*.md` | ملفات قواعد المستخدم |
| البيانات الأمامية `paths:` | قواعد خاصة بالمسارات (للمسارات المطابقة فقط) |
| `@path/to/file` | استيراد محتوى ملف في CLAUDE.md |

### الذاكرة التلقائية

```
~/.claude/projects/<proj>/memory/
├── MEMORY.md          ← Memory index
└── topic_xxx.md       ← Topic-based memory files
```

تُحمَّل ملفات الذاكرة تلقائيًا في السياق، وتُحفظ بعد /compact.

---
## سير العمل ونصائح

### وضع الخطة

| الإجراء | الوصف |
|------|------|
| `Shift+Tab` | دورة: تلقائي → عادي → قبول تلقائي → الخطة |
| `--permission-mode plan` | البدء في وضع الخطة |

### التفكير والجهد

| الإجراء | الوصف |
|------|------|
| `Alt+T` | تبديل وضع التفكير |
| `"ultrathink"` | أقصى جهد لهذا الدور |
| `Ctrl+O` | عرض عملية التفكير (إخراج مطوّل) |
| `/effort` | ضبط المستوى: low · med · high · max |

### أشجار عمل Git

| الإجراء | الوصف |
|------|------|
| `--worktree name` | إنشاء مساحة عمل فرع معزولة لكل ميزة |
| `isolation: worktree` | يعمل الوكيل في شجرة عمل معزولة |
| `sparsePaths` | سحب جزئي للمجلدات المطلوبة فقط |
| `/batch` | إنشاء عدة أشجار عمل تلقائيًا للتغييرات المتوازية |

### وضع الصوت

| الإجراء | الوصف |
|------|------|
| `/voice` | تفعيل الضغط للتحدث |
| `Space` (مع الاستمرار) | اضغط مع الاستمرار للتسجيل، وأفلت للإرسال |
| 20 لغة | EN / ES / FR / DE / ZH / JA / KO ... |

### إدارة السياق

| الإجراء | الوصف |
|------|------|
| `/context` | عرض الاستخدام + نصائح التحسين |
| `/compact [focus]` | ضغط مع التركيز |
| الضغط التلقائي | يُفعّل تلقائيًا عند ~95% من السعة |
| سياق 1M | Opus 4.8 (متاح على Max/Team/Enterprise) |
| CLAUDE.md | يُحفظ بعد الضغط |

### نصائح متقدمة للجلسات

| الإجراء | الوصف |
|------|------|
| `claude -c` | متابعة آخر محادثة |
| `claude -r "name"` | استئناف بالاسم |
| `/btw question` | سؤال جانبي، دون تأثير على السياق الرئيسي |

### وضع SDK / الوضع بلا واجهة

| الإجراء | الوصف |
|------|------|
| `claude -p "query"` | تشغيل غير تفاعلي |
| `--output-format json` | إخراج منظّم |
| `--max-budget-usd 5` | سقف التكلفة |
| `cat file \| claude -p` | إدخال عبر أنبوب |

### الجدولة والعمل عن بُعد

| الإجراء | الوصف |
|------|------|
| `/loop 5m msg` | مهمة متكررة |
| `/rc` | تحكم عن بُعد |
| `--remote` | جلسة ويب على claude.ai |

---

## المهارات والوكلاء

### المهارات المدمجة

| المهارة | الوظيفة |
|-------|------|
| `/simplify` | مراجعة الكود (3 وكلاء متوازون) |
| `/batch` | تغييرات متوازية واسعة النطاق (5-30 شجرة عمل) |
| `/debug [desc]` | تصحيح الأخطاء من السجلات |
| `/loop [interval]` | مهام مجدولة دوريًا |
| `/claude-api` | تحميل وثائق مرجع API + SDK |

### مواقع المهارات المخصصة

| الموقع | النطاق |
|------|---------|
| `.claude/skills/<name>/` | مهارات المشروع |
| `~/.claude/skills/<name>/` | مهارات شخصية |

### حقول البيانات الأمامية للمهارة

| الحقل | الوصف |
|------|------|
| `description` | وصف التفعيل التلقائي |
| `allowed-tools` | أدوات تتخطى prompts الأذونات |
| `model` | تجاوز النموذج لهذه المهارة |
| `effort` | تجاوز مستوى الجهد |
| `context: fork` | التشغيل في وكيل فرعي |
| `$ARGUMENTS` | عنصر نائب لإدخال المستخدم |
| `${CLAUDE_SKILL_DIR}` | مسار دليل المهارة |
| `` !`cmd` `` | حقن سياق ديناميكي (تشغيل cmd، تضمين النتيجة) |

### الوكلاء المدمجون

| الوكيل | الوصف |
|-------|------|
| **Explore** | بحث سريع للقراءة فقط (يستخدم Haiku) |
| **Plan** | بحث لوضع الخطة |
| **General** | مجموعة أدوات كاملة، مهام معقدة |
| **Bash** | طرفية بسياق مستقل |

### حقول البيانات الأمامية للوكيل

| الحقل | الوصف |
|------|------|
| `permissionMode` | default / acceptEdits / plan / dontAsk / bypass |
| `isolation: worktree` | التشغيل في شجرة عمل git |
| `memory: user\|project` | ذاكرة دائمة |
| `background: true` | مهمة في الخلفية |
| `maxTurns` | حد أدوار الوكيل |
| `SendMessage` | استئناف الوكلاء المتوقفين |

---
## الإعدادات ومتغيرات البيئة

### ملفات الإعدادات

| الملف | الوصف |
|------|------|
| `~/.claude/settings.json` | إعدادات المستخدم |
| `.claude/settings.json` | إعدادات المشروع المشتركة |
| `.claude/settings.local.json` | إعدادات محلية فقط |
| `~/.claude.json` | OAuth وMCP والحالة |
| `.mcp.json` | خوادم MCP للمشروع |

### الإعدادات الرئيسية

| الإعداد | الوصف |
|------|------|
| `modelOverrides` | ربط محدّد النموذج بمعرّفات نماذج مخصصة |
| `autoMemoryDirectory` | دليل ذاكرة مخصص |
| `worktree.sparsePaths` | أدلة السحب المتفرّق |

### متغيرات البيئة الرئيسية

| المتغير | الوصف |
|------|------|
| `ANTHROPIC_AUTH_TOKEN` | مفتاح API |
| `ANTHROPIC_MODEL` | النموذج الافتراضي |
| `ANTHROPIC_BASE_URL` | نقطة نهاية API (QCode.cc: `https://api.qcode.cc/api`) |
| `CLAUDE_CODE_EFFORT_LEVEL` | مستوى الجهد الافتراضي (low / med / high) |
| `MAX_THINKING_TOKENS` | حد tokens التفكير (0 = إيقاف) |
| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | حد tokens الإخراج (الافتراضي 32K) |
| `ANTHROPIC_CUSTOM_MODEL_OPTION` | إدخال مخصص في قائمة /model المنسدلة |
| `CLAUDE_CODE_PLUGIN_SEED_DIR` | أدلة بذور الإضافات (مفصولة بنقطتين) |
| `CLAUDECODE` | الكشف عمّا إذا كنت داخل shell الخاص بـ Claude Code (=1) |
| `IS_DEMO` | وضع العرض التجريبي (إخفاء البريد الإلكتروني/المؤسسة) |
| `CLAUDE_CODE_DISABLE_CRON` | تعطيل مهام cron |

---

## وضع الأذونات

| الوضع | الوصف | العلَم |
|------|------|---------|
| `auto` | يراجع مصنّف الإجراءات التي تحتاج إلى موافقة ويمنع الإجراءات الخطرة منها (الافتراضي للجلسات التفاعلية منذ 2.1.283) | `--permission-mode auto` |
| `default` | يسأل عند كل إجراء يحتاج إلى موافقة (يُوسم باسم «Manual» في الواجهة) | `--permission-mode default` |
| `acceptEdits` | قبول تعديلات الملفات تلقائيًا | `--permission-mode acceptEdits` |
| `plan` | للقراءة فقط، دون تعديلات | `--permission-mode plan` |
| `dontAsk` | يرفض كل شيء باستثناء ما سُمح به صراحةً | `--permission-mode dontAsk` |
| `bypassPermissions` | يتجاوز جميع فحوصات الأذونات | `--permission-mode bypassPermissions` |

> علَم CLI `--dangerously-skip-permissions` يكافئ `bypassPermissions`. استخدمه في البيئات المعزولة فقط.
> في CI والنصوص البرمجية، اضبط الوضع صراحةً؛ نوصي باستخدام `--permission-mode dontAsk` مع `--allowedTools`. من دون ذلك، يبدأ `claude -p` عبر QCode في الوضع auto.

---

## الإعداد السريع لـ QCode.cc

```bash
# One-line setup
export ANTHROPIC_BASE_URL=https://api.qcode.cc/api
export ANTHROPIC_AUTH_TOKEN=cr_your_key
```

> يعمل المفتاح نفسه `cr_` مع كل من Claude Code و[Codex](/docs/getting-started/codex-quick-start)، مع مشاركة حصة الخطة.

---

## الوثائق ذات الصلة

- [البرنامج التعليمي الكامل لـ Claude Code](/docs/getting-started/claude-code-tutorial) — من الصفر إلى الإتقان
- [دليل إعداد CLAUDE.md](/docs/usage/claude-md) — دليل إعدادات المشروع
- [نظام Hooks](/docs/advanced/hooks) — خطافات الأتمتة
- [الأتمتة وCI/CD](/docs/advanced/headless) — وضع بلا واجهة عمليًا
- [البرنامج التعليمي الكامل لـ Codex](/docs/ide/codex) — دليل Codex CLI
- [Codex مقابل Claude Code](/docs/getting-started/codex-vs-claude-code) — مقارنة بين أداتين
- [الخطط والأسعار](https://qcode.cc/pricing) — خطط QCode.cc