أستخدم Claude Code يومياً منذ أوائل 2025، ويمكنني أن أخبرك أن أكبر عامل واحد للحصول على نتائج مفيدة ليس هندسة الأوامر أو الحيل الذكية. إنه السياق. تحديداً، إنه ملف CLAUDE.md مكتوب جيداً الموجود في جذر مشروعك. هذا الملف الواحد هو الفرق بين مساعد ذكاء اصطناعي يحارب قاعدة الأكواد الخاصة بك وبين واحد يشعر وكأنه مطور أول منذ انضم لفريقك منذ أشهر.

إذا كنت تلقي الأوامر على Claude Code وتحصل على نتائج عامة أو خاطئة أو محبطة، فهذا الدليل موجه لك. سأشرح بالضبط كيفية هيكلة CLAUDE.md الخاص بك، ما يجب تضمينه، ما يجب تركه، وأشارك أمثلة حقيقية من المشاريع التي أطلقناها في Social Animal.

جدول المحتويات

ما هو CLAUDE.md ولماذا يهم

CLAUDE.md هو ملف markdown تضعه في جذر المستودع الخاص بك وقراءته Claude Code تلقائياً في كل مرة يبدأ جلسة. فكر فيه كوثيقة استقبال لشريكك في البرمجة بالذكاء الاصطناعي. عندما ينضم مطور جديد إلى فريقك، لا تعطيه جهاز كمبيوتر وتقول "اكتشف الأمر بنفسك". تشرح له العمارة، تشرح الأجزاء الغريبة، تشير إلى الألغام. CLAUDE.md يفعل الشيء نفسه مع Claude.

بدون ذلك، يجب على Claude Code أن يستنتج كل شيء من هيكل الملف الخاص بك، package.json، وأي ملفات يحدث أنه يقرأها. هذا مثل طلب موظف جديد أن يفهم نظامك بالكامل من خلال قراءة ملفات المصدر العشوائية. سيحصل على بعض الأشياء بشكل صحيح، لكنه سيفترض أيضاً افتراضات تهدر وقت الجميع.

مع CLAUDE.md متين، رأيت دقة إكمال المهام تقفز من حوالي 60% إلى أكثر من 90% في المحاولات الأولى. هذا ليس تحسناً صغيراً — إنه الفرق بين الدعم المدعوم بالذكاء الاصطناعي في التطوير كونه مضاعفاً للإنتاجية وكونه مصدر إحباط.

كيف يقرأ Claude Code سياق مشروعك

Claude Code لديه تسلسل هرمي محدد لتحميل السياق. فهم هذا مهم لأنه يؤثر على كيفية تنظيم ذاكرة مشروعك.

ترتيب تحميل السياق

  1. ~/.claude/CLAUDE.md — تفضيلاتك العالمية (المطبقة على كل مشروع)
  2. ./CLAUDE.md — الملف على مستوى المشروع في جذر المستودع الخاص بك
  3. ./subdirectory/CLAUDE.md — تجاوزات خاصة بالمجلد
  4. .claude/settings.json — أذونات الأدوات وإعدادات المشروع المحددة
  5. سياق الجلسة — ما تخبر Claude به في المحادثة الحالية

ملف CLAUDE.md على مستوى المشروع هو حيث ستقضي معظم وقتك. الملف العام جيد للتفضيلات الشخصية ("أفضل المكونات الوظيفية" أو "استخدم دائماً نمط TypeScript Strict")، لكن القيمة الحقيقية في السياق لكل مشروع.

إليك ما هو حاسم: Claude Code يقرأ CLAUDE.md في بداية كل جلسة، لكنه يتمتع أيضاً بمساحة نافذة سياق محدودة. إذا كان CLAUDE.md الخاص بك 5000 كلمة من الوثائق العشوائية، فأنت تحرق الرموز التي يمكن استخدامها لاستدلال الأكواد الفعلي. كن موجزاً. كن محدداً. كل سطر يجب أن يحقق قيمته.

تشريح ملف CLAUDE.md الرائع

بعد كتابة وصقل ملفات CLAUDE.md عبر عشرات المشاريع — تطبيقات Next.js، مواقع Astro، تكاملات CMS بدون رأس، خدمات API — استقررت على بنية متسقة تعمل.

الهيكل المثالي

# اسم المشروع

## نظرة عامة
فقرة واحدة توضح ما يفعله هذا المشروع ومن يستخدمه.

## مجموعة التقنيات
الإصدارات الدقيقة والأطر.

## العمارة
كيف تتناسب القطع مع بعضها.

## الاتفاقيات الرئيسية
معايير الترميز وأنماط التسمية وقواعد تنظيم الملفات.

## الأوامر الشائعة
أوامر البناء والاختبار والنشر والتطوير.

## السياق المهم
الأشياء التي لا تكون واضحة من الأكواد.

## المشاكل المعروفة / الفخاخ
الألغام لتجنبها.

## لا تفعل
الأشياء الواضحة التي لا يجب أن يفعلها الذكاء الاصطناعي.

دعنا نتعمق في كل قسم.

شرح القسم تلو الآخر

نظرة عامة

احتفظ بهذا بحد أقصى 2-3 جمل. Claude لا يحتاج خارطة الطريق الخاصة بمنتجك — يحتاج إلى فهم المجال حتى يتمكن من اتخاذ قرارات سياقية مناسبة.

## نظرة عامة
هذا هو موقع التسويق لـ Acme Corp، وهي منصة SaaS B2B لإدارة سلسلة التوريد. يتم إنشاء الموقع بشكل ثابت مع المسارات الديناميكية للتعامل مع النماذج وجمع العملاء المحتملين. يتم إدارة المحتوى من خلال Sanity CMS بواسطة فريق التسويق.

مجموعة التقنيات

كن دقيقاً. لا تقل فقط "React" — حدد الإصدار والإطار واستراتيجية العرض. هذا يمنع Claude من اقتراح الأنماط التي تعمل في React 18 لكن تنقطع في React 19، أو التوصية بـ Pages Router عندما تكون على App Router.

## مجموعة التقنيات
- **الإطار**: Next.js 15.1 (App Router، RSC بشكل افتراضي)
- **اللغة**: TypeScript 5.7 (وضع صارم)
- **التنسيق**: Tailwind CSS v4 مع تكوين أول للـ CSS
- **CMS**: Sanity v3 مع معاينة مباشرة
- **النشر**: Vercel (بيئات Production + Preview)
- **مدير الحزم**: pnpm 9.x
- **Node**: v22 LTS
- **الاختبار**: Vitest + Playwright
- **إدارة الحالة**: Zustand (حد أدنى، فقط حالة UI من جانب العميل)

العمارة

هذا هو المكان الذي يكتب فيه معظم الناس القليل جداً أو الكثير جداً. أنت لا تكتب وثيقة تصميم النظام. أنت تعطي Claude نموذجاً عقلياً.

## العمارة
- `app/` — صفحات وتخطيطات Next.js App Router
- `app/api/` — مسارات API (تقديم النماذج، webhooks)
- `components/` — مكونات واجهة المستخدم المشتركة (التصميم الذري: atoms/، molecules/، organisms/)
- `lib/` — وظائف خدمية، عملاء API، تعريفات النوع
- `lib/sanity/` — عميل Sanity، الاستعلامات (GROQ)، وتوليد النوع
- `content/` — ملفات MDX لمنشورات المدونة (مع Frontmatter)
- `public/` — الأصول الثابتة (تفضيل next/image لجميع الصور)

تدفق البيانات: Sanity CMS → استعلامات GROQ في lib/sanity/queries.ts → Server Components → Client Components (فقط عند الحاجة إلى التفاعلية)

تم إنشاء جميع الصفحات بشكل ثابت في وقت البناء باستثناء /blog/[slug]/preview الذي يستخدم وضع المسودة.

الاتفاقيات الرئيسية

هذا القسم يوفر معظم الوقت. بدونه، سيتبع Claude أفضل الممارسات العامة التي قد تتعارض مع خيارات فريقك.

## الاتفاقيات الرئيسية
- المكونات مسماة بـ PascalCase، مكون واحد لكل ملف
- استخدم التصديرات المسماة، لا تصديرات افتراضية أبداً (باستثناء pages/layouts)
- يحدث جميع جلب البيانات في Server Components — لا تستخدم useEffect أبداً لجلب البيانات
- أنواع استجابة API تعيش في lib/types/ وتم إنشاء آلياً من مخطط Sanity
- استخدم أداة `cn()` (lib/utils.ts) لدمج فئات مشروطة، وليس الحرفية الموجهة
- حدود الأخطاء تلتف حول كل قسم صفحة رئيسي، وليس الصفحة بأكملها
- كل معالجة النموذج تستخدم react-hook-form + مخططات التحقق من صحة zod
- رسائل الالتزام تتبع Conventional Commits (feat:، fix:، chore:)

الأوامر الشائعة

قد يبدو هذا أساسياً، لكن Claude Code يشغل هذه الأوامر فعلاً. إذا كان لا يعرف الأوامر الصحيحة، سيخمن، وغالباً سيخمن بشكل خاطئ.

## الأوامر الشائعة
- `pnpm dev` — بدء خادم التطوير (المنفذ 3000)
- `pnpm build` — بناء الإنتاج
- `pnpm lint` — فحص ESLint + Prettier
- `pnpm test` — تشغيل اختبارات Vitest
- `pnpm test:e2e` — تشغيل اختبارات Playwright E2E
- `pnpm sanity:typegen` — إعادة إنشاء أنواع Sanity بعد تغييرات المخطط
- `pnpm db:migrate` — تشغيل ترحيلات Drizzle ORM

السياق المهم

هذا للأشياء التي لا يمكن لـ Claude أن يستنتجها من قراءة الأكواس الخاصة بك. منطق العمل، القيود الخارجية، الأشياء التي ستستغرق مراجع بشري 30 دقيقة لشرحها.

## السياق المهم
- نستخدم ISR (revalidate: 3600) لجميع صفحات CMS. لا تستخدم `force-dynamic` أبداً إلا إذا كان ضرورياً تماماً.
- webhook Sanity في /api/revalidate يتعامل مع إعادة التحقق من الطلب — لا تضيف منطق إعادة التحقق اليدوي.
- تحسين الصور يمر عبر Sanity CDN (cdn.sanity.io)، وليس next/image لمحتوى CMS.
- المصادقة يتم التعامل معها من خلال Clerk — لا تبني أبداً تدفقات مصادقة مخصصة.
- نقطة نهاية /api/leads لها حد معدل عبر Upstash Redis. لا تزيل ميدلوير حد المعدل.

الفخاخ المعروفة

لكل مشروع أشياء غريبة. ضعها هنا حتى لا ينزلق Claude عليها.

## الفخاخ المعروفة
- مُعيد Sanity's Portable Text له خطأ مع القوائم المتداخلة في v3.2. نستخدم مُسلسل مخصص في components/portable-text/list-fix.tsx
- Tailwind v4 لا يدعم المسمى `@apply` في ملفات CSS module — استخدم فئات مضمنة بدلاً من ذلك
- إعادة التوجيه vercel.json لـ /docs/* تحقق بالوكيل إلى موقع Mintlify docs الخاص بنا. لا تعدّل هذه بدون التحقق من الفريق.
- متغيرات البيئة بـ NEXT_PUBLIC_ prefix هي الوحيدة المتاحة من جانب العميل. لا تعرّض أبداً أسرار API بهذه الطريقة.

قسم "لا تفعل"

قد يكون هذا هو الأقسام الأكثر أهمية. التعليمات السلبية فعالة بشكل استثنائي مع نماذج الذكاء الاصطناعي.

## لا تفعل
- لا تثبّت تبعيات جديدة بدون السؤال أولاً
- لا تستخدم `any` type — ابحث أو أنشئ أنواعاً مناسبة
- لا تنشئ مسارات API جديدة للأشياء التي يمكن القيام بها في Server Components
- لا تعدّل ملفات مخطط Sanity بدون تأكيد خطة الترحيل
- لا تستخدم `"use client"` إلا إذا احتاج المكون حقاً إلى APIs المتصفح أو معالجات الأحداث
- لا تكتب ملفات CSS — كل شيء هو فئات خدمية Tailwind
- لا تحرّق أوتاد النصوص التي يجب أن تأتي من CMS

أمثلة CLAUDE.md الحقيقية

مثال: موقع Next.js للتسويق

هذا نسخة مختصرة من CLAUDE.md نستخدمه في مشاريع العملاء، خاصة عند بناء مواقع Next.js مع خلفيات CMS بدون رأس.

# موقع Acme التسويقي

## نظرة عامة
موقع تسويقي لـ Acme (acme.com). مبني مع Next.js 15، محرر نسق مع Tailwind v4، محتوى من Sanity CMS. الهدف: LCP تحت 2 ثانية على جميع الصفحات.

## مجموعة التقنيات
Next.js 15.1 | TypeScript 5.7 صارم | Tailwind v4 | Sanity v3 | Vercel | pnpm

## العمارة
App Router مع RSC. جميع جلب البيانات في server components عبر استعلامات GROQ في lib/sanity/queries.ts. مكونات العميل فقط للعناصر التفاعلية (الحوارات، النماذج، أساليب العرض الدوراني).

الصفحات: / (الرئيسية)، /about، /pricing، /blog، /blog/[slug]، /contact

## الاتفاقيات
- تصديرات مسماة فقط (باستثناء page.tsx/layout.tsx)
- المكونات: PascalCase، واحد لكل ملف
- cn() لدمج الفئات
- مخططات Zod لجميع التحقق من صحة النموذج
- لا useEffect لجلب البيانات. أبداً.

## الأوامر
pnpm dev | pnpm build | pnpm lint | pnpm test

## لا تفعل
- أضف "use client" بدون تبرير
- ثبّت الحزم بدون السؤال
- استخدم التصديرات الافتراضية للمكونات
- عدّل sanity/schema/ ملفات بدون تأكيد الترحيل
- استخدم any type

مثال: موقع محتوى Astro

بالنسبة لمشاريع Astro، يبدو CLAUDE.md مختلفاً قليلاً لأن نموذج العمارة مختلف.

# مدونة التقنية — Astro

## نظرة عامة
mدونة مطورين مع أكثر من 500 مقالة. ثابتة أولاً، صفر JS بشكل افتراضي. MDX للمحتوى مع مكونات مخصصة.

## مجموعة التقنيات
Astro 5.x | MDX | Tailwind v4 | مرشح إلى Cloudflare Pages | Content Collections v2

## العمارة
src/content/ — مقالات MDX مع frontmatter التحقق من صحة Zod
src/components/ — مكونات Astro (صفر JS) وجزر React (تفاعلية)
src/layouts/ — التخطيطات الأساسية
src/pages/ — التوجيه المستند إلى الملفات

## القواعد الرئيسية
- الافتراضي لمكونات Astro (.astro). استخدم React فقط للجزر التي تحتاج إلى تفاعلية.
- client:visible للمكونات التفاعلية أسفل الطية
- client:idle للمكونات التفاعلية غير الحرجة
- لا تستخدم client:load directive إلا إذا كان ضرورياً تماماً
- جميع الصور تستخدم مكون Astro Image مع width/height مناسب
- تغذية RSS يتم إنشاؤها آلياً من مجموعة المحتوى — لا تبني منطق التغذية اليدوي

## لا تفعل
- أضف مكونات React عندما مكون Astro سيعمل
- استخدم client:load directive
- تخطي أبعاد الصورة (يسبب CLS)
- عدّل مخطط مجموعة المحتوى بدون تحديث frontmatter الموجودة

الأخطاء الشائعة التي تدمر سياق الذكاء الاصطناعي

لقد راجعت الكثير من ملفات CLAUDE.md في هذه النقطة. إليك الأنماط التي تؤدي باستمرار إلى نتائج سيئة.

الخطأ لماذا يؤذي الإصلاح
طويل جداً (2000+ كلمة) يحرق رموز نافذة السياق، المعلومات الرئيسية تضيع اجعلها تحت 800 كلمة. ربط الوثائق الخارجية للتعمقات العميقة.
غامضة جداً ("نستخدم React") Claude يملأ الفراغات بالافتراضات كن محدداً: الإصدارات، الأنماط، الأدوات الدقيقة
لا توجد تعليمات سلبية Claude يفعل الأشياء "المعقولة" التي تنقطع الاتفاقيات الخاصة بك ضمن قسم "Do NOT" دائماً
نسخ-لصق README.md READMEs للبشر، وليس سياق AI اكتب CLAUDE.md من الصفر مع إطار AI محدد
تضمين البيانات الحساسة مفاتيح API، أسرار في ملفات السياق أبداً لا تضع الأسرار في CLAUDE.md. ارجع إلى .env.example بدلاً من ذلك
لا تحدثها أبداً المشروع يتطور، ملف السياق لا راجع CLAUDE.md في كل sprint أو refactor رئيسي
تعليمات متناقضة "استخدم server components" + أمثلة مع useEffect fetching يملك شخص واحد الملف، راجع للاتساق

CLAUDE.md مقابل ملفات سياق الذكاء الاصطناعي الأخرى

Claude Code ليس الأداة الوحيدة AI التي تقرأ ملفات سياق المشروع. إليك كيف تبدو المناظر الطبيعية في 2025:

الملف الأداة قراءة تلقائية النطاق
CLAUDE.md Claude Code نعم، في بداية الجلسة على مستوى المشروع
.cursorrules Cursor نعم، عند فتح الملف على مستوى المشروع
.github/copilot-instructions.md GitHub Copilot نعم، في Copilot Chat على مستوى المستودع
.windsurfrules Windsurf (Codeium) نعم على مستوى المشروع
AGENTS.md OpenAI Codex CLI نعم على مستوى المشروع
.ai/context.md اتفاق مخصص لا (مرجع يدوي) متنوع

الخبر السار: معظم المحتوى قابل للنقل. إذا كتبت CLAUDE.md متينة، تحويلها إلى .cursorrules أو copilot-instructions.md يستغرق حوالي 5 دقائق. الهيكل والمعلومات متطابقة — فقط اسم الملف والتنسيق الطفيفة يختلفان.

إذا كان فريقك يستخدم أدوات AI متعددة (وكثير يفعلون في 2025)، فكر في الحفاظ على مصدر حقيقي واحد وإنشاء ملفات الأدوات المحددة منه. سكريبت بناء بسيط يمكن أن ينسخ ملف السياق الرئيسي إلى جميع الموقع الصحيحة.

الأنماط المتقدمة للمشاريع الكبيرة

ملفات CLAUDE.md المتداخلة

بالنسبة لـ Monorepos أو قواعد أكواد كبيرة، يمكنك وضع ملفات CLAUDE.md في مجلدات فرعية. سيقرأ Claude Code الملف الأكثر تحديداً للمجلد الذي تعمل فيه.

project/
├── CLAUDE.md              # سياق المشروع العالمي
├── apps/
│   ├── web/
│   │   └── CLAUDE.md      # سياق تطبيق الويب محدد
│   └── api/
│       └── CLAUDE.md      # سياق API محدد
├── packages/
│   └── ui/
│       └── CLAUDE.md      # سياق نظام التصميم

ملف CLAUDE.md الجذر يغطي العمارة والاتفاقيات المشتركة. كل ملف متداخل يضيف تفاصيل لتلك الحزمة.

سياق ديناميكي مع /compact

أمر /compact لـ Claude Code يلخص المحادثة الحالية ويحرر مساحة السياق. لجلسات طويلة، وجدت نمطاً يعمل جيداً:

  1. ابدأ مع CLAUDE.md محمّل تلقائياً
  2. اعمل على ميزة
  3. شغّل /compact عندما يصبح السياق ثقيلاً
  4. استمر — يحتفظ Claude بسياق CLAUDE.md بالإضافة إلى ملخص ضغوط

سياق الفريق المشترك مقابل السياق الشخصي

نحن نبقي CLAUDE.md في التحكم بالإصدار (يجب أن يتم التزامه). لكن المطورين الفرديين يستخدمون أيضاً ~/.claude/CLAUDE.md للتفضيلات الشخصية:

# التفضيلات الشخصية
- أفضل أسماء المتغيرات الكاملة على الاختصارات
- أظهر لي التفكير قبل كتابة الأكواس
- عند اقتراح التغييرات، أظهر الفرق الكامل للملف
- أستخدم VS Code مع vim keybindings (لا تقترح اختصارات IDE محددة)

هذا الفصل يبقي ملف الفريق نظيفاً ومركزاً على حقائق المشروع بينما تسمح للأفراد بتخصيص تجربتهم.

قياس التأثير

كيف تعرف أن CLAUDE.md الخاص بك يعمل؟ إليك المقاييس التي نتابعها داخلياً:

  • دقة المحاولة الأولى: كم مرة استجابة Claude الأولى تحتاج صفر تصحيحات؟ CLAUDE.md جيد يحصل على هذا فوق 80%.
  • انتهاكات الاتفاقية: حسب كم مرة Claude ينقطع معايير الترميز الخاصة بك. يجب أن يتجه نحو صفر.
  • أسئلة السياق: إذا كان Claude يسأل بشكل مستمر "ما هو إطار العمل هذا؟" أو "هل يجب أن أستخدم App Router؟"، CLAUDE.md الخاص بك ينقصه معلومات.
  • تكرار الانعكاس: كم مرة يجب عليك رفض أو عكس تغييرات Claude. أقل هو أفضل.

أبلغت فريق واحد في شركة ناشئة متوسطة الحجم عن خفض متوسط وقت المهام المدعومة بـ AI من 12 دقيقة إلى 4 دقائق بعد الاستثمار في ساعة واحدة في CLAUDE.md الخاص بهم. هذا تحسن 3x من ملف واحد.

إذا كنت تبني مشروعاً معنا من خلال خدمات تطوير CMS بدون رأس الخاصة بنا، فنحن ندرج CLAUDE.md مخصصة كجزء من كل تسليم مشروع. إنها حاسمة جداً لسرعة التطوير المستمرة.

الأسئلة الشائعة

ما هو CLAUDE.md وأين يذهب؟ CLAUDE.md هو ملف markdown توضعه في جذر مستودع المشروع الخاص بك. Claude Code يقرأه تلقائياً في بداية كل جلسة لفهم عمارة المشروع والاتفاقيات والمجموعة التقنية والقيود. فكر فيه كوثيقة استقبال مكتوبة خصيصاً لمساعد الترميز بالذكاء الاصطناعي.

ما هو طول ملف CLAUDE.md؟ استهدف 300-800 كلمة. الملفات الأقصر تفتقد السياق الحرج، لكن أي شيء فوق 1000 كلمة يبدأ بأكل نافذة السياق — مساحة أفضل استخدام لاستدلال الأكواس الفعلي. كن موجزاً ومحدداً. كل جملة يجب أن تحقق قيمتها. إذا احتجت إلى عمق أكثر، ارتبط إلى الوثائق الخارجية بدلاً من تضمينها.

هل يجب أن أؤتمت CLAUDE.md لتحكم الإصدار؟ بشكل مطلق. يجب أن يتم التعامل مع CLAUDE.md مثل أي وثيقة مشروع أخرى — محكومة بالإصدار، تمت مراجعتها، محدثة. فريقك كله يستفيد من سلوك AI متسق. التفضيلات الشخصية تذهب إلى ~/.claude/CLAUDE.md بدلاً من ذلك، والتي تبقى محلية لماكينة المطورة لكل واحدة.

كيف يختلف CLAUDE.md عن .cursorrules؟ المحتوى متطابق تقريباً — كلاهما يوفر سياق المشروع لأداة ترميز بالذكاء الاصطناعي. الفرق في أي أداة تقرأه. CLAUDE.md لـ Claude Code (أداة Anthropic CLI)، بينما .cursorrules لـ Cursor IDE. إذا استخدمت أداتي، احتفظ بمصدر حقيقي واحد وانسخه إلى كلا الملفين، ضبط لأي تنسيق محدد بالأداة.

ما هو الجزء الأكثر أهمية من CLAUDE.md؟ قسم "Do NOT". التعليمات السلبية فعالة بشكل غير متناسب مع نماذج AI. إخبار Claude بما يجب تجنبه — لا تستخدم any types، لا تضيف "use client" غير ضروري، لا تثبّت حزم جديدة بدون سؤال — يمنع الأخطاء الأكثر شيوعاً والمحبطة. قائمة حظر جيدة توفر أكثر من صفحات التعليمات الإيجابية.

هل يمكنني استخدام CLAUDE.md للمشاريع غير الترميز؟ نعم. CLAUDE.md يعمل لأي مشروع تتفاعل معه من خلال Claude Code. لقد رأيت أنماطاً فعالة لمستودعات الوثائق، ومشاريع البنية الأساسية كأكواس، وحتى مسارات تحليل البيانات. المبدأ هو نفسه: أعط Claude السياق الذي يحتاجه لاتخاذ قرارات جيدة حول مشروعك المحدد.

كم مرة يجب أن أحدّث CLAUDE.md الخاص بي؟ راجعها في كل refactor رئيسي وعلى الأقل مرة واحدة في sprint. إذا قمت بترقية إصدار إطار العمل أو تغيير تبعية رئيسية أو اعتماد اتفاقية جديدة، حدّث الملف فوراً. السياق القديم أسوأ من عدم وجود سياق لأنه يُضلل الذكاء الاصطناعي بنشاط. بعض الفرق تضيف مراجعة CLAUDE.md إلى قائمة مراجعة PR لتغييرات البنية الأساسية.

هل CLAUDE.md يعمل مع Claude على الويب (claude.ai)؟ لا. CLAUDE.md يُقرأ خصيصاً بواسطة Claude Code، أداة الترميز المستندة إلى CLI. إذا كنت تستخدم Claude عبر واجهة الويب أو API، ستحتاج إلى لصق السياق يدويا أو استخدام ميزة Projects لإرفاقه كملف معرفة. يعتبر التحميل التلقائي لـ Claude Code ما يجعل الملف قوياً — احتكاك صفر، كل جلسة.