قدّم ملفات PDF وWord إلى Claude Code وCursor وCodex

حتى أكتوبر 2026، يستطيع Claude Code قراءة ملف PDF بنفسه، ويقرأ Cursor ملف PDF ترفقه بالمحادثة، ويوثّق Codex CLI إدخال الصور لكن لا يوثّق ملفات PDF. ولا يذكر أي من الثلاثة ملفات Word (DOCX) بين الصيغ التي يقرؤها مباشرة. أما المواصفات والأدلة والأوراق البحثية والعقود التي سيستخدمها الوكيل أكثر من مرة، فحوّلها إلى Markdown، واحتفظ بالنسخ في المشروع، وأخبر الوكيل أين هي.

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

حاسوب محمول مفتوح بشاشة ضبابية بجانب رزمة من المستندات المطبوعة يمسكها مشبك ورق بلون الليلك. — احتفظ بالأصل بجانب النسخة التي يقرؤها الوكيل.

ما الذي يقرؤه كل وكيل مباشرة

هذا ما تقوله وثائق كل مزوّد حتى أكتوبر 2026.

الوكيل	PDF	Word (DOCX)	الصور
Claude Code	يقرأ ملفات PDF بأداة الملفات الخاصة به	غير مدرج في قائمة أنواع الملفات المدعومة	PNG وJPG وصيغ أخرى
Cursor	يقرأ ملفات PDF التي ترفقها بالمحادثة	غير مذكور	PNG وJPG وGIF وWebP وSVG
Codex CLI	غير مذكور بالنسبة إلى CLI	غير مذكور	الصيغ الشائعة، بما فيها PNG وJPEG

يقرأ Claude Code ملف PDF القصير كاملًا. أما ملف PDF الذي يزيد على 10 صفحات فيُقرأ على دفعات تصل إلى 20 صفحة في المرة، وتحتاج هذه القراءات إلى البرنامج pdftoppm من poppler. وعلى Windows عليك تثبيت إصدار من poppler بنفسك وإضافته إلى PATH؛ ودونه تفشل القراءة. وتجد التفاصيل في مرجع أدوات Claude Code.

أضاف Cursor قراءة PDF في الإصدار 2.4، الذي صدر في يناير 2026. لا تزال قائمة التجاهل الافتراضية في Cursor تضم ملفات PDF وعدة صيغ Office، وتقول مساعدة Cursor إن الملفات المتجاهَلة محجوبة عن الوكيل. أرفق ملف PDF بالمحادثة بنفسك بدلًا من انتظار أن يجده الوكيل في المشروع.

يقبل Codex CLI الصور التي تُمرَّر في سطر الأوامر أو تُلصق في الموجّه. ولا تصف وثائقه إدخال PDF أو Word في CLI.

يستطيع الوكيل مع ذلك محاولة استخراج النص من مستند بتشغيل برنامج مثبت على جهازك. وأحيانًا ينجح ذلك، لكنك لا ترى أي نص حصل عليه، وجدول قُرئ خطأً يدخل مباشرة في إجابته.

لماذا تعمل نسخة Markdown بشكل أفضل

Markdown نص عادي بعناوين وقوائم وجداول. وداخل المشروع يمنحك ذلك أربعة أشياء لا يوفرها ملف PDF أو DOCX.

يستطيع الوكيل البحث فيه. فالبحث النصي يجد عبارة داخل ملف Markdown. ملف DOCX أرشيف ZIP من أجزاء XML، لذا لا يجد البحث النصي العادي شيئًا بداخله.
يستطيع الوكيل اقتباس الأسطر بدقة، وتستطيع أن تجد كل جملة مقتبسة في الملف وتقرأ ما حولها.
يقرأ الوكيل ما يحتاج إليه فقط: يبحث في دليل طويل، ثم يفتح القسم الوحيد المهم بدلًا من المرور على الصفحات.
يُظهر Git ما تغيّر. وعندما يصل إصدار جديد من مواصفة، تسرد المقارنة الأسطر المتغيرة.

وترى أيضًا بالضبط ما يقرؤه الوكيل. فإذا خرج جدول خطأً، تصلحه مرة واحدة في ملف Markdown، وتستخدم كل الجلسات اللاحقة النسخة المصحّحة.

ملف PDF ممسوح ضوئيًا بلا طبقة نصية ليس سوى صور للصفحات. ويحتاج إلى OCR (التعرف على النص) قبل أن يستطيع الوكيل البحث فيه. ويتعرف MD Factory على النص في ملفات PDF الممسوحة على جهازك. وللتحقق من النتيجة، راجع دليلنا لتحويل ملفات PDF الممسوحة ضوئيًا.

ضع المستندات في مجلد docs

احتفظ بالأصول ونسخ Markdown الخاصة بها داخل المشروع، بجانب الشيفرة التي تعتمد عليها:

payments-service/
  AGENTS.md
  docs/
    partner-api-spec.pdf
    partner-api-spec.md
    partner-api-spec_images/
    supplier-contract.docx
    supplier-contract.md
  src/

انسخ ملفات PDF وWord إلى مجلد docs. يحفظ MD Factory كل ملف Markdown بجانب أصله، وهنا ستظهر النسخ.
في MD Factory، انقر على «إضافة مجلد» واختر مجلد docs، أو أفلت المجلد على النافذة. يبدأ التحويل فورًا.
انتظر حتى يعرض كل ملف حالة: «اكتمل» أو «يحتاج إلى مراجعة» أو «فشل».
انقر على «يحتاج إلى مراجعة» بجانب ملف لترى ما يجب التحقق منه، ثم قارن ذلك الجزء بالأصل.

تذهب صور المستند إلى مجلد يحمل اسمه، مثل partner-api-spec_images. أما ملفات PDF وWord نفسها فلا تتغير.

احتفظ بالأصول في المشروع. ففيها أرقام الصفحات والأشكال والصياغة الدقيقة الموقّعة، وستحتاج إليها كلما اختلفت النسخة عن إجابة الوكيل.

وجّه الوكيل إلى الملفات

أعطِ الوكيل قائمة قصيرة بالمستندات في ملف تعليماته. Claude Code يقرأ CLAUDE.md، أو AGENTS.md عندما لا يكون في المشروع CLAUDE.md. Codex و Cursor يقرآن AGENTS.md. مثلًا:

## المستندات المرجعية

نسخ Markdown من ملفات PDF وWord موجودة في docs/.
وأصل كل نسخة بجانبها.

- `docs/partner-api-spec.md`: مواصفة واجهة الشريك البرمجية، الإصدار 3.2
- `docs/supplier-contract.md`: عقد المورّد، إصدار 2026

ابحث في docs/ قبل الإجابة عن أسئلة تخص واجهة الشريك البرمجية أو العقد.
اقتبس عنوان القسم الذي اعتمدت عليه.
لا تعدّل الملفات في docs/.

اكتب المسارات بين علامات الاقتباس العكسية كما أعلاه، لا بالشكل @docs/partner-api-spec.md. وفي CLAUDE.md، المسار الذي يبدأ بـ @ استيراد: إذ يحمّل Claude Code الملف كله عند بداية كل جلسة. أما المسار بين علامات الاقتباس العكسية فيبقى إشارة عادية، ويفتح Claude الملف عندما تحتاج إليه المهمة.

اجعل القائمة قصيرة. يتوقف Codex عن قراءة ملفات التعليمات عندما يبلغ مجموعها 32 KiB، وهو حده الافتراضي.

لمهمة واحدة، اذكر الملف في موجّهك:

في Claude Code، اكتب @ واختر الملف. يضيف Claude Code محتواه إلى المحادثة إذا كان ضمن حد القراءة، وهو 25,000 رمز افتراضيًا. وإذا كان الملف أطول، فاطلب من Claude أن يبحث فيه أولًا.
في Cursor، اكتب @ واختر الملف أو مجلد docs كاملًا، كما هو موضح في مساعدة Cursor.
في Codex CLI، اكتب @ لإدراج مسار ملف، أو استخدم الأمر /mention لإرفاق ملف، كما هو موضح في دليل الموجّهات في Codex.

قد يبدو موجّه يذكر المستند ويطلب اقتباسات هكذا:

اقرأ قسمي "Authentication" و"Rate limits" في
docs/partner-api-spec.md. حدّث عميل واجهة API ليتبعهما.
لكل تغيير، اقتبس السطر من المواصفة الذي اعتمد عليه.

تحقق من الإجابات وحدّث النسخ

قبل أن تعتمد على إجابة، ابحث بنفسك عن المقطع المقتبس. استخدم الأمر الأول في PowerShell والثاني في Git Bash:

Select-String -Path docs\*.md -Pattern "rate limit"
grep -n -i "rate limit" docs/*.md

إذا لم يكن الاقتباس في ملف Markdown، فابحث في الأصل. وإن لم يكن هناك أيضًا، فالوكيل لم يأخذه من المستند. وللحصول على أرقام الصفحات والأشكال، افتح الأصل دائمًا.

انتبه إلى ملف .gitignore. يتخطى بحث Claude Code الملفات المدرجة في gitignore، مع أن Claude يستطيع البحث في ملف تسميه بمساره أو قراءته. يُبعد Cursor الملفات المدرجة في gitignore عن الوكيل ما لم يُعدها سطر يبدأ بـ ! في .cursorignore. وإذا كان لا بد أن تبقى المستندات خارج Git، فاذكر مسار كل ملف في ملف التعليمات الخاص بـ Claude Code، وأضف هذا السطر إلى .cursorignore من أجل Cursor: !docs/

ينبغي ألا تتغير الملفات المرجعية إلا عندما تقرر أنت. انظر إلى المقارنة بعد كل مهمة. وإذا أردت أن يترك Claude Code مجلد docs وشأنه، فأضف له قاعدة منع Edit.

عندما يصل إصدار جديد، استبدل الأصل في مجلد docs مع الإبقاء على اسم الملف نفسه، وأضفه إلى MD Factory مرة أخرى. إذا لم تكن قد حرّرت نسخة Markdown القديمة، فإن MD Factory يستبدلها. وإذا كنت قد حرّرتها، تحصل النسخة الجديدة على اسم مرقّم، مثل partner-api-spec (2).md، وتبقى تعديلاتك في الملف القديم. وتُظهر المقارنة بين ملفي Markdown حينئذ الأقسام التي تغيرت والشيفرة التي قد تحتاج إلى المتابعة.

المستندات السرية: ما الذي يرسله الوكيل

يحوّل MD Factory المستندات على جهازك ولا يرفعها، لكن هذا يخص التحويل فقط. فعندما يقرأ الوكيل نسخة Markdown، يذهب النص إلى مزوّد النموذج مثل بقية موجّهك.

يعمل Claude Code على جهازك لكنه يرسل الموجّهات ومخرجات النموذج عبر الشبكة. ومدة احتفاظ Anthropic بهذه البيانات تعتمد على نوع حسابك وإعدادات الخصوصية: راجع الاحتفاظ بالبيانات في Claude Code.
يقول Cursor إنه عندما يفتح الوكيل ملفًا، يمكن تضمين محتواه في طلب النموذج.
يستخدم Codex شركة OpenAI مزوّدًا افتراضيًا للنموذج.

قبل أن يقرأ الوكيل مستندًا سريًا:

حوّل وأضف المستندات التي تحتاجها المهمة فقط.
إذا كان المستند مشمولًا باتفاقية سرية أو بعقد عميل، فتحقق مما إذا كان يسمح بإرسال النص إلى خدمة ذكاء اصطناعي خارجية.
أبقِ المستندات التي يجب ألا يقرأها الوكيل خارج مجلد المشروع. فقواعد المنع في Claude Code وملفات التجاهل في Cursor تحجب أدوات الملفات المدمجة. ويشير المزوّدان إلى أن بعض أوامر الطرفية يمكنها مع ذلك قراءة هذه الملفات: راجع أذونات Claude Code و ملفات التجاهل في Cursor.
تعامل مع مستندات الآخرين على أنها مدخلات غير موثوقة: فقد تحتوي على نص كُتب لتوجيه وكيل. راجع الأوامر والتعديلات التي يقترحها الوكيل.