📘 תיעוד 117

התאמה אישית של קיצורי מקשים

התאמה אישית של קיצורי מקשים ב-Claude Code באמצעות קובץ הגדרות של קיצורי מקשים.

Claude Code תומך בקיצורי מקשים הניתנים להתאמה אישית. הרץ את /keybindings כדי ליצור או לפתוח את קובץ ההגדרות שלך בנתיב ~/.claude/keybindings.json.

#קובץ הגדרות

קובץ הגדרות קיצורי המקשים הוא אובייקט עם מערך bindings. כל בלוק מציין הקשר (context) ומפה של לחיצות מקשים לפעולות.

הערה: שינויים בקובץ קיצורי המקשים מזוהים ומיושמים באופן אוטומטי ללא הפעלה מחדש של Claude Code.

דוגמה זו מקשרת את Ctrl+E לפתיחת עורך חיצוני בהקשר הצ'אט, ומבטלת את הקישור של Ctrl+U:

{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "$docs": "https://code.claude.com/docs/en/keybindings",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+u": null
      }
    }
  ]
}

#הקשרים

כל בלוק קיצורים מציין הקשר (context) שבו הקיצורים חלים:

לפני גרסה v2.1.205, התקיימו הקשר Doctor ופעולה doctor:fix עבור מסך האבחון /doctor.

#פעולות זמינות

פעולות עוקבות אחר מבנה של namespace:action, כגון chat:submit לשליחת הודעה או app:toggleTodos להצגת רשימת המשימות. לכל הקשר יש פעולות ספציפיות הזמינות בו.

#פעולות יישום

פעולות הזמינות בהקשר Global:

#פעולות היסטוריה

פעולות לניווט בהיסטוריית הפקודות:

#פעולות צ'אט

פעולות הזמינות בהקשר Chat:

* ב-Windows ללא מצב VT (גרסאות Node מתחת ל-24.2.0 או מתחת ל-22.17.0, גרסאות Bun מתחת ל-1.2.23), ברירת המחדל היא Meta+M.

#פעולות השלמה אוטומטית

פעולות הזמינות בהקשר Autocomplete:

#פעולות אישור

פעולות הזמינות בהקשר Confirmation:

* ב-Windows ללא מצב VT (גרסאות Node מתחת ל-24.2.0 או מתחת ל-22.17.0, גרסאות Bun מתחת ל-1.2.23), ברירת המחדל היא Meta+M.

לפני גרסה v2.1.257, פעולה בשם confirm:toggleExplanation, שהייתה מקושרת כברירת מחדל ל-Ctrl+E, הציגה הסבר שנוצר על ידי המודל עבור הפקודה בבקשות אישור של Bash ו-PowerShell.

#פעולות הרשאה

פעולות הזמינות בהקשר Confirmation עבור תיבות דו שיח של הרשאות:

#פעולות תמליל

פעולות הזמינות בהקשר Transcript:

הפעולה transcript:toggleShowAll חלה במרנדר הקלאסי בלבד. ברינדור במסך מלא, מציג התמליל אינו מציע מתג להצגת כל התוכן.

#פעולות חיפוש בהיסטוריה

פעולות הזמינות בהקשר HistorySearch:

ברירות המחדל של historySearch:next, historySearch:accept, historySearch:cancel ו-historySearch:execute חלות על חיפוש היסטוריה מוטמע במרנדר הקלאסי, אשר תמיד מחפש בקשות מכל הפרויקטים. הפעולה historySearch:cycleScope נכנסת לתוקף רק ברינדור במסך מלא, שבו Ctrl+R פותח במקום זאת תיבת דו שיח לחיפוש ו-Ctrl+S מחליף את הטווח שלה במחזוריות. שאר המקשים של תיבת הדו שיח קבועים ולא ניתן לקשר אותם מחדש: Enter או Tab מציבים את ההתאמה המודגשת בקלט הבקשה, ו-Esc מבטל.

#פעולות משימה

פעולות הזמינות בהקשר Task:

#פעולות ערכת נושא

פעולות הזמינות בהקשר ThemePicker:

#פעולות עזרה

פעולות הזמינות בהקשר Help:

#פעולות לשוניות

פעולות הזמינות בהקשר Tabs:

#פעולות קבצים מצורפים

פעולות הזמינות בהקשר Attachments:

#פעולות כותרת תחתונה

פעולות הזמינות בהקשר Footer:

#פעולות בורר הודעות

פעולות הזמינות בהקשר MessageSelector:

#פעולות Diff

פעולות הזמינות בהקשר DiffDialog:

תצוגת פירוט ה-diff מקשרת גם מקשים בסגנון דפדוף לפעולות הגלילה הסטנדרטיות. קישורים אלה הם חלק מהקשר DiffDialog וחלים רק בתצוגת הפירוט. ברירות המחדל של הקשר Scroll המפורטות תחת פעולות גלילה נותרות ללא שינוי.

#פעולות לוח Diff

פעולות עבור לוח ה-diff שהפקודה /diff פותחת ברינדור במסך מלא. הפעולה app:cycleDiffBase נמצאת בהקשר DiffPanel, אשר פעיל בזמן שהלוח פתוח. האחרות הן בהקשר Global. הלוח דורש גרסה v2.1.260 ומעלה של Claude Code.

#פעולות בורר מודלים

פעולות הזמינות בהקשר ModelPicker:

#פעולות Select

פעולות הזמינות בהקשר Select:

Claude Code מחיל את קישורי select:pageUp, select:pageDown, select:first ו-select:last שלך בתפריט /skills. ברוב הרשימות האחרות, כגון בורר /model, Claude Code מדפדף באמצעות PageUp ו-PageDown ללא קשר לקישורים שהגדרת ומתעלם מ-Home ומ-End.

#פעולות תוספים

פעולות הזמינות בהקשר Plugin:

#פעולות הגדרות

פעולות הזמינות בהקשר Settings. נעשה שימוש חוזר בפעולות select:accept ו-confirm:no מהקשרי Select ו-Confirmation עם התנהגות ייעודית להגדרות: שינויים חלים על כל הגדרה מיד עם שינויה, כך ש-Escape סוגר את החלונית כאשר השינויים שלך שמורים במקום לדחות אותם.

#פעולות קול

פעולות הזמינות בהקשר Chat כאשר הכתבה קולית מופעלת:

#פעולות גלילה

פעולות הזמינות בהקשר Scroll כאשר רינדור במסך מלא מופעל:

#תחביר לחיצות מקשים

#מקשי שינוי

השתמש במקשי שינוי עם המפריד +:

• ctrl או control: מקש Control
• shift: מקש Shift
• alt, opt, option או meta: מקש Alt ב-Windows וב-Linux, מקש Option ב-macOS
• cmd, command, super או win: מקש Command ב-macOS, מקש Windows ב-Windows, מקש Super ב-Linux

קבוצת cmd מזוהה רק בטרמינלים שמדווחים על מקש השינוי Super, כגון אלה התומכים בפרוטוקול המקלדת של Kitty או במצב modifyOtherKeys של xterm. רוב הטרמינלים אינם שולחים אותו, לכן השתמש ב-ctrl או ב-meta עבור קיצורים שתרצה שיפעלו בכל מקום.

לדוגמה:

ctrl+k          Ctrl + K
shift+tab       Shift + Tab
meta+p          Option + P on macOS, Alt + P elsewhere
ctrl+shift+c    Multiple modifiers

#אותיות גדולות

Claude Code מנתח שמות מקשים ללא תלות באותיות גדולות או קטנות, כך ש-K הוא אותו קישור כמו k, ו-ctrl+K זהה ל-ctrl+k. כדי לקשר את Shift ואות, כתוב shift+k.

#פריסות מקלדת שאינן בפריסת ארה"ב

כתוב את שמות המקשים של קיצורי Ctrl כתווים לטיניים גם כאשר פריסת המקלדת הפעילה שלך מקלידה תווים אחרים.

האופן שבו Claude Code מתאים את המקש שאתה לוחץ עליו לקיצור תלוי בסוג הפריסה:

• בפריסה שאינה לטינית כגון קירילית, Claude Code מתאים קיצורי Ctrl לפי מיקום המקש בפריסת ארה"ב כאשר הטרמינל משתמש בפרוטוקול המקלדת של Kitty ומדווח על מיקום זה. בטרמינל כזה, כאשר פריסה רוסית פעילה, לחיצה על Ctrl ועל מקש W הפיזי מפעילה את ctrl+w. בטרמינל שאינו מדווח על המיקום, Claude Code מתאים את כל מה שהטרמינל שולח עבור הלחיצה: קוד בקרה של ASCII מפעיל את הקיצור הלטיני, ולחיצת מקש שמגיעה בתור התו הקירילי אינה מתאימה לשום קיצור.
• בפריסות שמסדרות מחדש אותיות לטיניות, כגון AZERTY, Claude Code מתאים את האות שהמקש מקליד, כך שלחיצה על Ctrl ועל המקש המסומן ב-A מפעילה את ctrl+a.

לפני גרסה v2.1.247, לחיצה על קיצור Ctrl תחת פריסה שאינה לטינית לא הפעילה את הקישור שלו בטרמינלים שמשתמשים בפרוטוקול המקלדת של Kitty, כגון Ghostty, Kitty, WezTerm ו-iTerm2.

#צירופי מקשים

צירופי מקשים הם רצפים של לחיצות מקשים המופרדים ברווחים:

ctrl+k ctrl+s   Press Ctrl+K, release, then Ctrl+S

#מקשים מיוחדים

• escape או esc: מקש Escape
• enter או return: מקש Enter
• tab: מקש Tab
• space: מקש רווח
• up, down, left, right: מקשי חצים
• pageup, pagedown: מקשי Page Up ו-Page Down
• home, end: מקשי Home ו-End
• backspace, delete: מקשי Delete
• wheelup, wheeldown: אירועי גלילה של גלגלת העכבר

#ביטול קישור של קיצורי ברירת מחדל

הגדר פעולה ל-null כדי לבטל קישור של קיצור ברירת מחדל:

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+s": null
      }
    }
  ]
}

זה עובד גם עבור קישורי רצף מקשים. ביטול הקישור של כל רצף שחולק קידומת משחרר את אותה קידומת לשימוש כקיצור של מקש יחיד. רצף מקשים בכל הקשר פעיל שומר את הקידומת שלו תפוסה, לכן עליך לבטל את הקישור של כל רצף בהקשר שמגדיר אותו.

Claude Code מקשר את רצפי ברירת המחדל הבאים בקידומת ctrl+x: ctrl+x ctrl+k, ctrl+x ctrl+e ו-ctrl+x enter בהקשר Chat, ctrl+x ctrl+b בהקשר Task, ו-ctrl+x b בהקשר DiffPanel. הרצף ctrl+x enter דורש גרסה v2.1.247 ומעלה, ו-ctrl+x b דורש גרסה v2.1.260 ומעלה. כדי להחזיר את ctrl+x עצמו כקישור של מקש יחיד, בטל את הקישור של כולם:

{
  "bindings": [
    {
      "context": "Task",
      "bindings": {
        "ctrl+x ctrl+b": null
      }
    },
    {
      "context": "DiffPanel",
      "bindings": {
        "ctrl+x b": null
      }
    },
    {
      "context": "Chat",
      "bindings": {
        "ctrl+x ctrl+k": null,
        "ctrl+x ctrl+e": null,
        "ctrl+x enter": null,
        "ctrl+x": "chat:newline"
      }
    }
  ]
}

אם תבטל את הקישור של חלק מהרצפים על קידומת מסוימת אך לא של כולם, לחיצה על הקידומת עדיין תיכנס למצב המתנה לרצף עבור הקישורים הנותרים.

#קיצורים שמורים

לא ניתן לקשר מחדש את הקיצורים הבאים:

#התנגשויות טרמינל

חלק מהקיצורים עלולים להתנגש עם מרבבי טרמינל:

#אינטראקציה עם מצב Vim

כאשר מצב vim מופעל דרך /config אל Editor mode, קיצורי המקשים ומצב vim פועלים באופן עצמאי:

• מצב Vim מטפל בקלט ברמת קלט הטקסט (תנועת סמן, מצבים, תנועות)
• קיצורי מקשים מטפלים בפעולות ברמת הרכיב (החלפת מצב רשימת משימות, שליחה וכדומה)
• מקש Escape במצב vim מעביר ממצב INSERT למצב NORMAL, הוא אינו מפעיל את chat:cancel
• רוב קיצורי Ctrl+key מועברים דרך מצב vim אל מערכת קיצורי המקשים
• לא ניתן למפות מחדש מקשי vim דרך קובץ קיצורי המקשים. כדי למפות רצף של שני מקשים במצב INSERT כגון jj אל Escape, השתמש בהגדרה vimInsertModeRemaps
• במצב NORMAL של vim, המקש ? מציג את תפריט העזרה (התנהגות vim)
• במצב NORMAL של vim, המקש / פותח חיפוש בהיסטוריה, בדיוק כמו Ctrl+R במצב רגיל

#אימות

Claude Code מאמת את קיצורי המקשים שלך ומציג אזהרות עבור:

• שגיאות פענוח (JSON או מבנה לא תקינים)
• שמות הקשר לא חוקיים
• ערכי פעולה לא חוקיים, כגון פעולה שאינה מחרוזת או null
• שמות פעולה לא ידועים, כגון שגיאת הקלדה של פעולה רשומה. Claude Code מדלג על הקישור ומשאיר בתוקף כל קישור ברירת מחדל עבור מקש זה. לפני גרסה v2.1.246, קישור עם שם פעולה לא ידוע השבית מקש זה בשקט
• התנגשויות עם קיצורים שמורים
• קישורים כפולים באותו הקשר

Claude Code מדווח על אזהרות כאשר הקובץ נטען וכותב כל אחת מהן ליומן ניפוי השגיאות. הפעל את Claude Code עם --debug כדי לראות את הפרטים.