Claude Code: كيفية إعادة تهيئة إضافة مثبّتة دون إعادة تثبيتها (2.1.285)

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

تتوفر معلومات استخدام Ailoot في الوثائق.

ما الذي أضافه الإصدار 2.1.285#

يتضمن إدخال سجل تغييرات Claude Code للإصدار 2.1.285 (التزام مؤرخ في 29 September 2026) عدة أسطر عن الإضافات. ويتعلق اثنان منها بهذه المقالة:

Added claude plugin configure <plugin> to show a plugin's options and which are unset, or save new values read from stdin with --values-stdin

يعني ذلك أن الأمر الجديد claude plugin configure <plugin> يعرض إعدادات الإضافة ويحدد غير المُعدّ منها، أو يحفظ قيماً جديدة مقروءة من الإدخال القياسي عند استخدامه مع --values-stdin.

Added <server>.<key>=<value> to claude plugin install --config, so a bundled .mcpb MCP server's own settings can be set at install time and it starts without visiting /plugin → Configure

يعني ذلك أن claude plugin install --config يدعم الآن الصيغة <server>.<key>=<value>، ما يتيح تزويد إعدادات خادم MCP المضمّن مع إضافة في ملف .mcpb أثناء التثبيت، ليبدأ الخادم دون الانتقال إلى /plugin → Configure.

يؤكد مرجع الأوامر شرط الإصدار: يتطلب claude plugin configure الإصدار Claude Code v2.1.285 أو أحدث. هذا الأمر غير متاح في الإصدارات الأقدم.

الفرق عن /plugin configure#

كان الأمر /plugin configure <plugin> (مع الاسم المستعار config) متاحاً بالفعل داخل جلسة Claude Code تفاعلية. وهو يفتح مربع حوار لإعدادات userConfig ويتطلب الإصدار v2.1.147 أو أحدث. لكن /plugin لا يعمل إلا في جلسة تفاعلية: ففي استدعاء غير تفاعلي مثل claude -p، يرد Claude Code بأن /plugin غير متاح في تلك البيئة.

وفقاً للوثائق، تُشغَّل أوامر claude plugin من shell أو من script، خارج جلسة Claude Code. ويتيح ذلك أيضاً تشغيل claude plugin configure دون فتح مربع حوار. لا توضح الوثائق سلوك هذا الأمر دون طرفية تفاعلية، ولا مكان تخزين القيم السرية على خادم لا يحتوي على بيئة رسومية. تحقّق من ذلك في بيئتك قبل استخدامه في CI.

الخطوة 1. اعرف الإعدادات المحددة#

تتطلب الوثائق معرّف الإضافة كاملاً بصيغة name@marketplace، كما يظهر في claude plugin list. لا يقبل الأمر configure اسماً دون @marketplace.

claude plugin list
claude plugin configure formatter@my-marketplace

استبدل formatter@my-marketplace بمعرّف إضافتك. دون خيارات، يسرد الأمر كل إعداد مع إحدى العلامتين required أو optional، ثم sensitive للحقل السري، ويتبع ذلك set أو not set. ولا يطبع القيم المخزنة.

إذا كنت بحاجة إلى مخرجات قابلة للقراءة آلياً، فأضف --json. عندها ستتضمن المخرجات القيم المخزنة للحقول العادية، لكن محتوى الحقل السري لا يُطبع أبداً.

الخطوة 2. غيّر قيمة باستخدام ملف#

تُمرّر القيم في كائن JSON، حيث يكون كل مفتاح اسم إعداد من manifest، وكل قيمة سلسلة نصية بلا فواصل أسطر. تعرض الوثائق طريقة تعتمد على ملف: اكتب الكائن في values.json ومرّر ذلك الملف إلى الإدخال القياسي للأمر. هنا، api_url هو المفتاح المستخدم في مثال الوثائق. استخدم في إضافتك اسم الإعداد المطلوب من manifest أو من مخرجات الخطوة 1.

{"api_url": "NEW_ADDRESS"}

claude plugin configure formatter@my-marketplace --values-stdin < values.json

تنطبق القواعد التالية عند الحفظ:

• تحتفظ الإعدادات المحذوفة من JSON بقيمها السابقة. يمكنك تمرير الحقل الذي تريد تغييره فقط.
• يشير وصف الخيار إلى تعيين القيم عموماً، ولا يذكر قاعدة منفصلة للحقول السرية. بعد الحفظ، استخدم الخطوة 1 للتحقق من أن الحقل المعني يحمل الحالة set.
• يتحقق Claude Code من كل قيمة بمقارنتها بالنوع المعلن، ويطبع Configuration saved. Restart Claude Code to apply it. وهذا يعني أن الإعداد حُفظ وسيُطبَّق بعد إعادة تشغيل Claude Code.
• إذا احتوى JSON على مفتاح غير معلن في manifest، أو لم تجتز قيمة التحقق، فلن يحفظ الأمر شيئاً، وسيطبع Failed to save configuration: متبوعاً بالسبب، ثم ينتهي برمز الخروج 1.

إذا كتبت رمزاً في values.json، فتذكّر أنه ملف عادي على القرص. احذفه بعد حفظ الإعدادات، ولا تضف ملفاً كهذا إلى المستودع.

مكان تخزين القيمة#

وفقاً لوثائق manifest الإضافات، تُحفظ القيم العادية ضمن pluginConfigs في ملف settings.json الخاص بالمستخدم. أما قيم الحقول التي تحمل العلامة sensitive: true فتُخزَّن في مخزن بيانات الاعتماد الآمن للنظام بدلاً من settings.json؛ ويُحجب الإدخال لهذه الحقول.

لا جدوى من البحث عن قيمة حقل سري في settings.json. يعرض claude plugin configure حالته بالعلامتين sensitive وset أو not set.

install --config: تعيين قيمة أثناء التثبيت#

عند إجراء تثبيت جديد، يوفر claude plugin install الخيار --config <key=value>. يعيّن هذا الخيار إعداد userConfig المعلن في manifest ويتطلب الإصدار v2.1.147 أو أحدث. كرر الخيار لكل إعداد. ابتداءً من الإصدار 2.1.285، يعيّن المفتاح بصيغة <server>.<key> إعداد خادم MCP مضمّن معلناً في user_config الخاص بذلك الخادم.

في المثال أدناه، استبدل formatter@my-marketplace بمعرّف إضافتك، وapi_url باسم الإعداد في manifest، واستبدل العنصر النائب NEW_ADDRESS بالكامل بالقيمة التي تريدها. أبقِ علامتي الاقتباس حول الوسيطة.

claude plugin install formatter@my-marketplace --config 'api_url=NEW_ADDRESS'

يعتمد الأمر الذي ينبغي استخدامه على ما إذا كانت الإضافة مثبتة: يعيّن install --config القيم أثناء التثبيت الأول، بينما يغيّر plugin configure --values-stdin قيم إضافة مثبّتة بالفعل.

بالنسبة إلى إعدادات خادم MCP مضمّن، تسرد الوثائق طرقاً أخرى: plugin install --config أو Configure في /plugin. ولا تقترح أمر plugin configure لهذه الإعدادات.

إذا تعذّر على الأمر العثور على الإضافة#

إذا لم يتمكن claude plugin configure من العثور على إضافة محمّلة بهذا المعرّف، فسيطبع No installed plugin has the id "<plugin>". وينتهي برمز الخروج 1. تحقق أولاً من إدخال معرّف name@marketplace الكامل كما يظهر في claude plugin list. اسم الإضافة وحده لا يكفي.

للأمر داخل الجلسة رسالة خاصة به. إذا حددت إضافة غير مثبّتة في المشروع الحالي عند استخدام /plugin enable أو disable أو uninstall أو configure، فسيطبع Claude Code Plugin "<plugin>" is not installed in this project ولن يفعل شيئاً.

الخلاصة#

لتغيير رمز أو عنوان لإضافة مثبّتة بالفعل في Claude Code 2.1.285 أو أحدث، اعثر على معرّفها باستخدام claude plugin list، وتحقق من حالة الإعدادات باستخدام claude plugin configure، ومرّر القيمة الجديدة من ملف باستخدام --values-stdin، ثم أعد تشغيل Claude Code. لا تُخزَّن قيم الحقول السرية في settings.json، لذا تحقق من حالتها باستخدام الأمر نفسه.

قد يساعدك دليل Skills وSubagents وMCP وPlugins في Claude Code على الاختيار بين أنواع الإضافات. وإذا لم تختر إضافة بعد، يمكنك البدء بـأفضل 10 إضافات لـ Claude Code. وهناك دليل منفصل لروبوت Telegram: طريقة تثبيت إضافة في وكيل Telegram تختلف عن تثبيت إضافة في Claude Code.

تعرّف على Ailoot.