Deepseek ArtifactsDeepseek Artifacts
تخصيص لوحة المفاتيح · محدَّث للإصدار v2.1.288

اختصارات Claude Code: إعادة ربط المفاتيح ووضع Vim وأهم الاختصارات

كل الطرق لتغيير سلوك المفاتيح في Claude Code: تعديل keybindings.json، وتشغيل وضع vim عبر /vim أو /config، وحفظ اختصارات لوحة المفاتيح الافتراضية المهمة فعلًا.

الخلاصة السريعة

  • تقع الاختصارات في ~/.claude/keybindings.json — شغّل /keybindings لإنشاء الملف وفتحه. التعديلات تسري بمجرد الحفظ دون إعادة تشغيل.
  • تُجمَّع الارتباطات حسب السياق (Chat وAutocomplete وAgents وScroll…) وتربط مفتاحًا مثل "ctrl+e" بإجراء مثل chat:externalEditor. اسند القيمة null للمفتاح لفك ارتباطه.
  • وضع vim: شغّل /vim، أو /config ثم Editor mode ثم Space ثم Enter. مفتاح Escape يبدّل بين INSERT/NORMAL، وأصبح النمط البصري (v/V) متاحًا منذ v2.1.118.
  • بعض المفاتيح خارج المتناول: لا يمكن إعادة ربط Ctrl+C وCtrl+D وCtrl+M، وبادئة Ctrl+B في tmux تبتلع الاختصارات قبل أن يراها Claude Code أصلًا.

How to Enable Vim Editor in Claude Code CLI

القناة: ProgrammingKnowledge21:32

فتح

Claude Code v2.1.118 — Vim Visual Mode & Custom Themes

القناة: Claude Code Updates0:41

فتح

How to use Vim in Claude Code

القناة: HAMY LABS5:41

فتح

Claude Code release notes — v2.1.118 & v2.1.288

ملاحظات الإصدار: github.com/anthropics/claude-code

فتح

Keybindings — official documentation

الوثائق: code.claude.com/docs

فتح

تمت مطابقة وقائع هذه الصفحة مع وثائق الاختصارات الرسمية ومع مُدخلَي v2.1.118 وv2.1.288 في سجل التغييرات؛ ولقطات الشاشة مأخوذة من مقاطع الفيديو أعلاه. السلوك الموصوف يطابق Claude Code v2.1.288 (أكتوبر 2026).

لقطات الشاشة إطارات من مقاطع الفيديو المذكورة، تُستخدم مع ذكر المصدر ومع رابط يعيد في كل خطوة إلى الطابع الزمني الأصلي.

إعادة ربط المفاتيح وتشغيل وضع vim، خطوة بخطوة

أعد ربط المفاتيح في keybindings.json

  1. 1

    شغِّل Claude Code وتحقق من بيئتك

    نفّذ claude في الطرفية لبدء جلسة. تخصيص المفاتيح ووضع vim ميزتان في واجهة السطر الأمرية، فكل ما في هذه الصفحة يجري في الموجّه نفسه. في الإصدار v2.1.288 وما بعده تحصل أيضًا على أحدث اختصارات عرض الوكلاء: البحث بـ Ctrl+F والقفز بين المجموعات بـ Alt+↑/↓.

    Claude Code welcome screen in a Windows PowerShell terminal showing the session banner and an empty prompt before any keybindings are customized
    جلسة Claude Code جديدة، جاهزة للتخصيص.شاهد عند 0:17
  2. 2

    افتح keybindings.json عبر /keybindings

    اكتب /keybindings في الموجّه. إذا لم يكن ~/.claude/keybindings.json موجودًا بعد، أنشأه Claude Code ثم يفتحه في محررك. أي تغيير تحفظه يُكتشف تلقائيًا — لا حاجة لإعادة التشغيل.

    Claude Code slash command menu filtering the command list after a forward slash is typed into the input box
    تتضائل قائمة الأوامر مع الكتابة — و/keybindings أحد بنودها.شاهد عند 0:34
  3. 3

    اربط مفتاحًا بإجراء داخل سياق

    يحوي الملف مصفوفة bindings مجمّعة حسب السياق — Chat وAutocomplete وAgents وTask وScroll وغيرها. كل كتلة تربط مفتاحًا باسم إجراء: { "context": "Chat", "bindings": { "ctrl+e": "chat:externalEditor" } }. أضف الحقل $schema في أعلى الملف ليكمل محررك أسماء الإجراءات تلقائيًا.

  4. 4

    فك الارتباط بـ null وسلسِل التركيبات

    أسند null إلى مفتاح لإيقاف سلوك افتراضي — "ctrl+s": null يعطّل تخزين الإدخال المؤقت. تُكتب التركيبات (chords) بفواصل مسافات: "ctrl+x ctrl+k" تعني الضغط على Ctrl+X ثم Ctrl+K خلال ثلاث ثوانٍ. وبعض التركيبات محجوزة لا تُعاد ربطها: Ctrl+C وCtrl+D وCtrl+M وCtrl+[ وCtrl+I.

شغِّل وضع vim

  1. 5

    افتح لوحة الإعدادات عبر /config

    تفضّل مفتاح تبديل على تحرير JSON يدويًا؟ يفتح /config اللوحة الظاهرة في الفيديو، بتبويباتها Status وConfig وUsage وبحثٍ يرشّح القائمة أثناء الكتابة.

    Claude Code /config settings panel listing Auto-compact, Todo list, Editor mode and Theme options in the terminal
    تسرد لوحة /config كل إعداد، ومنها Editor mode.شاهد عند 0:40
  2. 6

    رشّح القائمة حتى Editor mode

    اكتب edit في صندوق البحث فتضيق القائمة إلى إعداد Editor mode. قيمته الافتراضية normal — نمط التحرير من نوع readline المألوف لمن جاء من bash أو اختصارات Emacs.

    Claude Code config search filtered to the Editor mode setting showing its default normal value
    يبدأ Editor mode بالقيمة normal، وSpace يبدّلها.شاهد عند 1:08
  3. 7

    اضغط Space للتبديل إلى vim

    مع تحديد سطر Editor mode، اضغط Space — تتحول القيمة من normal إلى vim. ويسطر سطر التلميح العقد كاملًا: Space للتغيير، وEnter للحفظ، و/ للبحث، وEsc للإلغاء.

    Claude Code Editor mode setting switched from normal to vim in the /config panel
    ضغطة Space واحدة تكفي لاختيار vim.شاهد عند 1:11
  4. 8

    احفظ وراقب -- INSERT --

    اضغط Enter للحفظ. يطبع Claude Code رسالة «Set editor mode to vim» ويكتسب شريط الحالة السفلي علامة -- INSERT -- الخاصة بـ vim. يبقى هذا الاختيار عبر الجلسات على الجهاز نفسه — يُحفظ كقيمة editorMode داخل ~/.claude.json، وهو ملف تشغيلي لا ينبغي ربطه الرمزي بملفات dotfiles لديك لأنه يحمل أيضًا ذاكرة OAuth المؤقتة وحالة الجلسات.

    Claude Code confirming Set editor mode to vim with the vim INSERT mode indicator in the footer
    تم الحفظ — يعرض الشريط السفلي الآن مؤشر -- INSERT -- الخاص بـ vim.شاهد عند 1:28
  5. 9

    اكتب في insert mode، وقُد في normal mode

    يعمل insert mode ككتابة عادية. يبدّل Escape إلى normal mode: حروف h وj وk وl تحرك المؤشر، وb وw يقفزان بين الكلمات، وd يحذف، وc يغيّر، وr يستبدل. وإعادة تشغيل /vim تُطفئ النمط كله. مفاتيح vim ذاتها لا تُعاد ربطها عبر keybindings.json — فالإعداد vimInsertModeRemaps هو خصيصًا لتسلسلات INSERT مثل jj.

  6. 10

    حدّد النص بالنمط البصري (v2.1.118+)

    تذكر دروس قديمة أن النمط البصري غير موجود — لكن ذلك تجاوزه الزمن. أضاف الإصدار v2.1.118 النمط البصري (v) ونمط الأسطر البصري (V) مع التحديد والعوامل والتغذية البصرية: اضغط v مع حركة لتحديد المحارف، وV مع حركة لتحديد أسطر كاملة، ثم طبّق d أو y أو c على التحديد.

    Claude Code v2.1.118 release note card listing the vim visual mode commands v plus motion and V plus motion
    أتى الإصدار v2.1.118 بالتحديد عبر v وV إلى وضع vim في Claude Code.شاهد عند 0:16

الاختصارات الافتراضية التي تستحق الحفظ

  1. 11

    احفظ الاختصارات الافتراضية الأهم

    Shift+Tab يتنقل بين أنماط الأذونات، وEnter يرسل، وCtrl+J يضيف سطرًا جديدًا، وCtrl+L يمسح الإدخال، وCtrl+R يبحث في السجل، وCtrl+O يبدّل عرض المحضر، وCtrl+T يعرض المهام، وCtrl+B يرسل مهمة إلى الخلفية، وCtrl+X Ctrl+K ينهي الوكلاء. وفي عرض الوكلاء (v2.1.288+) يجد Ctrl+F جلسة بالاسم وتقفز Alt+↑/↓ بين المجموعات — وكلها قابلة لإعادة الربط في keybindings.json.

keybindings.json مقابل /config و/vim: أيٌّ يغيّر ماذا

ثلاث طبقات تتحكم فيما تفعله مفاتيحك في Claude Code. وهي تتكامل ولا تتنافس — اختر الطبقة الموافقة للتغيير الذي تريده.

  • 1keybindings.json يعيد ربط إجراءات بعينها. انقل chat:externalEditor إلى ctrl+e، وافك ارتباط chat:stash، وأضف تركيبة ctrl+x. دقيق، وقابل للنقل، وآمن لإدراجه في نظام التحكم بالإصدارات.
  • 2/config ثم Editor mode يبدّلان نموذج التحرير كله بين normal (readline) وvim. مفتاح واحد، يُحفظ فورًا، ويسري على كل جلسات ذلك الجهاز القادمة.
  • 3/vim يفعل الأمر نفسه تمامًا الذي يفعله مفتاح Editor mode — إنه أقصر طريق، وهو الأمر الذي يعتمده شرح HAMY LABS. أعد تشغيله للعودة إلى normal.
  • 4تلتقط طرفيتك بعض المفاتيح قبل أن يراها Claude Code أبدًا: بادئة Ctrl+B في tmux، وCtrl+A في GNU screen، وCtrl+Z الذي يعلّق العملية. حِلّ تلك على مستوى الطرفية لا في keybindings.json.
  • 5داخل وضع vim، يكون vimInsertModeRemaps هو السبيل الوحيد لإعادة ربط سلوك vim مثل jj إلى escape — إذ لا يلمس keybindings.json عمدًا المفاتيح الداخلية لـ vim.

قاعدة عامة: اختصار واحد مزعج → keybindings.json؛ أسلوب تحرير مختلف كليًا → وضع vim؛ مفتاح لا يصل أصلًا → افحص الطرفية أولًا.

اختصار لا يعمل؟ أصلحه بهذا الترتيب

معظم شكاوى الاختصارات تعود إلى خمسة أسباب. سرّح القائمة قبل أن تعدّل الملف من جديد.

  • 1لا يتغير شيء بعد التعديل: تأكد أن الملف هو ~/.claude/keybindings.json (ليس settings.json) وأن JSON يُحلَّل سليمًا. شغّل Claude Code مع --debug لإظهار تحذيرات الربط كأسماء إجراءات مكتوبة خطأ أو سياقات مجهولة.
  • 2مفتاح يرفض إعادة الربط: المحجوزات هي Ctrl+C وCtrl+D وCtrl+M (Enter دائمًا) وCtrl+[ (Escape دائمًا) وCtrl+I (Tab دائمًا). أما المحارف المطبوعة في حقول النص فتتجه إلى الإدخال لا إلى الارتباطات.
  • 3لا يصل Ctrl+B ولا Ctrl+A: يستهلكهما tmux وGNU screen بادئتَين لهما. أعد ربط الاختصار في keybindings.json أو غيّر بادئة المُضاعِف.
  • 4إعادة استخدام بادئة تركيبة تفشل: إذا كانت ctrl+x تبدأ عدة تركيبات، فيجب فك كل تركيبات ctrl+x قبل أن يعمل ctrl+x وحده كمفتاح عادي.
  • 5مفاتيح vim تتجاهل ارتباطاتك: ذلك بقصد — وضع vim يدير مفاتيحه بنفسه. استخدم vimInsertModeRemaps لتسلسلات insert، وحدّث Claude Code إذا كان التحديد بـ v أو V لا يفعل شيئًا (يتطلب v2.1.118 وما بعده).

لاستعادة أي قيمة افتراضية، احذف سطرها من keybindings.json — الحذف هو ما يعيد الارتباط الأصلي، لا كتابة قيمة «default».

أسئلة شائعة عن اختصارات Claude Code

المزيد من أدلة Claude Code