Voice Mode
برمج بصوتك
اعتبارًا من 2026-10-20، تتضمن قائمة لغات الإملاء الصوتي الرسمية 20 لغة بالضبط، ورمز اللغة الألمانية هو de. يتيح الإملاء الصوتي في Claude Code تعاونًا في البرمجة بالذكاء الاصطناعي مدفوعًا بالصوت، مع دعم 20 لغة لتجربة تطوير دون لمس لوحة المفاتيح: يُحوَّل كلامك مباشرةً إلى نص في إدخال prompt، ويمكنك مزج الإملاء والكتابة في الرسالة نفسها.
ما هو Voice Mode في Claude Code (الإملاء الصوتي)
Voice Mode هو الإملاء الصوتي في Claude Code CLI: يُنسخ كلامك مباشرةً إلى إدخال prompt، ما يتيح لك مزج التحدث والكتابة.
طريقتان للتسجيل: اضغط باستمرار على Space أثناء التحدث وأفلته للتوقف، أو انقر مرة للبدء وانقر مرة أخرى للإرسال. ضُبط النسخ ليتناسب مع مفردات البرمجة، ويُضاف اسم مشروعك الحالي واسم فرع git تلقائيًا كتلميحات للتعرف.
دليل الإعداد
يحتاج الإملاء الصوتي إلى تسجيل الدخول إلى claude.ai؛ وهو غير متاح عندما يكون Claude Code مهيأً بمفتاح API من Anthropic أو تسجيل دخول API آخر. يجب أن يكون الميكروفون على جهازك الخاص، لذا لا يعمل الإملاء في جلسات السحابة أو جلسات SSH. هناك طريقتان لتمكينه: شغّل /voice في جلسة، أو اضبط enabled و mode في كائن voice بملف إعدادات المستخدم.
الخطوة 1: تثبيت Claude Code
ثبّت Claude Code CLI الرسمي. اعتبارًا من 2026-10-20، أول إدخال في CHANGELOG الرسمي هو الإصدار 2.1.303.
npm install -g @anthropic-ai/claude-code@latestالخطوة 2: تشغيل /voice والسماح بالوصول إلى الميكروفون
اكتب /voice في جلسة Claude Code لتفعيل الإملاء الصوتي. عند أول تفعيل يُجرى فحص للميكروفون، وعلى macOS تتلقى الطرفية طلب إذن الميكروفون من النظام.
claude config set --global voice_mode trueالخطوة 3: بدء Voice Mode
وضع الضغط مع الاستمرار هو الافتراضي: اضغط مع الاستمرار على Space أثناء التحدث واتركه للتوقف؛ شغّل /voice tap لاستخدام وضع النقر بدلًا من ذلك. مفتاح الإملاء مرتبط بـvoice:pushToTalk ويُعيّن افتراضيًا إلى Space، ويمكنك إعادة ربطه بمزيج مثل meta+k. لا يمكن ربط Caps Lock، لأن الطرفيات لا ترسله كحدث مفتاح.
الخطوة 4: ضبط لغة الإملاء
تأتي لغة الإملاء من إعداد اللغة: ضع اسم لغة أو رمز لغة BCP 47 في /config أو في ملف الإعدادات؛ عندما يكون الإعداد فارغًا، يعود الإملاء افتراضيًا إلى الإنجليزية. إذا لم تكن القيمة ضمن القائمة المدعومة، يحذرك /voice ويعود إلى الإنجليزية في الإملاء، بينما لا تتأثر ردود Claude النصية.
اللغات المدعومة للإملاء الصوتي
يدعم الإملاء 20 لغة، تغطي مجتمعات المطورين الرئيسية حول العالم. اضبطها عبر إعداد اللغة باستخدام رمز لغة BCP 47 أو اسم لغة. اعتبارًا من 2026-10-20، تسرد قائمة لغات الإملاء الصوتي الرسمية اللغات الـ20 كلها: التشيكية، والدنماركية، والهولندية، والإنجليزية، والفرنسية، والألمانية، واليونانية، والهندية، والإندونيسية، والإيطالية، واليابانية، والكورية، والنرويجية، والبولندية، والبرتغالية، والروسية، والإسبانية، والسويدية، والتركية، والأوكرانية.
مسارات عمل نموذجية للإملاء الصوتي
يناسب الإملاء وصف المتطلبات وتعقّب الأخطاء. كيّف العبارات النموذجية مع مشروعك؛ أما المسارات والمعرّفات الدقيقة فتظل الكتابة أفضل.
مراجعة الكود
صِف متطلبات المراجعة صوتيًا، ويحلل الذكاء الاصطناعي تلقائيًا جودة الكود والمشكلات الأمنية واقتراحات التحسين
مناقشة البنية
صِف شفهيًا احتياجات بنية النظام، ويولّد الذكاء الاصطناعي مقترحات التصميم وكود التنفيذ
المساعدة في تصحيح الأخطاء
صِف أعراض الخطأ صوتيًا، ويحدد الذكاء الاصطناعي السبب الجذري ويقدم حلولًا للإصلاح
كتابة الوثائق
أملِ محتوى الوثائق، ويولّد الذكاء الاصطناعي تلقائيًا وثائق تقنية وتعليقات منسقة
أفضل الممارسات
عندما يكون النسخ غير دقيق، أو لا يستجيب المفتاح، أو يتوقف التسجيل مبكرًا، تدرج الوثائق الرسمية الأسباب المعتادة.
يجب أن يكون الميكروفون محليًا
يحتاج الإملاء الصوتي إلى ميكروفون محلي، لذا لا يعمل في الجلسات السحابية أو جلسات SSH. يدعم امتداد Claude Code لـVS Code الإملاء أيضًا، لكن ليس في الجلسات البعيدة مثل SSH أو Dev Containers أو Codespaces.
تختلف مكونات التسجيل الخلفية حسب المنصة
يستخدم التسجيل وحدة أصلية مضمّنة على macOS وLinux وWindows. على Linux، عندما يتعذر تحميل الوحدة الأصلية، يعود Claude Code إلى arecord من ALSA utils أو rec من SoX، ويطبع /voice أمر تثبيت إذا لم يتوفر أي منهما.
يحتاج WSL إلى الواجهة الخلفية PulseAudio
يوجّه WSLg الصوت عبر PulseAudio بدلًا من جهاز ALSA، لذا يحتاج SoX إلى تثبيت الواجهة الخلفية PulseAudio الخاصة به صراحةً: الحزمتان sox وlibsox-fmt-pulse. تثبيت sox وحده يجلب الواجهة الخلفية ALSA، ولا يحتوي WSL على جهاز /dev/snd، لذا لا يعمل التسجيل هناك.
قد تعطّل سياسة المؤسسة الإملاء
يمكن لسياسة المسؤول في مؤسستك إيقاف الإملاء الصوتي. إذا أفاد /voice بأن سياسة ما تحظره، فتواصل مع مسؤول مؤسستك للتأكد مما إذا كان الإملاء الصوتي متاحًا لمؤسستك.
الإلغاء والإيقاف التلقائي
اضغط Esc أو Ctrl+C لإلغاء الإملاء: يُهمل النص المنسوخ ويعود prompt إلى ما كان يحتويه قبل ذلك. يتوقف التسجيل أيضًا تلقائيًا بعد 15 ثانية من الصمت أو 2 دقيقة إجمالًا.
جودة التعرف والإرسال التلقائي
ضُبط النسخ ليتناسب مع مفردات البرمجة، ويُضاف اسم مشروعك الحالي واسم فرع git تلقائيًا كتلميحات للتعرف. لا يُرسل النص المنسوخ تلقائيًا إلا عند 3 كلمات أو أكثر؛ واللغات التي تُكتب من دون مسافات، مثل اليابانية والصينية والتايلاندية، تُحتسب كلمات مفردة. يسجّل CHANGELOG الرسمي إصلاح سلوك الإرسال التلقائي هذا.
الوثائق
جرّب البرمجة الصوتية
يحتاج الإملاء الصوتي إلى تسجيل الدخول إلى claude.ai، ولا يتاح باستخدام مفتاح API لطرف ثالث؛ لا يستهلك النسخ رسائل Claude أو tokens، وتُفوتر النماذج عن كل token، وتُدرج أسعار كل نموذج على /models.
آخر تحديث 2026-11-14