📘 תיעוד 112

הגדרת המסוף עבור Claude Code

תיקון Shift+Enter לשורות חדשות, קבלת צלצול מסוף כש-Claude מסיים, הגדרת tmux, התאמת ערכת הצבעים והפעלת מצב Vim ב-CLI של Claude Code.

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

• Shift+Enter שולח במקום להוסיף שורה חדשה
• קיצורי מקש Option אינם עושים דבר ב-macOS
• אין צליל או התראה כש-Claude מסיים
• הפעלת Claude Code בתוך tmux
• Backspace מוחק מילה שלמה ב-Windows
• התצוגה מהבהבת או שהגלילה קופצת
• רצון במקשי Vim בתיבת ההנחיה

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

#הזנת הנחיות מרובות שורות

לחיצה על Enter שולחת את ההודעה שלך. כדי להוסיף מעבר שורה בלי לשלוח, לחץ על Ctrl+J, או הקלד \ ולאחר מכן לחץ על Enter. שתי האפשרויות פועלות בכל מסוף ללא כל הגדרה.

ברוב המסופים ניתן גם ללחוץ על Shift+Enter, אך התמיכה משתנה לפי מדמה המסוף:

עבור VS Code, Cursor, Devin Desktop, Alacritty ו-Zed, הפקודה /terminal-setup כותבת מיפוי מקשים של Shift+Enter אל קובץ ההגדרות של המסוף. בהרצה הראשונה מופיע אישור כגון Installed VSCode terminal Shift+Enter key binding. מיפויים קיימים נשארים במקומם; אם מופיעה הודעה כגון VSCode terminal Shift+Enter key binding already configured, לא בוצע שינוי. הרץ את /terminal-setup ישירות במסוף המארח ולא מתוך tmux או screen, מכיוון שעליה לכתוב להגדרות של המסוף המארח.

ב-VS Code, ב-Cursor וב-Devin Desktop, הפקודה /terminal-setup מעדכנת גם שתי הגדרות עורך: היא מגדירה את terminal.integrated.gpuAcceleration ל-"off" כדי למנוע טקסט משובש במסוף המשולב, והיא מגדירה את terminal.integrated.mouseWheelScrollSensitivity לגלילה חלקה יותר במצב מסך מלא. כדי לבטל את שינוי האצת ה-GPU, החזר את ההגדרה ל-"auto" וטען מחדש את חלון העורך. לפני גרסה v2.1.157, הפקודה /terminal-setup השאירה את האצת ה-GPU ללא שינוי.

ב-Zed, הפקודה /terminal-setup מעדכנת את קובץ keymap.json שלך ישירות:

• אם מפת המקשים כבר כוללת מיפויים ואף אחד מהם אינו shift-enter של המסוף (Terminal), Claude Code מגבה תחילה את הקובץ לעותק באותה תיקייה, כגון keymap.json.1a2b3c4d.bak, ולאחר מכן ממזג את מיפוי Shift+Enter לתוך מפת המקשים שלך, תוך שמירה על יתר המיפויים וההערות שלך.
• אם Claude Code אינו מצליח לקרוא או לנתח את מפת המקשים, אינו מצליח לגבות אותה, או אינו מצליח לאמת את תוצאת המיזוג, הוא משאיר את הקובץ ללא שינוי ומדפיס את בלוק מיפוי המקשים כדי שתוסיף אותו בעצמך.

אם אתה מריץ בתוך tmux, מקש Shift+Enter דורש גם את הגדרת tmux למטה, גם כאשר המסוף החיצוני תומך בכך.

כדי לקשור שורה חדשה למקש אחר, או להחליף את ההתנהגות כך ש-Enter יוסיף שורה חדשה ו-Shift+Enter ישלח, מפה את הפעולות chat:newline ו-chat:submit בקובץ מיפויי המקשים שלך.

#הפעלת קיצורי מקש Option ב-macOS

חלק מקיצורי הדרך של Claude Code משתמשים במקש Option, כגון Option+Enter לשורה חדשה או Option+P להחלפת מודלים. ב-macOS, רוב המסופים אינם שולחים את Option כמקש שינוי (modifier) כברירת מחדל, ולכן קיצורים אלה אינם עושים דבר עד שתפעיל זאת. ההגדרה במסוף עבור פעולה זו מסומנת בדרך כלל כ-"Use Option as Meta Key"; השם Meta הוא השם ההיסטורי ב-Unix עבור המקש שמסומן כיום כ-Option או Alt.

#Apple Terminal

פתח את Settings → Profiles → Keyboard וסמן את "Use Option as Meta Key".

אם אישרת את בקשת הגדרת המסוף בהפעלה הראשונה של Claude Code, הדבר כבר בוצע. בקשה זו מריצה את /terminal-setup עבורך, אשר מפעילה את Option כ-Meta ומכבה את הפעמון הקולי בפרופיל של Apple Terminal.

במצב קורא מסך, הפקודה /terminal-setup משאירה את הגדרת הפעמון ללא שינוי כדי שפעמון המסוף יישאר נשמע. לפני גרסה v2.1.211, הפקודה /terminal-setup כיבתה את הפעמון גם במצב קורא מסך. אם הרצה מוקדמת יותר כיבתה את הפעמון, הפעל אותו מחדש תחת Settings → Profiles → Advanced → "Audible bell".

#iTerm2

פתח את Settings → Profiles → Keys → General והגדר את Left Option key ואת Right Option key ל-"Esc+".

הרצת /terminal-setup ב-iTerm2 מפעילה את "Applications in terminal may access clipboard" תחת Settings → General → Selection כדי שהפקודה /copy תוכל לכתוב ללוח המערכת שלך. הפקודה מזהה את iTerm2 גם כאשר היא מורצת מתוך tmux. הפעל מחדש את iTerm2 כדי שהשינוי ייכנס לתוקף.

#VS Code

הוסף את "terminal.integrated.macOptionIsMeta": true להגדרות VS Code שלך.

עבור Ghostty, Kitty ומסופים אחרים, חפש הגדרה של Option-as-Alt או Option-as-Meta בקובץ ההגדרות של המסוף.

#קבלת צלצול מסוף או התראה

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

כברירת מחדל Claude Code שולח התראת שולחן עבודה רק ב-Ghostty, Kitty ו-iTerm2. במסופים אחרים, הגדר את preferredNotifChannel ל-"terminal_bell" כדי להשמיע צלצול מסוף במקום זאת, או הגדר Notification hook עבור צליל או פקודה מותאמים אישית. רשומת ההגדרות הבאה מפעילה את צלצול המסוף:

{
  "preferredNotifChannel": "terminal_bell"
}

התראת שולחן העבודה מגיעה למחשב המקומי שלך דרך SSH, כך שהפעלה מרוחקת עדיין יכולה להתריע בפניך. Ghostty ו-Kitty מעבירים אותה למרכז ההתראות של מערכת ההפעלה ללא הגדרה נוספת. ב-iTerm2 נדרש להפעיל העברה:

1. פתיחת הגדרות ההתראות ב-iTerm2: עבור אל Settings → Profiles → Terminal.
2. הפעלת התראות: סמן את "Notification Center Alerts", לחץ על "Filter Alerts" והפעל את "Send escape sequence-generated alerts".

אם התראות עדיין אינן מופיעות, ודא שליישום המסוף שלך יש הרשאת התראות בהגדרות מערכת ההפעלה, ואם אתה מריץ בתוך tmux, הפעל העברה (passthrough).

#השמעת צליל עם Notification hook

בכל מסוף ניתן להגדיר Notification hook כדי להשמיע צליל או להריץ פקודה מותאמת אישית כאשר Claude זקוק לתשומת לבך. מנגנוני ה-hooks רצים לצד ההתראה המובנית ולא מחליפים אותה, כך שמסופים שאינם מקבלים התראת שולחן עבודה, כגון Warp או המסוף המשולב של VS Code, יכולים להשתמש ב-hook או להגדיר את preferredNotifChannel ל-"terminal_bell" במקום זאת.

הדוגמה שלהלן משמיעה צליל מערכת ב-macOS. המדריך המקושר כולל פקודות התראת שולחן עבודה עבור macOS, Linux ו-Windows.

{
  "hooks": {
    "Notification": [
      {
        "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }]
      }
    ]
  }
}

#הגדרת tmux

כאשר Claude Code רץ בתוך tmux, שני דברים נשברים כברירת מחדל: Shift+Enter שולח במקום להוסיף שורה חדשה, והתראות שולחן העבודה וסרגל ההתקדמות לעולם אינם מגיעים למסוף החיצוני. הוסף את השורות האלה אל ~/.tmux.conf, ולאחר מכן הרץ את הפקודה tmux source-file ~/.tmux.conf כדי להחיל אותן על השרת הרץ:

set -g allow-passthrough on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'

שורת ה-allow-passthrough מאפשרת להתראות ולעדכוני התקדמות להגיע למסוף החיצוני במקום להיבלע על ידי tmux. שורות ה-extended-keys מאפשרות ל-tmux להבדיל בין Shift+Enter לבין Enter רגיל כדי שקיצור הדרך לשורה חדשה יעבוד.

#תיקון מחיקת מילה שלמה על ידי Backspace ב-Windows

ב-Windows, קלוד קוד קורא מקש Backspace שמגיע בתור ^H בתור Ctrl+Backspace, אשר מוחק את המילה הקודמת, למעט כאשר TERM_PROGRAM הוא mintty או ש-TERM הוא cygwin. ב-macOS וב-Linux, קלוד קוד קורא זאת בתור Backspace רגיל.

אם כל לחיצה על Backspace מוחקת מילה שלמה, המסוף שלך שולח ^H עבור Backspace רגיל. הגדר את CLAUDE_CODE_BS_AS_CTRL_BACKSPACE=0. במצב זה Backspace ו-Ctrl+H מוחקים תו אחד כל אחד. אם Ctrl+Backspace מוחק רק תו אחד ב-macOS או ב-Linux מכיוון שהמסוף שלך שולח עבורו ^H, הגדר את המשתנה ל-1 במקום זאת.

#התאמת ערכת הצבעים

השתמש בפקודה /theme, או בבורר ערכות הנושא ב-/config, כדי לבחור ערכת נושא של Claude Code שתואמת למסוף שלך. בחירה באפשרות auto מזהה את הרקע הבהיר או הכהה של המסוף שלך, וכך ערכת הנושא עוקבת אחר שינויי מראה מערכת ההפעלה בכל פעם שהמסוף עושה זאת. Claude Code אינו שולט בערכת הצבעים של המסוף עצמו, אשר נקבעת על ידי יישום המסוף.

כדי להתאים אישית את מה שמופיע בתחתית הממשק, הגדר שורת מצב מותאמת אישית שמציגה את המודל הנוכחי, תיקיית העבודה, ענף ה-git, או הקשר אחר.

#יצירת ערכת נושא מותאמת אישית

בנוסף להגדרות המובנות מראש, /theme מציג את כל ערכות הנושא המותאמות אישית שהגדרת וכל ערכת נושא שנתרמה על ידי תוספים מותקנים. בחר ב-New custom theme… בסוף הרשימה כדי ליצור ערכה באופן אינטראקטיבי: אתה נותן שם לערכת הנושא, ולאחר מכן בוחר אסימוני צבע (color tokens) בודדים לדריסה. לחץ על Ctrl+E כאשר ערכת נושא מותאמת אישית מודגשת כדי לערוך אותה.

כל ערכת נושא מותאמת אישית היא קובץ JSON בתוך ~/.claude/themes/. שם הקובץ ללא סיומת .json הוא ה-slug של ערכת הנושא, ובחירה בערכת הנושא שומרת את custom:<slug> כהעדפת ערכת הנושא שלך. לקובץ יש שלושה שדות אופציונליים:

ערכי צבע מקבלים #rrggbb, #rgb, rgb(r,g,b), ansi256(n), או ansi:<name> כאשר <name> הוא אחד מ-16 שמות צבעי ANSI התקניים כגון red או cyanBright. אסימונים לא מוכרים וערכי צבע לא חוקיים זוכים להתעלמות, כך ששגיאת הקלדה אינה יכולה לשבור את התצוגה.

הדוגמה הבאה מגדירה ערכת נושא ששומרת על הגדרת הבסיס dark אך משנה את צבע הדגשת ההנחיה, טקסט שגיאה וטקסט הצלחה:

{
  "name": "Dracula",
  "base": "dark",
  "overrides": {
    "claude": "#bd93f9",
    "error": "#ff5555",
    "success": "#50fa7b"
  }
}

Claude Code עוקב אחר ~/.claude/themes/ וטוען מחדש כאשר קובץ מתווסף או משתנה, כך שעריכות שבוצעו בעורך שלך חלות על הפעלה רצה ללא הפעלה מחדש. אם התיקייה ~/.claude/themes/ עצמה לא הייתה קיימת כאשר Claude Code הופעל, הפעל מחדש פעם אחת לאחר יצירת קובץ ערכת הנושא הראשון שלך. לאחר מכן, שינויים יחולו ללא הפעלה מחדש.

המדריך שלהלן מכסה את האסימונים שניתן להגדיר ב-overrides. העורך האינטראקטיבי ב-/theme מציג את אותם אסימונים עם תצוגה מקדימה חיה, בתוספת כמה הדגשות ייעודיות כגון צבעי מסך הקליטה (onboarding) שהושמטו כאן.

הדוגמה הבאה משלבת אסימונים מכמה מהקבוצות שלהלן: הדגשת המותג, גבול מצב תוכנית, רקעי הבדלים (diff), ורקע ההודעה.

{
  "name": "Midnight",
  "base": "dark",
  "overrides": {
    "claude": "#a78bfa",
    "planMode": "#38bdf8",
    "diffAdded": "#14532d",
    "diffRemoved": "#7f1d1d",
    "userMessageBackground": "#1e1b4b"
  }
}

#צבעי טקסט והדגשה

שליטה בהדגשת המותג הראשית ובגווני טקסט החזית המשמשים ברחבי הממשק.

#צבעי סטטוס

איתות על מצבי הצלחה, כישלון ואזהרה בהודעות ובמחוונים.

#תיבת קלט ומחווני מצב

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

#רינדור הבדלים (Diff)

צביעת קוד שנוסף והוסר בעריכות קבצים ובבדיקות.

#מצב מסך מלא

Claude Code צובע את userMessageBackground, את bashMessageBackgroundColor ואת memoryBackgroundColor הן במרנדר ברירת המחדל והן במרנדר מסך מלא. הוא משתמש ב-userMessageBackgroundHover וב-selectionBg רק במצב רינדור מסך מלא.

#מד שימוש ותוויות דוברים

התאמת הפס המוצג בתצוגת /usage והתוויות המבדילות בין ההודעות שלך להודעות של Claude.

#גרסאות נצנוץ (Shimmer) וצבעי סוכני משנה

לכמה אסימונים יש גרסת נצנוץ (shimmer) מותאמת שמספקת את הצבע הבהיר יותר המשמש במדרג הצבעים המונפש של הספינר. דרוס את ה-shimmer לצד אסימון הבסיס שלו אם ההנפשה נראית לא מתואמת:

• claude ו-claudeShimmer
• warning ו-warningShimmer
• permission ו-permissionShimmer
• promptBorder ו-promptBorderShimmer
• inactive ו-inactiveShimmer
• fastMode ו-fastModeShimmer

כל סוכן משנה ומשימה מקבילית מוצגים באחד משמונה צבעים בעלי שמות כדי שתוכל להבדיל ביניהם בתמליל. שמות האסימונים עוקבים אחר התבנית <color>_FOR_SUBAGENTS_ONLY, כאשר <color> הוא red, blue, green, yellow, purple, orange, pink או cyan. דרוס אותם כדי לשנות את המראה של כל צבע בעל שם. לדוגמה, סוכן משנה עם color: blue בהגדרה שלו מצויר באמצעות הערך של blue_FOR_SUBAGENTS_ONLY.

Claude Code מרנדר את מילת המפתח ultrathink בקלט ההנחיה עם מדרג צבעי קשת בעל שבעה צבעים. שמות האסימונים עוקבים אחר התבנית rainbow_<color> ו-rainbow_<color>_shimmer, כאשר <color> הוא red, orange, yellow, green, blue, indigo או violet.

#מעבר לרינדור מסך מלא

במצב קורא מסך, סעיף זה אינו חל. Claude Code תמיד מרנדר כטקסט גלילה רגיל למעט בהפעלות רקע מחוברות, ואם תריץ /tui fullscreen בכל הפעלה אחרת, Claude Code ידפיס הסבר במקום לעבור.

אם התצוגה מהבהבת או שמיקום הגלילה קופץ בזמן ש-Claude עובד, עבור למצב רינדור מסך מלא. במצב זה אתה גולל באמצעות העכבר או מקש PageUp בתוך Claude Code ולא באמצעות גלילת המסוף המקורית; ראה את דף המסך המלא למידע על חיפוש והעתקה.

אם הבהוב הוא הבעיה היחידה והמסוף שלך תומך בפלט מסונכרן אך אינו מזוהה אוטומטית, כגון eat של Emacs, הגדר את CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 כדי לעצור את ההבהוב בלי להחליף מרנדר.

הרץ את /tui fullscreen כדי לעבור ולשמור את ההעדפה. השיחה שלך תופעל מחדש בשלמותה והפעלות עתידיות יתחילו במסך מלא אלא אם הפעלת מסך מלא תיכשל. ניתן גם להגדיר את משתנה הסביבה CLAUDE_CODE_NO_FLICKER לפני הפעלת Claude Code:

עבור Bash ו-Zsh:

CLAUDE_CODE_NO_FLICKER=1 claude

עבור PowerShell:

$env:CLAUDE_CODE_NO_FLICKER = "1"; claude

בקובץ ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_NO_FLICKER": "1"
  }
}

#הדבקת תוכן גדול

כאשר אתה מדביק יותר מ-800 תווים או יותר משלוש שורות לתוך ההנחיה, Claude Code מכווץ את הקלט למציין מיקום כגון [Pasted text #1 +120 lines] כדי שתיבת הקלט תישאר שמישה. בחלון מסוף הנמוך מ-12 שורות מגבלת השורות יורדת, כך ש-Claude Code מכווץ הדבקה של שלוש שורות ב-11 שורות וכל הדבקה מרובת שורות ב-10 שורות ומטה. Claude Code עדיין שולח את התוכן המלא בעת השליחה.

כאשר אתה מוחק באמצעות קיצור דרך למילה או שורה כגון Ctrl+W או Ctrl+K, או באמצעות מחיקת vim דרך תנועת f/t כגון df], וטווח המחיקה מגיע לתוך מציין המיקום, Claude Code מסיר את מציין המיקום בשלמותו. באפשרותך להדביק את המחיקה בחזרה כדי לשחזר אותה, באמצעות Ctrl+Y לאחר קיצור דרך של מילה או שורה, או באמצעות p במצב NORMAL לאחר מחיקת vim.

Claude Code שומר את התוכן המכווץ תחת ~/.claude/paste-cache/, כך שכאשר אתה משחזר הנחיה מהיסטוריית הפקודות ושולח אותה שוב, Claude Code שולח שוב את התוכן המודבק המלא, כולל בהפעלה מאוחרת יותר, עד שסריקת השימור מסירה את קובץ המטמון.

Claude Code מוחק קובצי מטמון ישנים יותר מ-cleanupPeriodDays, בהתאם לכללי סריקת השימור, כך שהנחיה ששוחזרה עשויה להפנות לטקסט מודבק שכבר אינו קיים. בעת שליחת הנחיה כזו, Claude Code לעולם אינו שולח את המחרוזת המילולית [Pasted text #N], ומציג התראה המציינת את ההדבקה החסרה:

• בהנחיה רגילה שנותר בה טקסט, Claude Code מסיר את מציין המיקום ושולח את הטקסט שנותר.
• בפקודת מצב מעטפת או בפקודת /, שבהן ההסרה תשנה את מה שרץ, ובכל הנחיה שההסרה מותירה אותה ריקה, Claude Code מבטל את השליחה ומשאיר את הטקסט המקורי בקלט, כשמציין המיקום עדיין בתוכו. מחק את מציין המיקום או ערוך את הפקודה, ולאחר מכן שלח שוב.

המסוף המשולב של VS Code עלול להשמיט תווים מהדבקות גדולות מאוד לפני שהם מגיעים ל-Claude Code, לכן העדף שם תהליכי עבודה מבוססי קבצים. עבור קלטים גדולים מאוד כגון קבצים שלמים או קובצי יומן (logs) ארוכים, כתוב את התוכן לקובץ ובקש מ-Claude לקרוא אותו במקום להדביק. הדבר שומר על תמליל השיחה קריא ומאפשר ל-Claude להפנות לקובץ לפי נתיב בסבבים מאוחרים יותר.

#עריכת הנחיות באמצעות מיפויי מקשים של Vim

Claude Code כולל מצב עריכה בסגנון Vim עבור קלט ההנחיה. הפעל אותו דרך /config → Editor mode, או על ידי הגדרת editorMode ל-"vim" בתוך ~/.claude/settings.json. החזר את Editor mode ל-normal כדי לכבות אותו.

מצב Vim תומך בתת-קבוצה של תנועות ואופרטורים במצבי NORMAL ו-VISUAL, כגון ניווט באמצעות hjkl, בחירה באמצעות v/V, ו-d/c/y עם אובייקטי טקסט. ראה את מדריך מצב עורך Vim לטבלת המקשים המלאה.

לא ניתן למפות מחדש תנועות Vim דרך קובץ מיפויי המקשים. כדי למפות רצף של שני מקשים במצב INSERT כגון jj למקש Escape, הגדר את vimInsertModeRemaps בהגדרות המשתמש שלך.

לחיצה על Enter עדיין שולחת את ההנחיה שלך במצב INSERT, שלא כמו ב-Vim הסטנדרטי. השתמש ב-o או ב-O במצב NORMAL, או ב-Ctrl+J, כדי להוסיף שורה חדשה במקום זאת.

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

• מצב אינטראקטיבי: מדריך קיצורי מקשים מלא וטבלת מקשי Vim
• מיפויי מקשים: מיפוי מחדש של כל קיצור דרך ב-Claude Code, כולל Enter ו-Shift+Enter
• רינדור מסך מלא: פרטים על גלילה, חיפוש והעתקה במצב מסך מלא
• מדריך מנגנוני ה-Hooks: דוגמאות נוספות ל-Notification hook עבור Linux ו-Windows
• פתרון בעיות: תיקונים לבעיות שאינן קשורות להגדרת המסוף