Install
claude plugin marketplace add mbailey/voicemode
claude plugin install voicemode@voicemodeلمن يناسب
أنت تستخدم Claude Code بالفعل وتريد مواصلة الحوار بكلام طبيعي عندما تكون اليدان مشغولتين والكتابة غير مريحة. النص الرسمي يقول إن الصوت ليس بديلاً عن الكتابة، بل ليبقى الحوار قابلاً للاستخدام عندما يتعذر الكتابة. يناسب من يقبل دخولاً وخروجاً صوتياً حقيقيين، لا مجرد صدى نصي.
مقتطفات المنصات تغطي Linux وmacOS وWindows (أصلي أو WSL) وNixOS، وPython 3.10-3.14. الملاحظات الحالية لا تسرد طراز ميكروفون إلزامياً ولا متطلبات مكبر صوت ولا ما إذا كانت خدمة صوت سحابية مفروضة. إن لم تستطع تثبيت إضافة لـ Claude Code أو السماح بأدوات صوتية، فلن يفيدك هذا الدليل.
إنهاء المحاولة الأولى في 3 دقائق
المتطلبات المسبقة: Claude Code متاح، وPython في 3.10-3.14، والبيئة الحالية تسمح بالكلام والاستماع. المسار الرسمي الموصى به هو إضافة السوق أولاً ثم تثبيت الإضافة. لا تبدأ بأمر MCP التفافي:
claude plugin marketplace add mbailey/voicemode
claude plugin install voicemode@voicemode
بعد التثبيت أعد تشغيل Claude Code أو افتحه من جديد وتأكد أن الإضافة ظهرت. في المحاولة الأولى استخدم فقط mcp__voicemode__converse كما سمّاه المقتطف. هذا ليس استعلام قراءة فقط: يدخل محادثة صوتية، وقد يستخدم أجهزة صوت محلية، ويسلّم كلامك إلى الوكيل. قبل البدء تأكد أنك في مكان تستطيع فيه الكلام والاستماع ولا تمانع معالجة النموذج لهذه المحادثة، ثم نفّذ الاستدعاء.
إشارة النجاح القابلة للرصد: استمرار الحوار بشكل صوتي، لا نجاح أمر تثبيت الإضافة نفسه. الملاحظات الحالية لا تعطي جملة اختبار ثابتة ولا كلمة مفتاحية في السجل. إذا أظهر العميل تأكيد صلاحية، فانظر أنه سيسمح بـ mcp__voicemode__converse قبل الموافقة. لا تستدعِ mcp__voicemode__service في المحاولة الأولى — المقتطف يضعه في قائمة الصلاحيات فقط ولا يشرح ماذا يفعل.
المواد تتضمن أيضاً claude mcp add --scope user voicemode -- uvx --refresh --from voice-mode voicemode-mcp-launcher، وهو مسار تثبيت آخر. المحاولة الأولى تسلك سوق الإضافات أعلاه فقط؛ لا تضبط مدخلين في آن واحد.
حالات الاستخدام
الحالة 1: عندما لا تناسب الكتابة في المكان، استخدم mcp__voicemode__converse لتحويل مهمة Claude Code الجارية إلى ذهاب وإياب صوتي. الملاحظات الحالية تضمن فقط «محادثة صوتية طبيعية» ولا تسرد اللغة أو المقاطعة أو خفض الضوضاء أو معاملات تحول الصوت إلى مسودة قابلة للتحرير. النجاح أن تفهم الرد وتواصل الجولة التالية، لا سطر سجل نصي بعينه.
الحالة 2: عندما يجب السماح بالقدرة الصوتية صراحة، تظهر في قائمة الصلاحيات mcp__voicemode__converse وmcp__voicemode__service معاً. المقتطف لا يشرح دور service ولا إن كان يغيّر خدمات محلية ولا كيفية التراجع عند الفشل. لذلك تتوقف هذه الحالة عند «السماح لـ converse حسب القائمة، وservice يبقى بلا شرح». لا تختلق خطوات لإعادة تشغيل خدمة أو تثبيت عفريت نظام.
حدود الاستخدام
الصفحة الرسمية هي
https://github.com/mbailey/voicemode
لا تفهمها على أنها «بلا شبكة وبلا قراءة محلية وبلا حد خصوصية»: المحادثة الصوتية تجمع كلامك افتراضياً. يجب أن يقع Python في 3.10-3.14. قائمة المنصات تقف عند Linux وmacOS وWindows (أصلي أو WSL) وNixOS. المقتطف بلا خطوات إلغاء تثبيت أو إغلاق ميكروفون أو سحب محادثة. أداة service بلا استخدام سوى اسم الصلاحية. أمر تشغيل uvx التفافي موجود، لكن لا تجعله ينافس سوق الإضافات كمسار رئيسي ثانٍ. الحصص والفوترة ومفاتيح السحابة الإلزامية غير مكتوبة.