Table of Contents

تعمل أدوات Claude الوكيلة الآن مع نماذج على أجهزتك، دون مفتاح API أو اشتراك أو إرسال بياناتك خارج الجهاز. توفر Ollama واجهة API متوافقة مع Anthropic، ويتصل بها كل من Claude Code وClaude Desktop باستخدام بضعة أوامر.

تغفل أدلة كثيرة تفصيلاً مهماً. فهي تتحدث عن Claude Cowork ثم تعطي خطوات تضبط أداة سطر الأوامر. هذان تكاملان مختلفان، وواحد فقط منهما يوفر Cowork.

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

بعد قراءة الدليل: ستحدد التكامل المطلوب، وتربطه عبر مسار Ollama الموثق، وتتحقق من نقطة الاتصال باختبار واحد لاستدعاء الأدوات. لا تبقي الاستدلال محلياً إلا عند اختيار نموذج محلي وتجنب الميزات المرتبطة بالسحابة.

الإجابة المختصرة

يتصل Ollama بـ Claude بطريقتين منفصلتين. واختيار الطريقة الخاطئة هو السبب الأكثر شيوعاً لإنهاء دليل الإعداد بطرفية تعمل من دون Cowork.

التكاملما يوفرهمسار الإعدادالنظام
Claude DesktopCowork والوكلاء الفرعيون والبحث على الويب والوضع التلقائيتطبيق Ollama، ثم Apps وConnect ClaudemacOS فقط
Claude Codeوكيل البرمجة في CLI مع استدعاء الأدوات وتحرير الملفاتollama launch claude أو متغيرات البيئةmacOS وLinux وWindows

إذا أردت Cowork، فاستخدم تكامل Claude Desktop. يُضبط عبر واجهة رسومية في تطبيق Ollama، وهو متاح على macOS فقط. ولا يزال دعم Windows مدرجاً على أنه قادم.

إذا أردت وكيلاً في الطرفية، فاستخدم Claude Code. يكفي أمر واحد.

كلاهما مجاني. التكلفة الوحيدة هي العتاد والكهرباء.

تكاملان مختلفان

يبدأ الالتباس من الأسماء. Claude Cowork ميزة داخل Claude Desktop، وليس تطبيقاً منفصلاً أو اسماً آخر لـ Claude Code.

تعرض وثائق Ollama التكاملين في صفحتين وعنوانين منفصلين. يظهر Claude Desktop ضمن Assistants إلى جانب OpenClaw وHermes. ويظهر Claude Code ضمن Coding إلى جانب OpenCode وCline وCodex CLI.

هذا الفرق مهم لأن الإعداد مختلف تماماً:

  • تضبط Claude Desktop من واجهة تطبيق Ollama. لا تحتاج إلى تعديل ملف إعدادات الصدفة.
  • تضبط Claude Code عبر متغيرات البيئة أو أمر تشغيل واحد.

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

إعداد Claude Desktop وCowork

يتم هذا المسار عبر تطبيق Ollama، لا الطرفية.

المتطلبات

  • تثبيت Ollama على macOS. دعم Windows مدرج على أنه قادم.
  • تنزيل نموذج مسبقاً إذا أردت التشغيل محلياً. لاستخدام نموذج سحابي، سجّل الدخول إلى Ollama وفعّل النماذج السحابية. بعض النماذج تحتاج إلى خطة مدفوعة.
  • تثبيت Claude. إذا لم يكن موجوداً، يعرض Ollama تنزيله أثناء الإعداد.

الخطوات

  1. افتح Ollama واختر Apps.
  2. اختر Connect Claude.
  3. اتبع مطالبات الإعداد. ثبّت Claude إذا طُلب منك ذلك، ثم أعد تشغيله عند ظهور الطلب.

هذا هو المسار كاملاً. لتغيير النموذج لاحقاً، افتح Ollama Settings، وانتقل إلى Apps، واختر النماذج، ثم اضغط Restart Claude.

الميزات المدعومة

تذكر وثائق Ollama أربع ميزات مدعومة عبر هذا التكامل:

  • Cowork لإتمام المهام الصعبة
  • الوكلاء الفرعيون لتقسيم المهام الأكبر بين وكلاء
  • Web search وتوفره Ollama افتراضياً
  • Auto mode، حيث يقرر الوكيل متى يطلب الإذن قبل إجراء تغييرات

تظهر Cowork في هذه القائمة، ما يعني أنها متاحة عبر هذا التكامل وليست عبر مسار سطر الأوامر.

قطع الاتصال

يعيد قطع الاتصال إعداد Claude السابق، لذا فالتغيير غير إتلافي.

  • من الواجهة، افتح Apps وافصل Claude، ثم أعد تشغيله عند الطلب.
  • من الطرفية، نفّذ ollama launch claude-desktop --restore.
  • إغلاق Ollama أثناء اتصال Claude يعيد إعداد Claude المعتاد أيضاً. اترك Ollama يعمل إذا أردت استمرار الإعداد المحلي.
مخطط يوضح اتصال تطبيق Ollama بـ Claude Desktop عبر لوحة Apps، واختيار النماذج من إعدادات Ollama، ومسار استعادة الإعداد الأصلي

إعداد Claude Code من CLI

هذا هو المسار الذي تغطيه معظم الأدلة، وهو المناسب للعمل في الطرفية.

طريقة الأمر الواحد

ollama launch claude

يضبط الأمر متغيرات البيئة المطلوبة، ويوجه Claude Code إلى نسخة Ollama المحلية، ثم يشغله. اختر نموذجاً من القائمة واضغط Enter. لتحديد النموذج مسبقاً، أضف الخيار:

ollama launch claude --model qwen3.5

يتولى الغلاف إعداد البيئة. اقرأ القسم التالي أيضاً، فمعرفة القيم التي يضبطها تساعدك على استكشاف المشكلات لاحقاً.

ضبط متغيرات البيئة يدوياً

export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434

claude --model qwen3.5

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

لتجنب تغيير إعدادات الصدفة، مرر كل شيء داخل الأمر مباشرةً:

ANTHROPIC_AUTH_TOKEN=ollama ANTHROPIC_BASE_URL=http://localhost:11434 ANTHROPIC_API_KEY="" claude --model kimi-k2.7-code:cloud

معلومتان من الوثائق الرسمية:

  • يحمل ANTHROPIC_AUTH_TOKEN مصادقة bearer، ولهذا يحتوي النص الحرفي ollama في الوضع المحلي.
  • تتقدم ملفات إعدادات Claude على متغيرات الصدفة. إذا تصرف الاتصال بشكل غريب بعد تصدير قيم جديدة، فتحقق من تلك الإعدادات، ثم نفّذ /status داخل Claude Code لمعرفة نقطة الاتصال المستخدمة.

الاتصال مباشرةً بـ Ollama Cloud

لا تحتاج إلى تثبيت Ollama لهذا المسار. عيّن مفتاح API ووجّه Claude Code إلى نقطة الاتصال المستضافة لدى Ollama:

ANTHROPIC_BASE_URL=https://ollama.com \
ANTHROPIC_AUTH_TOKEN="$OLLAMA_API_KEY" \
ANTHROPIC_API_KEY="" \
claude --model glm-5.3-flash

لهذا المسار قيد واحد. توضح وثائق Ollama أن البحث المستضاف على الويب والتحكم المتقدم بالأدوات غير مدعومين بالكامل. تعمل المحادثة الأساسية وتحرير الملفات واستدعاء الأدوات مع النماذج المتوافقة.

اختيار النماذج في سبتمبر 2026

تغيرت مجموعة النماذج كثيراً خلال عام 2026، لذا يجدر إعادة النظر في النصائح المنشورة في الربيع.

النموذجالنوعالسياقسبب الاختيار
Qwen3.8 27Bمحلي، 18 GB256Kأفضل نموذج محلي متعدد الاستخدامات حالياً مع الرؤية واستدعاء الأدوات والتحكم في التفكير
Qwen3 Coder Nextمحلي، MoE إجمالي 80B / نشط 3B256Kمصمم لوكلاء البرمجة الدائمين، مع وضع سريع بلا تفكير
Qwen3.6 35B A3Bمحلي، MoE 35B / نشط 3B262Kترخيص Apache 2.0 وكفاءة مع ذاكرة متواضعة
kimi-k2.7-code:cloudسحابيكبيرنموذج سحابي للبرمجة لا يحتاج إلى عتاد محلي
glm-5.3-flashسحابيكبيرالنموذج الذي تبدأ به وثائق Ollama نفسها

ابدأ بـ Qwen3.8 27B إذا كانت لديك ذاكرة كافية. يعمل محلياً بسياق 256K ورؤية أصلية واستدعاء للأدوات وإمكانية تبديل التفكير لكل طلب. ويقدم أداءً يومياً مريحاً على بطاقة بها 24 GB أو أكثر.

ابدأ بنموذج سحابي إن لم تتوفر تلك الذاكرة. لا يكلفك اختبار Claude Code مع نموذج مستضاف شيئاً، ويلغي الحاجة إلى التفكير في العتاد، لكن الشيفرة تغادر جهازك.

تحذير بشأن النماذج الثلاثية

إذا قرأت دليل الذكاء الاصطناعي المحلي ، فستعرف أن Bonsai 2 27B الثلاثي يشغل نموذجاً كاملاً بحجم 27B في 5.53 GiB. قد يبدو خياراً مناسباً هنا أيضاً.

لن يعمل مع مسار العمل هذا. توجد النوى الثلاثية في نسخة Prism ML المتفرعة من llama.cpp، ولا يستطيع Ollama القياسي تحميل هذه الملفات. يفشل أمر مثل ollama launch claude --model Ternary-Bonsai-2-27B قبل بدء الاستدلال. استخدم حزمة Qwen3.8 27B القياسية مع Claude Code واترك الحزم الثلاثية لبيئة تشغيل متوافقة.

السهولة وأقصى كفاءة تتطلبان خيارين مختلفين هنا. تتوقع الأدوات المتكاملة ملف GGUF قياسياً.

اضبط السياق على 64K قبل لوم النموذج

تقدم وثائق Ollama توجيهاً مباشراً للعمل مع المستودعات: اختر نموذجاً واضبط نافذة السياق على 64K أو أكثر، وارفعها للمستودعات الأكبر.

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

السياقالاستخدام
أقل من 32Kتعديل ملف واحد والأسئلة السريعة
64Kالعمل على ملفات متعددة في مستودع متوسط
128Kمستودعات أكبر ومخرجات أوامر طويلة
256Kنافذة Qwen3.8 27B الكاملة

إذا فقد Claude Code مسار المهمة في منتصفها، فتحقق من إعداد السياق قبل تبديل النموذج.

تحقق من استدعاء الأدوات بأمر واحد

استدعاء الأدوات هو ما يفرق بين الوكيل ومولد النصوص. تحقق منه بدلاً من افتراض عمله.

بعد تشغيل Claude Code، اطلب منه:

Read the current directory and list all files

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

تحقق من الأسباب بهذا الترتيب:

  1. بدّل إلى نموذج ثبت دعمه للأدوات. ليست كل النماذج تدعمها، ولا يكشف عدد المعلمات هذا الفرق.
  2. تحقق من أن البيئة تشير إلى Ollama. نفّذ ollama --version وتأكد من أن ANTHROPIC_BASE_URL تشير إلى نقطة الاتصال المحلية.
  3. نفّذ /status داخل Claude Code. تتقدم نقطة الاتصال أو بيانات الاعتماد في إعدادات Claude على متغيرات الصدفة التي صدّرتها للتو.

الميزات التي تبقى حصرية للسحابة

اعرف حدود الخيارات قبل إعادة بناء سير عمل حول الاستدلال المحلي.

الميزةمع النماذج المحليةالسحابة
المحادثة وتحرير الملفاتنعمنعم
استدعاء الأدواتبحسب النموذجنعم
الوكلاء الفرعيوننعمنعم
البحث على الويبعبر Ollamaنعم
Coworkعبر تكامل Claude Desktopنعم
الوضع التلقائيعبر تكامل Claude Desktopنعم
المطالبات المجدولةعبر /loop في Claude Codeنعم

ثمة ثلاثة قيود على الجانب المحلي:

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

يناسب الاستدلال المحلي العمل المحدد القابل للتحقق، ويضعف في المهام الواسعة والغامضة. رتّب العمل مع مراعاة هذا الحد.

الأتمتة

تتيح ميزتان استخدام النظام بما يتجاوز التفاعل المباشر.

التشغيل دون واجهة للبرامج النصية وCI

يتجاوز الخيار --yes المحددات التفاعلية وينزل النموذج عند الحاجة. وهو يتطلب --model، وكل ما يأتي بعد -- يمر مباشرة إلى Claude Code:

ollama launch claude --model gemma4:cloud --yes -- -p "how does this repository work?"

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

المطالبات المجدولة عبر /loop

داخل جلسة Claude Code، ينفذ /loop مطالبة أو أمراً مائلاً على فاصل زمني:

/loop 30m Check my open PRs and summarize their status
/loop 1h Research the latest AI news and summarize key developments
/loop 15m Check for new GitHub issues and triage by priority

يعمل الأمر ما دامت الجلسة مفتوحة. إنه ليس خدمة في الخلفية، ويتوقف عند انتهاء الجلسة.

استكشاف الأخطاء وإصلاحها

العَرَضالسبب المحتملالحل
رفض الاتصالOllama غير مشغلنفّذ ollama serve وتحقق باستخدام curl http://localhost:11434/api/tags
يصف الإجراءات بدلاً من تنفيذهاالنموذج المختار لا يدعم استدعاء الأدواتبدّل إلى نموذج ثبت دعمه لهذه الميزة
يُستخدم مفتاح API حقيقي بدلاً من نقطة الاتصال المحليةما زال ANTHROPIC_API_KEY مصدراًاضبطه كسلسلة فارغة كما سبق
غياب Cowork بعد الإعدادجرى ضبط CLI لـ Claude Code بدلاً من Claude Desktopاستخدم مسار Apps في Ollama لتفعيل Cowork
بطء التوليدالسياق أكبر من اللازم أو اختير نموذج كثيف بينما يكفي نموذج متناثرقلل السياق ثم جرّب نموذج mixture-of-experts
لا تؤثر المتغيرات المصدرةتتقدم إعدادات Claude على متغيرات الصدفةافحص ملفات الإعداد ثم نفذ /status
فشل طلبات الخلفيةيختار Claude Code نموذجاً صغيراً للمهام الداخليةوجه إعداد النموذج الصغير إلى النموذج المحلي نفسه

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

أهم النقاط

  • Claude Desktop وClaude Code تكاملان منفصلان. توجد Cowork داخل Claude Desktop، وتُضبط في macOS من لوحة Apps في Ollama. لا يوفر مسار CLI ميزة Cowork.
  • يبدأ مسار CLI بأمر واحد: ollama launch claude. يحتاج الإعداد اليدوي إلى ثلاثة متغيرات، وتغفل أدلة كثيرة ANTHROPIC_API_KEY="".
  • لا تحتاج إلى تثبيت محلي. وجه Claude Code إلى https://ollama.com باستخدام مفتاح API.
  • اضبط السياق على 64K أو أكثر قبل تقييم النموذج. قد تبدو النافذة الصغيرة كأنها إخفاق في الاستدلال.
  • تحقق من استدعاء الأدوات بطلب واحد. إذا وصف النموذج ما كان سيفعله، فأنت تستخدم مولد نصوص لا وكيلاً.
  • لا تعمل حزم Bonsai الثلاثية هنا. تحتاج إلى نسخة Prism ML المتفرعة من llama.cpp، ولا يستطيع Ollama القياسي تحميلها.
  • قطع الاتصال آمن. يعيد إنهاء Ollama إعداد Claude السابق، كما يمكنك تنفيذ ollama launch claude-desktop --restore من الطرفية.

الخطوات التالية

  1. ثبّت Ollama ونزّل نموذجاً ثبت دعمه للأدوات قبل إعداد Claude: مكتبة نماذج Ollama
  2. اقرأ صفحة Ollama عن Claude Code للاطلاع على الخيارات والنماذج الحالية: تكامل Claude Code
  3. استخدم صفحة Claude Desktop إذا أردت Cowork: تكامل Claude Desktop
  4. حدد العتاد قبل شرائه بالاستعانة بفئات الذاكرة في دليل الاستدلال المحلي: الذكاء الاصطناعي المحلي في 2026: نموذج 27B يتفوق على Sonnet 4.6
  5. تحقق مما يستطيع العتاد الأصغر تشغيله إذا أردت وكيلاً دائماً على جهاز منخفض الطاقة: ما نماذج الذكاء الاصطناعي التي تعمل على Raspberry Pi 4 أو 5؟

مقالات ذات صلة

المقالما يتناوله
الذكاء الاصطناعي المحلي في 2026: نموذج 27B يتفوق على Sonnet 4.6معيار أداء الاستدلال المحلي والتكميم الثلاثي واختيار العتاد
ما نماذج الذكاء الاصطناعي التي تعمل على Raspberry Pi 4 أو 5؟استدلال محلي لمساعد صغير يعمل دائماً
إنشاء مساعد AI يحمي الخصوصية لـ Meshtasticنموذج محلي يشغل راديو خارج الشبكة، مع إعطاء الأولوية للخصوصية
أفضل إضافات VS Code لتطوير الذكاء الاصطناعيأدوات للمحرر تستخدم مع وكيل برمجة محلي

المراجع

  1. تكامل Claude Code - وثائق Ollama
  2. تكامل Claude Desktop - وثائق Ollama
  3. مكتبة نماذج Ollama
  4. Qwen3.8 - مكتبة نماذج Ollama
  5. Claude Cowork مع نماذج محلية - PromptSpace
  6. نسخة Prism ML المتفرعة من llama.cpp - النوى الثلاثية