AI-translated from English; not yet reviewed by a fluent editor.

# نفّذ تغييرًا واحدًا في Claude Code وتحقق منه باستخدام نموذج Ollama محلي

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

By BIG CHANGE Editorial

Published: 2026-10-20T11:36:37.990Z
Updated: 2026-10-20T11:36:37.990Z
Canonical: https://bigchange.ai/blog/claude-code-local-ollama-checked-change-guide

![Conceptual charcoal illustration of an open desktop workstation showing its fan, memory modules, graphics card and internal cables.](https://bigchange.ai/api/media/file/local-model-workstation-open-chassis-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

يمكن أن يعمل Claude Code على مستودع تملكه عبر نموذج يقدمه Ollama على جهازك. يتصل [تكامل Claude Code](https://docs.ollama.com/integrations/claude-code) الحالي في Ollama مباشرة عبر واجهة API المتوافقة مع Anthropic. يتتبع هذا الدليل تغييرًا واحدًا محدود النطاق من حالة ابتدائية مسجلة إلى قرار بشري بشأن الفروق. وهو مخصص لمطور يستطيع تثبيت الأداتين والسماح بتحرير المستودع وتشغيل نموذج برمجة محلي مناسب. راجعت BIG CHANGE الأدلة في 20 أكتوبر 2026؛ ولم نشغّل النموذج أو نختبر مستودعًا.

## التغيير الكبير

- **ما الذي تغيّر:** يوثّق Ollama الآن مسارًا مباشرًا من Claude Code إلى خادمه المحلي المتوافق مع Anthropic، باستخدام أداة تشغيل أو إعدادات صريحة لنقطة اتصال محلية. لا يحتاج هذا الإعداد الموثق إلى وسيط منفصل.
- **لماذا يهم:** يمكنك الاحتفاظ بسير العمل في Claude Code مع اختيار نموذج محلي، والتحقق من السياق المخصص له فعليًا، ومراجعة تعديل حقيقي في المستودع مقابل فحص القبول الأصلي للمشروع.
- **ما الذي يجب الانتباه إليه:** لا يثبت اختيار وسم محلي وتشغيل نموذج أن كل طلب بقي محليًا أو أن شيفرته صحيحة. افحص التوجيه الفعلي وصلاحيات الأدوات وجميع الفروق ونتيجة الفحص قبل قبول التغيير.

### 1. سجّل حالة المستودع الابتدائية

اعمل في مستودع Git تملكه أو يُسمح لك بتغييره. استخدم فرعًا يمكن مراجعته أو نسخة عمل قابلة للاستغناء عنها. حدّد سلوكًا صغيرًا واحدًا أو عيبًا تريد تغييره، والملفات التي قد يتأثر بها، وشرط التوقف. اعثر على أمر القبول الموجود في المستودع، مثل الاختبار أو فحص البناء الموثق؛ ولا تستبدله بأمر عام. شغّله **قبل** أن يعدّل الوكيل أي شيء، وسجّل الأمر وحالة الخروج والمخرجات ذات الصلة. سجّل أيضًا الفرع و `git status` وأي فروق موجودة مسبقًا. التغييرات السابقة جزء من الحالة الابتدائية وليست من نتائج الذكاء الاصطناعي.

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

### 2. ثبّت نموذجًا محليًا مناسبًا وخصص السياق

ثبّت إصدارًا حديثًا من [Ollama](https://docs.ollama.com/quickstart) و [Claude Code CLI](https://code.claude.com/docs/en/setup) باتباع التعليمات الرسمية وقواعد جهازك ومؤسستك. سجّل `ollama --version` و `claude --version`. أضاف Ollama التوافق مع Anthropic Messages في الإصدار 0.14.0 في يناير 2026؛ وهذا التاريخ **لا** يحدد الحد الأدنى للإصدار اللازم لأمر `ollama launch` الحالي.

اختر نموذجًا تشير صفحة كتالوجه الحالية إلى دعم الأدوات، ويسمح ترخيصه باستخدامك، وتناسب أوزانه **والسياق المخصص له** جهازك. ومن الأمثلة المحلية المحددة [qwen3-coder:30b](https://ollama.com/library/qwen3-coder:30b)، المدرج مع دعم الأدوات وملف Q4\_K\_M بحجم نحو 19 GB وApache License 2.0. هذا حجم التنزيل وليس متطلب RAM أو VRAM. لا يعني السياق المعلن للنموذج أن جهازك يستطيع تخصيصه. إذا لم يناسبك النموذج، فاختر وسمًا محليًا آخر موثقًا بدعم الأدوات واستبدل الوسم بصورة متسقة في الأوامر التالية.

من الطرفية، وبعد تشغيل تطبيق Ollama أو الخادم المحلي، نزّل النموذج وتأكد من الوسم الدقيق:

```text
ollama pull qwen3-coder:30b
ollama list
```

يوصي Ollama [بما لا يقل عن 64,000 رمز](https://docs.ollama.com/context-length) لوكلاء البرمجة، ويذكر أن السياق الأكبر يستخدم ذاكرة أكثر. اضبط 64k أو أكثر في **إعدادات تطبيق Ollama الموجود** إذا كان عتادك يدعم ذلك. وإذا كنت تدير الخادم بنفسك، فاضبط الخدمة الموجودة باستخدام `OLLAMA_CONTEXT_LENGTH=64000` وفق [تعليمات الخادم الخاصة بمنصتك](https://docs.ollama.com/context-length)؛ ولا تبدأ خادمًا ثانيًا على المنفذ 11434. بعد تحميل النموذج استجابة لطلب، يعرض `ollama ps` القيم الفعلية لكل من `CONTEXT` و `PROCESSOR`. توقف أو قلّص نطاق المهمة واختر إعدادًا مناسبًا إذا تعذر تحميل التخصيص المطلوب. لا تعرض الحد الأقصى في الكتالوج على أنه السياق المخصص فعليًا.

### 3. وجّه Claude Code إلى الخادم المحلي

افتح طرفية **داخل المستودع المختار**. يوثّق Ollama مسار أداة التشغيل هذا؛ استخدم الوسم المحلي نفسه الذي أكدته نتيجة `ollama list`:

```text
ollama launch claude --model qwen3-coder:30b
```

يوثّق Ollama هذا المسار لنموذج غير Claude. [دليل Anthropic للبوابات](https://code.claude.com/docs/en/llm-gateway) يقول إن Anthropic لا يدعم توجيه Claude Code إلى نماذج غير Claude عبر بوابة. تعامل معه بوصفه تكاملًا موثقًا من Ollama دون دعم من Anthropic لهذا التوجيه، وافحص الجلسة الفعلية قبل الاعتماد عليه.

للإعداد اليدوي، تستخدم [تعليمات تكامل Ollama](https://docs.ollama.com/integrations/claude-code#manual-setup) بدلًا من ذلك `ANTHROPIC_AUTH_TOKEN=ollama` وقيمة فارغة صراحةً لـ `ANTHROPIC_API_KEY` و `ANTHROPIC_BASE_URL=http://localhost:11434`. يضبط أمر **Bash** الاختياري هذا القيم الثلاث لهذه العملية من Claude Code فقط، من دليل المستودع الذي تملكه؛ ولا يغيّر ملف إعداد الصدفة العام:

```bash
ANTHROPIC_AUTH_TOKEN=ollama ANTHROPIC_API_KEY="" ANTHROPIC_BASE_URL=http://localhost:11434 claude --model qwen3-coder:30b
```

للصدفات الأخرى، استخدم أداة تشغيل Ollama المفضلة أعلاه أو إعداد الصدفة المحددة في الدليل الرسمي الحالي. افحص إعدادات Claude Code الموجودة التي قد تتجاوز متغيرات الأمر. لا تطبع أي بيانات اعتماد موجودة مسبقًا أثناء فحص الإعدادات. القيم الفعلية المتوقعة عند القراءة هي الوسم المحلي المختار و `http://localhost:11434`؛ وهذا فحص يجريه القارئ وليس نتيجة رصدتها BIG CHANGE. يتجاهل الخادم المحلي الرمز البديل `ollama`؛ فهو ليس سرًا للتحكم في الوصول. لا يحتاج المسار المحلي الموثق إلى مفتاح سحابي من Ollama أو مفتاح استدلال من Anthropic. تبقى شروط برنامج Claude Code والخدمات المتصلة سارية.

أبقِ الخادم مرتبطًا محليًا وفق [إرشادات Ollama لإعداد الخادم](https://docs.ollama.com/faq). إن الوسم `:cloud` أو عنوان الأساس `https://ollama.com` يعني مسارًا سحابيًا يحتاج إلى قرار مختلف بشأن البيانات والتكلفة. توقف قبل إرسال محتوى المستودع إذا كان النموذج أو الوجهة غير واضحين.

### 4. افحص المسار ثم اطلب تعديلًا واحدًا

قبل السماح بتغييرات الملفات، افحص نموذج Claude Code واتصاله الفعليين باستخدام `/status` حيثما يتوفر. قارن القيم المقروءة بأداة التشغيل أو نقطة الاتصال اليدوية و `ollama list`، ثم بعد أن يحمّل طلبٌ النموذجَ، بـ `ollama ps`. سجّل الوسم المحمّل بدقة والقيم المخصصة لكل من `CONTEXT` و `PROCESSOR`؛ فقد يؤثر توزيع المعالجة مع CPU في جدوى سير العمل. افحص أيضًا أدلة الطلبات في الخادم المحلي إن توفرت. تثبت هذه الفحوص الإعداد وتحميل النموذج، لا تدقيقًا كاملًا لكل حركة الشبكة. راجع أدوات MCP المفعلة وجلب الويب والبحث والقياس عن بُعد وأي إعدادات سحابية بصورة منفصلة إذا كانت المعالجة المحلية مهمة لسياسة الشيفرة لديك.

استخدم طلبات الموافقة المعتادة في Claude Code و [ضوابط الصلاحيات](https://code.claude.com/docs/en/permissions). اطلب المهمة الواحدة في المستودع الذي تملكه بلغة عادية: حدّد السلوك المطلوب والنطاق المسموح وأمر القبول الأصلي ومكان التوقف. اطلب الإبلاغ عن الملفات المعدلة ومخرجات الفحص. أبقِ قرارات إنشاء الالتزام والدفع والإصدار بيد مالك المستودع، وارفض إجراءات الشبكة أو الأدوات غير المتوقعة. لا يُعد ادعاء النموذج أنه استخدم نقطة الاتصال المحلية أو اجتاز الفحص تحققًا.

### 5. اتخذ القرار وفق جميع الفروق والفحص الأصلي

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

إذا تعذر الوصول إلى Ollama، فافحص التطبيق أو الخدمة قيد التشغيل و `ollama list` قبل محاولة مهمة البرمجة. إذا تعذر تحميل النموذج أو أبلغ `ollama ps` عن سياق غير كافٍ، فافحص الذاكرة وإعداد السياق؛ واستخدم مهمة أضيق نطاقًا أو نموذجًا محليًا مناسبًا. إذا أظهر `/status` أو الإعداد الفعلي مزودًا مستضافًا، فتوقف قبل إرسال الشيفرة وأصلح إعدادات الصدفة الحالية أو Claude Code. قد ينتج خطأ استدعاء الأداة من توافق النموذج أو رفض صلاحية؛ افحص الرد الدقيق قبل تغيير أي منهما. إذا كانت المحاولة قد عدّلت الملفات، فافحص فروقها قبل التراجع أو المتابعة. وبعد فشل فحص القبول، شخّص الشيفرة ولا تكرر الفحص إلا بعد تصحيح تمت مراجعته.

يتجنب الاستدلال المحلي رسوم المزود لكل رمز للنموذج المنزّل، لكنه يستخدم العتاد والتخزين والكهرباء. قد ترسل التنزيلات أو القياس عن بُعد أو أدوات الويب أو تكاملات MCP أو إعدادات النماذج السحابية بيانات، أو تترتب عليها تكاليف أخرى. يدعم Ollama [جزءًا من Anthropic Messages API](https://docs.ollama.com/api/anthropic-compatibility) مع قيود على ميزات منها عدّ الرموز والتخزين المؤقت للمطالبات والدفعات والاستشهادات وملفات PDF والاختيار الإجباري للأداة؛ وتختلف النماذج أيضًا في قدرتها على استخدام الأدوات. لا توجد نتيجة مقاسة للسرعة أو الجودة أو الخصوصية أو التوفير من مراجعة BIG CHANGE للوثائق. لإعداد مختلف لوكيل محلي، راجع [دليلنا عن Junie Local](https://bigchange.ai/blog/junie-local-windows-coding-agent-setup)؛ فهذا الإجراء يحتفظ تحديدًا بـ Claude Code ويفحص مساره إلى Ollama.

## المصادر وقراءات إضافية

- [Ollama، «Claude Code»](https://docs.ollama.com/integrations/claude-code) يقدم أداة التشغيل الحالية والإعدادات المحلية اليدوية والبديل السحابي. إنه يوثّق مسارًا لا تشغيلًا ناجحًا في مستودع القارئ.
- [Ollama، «Anthropic compatibility»](https://docs.ollama.com/api/anthropic-compatibility) يصف نقطة الاتصال المحلية والرمز البديل الذي يجري تجاهله وتنزيل النموذج وحدود ميزات API. التوافق لا يضمن كل نموذج أو استدعاء أداة.
- [Ollama، «Context length»](https://docs.ollama.com/context-length) يشرح توصية 64k للبرمجة والموازنة مع استخدام الذاكرة وقراءة `ollama ps`. يحدد الجهاز الفعلي حجم التخصيص الممكن.
- [صفحة qwen3-coder:30b في Ollama](https://ollama.com/library/qwen3-coder:30b) تدرج الملف النموذجي والأدوات ورابط ترخيص Apache 2.0. أعد فحص صفحة النموذج الدقيقة قبل التنزيل أو إعادة التوزيع.
- [تثبيت Claude Code](https://code.claude.com/docs/en/setup) و [إعدادات الصلاحيات](https://code.claude.com/docs/en/permissions) يشرحان الوصول والموافقة على الأدوات. ولا يثبت أي منهما نقطة الاتصال الفعلية لجلسة معينة أو نتيجة آمنة في المستودع.
- [Anthropic، «Other LLM gateways»](https://code.claude.com/docs/en/llm-gateway) يذكر أن Anthropic لا يدعم توجيه Claude Code إلى نماذج غير Claude عبر بوابة. ويوثّق Ollama بصورة منفصلة التكامل المحلي الموضح هنا.

## Sources

- [Claude Code — Ollama](https://docs.ollama.com/integrations/claude-code) — تعليمات أداة التشغيل الأساسية ونقطة الاتصال المحلية اليدوية، مع مسار سحابي منفصل. لا تثبت أن تشغيلًا معينًا استخدم localhost.
- [Anthropic compatibility — Ollama](https://docs.ollama.com/api/anthropic-compatibility) — نقطة اتصال Messages المحلية والرمز البديل المتجاهَل وتنزيل النموذج والميزات غير المدعومة. يختلف التوافق حسب النموذج والأداة.
- [Context length — Ollama](https://docs.ollama.com/context-length) — توصية 64k للبرمجة والموازنة مع الذاكرة وقراءة context/processor من ollama ps؛ لا توجد مصادقة على سعة جهاز معين.
- [qwen3-coder:30b — مكتبة نماذج Ollama](https://ollama.com/library/qwen3-coder:30b) — الوسم المحلي الدقيق للمثال والأدوات وملف Q4_K_M بحجم نحو 19 GB ورابط ترخيص Apache 2.0؛ حجم التنزيل ليس الذاكرة اللازمة للتشغيل.
- [Quickstart — Ollama](https://docs.ollama.com/quickstart) — المسار الرسمي للتثبيت والبدء؛ على القارئ مراجعة تعليمات منصته الحالية والإصدار المثبت.
- [FAQ — Ollama](https://docs.ollama.com/faq) — إعداد الخادم المحلي وحدود الشبكة والسحابة؛ ليس تدقيقًا كاملًا لخصوصية Claude Code أو التكاملات.
- [Claude Code support — Ollama](https://ollama.com/blog/claude) — يؤرّخ توافق Messages في v0.14.0؛ ولا يحدد الحد الأدنى لإصدار أداة التشغيل الحالية.
- [Advanced setup — Claude Code Docs](https://code.claude.com/docs/en/setup) — التثبيت الرسمي ومتطلبات المنصة؛ لم يجر تثبيت نسخة من Claude Code أو تشغيلها أثناء إعداد المادة.
- [Configure permissions — Claude Code Docs](https://code.claude.com/docs/en/permissions) — الموافقة على الأدوات والصلاحيات الفعلية؛ تعليمات المسار بلغة عادية ليست بيئة عزل.
- [Other LLM gateways — Claude Code Docs](https://code.claude.com/docs/en/llm-gateway) — تقول Anthropic إنها لا تدعم توجيه Claude Code إلى نماذج غير Claude عبر بوابة. هذا حد دعم المزود إلى جانب التكامل المحلي الموثق لدى Ollama، وليس استنتاجًا قانونيًا.