الأوامر والعلامات وملفات الذاكرة لجلسة Claude Code في مستودع حقيقي. سير العمل المتكرر ينتمي إلى أوامر مائلة مخصصة. العمل الذي يجب أن يبقى بعيدا عن الدردشة الرئيسية ينتمي إلى وكيل فرعي. الإجراءات التي يجب أن تعمل في كل مرة تنتمي إلى خطّافات.
التثبيت وبدء جلسة
المثبتات الأصلية تضع ملف claude ثنائي على مسار PATH وتحدثها في الخلفية. Homebrew و WinGet و تثبيتات حزم Linux تبقى على الإصدار الذي ثبته حتى تحديثه.
| الأمر | ماذا يفعل | مثال |
|---|---|---|
| التثبيت الأصلي، macOS أو Linux | ينزل الملف الثنائي | curl -fsSL https://claude.ai/install.sh \| bash |
| التثبيت الأصلي، PowerShell | نفس المثبت لنظام Windows PowerShell | irm https://claude.ai/install.ps1 \| iex |
| التثبيت الأصلي، CMD | استخدم هذا عندما irm ليس أمر CMD |
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd |
| صندوق Homebrew | قناة مستقرة، تأخر حوالي أسبوع | brew install --cask claude-code |
| WinGet | تحديثات يدوية | winget install Anthropic.ClaudeCode |
| حزمة npm عامة | يتطلب Node.js 22 أو لاحقا؛ claude الذي تشغله لا يزال ملف ثنائي أصلي |
npm install -g @anthropic-ai/claude-code |
| التحقق من الملف الثنائي | يطبع إصدارا بعد محطة جديدة | claude --version |
| تسجيل الدخول | اشتراك Claude بشكل افتراضي | claude auth login |
| تسجيل الدخول لفواتير API | وحدة تحكم Anthropic بدلا من اشتراك | claude auth login --console |
| تحديث تثبيت أصلي | يعمل أيضا عندما تكون التحديثات الخلفية معطلة | claude update |
| يبدأ | جلسة تفاعلية في المجلد الحالي | claude |
| ابدأ برموجه | جلسة تفتح على تلك الرسالة الأولى | claude "اشرح هذا المشروع" |
على Windows أصلي، ثبت Git for Windows بحيث تستطيع أداة shell استخدام Git Bash. بدونها، Claude Code يستخدم PowerShell. Homebrew و WinGet يبقيان في مكانهما حتى تشغل brew upgrade claude-code أو winget upgrade Anthropic.ClaudeCode، ما لم يكن CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1. claude install stable يعيد ثبيت الملف الثنائي الأصلي على قناة مستقرة.
أوامر مائلة
اكتب / في بداية الرسالة. الأحرف بعد الشرطة تصفي القائمة. النص بعد اسم الأمر هو الحجة. أمر مائل في منتصف الجملة نص عادي.
/review يعرّف /code-review الأمر المجمع. مهارة مشروع تسمى code-review تستبدل /code-review وتترك /review على المهارة المجمعة. قائمة تدقيق مخصصة تنتمي إلى /team:review, كما في أوامر مائلة مخصصة.
| الأمر | ماذا يفعل | مثال |
|---|---|---|
/help |
قوائم الأوامر المتاحة في هذه الجلسة | /help |
/clear [اسم] |
محادثة جديدة، سياق فارغ. الأسماء المستعارة: /reset, /new |
/clear auth-refactor |
/compact [تعليمات] |
تلخص المحادثة الحالية لتحرير السياق | /compact احفظ أسماء الاختبارات الفاشلة |
/model [نموذج] |
الأنماط الافتراضية والملخصات لجلسات جديدة. لا حجة تفتح منتقي. في -p، حجة نموذج تنطبق على تلك الجلسة فقط |
/model sonnet |
/init |
يكتب CLAUDE.md بدء من المستودع. إن كان موجود، يقترح تعديلات |
/init |
/review |
الاسم المستعار /code-review. كلمات الجهد تشمل low, medium, high |
/review |
/memory |
يحرّر ملفات CLAUDE.md والذاكرة التلقائية |
/memory |
/config [key=value] |
واجهة المستخدم للإعدادات. الاسم المستعار: /settings. الكتابات المباشرة تتخطى اللوحة |
/config theme=dark |
/permissions |
السماح والطلب وقواعد الرفض. الاسم المستعار: /allowed-tools |
/permissions |
/cost |
الاسم المستعار /usage: تكلفة الجلسة وحدود الخطة والنشاط |
/cost |
/agents |
تذكير لتحرير .claude/agents/ أو ~/.claude/agents/. على v2.1.197 والأقدم هذا فتح واجهة مدير |
/agents |
/hooks |
قوائم الخطّافات المكونة مجمعة حسب الحدث | /hooks |
/mcp |
قائمة خادم MCP، OAuth، تمكين، تعطيل، إعادة اتصال | /mcp |
/context يظهر ما يملأ النافذة. /tasks قوائم العمل الخلفي، بما في ذلك الوكلاء الفرعيين المنتهين. /doctor يفحص الإعداد. /vim تمت إزالته في v2.1.92. وضع المحرر تحت /config.
عيّن CLAUDE_CODE_NEW_INIT=1 قبل /init للتدفق الذي يقدم أيضا مهارات وخطّافات وملف ذاكرة شخصية. /init لن يستبدل CLAUDE.md موجود.
اختصارات لوحة المفاتيح
الربط يعتمد على المحطة. في عارض النسخ الشفافة، ? قوائم اختصارات تلك العرض.
| الاختصار | ماذا يفعل | مثال |
|---|---|---|
Enter |
يرسل الموجه | اكتب المهمة، ثم Enter |
Ctrl+J |
سطر جديد بدون إرسال. \ ثم Enter يفعل نفس الشيء |
موجه متعدد الأسطر |
Esc |
يوقف الرد الحالي أو يغلق حوارا. على موجه إذن يرفضه | Esc بينما يعمل أمر طويل |
Esc ثم Esc |
يمسح مسودة، أو يفتح إعادة ملء عندما يكون الإدخال فارغا | Esc مزدوج على موجه فارغ |
Ctrl+C |
يقاطع دورة تعمل. إذا لم يكن شيء يعمل، الضغطة الأولى تمسح المدخلات والضغطة الثانية تخرج | Ctrl+C, Ctrl+C |
Ctrl+D |
الضغطة الثانية في غضون 800 ms تخرج. مع نص في الموجه يحذف الحرف التالي | Ctrl+D, Ctrl+D |
Ctrl+L |
يعيد رسم المحطة والسجل | بعد عرض ملوث |
Ctrl+O |
عارض النسخ الشفافة: استدعاءات الأداة والطوابع الزمنية والنموذج على كل رد | Ctrl+O, ثم q للمغادرة |
Ctrl+R |
بحث عكسي سجل الموجه | Ctrl+R, ثم test |
Ctrl+B |
يضع في الخلفية shell أو وكيل يعمل. في tmux، اضغطه مرتين | أثناء تشغيل اختبار طويل |
Ctrl+G |
يفتح الموجه في محررك. Ctrl+X Ctrl+E نفس الربط |
موجه تريد إعادة كتابته |
Shift+Tab |
أوضاع الإذن الدراجة. المؤشر يصنف default كـ Manual، ثم acceptEdits, plan, وعند التوفر bypassPermissions و auto |
Shift+Tab حتى ترى plan |
Ctrl+S |
يخزن المسودة، بما في ذلك وضع shell. اضغط مرة أخرى على موجه فارغ للاستعادة | موقف موجه في منتصف الفكرة |
@ |
إكمال تلقائي مسار الملف | @src/api/server.ts |
! |
وضع shell، موصوف أدناه | ! npm test |
Ctrl+J يدرج سطر جديد في كل محطة. Shift+Enter يعمل فقط عندما يرسل المحاكي هذا.
علامات CLI
وضع الطباعة (-p, --print) يشغّل الموجه والخروج. هذا هو الشكل الذي يجب أن تستدعيه CI والنصوص البرمجية.
| العلامة | ماذا تفعل | مثال |
|---|---|---|
-p, --print |
لقطة واحدة، لا واجهة مستخدم تفاعلية | claude -p "اشرح هذه الدالة" |
--continue, -c |
آخر محادثة في هذا المجلد. يتخطى جلسات -p السابقة ما لم تمرر أيضا -p |
claude -c |
--resume, -r |
جلسة بواسطة id أو اسم أو مسار نسخ شفافة. لا قيمة تفتح منتقي | claude -r auth-refactor "أنهِ PR" |
--model |
الاسم المستعار (sonnet, opus, haiku, fable) أو معرّف نموذج كامل. يستبدل نموذج الإعدادات و ANTHROPIC_MODEL |
claude --model sonnet |
--allowedTools, --allowed-tools |
تلك الأدوات تعمل بدون موجه، ما عدا قراءات مسارات الشبكة. هذا لا يزيل الأدوات الأخرى. استخدم --tools لتقييد المجموعة |
claude -p --allowedTools "Read" "Bash(git diff *)" "ملخص الفرق" |
--output-format |
وضع الطباعة فقط: text, json, أو stream-json |
claude -p "الاستعلام" --output-format json |
cat logs.txt | claude -p "اشرح الأخطاء" يمرر ملف إلى وضع الطباعة. claude -n "auth-refactor" يسمي الجلسة ل --resume. --fork-session ينسخ محادثة مستأنفة إلى معرّف جديد. --permission-mode plan يبدأ في وضع الخطة. --dangerously-skip-permissions هو --permission-mode bypassPermissions. اتركه بعيدا على مستودع لا تثق به.
ملفات الذاكرة
Claude يقرأ CLAUDE.md في بداية كل جلسة. النص تعليمات، وليس سياسة صعبة: الأسطر القصيرة والمحددة تُتبع بشكل أكثر موثوقية من دليل أسلوب طويل. استهدف أقل من 200 سطر لكل ملف. تحقق مما حمّل بالفعل مع /context والنظر تحت ملفات الذاكرة.
ترتيب التحميل، الأوسع أولا:
| النطاق | الموقع | من ينطبق عليه |
|---|---|---|
| سياسة مدارة | macOS: /Library/Application Support/ClaudeCode/CLAUDE.md. Linux و WSL: /etc/claude-code/CLAUDE.md. Windows: C:\Program Files\ClaudeCode\CLAUDE.md |
الجميع الذي نشره المسؤول |
| مستخدم | ~/.claude/CLAUDE.md |
جميع مشاريعك. على Windows، ~/.claude هو %USERPROFILE%\.claude |
| مشروع | ./CLAUDE.md أو ./.claude/CLAUDE.md |
المستودع. التزمه |
| محلي | ./CLAUDE.local.md |
أنت، هذا السحب. أضفه إلى .gitignore |
CLAUDE.md و CLAUDE.local.md في المجلدات فوق دليل العمل حمّل كاملا عند الإطلاق. CLAUDE.md الجلوس في مجلد فرعي يحمّل عندما يقرأ Claude الملفات في ذلك المجلد.
احفظ أوامر البناء وأوامر الاختبار وتخطيط هنا. ضع إجراء متعدد الخطوات في أمر مائل بحيث يحمّل فقط عندما تستدعيه.
الواردات تستخدم @path داخل CLAUDE.md. المسارات النسبية تحل من الملف الذي يحتويها، والواردات يمكن أن تتداخل أربعة مستويات. مسار داخل علامات اقتباس هو حرفي، لذا `@README` لا يستورد README. المرة الأولى ملف مشروع يستورد شيئا خارج دليل العمل، Claude Code يطلب عليك الموافقة.
انظر @README للتخطيط و @docs/test-commands.md لكيفية تشغيل CI للاختبارات.
/memory يحرّر هذه الملفات والذاكرة التلقائية، وهي ملاحظات Claude الخاصة تحت دليل ذاكرة المشروع في ~/.claude. إذا كان المستودع يحتوي على AGENTS.md, استورده من CLAUDE.md. Claude Code يقرأ CLAUDE.md. القواعس مفصولة حسب المسار في .claude/rules/ حمّل مع الملفات التي تطابقها.
أشر إلى الملفات مع @
في الموجه، @ يفتح إكمال تلقائي مسار الملف. تلك الإشارة ليست @import المستخدم داخل CLAUDE.md. @ أيضا يعرّف وكيل فرعي. انظر دليل الوكلاء الفرعيين.
@src/auth/session.ts اشرح لماذا يتم إعادة كتابة ملف تعريف الارتباط في كل طلب.
وضع Bash مع !
ابدأ رسالة بـ ! و Claude Code يشغّل shell الخاص بك مباشرة. الأمر والإخراج تهبط في النسخ الشفافة، و Claude يجيب على هذا الإخراج. ! npm test كافية للحصول على شرح للفشل. الرد يكلف نفس سعر موجه عادي.
! git status
! git diff --stat
! npm test
الإخراج ينهمر مع تشغيل الأمر. Ctrl+B يضعه في الخلفية. Tab يكمل ! الأوامر السابقة في هذا المشروع، وعلامة تحتوي على / يكمل مسارات. اترك وضع shell مع Escape أو Backspace أو Ctrl+U على موجه فارغ. لصق سطر يبدأ بـ ! يدخل وضع shell.
هذه الأوامر تعمل خارج الحاوية. الحاوية تنطبق على الأوامر التي يختارها Claude. عيّن respondToBashCommands إلى false في settings.json لإبقاء الإخراج بدون رد آلي. سطر ! داخل ملف أمر هي ميزة مختلفة، مغطاة في أوامر مائلة مخصصة.
أنماط ستستخدمها مرة أخرى
# داخل الجلسة: /init ثم /permissions
claude -p --model haiku --allowedTools "Read" "Bash(git diff *)" --output-format json "ملخص المخاطر في الفرق"
claude -c -p "هل الأخطاء النوعية من أمس لا تزال موجودة؟"
claude -n "billing-webhook"
claude --resume billing-webhook
/compact احفظ مخطط حمل webhook
/cost
! npm test
@deploy/helm/values.yaml ماذا ينقطع إذا ذهب replicaCount من 2 إلى 1؟
/mcp يربط الأدوات الخارجية. الإعداد في خوادم MCP موضحة. نموذج يستدعي الأدوات حتى تنتهي المهمة هو الحلقة AI agentive يوضح خارج هذا CLI.
الأسئلة الشائعة
كيف أثبت Claude Code؟
على macOS أو Linux شغّل المثبت الأصلي من claude.ai/install.sh. على Windows استخدم مثبت PowerShell أو WinGet أو سكريبت CMD. npm install -g @anthropic-ai/claude-code يعمل أيضا وينزل نفس الملف الثنائي الأصلي. ثم شغّل claude --version و claude auth login.
ما الفرق بين /clear و /compact؟
/clear يبدأ محادثة جديدة بسياق فارغ. يمكنك تمرير اسم بحيث تظهر الخيط القديم في منتقي /resume. /compact يبقى في نفس المحادثة ويستبدل الأدوار السابقة برخلاصة بحيث يكون للنافذة مساحة مرة أخرى. مرر نص تركيز اختياري إلى /compact عندما يجب أن تبقى الخلاصة موضوعا واحدا.
أين يقرأ Claude Code CLAUDE.md؟
يحمّل السياسة المدارة، ثم ~/.claude/CLAUDE.md, ثم ملف المشروع في ./CLAUDE.md أو ./.claude/CLAUDE.md, ثم ./CLAUDE.local.md. الملفات في المجلدات الأب لدليل العمل الخاص بك تحمّل عند الإطلاق. CLAUDE.md في مجلد فرعي يحمّل عندما يقرأ Claude الملفات في ذلك المجلد.
كيف أستأنف جلسة Claude Code من أمس؟
من مجلد المشروع شغّل claude --resume أو claude -r لفتح منتقي. مرّر معرّف الجلسة أو الاسم الذي عيّنته مع claude -n أو /clear. claude --continue (أو -c) يفتح مرة أخرى آخر محادثة في ذلك المجلد بدون منتقي.
ماذا يفعل بادئة ! في Claude Code؟
موجه يبدأ بـ ! يعمل في وضع shell. Claude Code ينفذ الأمر، ويضع الإخراج في النسخ الشفافة، ويجيب عليه. أنت لا تنتظر Claude لاتخاذ قرار لاستدعاء shell. عيّن respondToBashCommands إلى false في settings.json إذا كنت تريد الإخراج في السياق بدون رد آلي.
كيف تم التحقق من هذا الدليل
كُتب يدويًا من الوثائق الرسمية، وأُعيد فحص كل أمر، ثم رُوجع مرة ثانية قبل النشر. آخر مراجعة في .
المصادر الرسمية التي قُرئت لهذا المقال