Claude Code هو مساعد برمجي مدعوم بالذكاء الاصطناعي يعمل مباشرة داخل الطرفية (terminal) لديك. فهو يقرأ قاعدة الشيفرة الخاصة بك، ويقترح التصحيحات، ويبني وظائف جديدة، وينفّذ الاختبارات، ويدير الملفات من خلال العمل على مشروعك محليًا.
يغطي هذا الدليل طرق التثبيت، وإعداد المصادقة، وتهيئة الطرفية وبيئة التطوير المتكاملة (IDE)، وإطلاق جلستك الأولى. يمكن للمستخدمين التثبيت عبر المثبّتات الأصلية، أو مديري الحزم، أو npm، مع المصادقة عبر OAuth أو مفاتيح API. تعمل الأداة مع أي طرفية، لكنها توفّر ميزات مُحسَّنة مع Warp وإضافات بيئة التطوير لـ VS Code وJetBrains.
البدء مع Claude Code هو أسرع طريقة لإحضار مساعد برمجي بالذكاء الاصطناعي إلى طرفيتك. يرشدك هذا الدليل عبر التثبيت، وحلقة القراءة-التقييم-الطباعة التفاعلية (REPL)، وأنماط الأذونات، ووضع التخطيط، وتهيئة مشروعك الأول.
البدء مع Claude Code: ماذا ستتعلّم
في هذا الدليل حول البدء مع Claude Code، ستعمل عبر خطوات عملية تطبيقية مع أمثلة حقيقية. يُشرح هذا الموضوع من الأساس حتى تتمكّن من تطبيقه فورًا في مشاريعك الخاصة.
فهم Claude Code
Claude Code هو مساعد برمجي مدعوم بالذكاء الاصطناعي يعمل مباشرة داخل طرفيتك — الواجهة النصية التي يُدخل المطوّرون عبرها الأوامر. فبدلًا من التنقّل عبر القوائم الرسومية، تصف ببساطة ما تحتاجه باللغة الطبيعية، ويستطيع Claude أن يقرأ قاعدة الشيفرة الخاصة بك، ويقترح التصحيحات، ويبني وظائف جديدة، وينفّذ الاختبارات، ويدير الملفات — كل ذلك من خلال العمل على مشروعك على جهازك المحلي.
مصطلحات أساسية للمبتدئين في الطرفية
- الطرفية (يُشار إليها أيضًا بالكونسول أو سطر الأوامر): نافذة نصية تكتب فيها الأوامر بدلًا من النقر على الأيقونات. على نظام macOS هذه هي Terminal.app؛ وعلى Windows هي Windows Terminal أو PowerShell.
- CLI (واجهة سطر الأوامر): برنامج تشغّله عبر أوامر مكتوبة بدلًا من واجهة رسومية. Claude Code هو تطبيق CLI.
- أمر الشرطة المائلة (slash command): اختصار سريع يبدأ بـ
/(مثل/helpأو/config) يُطلق إجراءً معيّنًا داخل Claude Code. - OAuth: تدفّق تسجيل دخول آمن يُطلق متصفّحك حتى تتمكّن من تسجيل الدخول دون لصق بيانات الاعتماد في الطرفية.
- مفتاح API: رمز سرّي يسمح لبرنامج بالمصادقة مع خدمة. يُستخدم كبديل عن OAuth عند ربط Claude Code.
- IDE (بيئة التطوير المتكاملة): محرّر شيفرة مزوّد بأدوات تطوير مدمجة — VS Code وIntelliJ IDEA وPyCharm أمثلة معروفة.
قبل أن تتمكّن من استخدام أي أمر شرطة مائلة أو بناء سير عمل، يحتاج Claude Code إلى أن يكون مثبّتًا ويعمل على جهازك. يرشدك هذا الدرس عبر عملية التثبيت، وإعداد المصادقة، واختيار التهيئة المناسبة للطرفية وبيئة التطوير، وإطلاق جلستك الأولى.
متطلّبات النظام
يدعم Claude Code نظام macOS 13+، وUbuntu 20.04+ (إلى جانب توزيعات Linux الحديثة الأخرى)، وWindows 10 1809+ (أصليًا أو عبر WSL). يلزم 4 غيغابايت من الذاكرة العشوائية كحدّ أدنى، مع التوصية بـ 8 غيغابايت للتشغيل السلس. ويُطلب اتصال إنترنت نشط في كل الأوقات.
ستحتاج أيضًا إلى حساب Anthropic مؤهَّل — تحديدًا خطة Pro أو Max أو Team أو Enterprise أو Console. لا تتضمّن الطبقة المجانية من Claude.ai الوصول إلى Claude Code. بدلًا من ذلك، يمكنك توفير مفتاح API من Anthropic Console أو الاتصال عبر Amazon Bedrock أو Google Vertex AI أو Microsoft Foundry.
على Windows، عند تثبيت Git for Windows، يستخدم Claude Code أداة Git Bash لأداة Bash. ويجري طرح أداة PowerShell تدريجيًا كخيار إضافي إلى جانب Bash — اضبط CLAUDE_CODE_USE_POWERSHELL_TOOL=1 لتمكينها أو 0 لتعطيلها.
تثبيت الـ CLI
طريقة التثبيت المفضّلة هي المثبّت الأصلي، الذي يتولّى التحديثات التلقائية في الخلفية حتى تكون دائمًا على أحدث إصدار.
لنظام macOS أو Linux (بما في ذلك WSL):
curl -fsSL https://claude.ai/install.sh | bashلنظام Windows عبر PowerShell:
irm https://claude.ai/install.ps1 | iexلنظام Windows عبر CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdتتوفّر طرق تثبيت بديلة لكنها تتطلّب تحديثات يدوية. عبر Homebrew: brew install --cask claude-code (القناة المستقرة) أو brew install --cask claude-code@latest (قناة الأحدث). عبر WinGet: winget install Anthropic.ClaudeCode. عبر npm: npm install -g @anthropic-ai/claude-code (يتطلّب Node.js 18+). على Linux، تعمل مديرات حزم النظام أيضًا: sudo apt install claude-code (Debian/Ubuntu)، أو sudo dnf install claude-code (Fedora/RHEL)، أو apk add claude-code (Alpine).
بعد التثبيت، تحقّق من التثبيت:
claude --versionلإجراء فحص شامل لتثبيتك وتهيئتك، شغّل claude doctor — فهو يتحقّق من إعدادك، وخوادم MCP، والإعدادات.
يمكنك التحكّم في قناة التحديث عبر /config — اختر بين latest (أحدث الميزات) وstable (الإصدارات المُختبَرة، المتأخرة بنحو أسبوع).
المصادقة
عندما تشغّل claude للمرة الأولى، يُطلق متصفّحك تلقائيًا لمصادقة OAuth. سجّل الدخول بحساب Anthropic الخاص بك وتكون جاهزًا.
إذا كنت تستخدم مفتاح API بدلًا من ذلك، اضبط متغيّر البيئة قبل الإطلاق:
export ANTHROPIC_API_KEY=sk-ant...لإعدادات المؤسسات أو مزوّدي السحابة، استخدم متغيّرات البيئة المقابلة:
- Amazon Bedrock:
CLAUDE_CODE_USE_BEDROCK=1 - Google Vertex AI:
CLAUDE_CODE_USE_VERTEX=1 - Microsoft Foundry:
CLAUDE_CODE_USE_FOUNDRY=1
تُخزَّن بيانات اعتمادك بشكل آمن — في macOS Keychain على Mac، أو في ~/.claude/.credentials.json (الوضع 0600) على Linux وWindows.
لتبديل الحسابات أو إعادة المصادقة في أي وقت، استخدم /logout. يمكنك أيضًا تشغيل المصادقة صراحةً بـ claude auth login — فهو يفتح تدفّق OAuth في المتصفّح، أو إذا تعذّر فتح المتصفّح، يطبع رابطًا يمكنك لصقه في أي متصفّح ثم لصق رمز التفويض مجددًا في الطرفية. تشمل الخيارات الإضافية claude auth login --email لملء بريدك الإلكتروني مسبقًا، وclaude auth login --sso للمؤسسات المُفعَّل فيها SSO، وclaude auth login --console لمصادقة مفتاح API عبر Anthropic Console.
طرفيتك: يُوصى بـ Warp
يعمل Claude Code في أي طرفية — Terminal.app وiTerm2 وWindows Terminal وAlacritty وKitty وGhostty وغيرها. لكن للحصول على أفضل تجربة، نوصي بـ Warp.
تمتلك Warp إضافة رسمية لـ Claude Code توفّر إشعارات سطح مكتب أصلية عندما يُكمل Claude مهمة، أو يحتاج إلى مدخلاتك، أو يطلب أذونات. هذا مفيد بشكل خاص للعمليات طويلة الأمد التي تنتقل خلالها إلى نافذة أخرى.
لإعداد إضافة Warp، شغّل هذه الأوامر داخل Claude Code بعد التثبيت:
/plugin marketplace add warpdotdev/claude-code-warp
/plugin install warp@claude-code-warpأعد تشغيل Claude Code بعد التثبيت لتفعيل الإضافة. ستحصل على إشعارات نظام تشغيل أصلية عند اكتمال المهام، وحالات الخمول، وطلبات الأذونات — دون الحاجة إلى المراجعة اليدوية بعد الآن.
بشكل افتراضي، يرسل Claude Code إشعارات سطح المكتب فقط في Ghostty وKitty وiTerm2. في أي طرفية أخرى، اضبط preferredNotifChannel على "terminal_bell" لإصدار جرس الطرفية بدلًا من ذلك، أو هيّئ خطّاف إشعار (Notification hook) لصوت مخصّص. كما تعمل Shift+Enter لإدراج سطر جديد دون إعداد في معظم الطرفيات؛ وفي VS Code وCursor وDevin Desktop وAlacritty وZed، شغّل /terminal-setup مرة واحدة لكتابة ذلك الاختصار.
بشكل افتراضي، يستخدم Claude Code الشاشة البديلة للطرفية لتجربة عرض بملء الشاشة. إذا كنت تفضّل الاحتفاظ بالمحادثة في سجلّ التمرير الأصلي للطرفية (مفيد لقارئات الشاشة، أو مُعدِّدات الطرفية، أو توجيه المخرجات عبر الأنابيب)، اضبط CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 قبل الإطلاق.
إضافات بيئة التطوير (IDE)
بدأ Claude Code كأداة CLI، لكنه يمتلك الآن إضافات رسمية للمحرّرات الرئيسية. يمكنك استخدام كليهما — الـ CLI للعمل المكثّف في الطرفية والإضافة للراحة داخل المحرّر.
VS Code هو التكامل الأكثر نضجًا. ثبّته من VS Code Marketplace أو شغّل code --install-extension Anthropic.claude-code. يمنحك واجهة رسومية أصلية، ومراجعة فروق مرئية، ومراجع للملفات، وسجلّ محادثات، والقدرة على تشغيل محادثات متعدّدة في علامات تبويب.
تمتلك JetBrains إضافة رسمية في مرحلة بيتا، متاحة في JetBrains Marketplace لـ IntelliJ IDEA وWebStorm وPyCharm وبيئات JetBrains الأخرى. وهي تنسّق الـ CLI مع عارض الفروق في بيئة التطوير لتجربة سلسة.
Cursor وDevin Desktop (أُعيدت تسميته من Windsurf في الإصدار v2.1.162) وKiro هي نسخ متفرّعة من VS Code تدعم إضافة VS Code والطرفية المدمجة. في VS Code وCursor وDevin Desktop، يُطفئ /terminal-setup تسريع وحدة معالجة الرسوميات (GPU) للطرفية المدمجة (لمنع النص المشوَّه) ويضبط حساسية التمرير لديها لتمرير أكثر سلاسة بملء الشاشة، كما يستخدم /ide و/scroll-speed تسمية Devin Desktop الجديدة أيضًا.
إلى جانب إضافات بيئة التطوير، يوجد أيضًا تطبيق سطح مكتب لنظامي macOS وWindows (غير متاح على Linux — استخدم الـ CLI بدلًا منه) يوفّر فروقًا مرئية، ومعاينة حية للتطبيق، ووكلاء خلفية مستقلين — دون الحاجة إلى طرفية. وClaude Code على الويب (claude.ai/code) هو معاينة بحثية تعمل على أجهزة افتراضية سحابية، حتى تتمكّن من العمل من أي متصفّح دون أي إعداد محلي.
جلستك الأولى
انتقل إلى أي مجلّد مشروع وأطلق Claude Code:
cd my-project
claudeسترى رسالة ترحيب ومُحفِّزًا للإدخال. ما عليك سوى كتابة ما تريد أن يفعله Claude بلغة إنجليزية بسيطة. يمكنك أيضًا لصق الصور بـ Ctrl+V — يظهر تلميح “Pasting…” في التذييل أثناء قراءة الصورة من الحافظة:
ما الملفات الموجودة في هذا المشروع وما الذي يفعله؟سيقرأ Claude ملفاتك، ويحلّل البنية، ويعطيك ملخّصًا. من هنا، يمكنك أن تطلب منه إجراء تغييرات، أو إصلاح أخطاء، أو تشغيل اختبارات، أو شرح شيفرة. عندما يحتاج Claude إلى تنفيذ إجراءات مثل تعديل الملفات أو تشغيل الأوامر، سيطلب إذنك أولًا.
هذا كل شيء — أنت جاهز. توجّه إلى الوحدة التالية لتتعلّم أوامر الشرطة المائلة التي تجعل Claude Code قويًا حقًا.
نصائح احترافية
- شغّل
/initفي كل مشروع جديد. فهو يولّد ملفCLAUDE.mdيمنح Claude سياقًا دائمًا حول قاعدة الشيفرة الخاصة بك — هذه الخطوة الواحدة تحسّن جودة الاستجابات بشكل كبير عبر الجلسات. - كن محدّدًا في مُحفِّزاتك. بدلًا من “أصلح الخطأ”، قل “نموذج تسجيل الدخول على /auth يُرجع خطأ 500 عندما يكون حقل البريد الإلكتروني فارغًا — جِد السبب وأصلحه”. التحديد يضيّق مساحة بحث Claude وينتج نتائج أفضل.
- استخدم
/clearبين المهام غير المرتبطة. نافذة سياق Claude Code محدودة. ومسح المحادثة يمنع تسرّب السياق غير المرتبط إلى مهمتك التالية. - راجع كل فرق ملف قبل القبول. يعرض لك Claude Code دائمًا ما يخطّط لتغييره. اجعل هذا عادةً — فهو يلتقط سوء الفهم مبكرًا ويبقيك مسيطرًا.
- أبقِ Claude Code محدّثًا. تُطرح ميزات وإصلاحات جديدة بشكل متكرّر. شغّل
npm update -g @anthropic-ai/claude-codeبانتظام، أو تحقّق من الإصدار بـ/status.
تحدٍّ تطبيقي: إعداد جلستك الأولى في Claude Code
المهمة: ثبّت Claude Code، وهيّئ مشروعًا، واجعل Claude ينشئ تطبيق “Hello World” بسيطًا من الصفر.
الخطوات
- ثبّت Claude Code عالميًا عبر npm:
npm install -g @anthropic-ai/claude-code - أنشئ مجلّدًا جديدًا لمشروعك وادخل إليه بـ
cd - أطلق Claude Code وشغّل
/initلتوليد ملفCLAUDE.mdمبدئي - اطلب من Claude أن “ينشئ سكربت Node.js بسيطًا يطبع Hello World ويتضمّن ملف README”
- راجع الملفات التي يولّدها Claude واطرح سؤال متابعة واحدًا (مثل، “أضف وسيطة سطر أوامر لتحية مخصّصة”)
النتيجة المتوقّعة
يجب أن يكون لديك ملف index.js عامل (أو ما يعادله) يعمل دون أخطاء، وملف CLAUDE.md ممتلئ في جذر المشروع، وملف README يصف المشروع.
تلميح: إذا طلب Claude إذنًا لتشغيل الأوامر، اكتب
yللسماح. يمكنك دائمًا كتابة/helpلرؤية الأوامر المتاحة في أي وقت.
اختبار المعرفة: البدء مع Claude Code
اختبر فهمك بأسئلة الاختبار هذه. حاول الإجابة عن كل سؤال قبل الكشف عن الإجابة.
1. ما النمطان الأساسيان لواجهة Claude CLI؟
- النمط المتصل وغير المتصل بالإنترنت
- حلقة REPL التفاعلية (claude) ونمط الطباعة (claude -p)
- النمط الرسومي ونمط الطرفية
- النمط الفردي والنمط الدُّفعي
الإجابة الصحيحة: B. حلقة REPL التفاعلية هي النمط الحواري الافتراضي. نمط الطباعة (-p) غير تفاعلي، وقابل للبرمجة النصية، وقابل للتوجيه عبر الأنابيب. وهو يخرج بعد استجابة واحدة.
2. كيف توجّه ملفًا إلى Claude عبر الأنبوب وتحصل على مخرجات JSON؟
- claude –file error.log –json
- cat error.log | claude -p –output-format json “explain this”
- claude < error.log –format json
- claude -p –input error.log –json
الإجابة الصحيحة: B. وجّه المحتوى عبر stdin إلى نمط الطباعة (-p) واستخدم –output-format json للحصول على مخرجات مهيكلة.
3. ما أنماط الأذونات الستة في Claude Code؟
- read, write, execute, admin, root, sudo
- default, acceptEdits, plan, auto, dontAsk, bypassPermissions
- safe, normal, elevated, admin, unrestricted, god
- view, edit, run, deploy, full, bypass
الإجابة الصحيحة: B. الأنماط الستة هي: default (يطلب الإذن)، acceptEdits (يقبل تعديلات الملفات تلقائيًا)، plan (تحليل للقراءة فقط)، auto (يقرّر مصنّف يعمل في الخلفية)، dontAsk (يرفض تلقائيًا ما لم يكن موافَقًا عليه مسبقًا)، bypassPermissions (يتخطّى كل الفحوصات).
4. كيف تُفعّل وضع التخطيط؟
- عبر أمر /plan فقط
- عبر /plan، أو Shift+Tab/Alt+M، أو راية –permission-mode plan، أو التهيئة الافتراضية
- عبر راية –planning فقط
- التخطيط مُفعَّل دائمًا
الإجابة الصحيحة: B. يمكن تفعيل وضع التخطيط عبر أمر /plan، أو اختصار لوحة المفاتيح Shift+Tab/Alt+M، أو راية CLI –permission-mode plan، أو كإعداد افتراضي في التهيئة.
5. ماذا يفعل أمر /init؟
- يهيّئ مشروع Claude Code جديدًا من الصفر
- يولّد ملف CLAUDE.md نموذجيًا بناءً على بنية مشروعك
- يعيد ضبط كل الذاكرة إلى الإعدادات الافتراضية
- ينشئ جلسة جديدة
الإجابة الصحيحة: B. يحلّل /init مشروعك ويولّد ملف CLAUDE.md نموذجيًا مع قواعد ومعايير مقترحة. وهو أداة تمهيد لمرّة واحدة.
اختبر معرفتك
موارد إضافية
| المورد | النوع | الرابط |
|---|---|---|
| Claude Code — دليل التثبيت | وثائق رسمية | code.claude.com/docs/en/install |
| Claude Code — البدء السريع | وثائق رسمية | code.claude.com/docs/en/quickstart |
| Claude Code — النمط التفاعلي | وثائق رسمية | code.claude.com/docs/en/interactive-mode |
| Claude Code — مرجع الـ CLI | وثائق رسمية | code.claude.com/docs/en/cli-reference |
| مفاتيح Anthropic API | Console | console.anthropic.com |
| سجلّ تغييرات Claude Code | GitHub | CHANGELOG.md |
كم يستغرق الأمر لتصبح منتجًا؟
معظم المطوّرين يصبحون منتجين خلال جلسة واحدة. البدء مع Claude Code سلس عمدًا: ثبّت، وافتح مشروعًا، واطرح سؤالًا، ووافق على تغيير صغير في وضع التخطيط.
هل يمكنني التراجع عمّا يغيّره المساعد؟
نعم. لأنه يعدّل الملفات في مشروعك الحقيقي، فإن نظام التحكّم في الإصدارات لديك هو شبكة الأمان. أودِع التغييرات (commit) قبل التغييرات الكبيرة وراجع الفروق كما تراجع أي طلب سحب (pull request).
هل يعمل مع لغتي أو إطار عملي؟
يعمل مع أي شيء موجود في مجلّد مشروعك، لأنه يقرأ ملفاتك الفعلية بدلًا من الاعتماد على قائمة ثابتة من المنصّات المدعومة.
البدء مع Claude Code: الأسئلة الشائعة
كيف تُثبّت Claude Code وتشغّله لأول مرة؟
يُثبَّت كأداة سطر أوامر (CLI) ثم يُشغَّل من داخل مجلد مشروعك الفعلي، حتى يتمكن من قراءة الشيفرة الموجودة والتفاعل معها مباشرة بدل العمل في فراغ.
ما وضع التخطيط (plan mode) ولماذا يُنصح باستخدامه؟
وضع التخطيط يجعل الأداة تعرض خطة عمل مقترحة قبل تنفيذ أي تعديل فعلي؛ يُنصح باستخدامه لأي مهمة غير بسيطة كي تراجع الخطوات وتوافق عليها قبل أن تُطبَّق على شيفرتك.
لماذا يحتاج Claude Code إلى معرفة أوامر البناء والاختبار في مشروعك؟
تسجيل أوامر البناء (build) والاختبار (test) والتدقيق (lint) يتيح للأداة التحقق من عملها بنفسها بعد كل تعديل، بدل الاعتماد الكامل عليك لاكتشاف الأخطاء لاحقًا.
هل من الآمن ترك Claude Code يعدّل الشيفرة مباشرة دون مراجعة؟
الأفضل التعامل مع كل تعديل كفرق (diff) قابل للمراجعة قبل قبوله، خصوصًا في التغييرات الكبيرة؛ هذا يحافظ على السيطرة الكاملة على ما يدخل فعليًا إلى مشروعك.
ما أفضل ممارسة لإدارة Git أثناء العمل مع Claude Code؟
يُنصح بحفظ (commit) حالة المشروع قبل أي تغييرات كبيرة، بحيث يسهل التراجع إذا لم تكن النتيجة كما هو متوقّع، وتبقى كل خطوة قابلة للتتبع والمراجعة.
البدء مع Claude Code يمنحك سير عمل متينًا وقابلًا للتكرار. ضع علامة مرجعية على دليل البدء مع Claude Code هذا وارجع إلى الخطوات كلما احتجت إليها.
جلستك الأولى: جولة سريعة
بمجرّد تثبيت الـ CLI، افتح طرفية داخل مجلّد مشروع حقيقي وأطلقه. يقرأ المساعد الملفات في ذلك المجلّد، حتى يتمكّن من الإجابة عن أسئلة حول شيفرتك الفعلية منذ أول مُحفِّز بدلًا من العمل في المجرّد.
ابدأ بأن تطلب منه تلخيص المشروع. فطلب مثل “اشرح ما يفعله هذا المستودع وكيف تتلاءم القطع الرئيسية معًا” يمنحك توجيهًا سريعًا ويؤكّد أن المساعد يستطيع رؤية ملفاتك. وهذه أيضًا طريقة آمنة للقراءة فقط للتحقّق من أن الأذونات مضبوطة كما تتوقّع.
لأول تغيير حقيقي لك، انتقل إلى وضع التخطيط. صِف النتيجة التي تريدها، وراجع الخطة التي يقترحها المساعد، ووافق عليها قبل لمس أي ملف. يحوّل وضع التخطيط التعديل من صندوق أسود إلى اقتراح قابل للمراجعة، وهو بالضبط ما تريده بينما لا تزال تبني الثقة في الأداة.
بعد إتمام التغيير، اطلب من المساعد تشغيل أوامر الاختبار والتدقيق لديك. إذا سجّلت تلك الأوامر في ذاكرة مشروعك، فسيعرف كيف يتحقّق من عمله بنفسه، ويلتقط الأخطاء مبكرًا، ويسلّمك تغييرًا جاهزًا للمراجعة بدلًا من تغيير عليك تنقيحه من الصفر.
البدء مع Claude Code: أخطاء شائعة يجب تجنّبها
يقع كثير من المستخدمين الجدد في العقبات نفسها عند إعداد Claude Code للمرة الأولى. تجنّب هذه الأخطاء يوفّر عليك وقتًا ثمينًا ويمنحك انطباعًا أفضل عن الأداة منذ الجلسة الأولى.
- الاعتماد على مثبّت بديل مثل npm أو Homebrew دون تفعيل التحديث التلقائي، فتظل عالقًا على إصدار قديم يفتقد إصلاحات وميزات لاحقة.
- تجاهل رسالة الخطأ الأولى بدلًا من تشغيل
claude doctorفورًا، رغم أنه يكشف عن مشكلات التهيئة والمصادقة خلال ثوانٍ. - إطلاق الجلسة الأولى من مجلد المستخدم الرئيسي بدلًا من مجلد مشروع حقيقي، فيفتقد Claude أي سياق مفيد عن شيفرتك.
- تفعيل نمط bypassPermissions في أول تجربة بدلًا من ترك الوضع الافتراضي، وهو ما يزيل شبكة الأمان قبل أن تبني ثقة كافية بقرارات الأداة.
البدء مع Claude Code: أفضل الممارسات
- ثبّت الـ CLI عالميًا وشغّله داخل مجلّد مشروع حقيقي حتى يستطيع قراءة شيفرتك وتهيئتك.
- ابدأ في وضع التخطيط للمهام غير التافهة حتى تتمكّن من مراجعة النهج قبل تغيير أي ملفات.
- استخدم النمط الأكثر تساهلًا الذي ترتاح له لتقليل المُحفِّزات، لكن أبقِ الإجراءات المُدمِّرة مقيّدة.
- أنشئ ملف CLAUDE.md مبكرًا حتى يتذكّر المساعد أعراف المشروع عبر الجلسات.
- أبقِ كل جلسة مركّزة على مهمة واحدة؛ وابدأ جلسة جديدة عند تبديل السياق.
