دليل Claude AI: نصائح وأفضل الممارسات

غيّرت النموذج الذي تستدعيه عبر Claude API إلى إصدار أحدث، فصار يظهر الخطأ AttributeError: 'ThinkingBlock' object has no attribute 'text'، أو صار نص الرد يعود فارغًا. السبب أن نماذج Claude 5 وما بعدها تفكر عند الحاجة حتى إن لم تضبط thinking، فتصبح الكتلة الأولى في الرد كتلة تفكير. أما نماذج Claude 4 فلم تكن تفكر ما لم تضبطه، لذا فإن تغيير اسم النموذج وحده يغيّر شكل الرد. ومع المدخلات البسيطة تبقى الكتلة الأولى نصًا، فتنجح الاختبارات التي تستخدم مدخلات خفيفة. استنادًا إلى وثائق Anthropic واختباراتي على أربعة نماذج (1 نوفمبر 2026)، يتناول هذا المقال السبب، وكيفية الإصلاح بالبحث عن كتل النص حسب نوعها (Python وTypeScript)، وما تفعله عندما يتركك max_tokens بلا نص، وأي النماذج يمكن إيقاف التفكير فيها وأيها لا يمكن، وكيف لا تفوّت المشكلة في الاختبار.

إذا وضعت عدة مواقع في مستودع واحد ووضعت CLAUDE.md أو AGENTS.md في مجلد كل موقع، فلا يُضمن أن تُقرأ تلك القواعد قبل بدء العمل. يحمّل Claude Code ملف CLAUDE.md الموجود أسفل مجلد التشغيل عندما يقرأ Claude ملفًا في ذلك المجلد أو يكتبه أو يحرّره، بينما لا يقرأ Codex إلا ملفات AGENTS.md الممتدة من جذر المشروع إلى مجلد التشغيل، مرة واحدة في بداية كل تشغيل. يقارن هذا المقال، بندًا بندًا، كيف تحمّل الأداتان هذه الملفات وكيف تتحقق من تحميلها (لا يعرض ‎/context إلا ما حُمِّل عند البدء)، ثم يتناول فحصًا يوقف الإصدار إذا تغيّر أي شيء خارج المجلد المسنَد، وإعدادات الأدوات التي تمنع الكتابة. كما يبيّن كيف تميّز المستودعات المتشابهة الأسماء بعنوان remote URL والإيداع الجذري، والأوامر التي لا تعرض إلا أسماء متغيرات البيئة (رُوجع في 1 نوفمبر 2026).

تتضمن خطة Max في Claude رصيد API بقيمة $100 شهريًا، وUltra ‏$200، وTeam حتى $500 إجمالًا، بينما لا تحصل Free وPro على شيء. وتتضمن Gemini رصيد Google Cloud بقيمة $10 شهريًا مع Google AI Pro، و$40 مع Ultra 5x، و$100 مع Ultra 20x، ولا شيء مع Plus. ومنذ 28 أكتوبر 2026، تتضمن ChatGPT ‏$100 و$200 و$500 شهريًا مع Pro 100 و200 و500، ورصيدًا لكل مقعد مع Business (حتى $500 إجمالًا)، بينما لا تحصل Go وPlus على شيء. استنادًا إلى صفحات الأسعار الرسمية ومقالات المساعدة ووثائق المطوّرين لدى الشركات الثلاث (رُوجعت في 27 أكتوبر 2026، وChatGPT في 30 أكتوبر)، يقارن هذا المقال بالترتيب نفسه أين يمكن استخدام الرصيد وأين لا يمكن (حدود استخدامك في Claude Code لا تتغير)، وكيف تطالب به (تتطلب Gemini دفعًا مسبقًا بقيمة $5)، ومتى تنتهي صلاحيته (رصيد Claude وChatGPT ينتهي شهريًا، بينما رصيد Gemini صالح لمدة 12 شهرًا ويتراكم)، وما يمكنك استخدامه مجانًا دون خطة (الرصيد التجريبي في Claude، والفئة المجانية في Gemini، والرموز المجانية لدى OpenAI مقابل مشاركة البيانات)، وما إذا كان المحتوى الذي ترسله يُستخدم في التدريب، ثم يلخّص العوامل الحاسمة في الاختيار.

في 26 أكتوبر 2026 (بتوقيت الولايات المتحدة)، قدّمت Anthropic بيان تسجيل بنموذج Form S-1 لطرح عام أولي (IPO) إلى هيئة الأوراق المالية والبورصات الأمريكية (SEC)، وطلبت الإدراج في Nasdaq Global Select Market بالرمز «ANT». ولم يُحدَّد بعدُ موعد الإدراج ولا عدد الأسهم ولا النطاق السعري ولا المبلغ المراد جمعه. استنادًا إلى النص الأصلي لـ S-1، يتناول هذا المقال الإيرادات (4.585 مليار دولار في 2025 و16.286 مليار دولار في النصف الأول من 2026) وما وراء الخسائر، وفئات الأسهم الخمس (A وN وT وF وE) وحقوق التصويت فيها، وكيف يعمل صندوق ائتمان المنفعة طويلة الأجل (LTBT) وهيكل الشركة ذات المنفعة العامة (PBC)، وحصص Amazon وGoogle، واستخدامات العائدات، وعوامل المخاطر. ثم يشرح خطوات الإدراج وفق إرشادات SEC، وهل يمكنك شراء الأسهم وكيف (تاريخ التحقق: 27 أكتوبر 2026)، وما يعنيه ذلك لمستخدمي Claude. هذا المقال ليس نصيحة استثمارية، ونحدّثه كلما ظهرت معلومات جديدة.

عبارة «Codex لا يعمل على التوازي ما لم تطلب منه» صحيحة، لكن بشروط: فتطبيق Codex وواجهة سطر الأوامر وإضافة IDE تُطلق وكلاء فرعيين عندما تطلب ذلك مباشرة، أو عندما يوجّه AGENTS.md أو إحدى المهارات إلى الإسناد (كما أن Ultra في ChatGPT Work يُسند العمل بتقديره الخاص أيضًا). أما Claude Code فيُسند العمل من تلقاء نفسه بناءً على الطلب ووصف كل وكيل فرعي. واستنادًا إلى الوثائق الرسمية من OpenAI وAnthropic (تاريخ التحقق: 26 أكتوبر 2026)، يقارن هذا المقال ما يُطلق العمل المتوازي، وخمسة أمور تضعها في تعليماتك، وأمثلة أوامر جاهزة للاستخدام، و[agents] في config.toml الخاص بـCodex وملفات TOML في ‎.codex/agents/‎، و‎.claude/agents/‎ ومتغيرات البيئة في Claude Code، وأوامر مثل ‎/subagents و/tasks و/subtask و/batch و/worktree، والمهام التي تناسب العمل المتوازي وتلك التي لا تناسبه، والأثر في حدود الاستخدام، ويعرض أيضًا دروسًا تعلّمها هذا الموقع من تشغيل الوكلاء الفرعيين على التوازي.

«Your credit balance is too low to access the Anthropic API» (وتظهر في Claude Code بصيغة «Credit balance is too low») تعني أن مؤسستك في Claude Console لا تملك رصيدًا مدفوعًا مسبقًا كافيًا. وللخطأ سببان: إما أن رصيدك منخفض فعلًا، وإما أنك قصدت استخدام خطة مثل Pro أو Max لكن Claude Code يعمل بمفتاح API من متغير البيئة ANTHROPIC_API_KEY فيُفوتَر الاستخدام على API بدلًا منها. وتميّز بينهما بالأمر ‎/status. استنادًا إلى الوثائق الرسمية ومركز المساعدة لدى Anthropic (تاريخ التحقق: 26 أكتوبر 2026)، يشرح هذا المقال كيف يظهر الخطأ، وثلاثة أسئلة لتحديد السبب، وكيف تشتري رصيدًا من صفحة Billing في Console وتضبط إعادة الشحن التلقائية، وكيف تحذف مفتاح API على macOS وLinux وWindows وتتحقق منه في VS Code، والفرق بين هذا وبين رصيد API الشهري في Max وTeam ورصيد الاستخدام، وأخطاء مشابهة لكنها مختلفة.

هناك طريقتان لاستخدام Claude مع البقاء على فاتورة Google Cloud: النسخة بإدارة Google، التي تشغّلها Google ضمن Agent Platform (المعروفة سابقًا باسم Vertex AI)، والنسخة بإدارة Anthropic، التي أصبحت متاحة للجميع في 22 أكتوبر 2026. يعمل Claude Code على النسخة بإدارة Google، ويُضبط بـ CLAUDE_CODE_USE_VERTEX والإعدادات المرتبطة به (ويُستحسن تثبيت النماذج إن عمّمته على عدة أشخاص). وإن احتجت إلى Files API وAgent Skills وManaged Agents والوضع السريع وميزات مشابهة، فاختر النسخة بإدارة Anthropic. على نقطة النهاية global في النسخة بإدارة Google، يكلّف Opus 5.5 وSonnet 5.5 وHaiku 5.5 ما يكلّفه Claude API تمامًا، بينما تكلّف المنطقتان المتعددتان us وeu ‏1.1 ضعف. أما النسخة بإدارة Anthropic فتُقاس بوحدات CCU، ولا تظهر قائمة أسعار لكل رمز في الوثائق الرسمية. استنادًا إلى الوثائق الرسمية (تاريخ المراجعة 26 أكتوبر 2026)، يتناول هذا المقال الفروق وطريقة الاختيار، والأسعار، والمناطق، والبدء، وحزم SDK، وإعداد Claude Code، وكيفية التعامل مع الحصص وأخطاء 429.

عند ظهور خطأ «temperature is deprecated for this model.» في Claude API، يكون السبب إرسال قيم غير افتراضية لـ temperature وtop_p وtop_k إلى نماذج Claude 4.7 وما بعدها، والحل حذف الحقول الثلاثة من الطلب. لا تقبل هذه النماذج القيم غير الافتراضية حتى في إصدار API السابق ‎2023-06-01، وفي الإصدار الجديد ‎2026-10-21 يظهر الخطأ 400 مع أي نموذج حتى مع القيم الافتراضية. تُرسل مكتبات SDK الحديثة، مثل anthropic 2.0.0 في Python، الإصدار ‎2026-10-21 تلقائيًا وتُزال منها الحقول الثلاثة من الأنواع، لذا قد يؤدي تمريرها بعد الترقية إلى خطأ في الوسيطات أو خطأ 400، ويشرح المقال كيفية الحل وإصلاح خطأ «anthropic-version: header is required» وفق وثائق Anthropic الرسمية (تاريخ التحقق 26 أكتوبر 2026).

لا تحتاج Claude Code وCodex إلى جهاز عالي الأداء، لأن النموذج يعمل على الخادم، ولا يقصر وقت كتابة الذكاء الاصطناعي بتغيير الجهاز. أما المتطلبات الرسمية لـ Claude Code فهي ذاكرة 4GB على الأقل ومعالج x64 أو ARM64 واتصال بالإنترنت، ولا تنشر Codex أرقامًا للذاكرة أو المعالج. يتغيّر على الجهاز وقت الأوامر التي تعمل محليًا مثل البناء والاختبار والبحث، وتشرح المقالة الوضع السريع وشروط العزل لكل نظام تشغيل وطرق التعامل مع الحمل الثقيل، وكيف تتحقق بنفسك من تفصيل الوقت، وثلاثة أمور تتحقق منها قبل شراء جهاز جديد.

أمر ‎/goal في Claude Code يتيح لك كتابة «متى يُعدّ العمل منتهيًا»، فيحكم نموذج صغير منفصل بعد كل دورة، ويواصل Claude العمل حتى يتحقق الشرط. تشرح المقالة، بالاستناد إلى النص الرسمي للوثائق، طريقة الضبط والتحقق والإلغاء، وشروط التوقف عند الأخطاء، وكتابة الشرط، والفرق بينه وبين ‎/loop وبين ‎/goal في Codex. وتعرض نتائج استخدامه في مهمة توحيد علامات الترقيم في مقالات الموقع، ومهمة من 321 عنصرًا انتهت في دورة واحدة، مع الوقت والتوكنات المسجّلة، وما لا تكشفه الأرقام عن جودة النتيجة.

أطلقت Anthropic في 8 أكتوبر 2026 ميزتين بصيغة بيتا: Claude Dashboards، التي تنشئ لوحات بيانات عند طرح أسئلة عن بيانات شركتك، وClaude Motion، التي تحوّل التقارير والرسوم البيانية إلى رسوم متحركة توضيحية قصيرة. تعتمد المقالة على إعلان Anthropic ومستندات المساعدة (تم التحقق منها في 22 أكتوبر 2026)، وتشرح مصادر البيانات المتصلة مثل BigQuery وSnowflake وSalesforce، والاستعلامات الظاهرة لكل رسم بياني، والتحقق منها في ثلاث نقاط. كما تتناول آلية عمل Motion التي تعمل بالكود دون نموذج توليد فيديو وتُصدَّر بصيغة MP4، وأمثلة لطلبات الإنشاء، والخطط المتاحة (Dashboards في Pro وMax وTeam وEnterprise، وMotion في Team وEnterprise)، وإعدادات المسؤول، والفرق بينها وبين Docs وSlides وDesign، والاستخدامات المناسبة وغير المناسبة.

Claude Duet تطبيق يعمل فيه Claude كـ«وكيل استباقي»، فيُنبّهك إلى الأمور المهمة في موجز الصباح وفي متابعات كل بضع ساعات، وينفّذ المهام التي تكلّفه بها في السحابة. تستند المقالة إلى إعلان Anthropic ووثائق المساعدة (تم التحقق في 22 أكتوبر 2026)، وتشرح ما يمكنه فعله عبر تبويب Make وتبويب Tasks وأكثر من 6,000 موصّل، ومن يستطيع استخدامه وسعره، ومنها أنه دعوة محدودة في الولايات المتحدة لخطتي Pro وMax بلا رسوم إضافية، وحدود مشتركة مع Claude، وإعادة ضبط الحدود حتى 30 نوفمبر. كما تشرح آلية الأمان التي تطلب الموافقة قبل الإرسال والدفع والتوقيع والحذف، وما لا يستطيع فعله بعد، وتوفّره خارج الولايات المتحدة، والفرق عن dot من ChatGPT.