تحديث سري لـ Claude Code، وأخيرًا لم يعد "آلة بحث نصية"

عندما تكتب التعليمات البرمجية، هل فكرت يومًا في سؤال:

لماذا يمكنك الانتقال مباشرة إلى تعريف الدالة بالضغط على Ctrl + النقر في VS Code؟ لماذا يمكنك رؤية وصف كامل للمعلمات عند تمرير الماوس فوق الدالة؟ لماذا يمكن للمحرر إخبارك أين الخطأ في التعليمات البرمجية الخاصة بك قبل تشغيلها؟

أنت تستخدم هذه الميزات كل يوم، وتستمتع بها.

ولكن ربما لا تعرف أن كل هذا مدعوم بشيء يسمى LSP (Language Server Protocol).

والأهم من ذلك، أن Claude Code الإصدار 2.0.74 وما يليه يدعم LSP أيضًا.

ماذا يعني هذا؟

هذا يعني أن Claude Code قد تحول أخيرًا من "آلة بحث نصية" إلى ذكاء اصطناعي يفهم التعليمات البرمجية حقًا.

ما هو LSP؟ بعبارات بسيطة

LSP هو بروتوكول أنشأته Microsoft، والغرض منه بسيط:

السماح باستخدام وظائف التعليمات البرمجية الذكية في أي محرر.

Claude Code LSP انظر:

يمكن استخدام خادم لغة TypeScript في VS Code، وفي JetBrains، وفي Cursor
الآن، يمكن استخدامه أيضًا في Claude Code

LSP هو الشيء الذي يجعل المحرر الخاص بك ذكيًا:

الإكمال التلقائي لأسماء ووظائف المعلمات
الانتقال إلى التعريف
البحث عن جميع المراجع
عرض الوثائق عند التمرير
الإبلاغ عن الأخطاء والتحذيرات في الوقت الفعلي

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

لكنك لم تفكر أبدًا في كيفية تحقيق ذلك.

الآن لا داعي للتفكير، ما عليك سوى أن تعرف: Claude Code لديه الآن هذه القدرات أيضًا.

كيف كان Claude Code يعمل من قبل؟

قبل دعم LSP، ماذا كان على Claude Code أن يفعل للعثور على مكان تعريف الدالة؟

الاعتماد على البحث باستخدام grep.

بصراحة، إنه مجرد بحث نصي كامل، للعثور على مكان ظهور الأحرف "displayBooks".

هل هذا ممكن؟ نعم إنه ممكن.

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

ولكن أين المشكلة؟

إنه لا يفهم حقًا بنية التعليمات البرمجية.

يشبه الأمر أن تطلب من شخص ما العثور على "Zhang San"، ولا يمكنه سوى قلب دفتر العناوين صفحة صفحة للعثور على الكلمتين "Zhang San".

بينما إذا كنت تستخدم هاتفك للبحث عن "Zhang San"، فستقوم باستدعاء قاعدة البيانات مباشرةً، وستحصل على النتائج في ثوانٍ.

هذا هو الفرق.

Claude Code السابق: يقرأ الملفات واحدًا تلو الآخر، ويعتمد على مطابقة النصوص. Claude Code الحالي: يسأل خادم اللغة مباشرةً، ويحدد الموقع بدقة.

الكفاءة ليست مختلفة قليلاً.

ما الذي جلبه LSP إلى Claude Code؟

5 قدرات أساسية، كل منها أداة كفاءة:

1. goToDefinition - الانتقال إلى التعريف

ماذا يمكنك أن تفعل بـ Ctrl+Click في VS Code؟ انتقل مباشرة إلى مكان تعريف الدالة.

يمكن لـ Claude Code الآن أن يفعل الشيء نفسه.

تسأله: "أين تم تعريف الدالة processRequest؟ باستخدام LSP"

لن يبحث بشكل غبي في جميع الملفات.

يسأل خادم اللغة مباشرةً، ويحصل على الإجابة في ثوانٍ: اسم الملف ورقم السطر والموقع الدقيق.

2. findReferences - البحث عن جميع المراجع

هذه ميزة قاتلة.

تريد إعادة هيكلة دالة، لكنك تخشى تغييرها، خوفًا من أن تتعطل أماكن أخرى.

ماذا تفعل؟

في السابق، كان عليك أن تجعل Claude Code يقرأ الملفات واحدًا تلو الآخر، وهو أمر بطيء للغاية.

الآن اسأل مباشرةً: "أين تم استدعاء الدالة displayError؟ باستخدام LSP"

يسرد لك خادم اللغة مباشرةً جميع مواقع المراجع.

بسرعة ودقة وقوة.

3. hover - الحصول على معلومات حول الوثائق والأنواع

عندما تحوم بالماوس في VS Code، يمكنك رؤية توقيع الدالة وأنواع المعلمات وتفسيرات الوثائق.

يمكن لـ Claude Code الآن رؤية ذلك أيضًا.

اسأله: "ما هي المعلمات التي تقبلها الدالة displayBooks؟ باستخدام LSP"

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

خاصة بالنسبة للغات الديناميكية مثل Python، كان Claude يعتمد سابقًا على السياق لاستنتاج الأنواع.الآن مع LSP، معلومات النوع واضحة تمامًا.

4. documentSymbol - سرد جميع الرموز في الملف

هل تريد معرفة الفئات والدوال والمتغيرات الموجودة في ملف بسرعة؟

اسأل Claude: "ما هي الرموز الموجودة في backend/index.js؟ باستخدام LSP"

سيعيد لك قائمة منظمة وواضحة.

5. workspaceSymbol - البحث عن الرموز في المشروع بأكمله

هذا أقوى.

ليس البحث عن النص، بل البحث عن الرموز.

هل تريد العثور على جميع الطرق التي تحتوي على "innerHTML"؟

يقوم خادم اللغة بالعثور عليها مباشرةً، وليس مطابقة السلاسل النصية، بل رموز التعليمات البرمجية الحقيقية.

دراسة حالة: ما هي المشاكل التي يمكن لـ LSP حلها؟

دعك من الأشياء النظرية، انظر إلى الحالات العملية.

الحالة 1: تتبع استدعاءات الدوال

هناك مشروع يسمى AseBook Finder، الواجهة الأمامية لديها دالة displayBooks.

تريد معرفة الأماكن التي تم فيها استدعاء هذه الدالة.

ماذا كنت تفعل من قبل؟ Claude Code grep في كل مكان، قد تفوتك، وقد تكون هناك تقارير خاطئة.

الآن اسأل مباشرةً: "ابحث عن جميع مراجع displayBooks باستخدام LSP"

النتيجة:

موقع تعريف الدالة
الموقع الذي تم استدعاؤه بعد نجاح fetch
جميع الأماكن الأخرى التي تم فيها الرجوع إليها

دقيق وسريع ولا يترك شيئًا.

الحالة 2: فهم معلمات الدالة

تريد أن يقوم Claude بإنشاء جزء من التعليمات البرمجية، يستدعي الدالة displayError.

لكنك غير متأكد من المعلمات التي تقبلها هذه الدالة.

اسأله: "ما هي المعلمات التي تقبلها displayError؟ باستخدام LSP"

يقوم خادم اللغة بإرجاع: يقبل معلمة message.

Claude يعرف، والتعليمات البرمجية التي تم إنشاؤها لن تكون خاطئة.

الحالة 3: البحث عن استدعاءات API

تريد العثور على المكان الذي تم فيه استدعاء واجهة برمجة التطبيقات /api/recommendations في المشروع.

اسأل Claude: "ابحث عن جميع مراجع /api/recommendations باستخدام LSP"

يعثر على موقع استدعاء fetch، بدقة تصل إلى السطر.

تصحيح أخطاء مشاكل API، وتتبع تدفق البيانات، مفيد للغاية.

الحالة 4: اكتشاف الأخطاء مبكرًا

أنت تعيد هيكلة التعليمات البرمجية، وأخطأت في كتابة اسم متغير عن طريق الخطأ.

في الظروف العادية، يجب عليك تشغيل التعليمات البرمجية للعثور عليها.

ولكن مع LSP، يقوم خادم اللغة بالتحقق في الوقت الفعلي، ويكتشف المشكلة ويبلغ Claude Code على الفور.

يخبرك Claude أن هناك خطأ هنا قبل تشغيل التعليمات البرمجية.

كيفية الإعداد؟ 5 خطوات لإنجازها

لا تقلق، الإعداد بسيط للغاية.

الخطوة 1: تمكين أدوات LSP

أضف سطرًا في ملف تكوين shell الخاص بك (.bashrc أو .zshrc):

exportENABLE_LSP_TOOLS=1 ثم قم بتشغيل source ~/.zshrc لتفعيله.

الخطوة 2: تثبيت ملحقات خادم اللغة

افتح Claude Code، وأدخل:

/plugin ابحث عن الملحق المقابل للغة التي تستخدمها:

Python: اختر pyright-lsp
TypeScript/JavaScript: اختر vtsls أو typescript-lsp
Go: اختر gopls
Rust: اختر rust-analyzer

اختر "Install for me only"، وقم بالتثبيت.

الخطوة 3: تثبيت الملفات الثنائية لخادم اللغة

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

Python:

pip install pyright TypeScript/JavaScript:

npm install -g @vtsls/language-server typescript Go:

go install golang.org/x/tools/gopls@latest Rust:

rustup component add rust-analyzer

الخطوة 4: أعد تشغيل Claude Code`claude`

الخطوة 5: التحقق من أن كل شيء يعمل

اكتب /plugin، وتحقق من علامة التبويب "Installed"، يجب أن ترى المكون الإضافي الخاص بك.

اختبره:

ابحث عن جميع مراجع someFunction باستخدام LSP إذا استخدم Claude Code أداة find_references بدلاً من grep، فهذا يعني أنك نجحت.

متى تستخدم LSP؟ ومتى لا تستخدمها؟

LSP ليست حلاً سحريًا لكل شيء.

الحالات التي تناسب استخدام LSP:

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

الحالات التي لا تناسب استخدام LSP:

المشاريع الصغيرة، البرامج النصية السريعة
البحث البسيط عن النصوص
مجرد البحث عن سلسلة نصية في مكان ما

ببساطة، استخدم grep عندما يكون سريعًا، واستخدم LSP عندما يكون دقيقًا.

الأدوات وجدت لخدمة الإنسان، وليست للاستخدام من أجل الاستخدام.

بعض المشاكل، أخبرك بها مسبقًا

المشكلة 1: يجب أن يكون خادم اللغة في PATH

إذا قال Claude Code "No LSP server available"، فغالبًا ما يكون خادم اللغة الخاص بك لم يتم تثبيته بشكل صحيح، أو ليس في PATH.

قم بتشغيل which pyright (أو خادم اللغة الخاص بك) في الوحدة الطرفية، لترى ما إذا كان يمكن العثور عليه.

المشكلة 2: يجب إعادة التشغيل بعد تثبيت المكون الإضافي

بعد تثبيت مكون إضافي جديد أو تحديث خادم اللغة، تأكد من إعادة تشغيل Claude Code.

يتم تحميل خوادم اللغة عند بدء التشغيل.

المشكلة 3: في بعض الأحيان تحتاج إلى أن تقول بوضوح "استخدم LSP"

إذا وجدت أن Claude Code لا يزال يستخدم grep بدلاً من LSP، فأضف عبارة "استخدم LSP":

ابحث عن جميع مراجع authenticateUser باستخدام LSP بهذه الطريقة يعرف أنه يجب عليه استخدام خادم اللغة.

المشكلة 4: لا توجد تلميحات مرئية

على عكس VS Code، لن يخبرك Claude Code ما إذا كان خادم LSP قيد التشغيل أم لا.

لا يوجد رمز في شريط الحالة، ولا توجد إشعارات.

الطريقة الوحيدة للتأكد: الاختبار الفعلي.

كلمة أخيرة

دعم Claude Code لـ LSP ليس تحديثًا بسيطًا، بل هو تغيير نوعي.

في السابق كان "البحث عن النصوص + استنتاج الذكاء الاصطناعي".

الآن هو "خادم اللغة + فهم الذكاء الاصطناعي".

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

فرق الكفاءة، شاسع.

إذا كنت تستخدم Claude Code في مشروع جاد، فاستغرق 5 دقائق لإعداد LSP.

هذه الـ 5 دقائق تستحق العناء.

قائمة المهام:

أضف export ENABLE_LSP_TOOLS=1 في تكوين shell
افتح Claude Code، وقم بتشغيل /plugin لتثبيت المكون الإضافي للغة الخاصة بك
قم بتثبيت الملفات الثنائية لخادم اللغة المقابل
أعد تشغيل Claude Code
اختبر "ابحث عن جميع مراجع XXX باستخدام LSP"

بعد التثبيت، ستكتشف: اتضح أن Claude Code يمكن أن يكون بهذه السرعة.

تحديث سري لـ Claude Code، وأخيرًا لم يعد "آلة بحث نصية"

ما هو LSP؟ بعبارات بسيطة

كيف كان Claude Code يعمل من قبل؟