🎮 פרק 5

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

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

לפי התיעוד הרשמי, נכון לספטמבר 2026, מריצים /keybindings כדי ליצור או לפתוח את קובץ ההגדרות בנתיב ~/.claude/keybindings.json. השינויים בקובץ מזוהים אוטומטית ונכנסים לתוקף מיד.

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

חיבור מקשים נכתב עם התו +: מקש ctrl או control, מקש shift, ומקש alt, opt, option או meta (מקש Alt ב-Windows ובלינוקס, ומקש Option ב-macOS). קבוצת cmd, command, super או win (מקש Command ב-macOS, מקש Windows ב-Windows, מקש Super בלינוקס) מזוהה רק בטרמינלים שמדווחים על מקש Super (כמו טרמינלים שתומכים בפרוטוקול המקלדת של Kitty או במצב modifyOtherKeys של xterm). רוב הטרמינלים אינם שולחים אותו, ולכן מומלץ להשתמש ב-ctrl או ב-meta עבור קיצורים שרוצים שיעבדו בכל מקום.

ב-macOS קיצורי Option/Alt (למשל Alt+B, Alt+F, Alt+D, Alt+Y, Alt+P) דורשים להגדיר את Option כ-Meta בהגדרות הטרמינל. לפי התיעוד הרשמי ההגדרה היא לפי טרמינל, לא כללית למערכת. הקיצור Option+T (חשיבה מורחבת) עובד ב-macOS בלי ההגדרה הזו.

שמות מקשים אינם תלויי רישיות בקובץ ההגדרות, ולכן K זהה ל-k, ו-ctrl+K זהה ל-ctrl+k. כדי לשייך Shift ואות, כותבים shift+k. כותבים שמות מקשים של קיצורי Ctrl באותיות לטיניות גם כאשר פריסת המקלדת הפעילה מקלידה תווים אחרים. בטרמינלים שמשתמשים בפרוטוקול המקלדת של Kitty (כמו Ghostty, Kitty, WezTerm ו-iTerm2), בפריסה לא לטינית (כמו קירילית), קלוד קוד מתאים קיצורי Ctrl לפי המיקום הפיזי של המקש בפריסת ארה"ב (למשל Ctrl והמקש הפיזי W מפעילים ctrl+w). בטרמינל שלא מדווח על מיקום, ההתאמה היא למה שהטרמינל שולח: קוד בקרה של ASCII מפעיל את הקיצור הלטיני, ואילו מקש שמגיע כתו קירילי אינו תואם לשום קיצור. לפי התיעוד הרשמי, לפני גרסה v2.1.247, קיצורי Ctrl לא פעלו בפריסה לא לטינית בטרמינלים עם פרוטוקול Kitty. בפריסות שמשנות סדר של אותיות לטיניות (כמו AZERTY), קלוד קוד מתאים את האות שהמקש מקליד (Ctrl עם המקש שמסומן בו A מפעיל ctrl+a).

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

קובץ הקיצורים הוא אובייקט JSON עם מערך bindings. כל בלוק שייך להקשר ממשק אחד, וממפה רצף מקשים לפעולה בפורמט namespace:action. ערך null מבטל קיצור קיים.

הדוגמה הבאה, מתוך התיעוד הרשמי, משייכת Ctrl+E לפתיחת עורך חיצוני בהקשר Chat, ומבטלת את 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
      }
    }
  ]
}

הקישור תקף רק בהקשר שבו הוגדר. קיצור ב-Chat לא יעבוד בדיאלוג אישור, בחיפוש היסטוריה או במציג תמליל. ההקשרים הזמינים כוללים: Global, Chat, Autocomplete, Settings, Confirmation, Tabs, Help, Transcript, HistorySearch, Task, ThemePicker, Attachments, Footer, MessageSelector, DiffDialog, DiffPanel, ModelPicker, EffortSlider, Select, Plugin, Agents, Scroll. לפי התיעוד הרשמי, לפני גרסה v2.1.205 היה קיים גם הקשר Doctor ופעולה doctor:fix עבור מסך האבחון /doctor.

הקשרים ופעולות ייעודיות:

• EffortSlider: סליידר רמת המאמץ שנפתח באמצעות /effort ללא ארגומנטים. המקש s מפעיל את הפעולה effortSlider:thisSessionOnly להחלת רמת המאמץ על הסשן הנוכחי בלבד (דורש גרסה v2.1.257 ומעלה). מקשי החצים, Enter ו-Escape בסליידר זה אינם ניתנים לשינוי.
• Agents: תצוגת סוכנים (claude agents, דורש גרסה v2.1.257 ומעלה). הקיצורים בהקשר זה מופעלים בהקשה בודדת (ולא באקורדים), ועוקפים קיצורים מקבילים ב-Chat או Global: המקש Ctrl+S מחליף קיבוץ סשנים (agents:switchView), והמקש Ctrl+T נועץ או משחרר נעיצה של סשן (agents:togglePin). קלט השיגור (dispatch input) פועל לפי קיצורי מקש בודד של chat:externalEditor (כמו Ctrl+G כברירת מחדל), ואקורדים כמו Ctrl+X Ctrl+E אינם פועלים שם.
• ModelPicker: בורר מודלים. המקש s מפעיל את הפעולה modelPicker:thisSessionOnly להחלת המודל לסשן הנוכחי בלבד. החצים ← ו-→ מפעילים modelPicker:decreaseEffort ו-modelPicker:increaseEffort.

ביטול קיצורי ברירת מחדל ואקורדים: הגדרת פעולה כ-null מבטלת קיצור קיים. הדבר עובד גם עבור אקורדים: רצפי מקשים המופרדים ברווח (כמו ctrl+k ctrl+s). יש ללחוץ על כל מקש באקורד תוך 3 שניות מהמקש הקודם, אחרת קלוד קוד מבטל את האקורד ומציג הודעה קצרה על כך. ביטול כל האקורדים שחולקים קידומת משחרר את הקידומת לשימוש כמקש בודד. אקורד בכל הקשר פעיל שומר את הקידומת שלו תפוסה, ולכן חובה לבטל כל אקורד בהקשר שבו הוא מוגדר.

קלוד קוד משייך כברירת מחדל אקורדים עם הקידומת ctrl+x: בהקשר Chat: האקורדים ctrl+x ctrl+k, ctrl+x ctrl+e, ctrl+x enter (דורש גרסה v2.1.247 ומעלה), וכן ctrl+x ctrl+a ו-ctrl+x tab (דורשים גרסה v2.1.260 ומעלה). בהקשר Task: האקורד ctrl+x ctrl+b. בהקשר DiffPanel: האקורד 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 ctrl+a": null,
        "ctrl+x tab": null,
        "ctrl+x": "chat:newline"
      }
    }
  ]
}

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

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

קיצורים שמורים שלא ניתנים לשינוי: לא ניתן לשנות את Ctrl+C (קטיעה), Ctrl+D (יציאה), Ctrl+M (מתקבל תמיד כ-Enter), Ctrl+[ (מתקבל תמיד כ-Escape, בטרמינלים עם פרוטוקול Kitty דורש גרסה v2.1.242 ומעלה), Ctrl+I (מתקבל תמיד כ-Tab), Ctrl+H (שולח בייט Backspace של ASCII, אופן הקריאה ב-Windows תלוי בטרמינל ובמשתנה CLAUDE_CODE_BS_AS_CTRL_BACKSPACE), ו-Caps Lock (אינו מועבר ליישומי טרמינל).

התנגשויות עם מרבבי טרמינל: Ctrl+B: קידומת של tmux (יש ללחוץ פעמיים כדי לשלוח, או להשתמש ב-Ctrl+X Ctrl+B). Ctrl+A: קידומת של GNU screen. Ctrl+Z: השהיית תהליך ב-Unix בחזרה למעטפת (SIGTSTP).

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

• מצב Vim מטפל בקלט ברמת הזנת הטקסט (תנועת סמן ומצבים).
• מערכת הקיצורים מטפלת בפעולות ברמת הרכיבים (הצגת משימות, שליחה ועוד).
• מקש Escape במצב Vim עובר ממצב INSERT למצב NORMAL, ואינו מפעיל chat:cancel.
• רוב קיצורי Ctrl עוברים דרך מצב Vim למערכת הקיצורים.
• מקשי Vim אינם ניתנים לשינוי דרך keybindings.json. כדי למפות רצף של שני מקשים במצב INSERT כמו jj ל-Escape, משתמשים בהגדרה vimInsertModeRemaps (דורש גרסה v2.1.208 ומעלה, ההגדרה נתמכת רק בהגדרות משתמש, בדגל --settings או בהגדרות מנוהלות, והגדרות בקובץ פרויקט אינן משפיעות).
• במצב NORMAL של Vim, המקש ? מציג את תפריט העזרה (התנהגות Vim), והמקש / פותח חיפוש היסטוריה (זהה ל-Ctrl+R). אם הסמן בתחילת הקלט או בסופו, j/k ו-↑/↓ מנווטים בהיסטוריית הפקודות. לחיצה על ← בהנחיה ריקה פותחת את תצוגת הסוכנים (החל מגרסה v2.1.219).

#קיצורי מקלדת מרכזיים

הטבלה מתארת את ברירות המחדל לפי התיעוד הרשמי, נכון לספטמבר 2026. אם שינית את keybindings.json, הפעולה נשארת אותה פעולה, אבל המקשים יכולים להיות אחרים.

#קיצורי עריכת טקסט בשורת הקלט

החל מגרסה v2.1.261, קלוד קוד מיישם את מוסכמות readline לעריכת טקסט (ההגדרה הישנה keybindingFlavor מיושנת ואינה משפיעה). לא ניתן לשנות קיצורים אלו בקובץ keybindings.json:

#גבולות מילים בקיצורי עריכה

הקיצורים Alt+B, Alt+F, Alt+D, Option+Delete ו-Ctrl+Backspace מתייחסים למילה כרצף של אותיות וספרות, כך שסימני פיסוק כמו _, . ו-/ מפרידים בין מילים. כאשר מופיע src/utils/foo.ts בהנחיה, לחיצות חוזרות על Alt+B עוצרות בתחילת ts, foo, utils ו-src.

הקיצור Ctrl+W פועל אחרת: הוא מתעלם מסימני פיסוק ומוחק לאחור עד לרווח הלבן הקודם, ולכן לחיצה אחת מסירה את כל src/utils/foo.ts.

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

מוסכמות readline אלו חלות בקלוד קוד החל מגרסה v2.1.261 ומעלה. ההגדרה keybindingFlavor שהפעילה אותן בגרסאות קודמות מיושנת ואינה משפיעה.

לא ניתן למפות מחדש קיצורים אלו בקובץ ההגדרות keybindings.json, שכן אין עבורם פעולות מוגדרות.

#ערכת נושא ותצוגה

#קלט מרובה שורות

#פקודות מהירות ותווי קידומת

#מציג תמליל מפורט

כאשר מציג התמליל פתוח (נפתח ונסגר באמצעות Ctrl+O), הקיצורים הבאים זמינים. מריצים /tui ללא ארגומנטים כדי לבדוק איזה מנוע רינדור פעיל. את Ctrl+E ניתן למפות מחדש דרך transcript:toggleShowAll.

#קלט קולי

#השלמת פקודות באמצע הנחיה

הקלדת / מציגה את הפקודות הזמינות, וניתן להמשיך להקליד אותיות כדי לסנן. התפריט מציג פקודות מובנות, מיומנויות (skills) של המשתמש, ופקודות מתוספים (plugins) ומשרתי MCP.

השלמת פקודות פועלת גם באמצע הנחיה: מקלידים / לאחר רווח, ולאחר מכן את האותיות הראשונות של שם הפקודה (לדוגמה run the tests, then /com). רק פקודות ששמן מתחיל באותיות אלו יותאמו, כך שנתיב קובץ כמו /tmp/notes.md אינו משאיר רשימה פתוחה. קלוד קוד מריץ את הפקודה בעצמו רק כאשר היא מופיעה בתחילת ההודעה.

• ברינדור fullscreen: ההתאמות נפתחות כרשימה תוך כדי הקלדה, ללא שורה מודגשת, כך ש-Enter שולח את ההנחיה כפי שהוקלדה. לוחצים Tab להכנסת ההתאמה העליונה, או בוחרים שורה באמצעות מקשי החצים ו-Enter.
• מחוץ ל-fullscreen: המשך ההתאמה העליונה מופיע כטקסט רפאים (ghost text) בסמן, בצירוף מונה כגון +2 כשיש התאמות נוספות. לוחצים Tab להכנסת ההתאמה היחידה, או לפתיחת הרשימה כאשר יש מספר התאמות, ואז בוחרים בחצים ו-Enter.
• בשני מנועי הרינדור, לחיצה על Tab על תו / בודד באמצע ההנחיה מציגה את כל הפקודות.
• מיומנות של תוסף מותאמת גם לפי שמה החשוף (לדוגמה /deploy מוצא את myplugin:deploy-app, ובעת הכנסת ההתאמה נכתב הנתיב המלא /myplugin:deploy-app).

ברינדור fullscreen, רשימות הפקודות של / ורשימות הקבצים של @ מגיבות גם לעכבר: מעבר עם הסמן מדגיש שורה, ולחיצה מקבלת אותה.

#מצב עורך Vim

מפעילים עריכה בסגנון Vim דרך /config בתפריט Editor mode.

קלוד קוד שומר על מצב Vim ועל מיקום הסמן בעת פתיחה וסגירה של מציג התמליל (Ctrl+O) או פתיחת פאנל כמו /config. אם יצאת מההנחיה במצב NORMAL, היא תישאר במצב NORMAL כשתחזור, והסמן יישאר במקום שבו עזבת אותו.

#החלפת מצבים

#מיפוי מחדש של רצפי מקשים במצב INSERT

ההגדרה vimInsertModeRemaps ממפה רצף של שני מקשים במצב INSERT ל-Escape, כך שמיפוי כמו jj מחזיר למצב NORMAL. דורש גרסה v2.1.208 ומעלה.

הדוגמה הבאה מתוך ~/.claude/settings.json מפעילה מצב Vim וממפה את jj ל-Escape:

{
  "editorMode": "vim",
  "vimInsertModeRemaps": { "jj": "<Esc>" }
}

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

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

קלוד קוד קורא הגדרה זו מקובץ הגדרות המשתמש, מדגל --settings ומהגדרות מנוהלות בלבד. הגדרות בקובץ פרויקט (.claude/settings.json או .claude/settings.local.json) אינן משפיעות, כדי שמאגר קוד לא יוכל למפות מקשים מחדש.

#ניווט במצב NORMAL

במצב NORMAL של Vim, אם הסמן נמצא בתחילת הקלט או בסופו ואינו יכול לנוע עוד, j/k ו-↑/↓ מנווטים בהיסטוריית הפקודות. לחיצה על ← בהנחיה ריקה פותחת את תצוגת הסוכנים (Agent view) גם ממצב NORMAL וגם ממצב INSERT (לפני גרסה v2.1.219, לחיצה על ← בהנחיה ריקה לא עשתה דבר במצב NORMAL).

#עריכה במצב NORMAL

#אובייקטי טקסט במצב NORMAL

אובייקטי טקסט פועלים עם אופרטורים כמו d, c ו-y:

#מצב חזותי (Visual mode)

לוחצים v לבחירה לפי תווים או V לבחירה לפי שורות. תנועות סמן מרחיבות את הבחירה, ואופרטורים פועלים עליה ישירות.

מצב חזותי בלוקי באמצעות Ctrl+V אינו נתמך.

#היסטוריית פקודות וחיפוש לאחור

קלוד קוד שומר היסטוריה של ההנחיות שהוקלדו, וחץ למעלה (↑) מגיע גם להנחיות מסשנים קודמים באותו פרויקט:

• היסטוריית הקלט נשמרת לפי ספריית עבודה.
• הרצת /clear פותחת סשן חדש: שליפת פקודות מציגה קודם את פקודות הסשן החדש, ולאחריהן את פקודות הסשנים הקודמים. שיחת הסשן הקודם נשמרת וניתנת לחידוש.
• שליחת אותה הנחיה פעמיים ברצף רושמת רשומה בודדת בהיסטוריה, כך שלחיצה על ↑ מדלגת להנחיה הייחודית הקודמת.
• כאשר שולפים הנחיה שכללה טקסט מודבק, קלוד קוד שולח שוב את התוכן המודבק המלא בעת שליחה חוזרת. אם התוכן כבר נוקה, קלוד קוד אינו שולח את המחרוזת המילולית [Pasted text #N].
• הרחבת היסטוריה עם הסימן ! כבויה כברירת מחדל.

#חיפוש לאחור עם Ctrl+R

לחיצה על Ctrl+R מפעילה חיפוש אינטראקטיבי בהיסטוריית הפקודות. ברינדור fullscreen, נפתח דיאלוג חיפוש: מקלידים לסינון, לוחצים Up ו-Down למעבר בין התאמות, ולוחצים Ctrl+S להחלפת טווח החיפוש בין הסשן הנוכחי, הפרויקט הנוכחי וכל הפרויקטים. לחיצה על Enter או Tab מכניסה את ההתאמה לשורת הקלט, ו-Esc מבטל.

במנוע הרינדור הקלאסי, החיפוש הפנימי (inline) מתבצע לפי השלבים הבאים:

1. התחלת חיפוש: לחיצה על Ctrl+R להפעלת חיפוש היסטוריה לאחור.
2. הקלדת שאילתה: הזנת טקסט לחיפוש בפקודות קודמות. מונח החיפוש מודגש בתוצאות התואמות.
3. ניווט בין תוצאות: לחיצה נוספת על Ctrl+R למעבר בין תוצאות ישנות יותר.
4. טווח חיפוש: החיפוש הפנימי (inline) מחפש תמיד בהנחיות מכל הפרויקטים.
5. קבלת תוצאה:
   • לחיצה על Tab או Esc לקבלת התוצאה הנוכחית והמשך עריכה.
   • לחיצה על Enter לקבלת הפקודה והרצתה מיד.
6. ביטול חיפוש:
   • לחיצה על Ctrl+C לביטול ושחזור הקלט המקורי.
   • לחיצה על Backspace בשדה חיפוש ריק לביטול.

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

#פקודות Bash ברקע ומצב מעטפת

קלוד קוד תומך בהרצת פקודות Bash ברקע, ומאפשר להמשיך לעבוד בזמן שתהליכים ממושכים רצים.

#כיצד פועלת הרצה ברקע

כאשר פקודה מופעלת ברקע, קלוד קוד מריץ אותה באופן אסינכרוני ומחזיר מיד מזהה משימת רקע (background task ID). קלוד קוד יכול לענות להנחיות חדשות בזמן שהפקודה ממשיכה לרוץ ברקע.

כדי להריץ פקודה ברקע:

• מבקשים מקלוד קוד בהנחיה להריץ פקודה ברקע.
• לוחצים Ctrl+B להעברת קריאת כלי Bash רגילה לרקע (משתמשי tmux לוחצים פעמיים על Ctrl+B בגלל מקש הקידומת של tmux).

מאפיינים עיקריים:

• הפלט נכתב לקובץ וקלוד יכול לקרוא אותו באמצעות כלי ה-Read.
• למשימות רקע יש מזהים ייחודיים למעקב ולשליפת פלט.
• משימות רקע מנוקות אוטומטית בעת יציאה מקלוד קוד. ב-macOS ובלינוקס, כאשר עוצרים משימת רקע מ-/tasks או ביציאה, נעצרים גם תהליכים שהתנתקו ממעטפת המשימה (כגון כאלו שהופעלו תחת setsid או timeout).
• העברת הסשן לרקע במקום יציאה ממנו שומרת על פעולת משימות הרקע בסשן הרקע.
• משימות רקע מופסקות אוטומטית אם הפלט שלהן חורג מ-5GB, בצירוף הערה מסבירה ב-stderr.
• ב-macOS ובלינוקס, קלוד קוד מסיים משימות רקע כאשר מערכת ההפעלה מאותתת על לחץ זיכרון (memory pressure), בתנאי שהסשן לא היה פעיל לפחות 30 דקות ושום סיבוב או סוכן משנה אינם רצים. הגדרת CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP=1 מכבה התנהגות זו (דורש גרסה v2.1.193 ומעלה).
• לפקודות רקע של סוכן משנה אין הגבלת זמן, פרט לפקודה של סוכן משנה הפועל בחזית שמסתיימת עם תשובתו הסופית (לפני גרסה v2.1.218 מנגנון לחץ הזיכרון ומגבלת 60 הדקות לא חלו על פקודות שהועברו לרקע עם Ctrl+B).

להשבתת כל פעילות משימות הרקע, מגדירים את משתנה הסביבה CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1.

פקודות נפוצות ברקע: כלי בנייה (webpack, vite, make), מנהלי חבילות (npm, yarn, pnpm), מריצי בדיקות (jest, pytest), שרתי פיתוח, ותהליכים ארוכים (docker, terraform).

#מצב מעטפת עם קידומת !

ניתן להריץ פקודות מעטפת ישירות בלי לעבור דרך קלוד, על ידי הקדמת הסימן ! לקלט:

! npm test
! git status
! ls -la

מאפייני מצב מעטפת:

• מוסיף את הפקודה ואת הפלט שלה להקשר השיחה.
• מציג התקדמות ופלט בזמן אמת.
• תומך בהעברה לרקע ב-Ctrl+B עבור פקודות ממושכות.
• אינו דורש מקלוד לפרש או לאשר את הפקודה.
• תומך בהשלמה אוטומטית לפי היסטוריה: מקלידים פקודה חלקית ולוחצים Tab להשלמה מפקודות ! קודמות בפרויקט הנוכחי.
• תומך בהשלמה אוטומטית חיה של נתיבי קבצים החל מגרסה v2.1.193 בכל הפלטפורמות: מקלידים מחרוזת המכילה לוכסן ימני (כגון ./src/ או ~/) כדי לראות תפריט קבצים ותיקיות, ולוחצים Tab לקבלה. גם ב-Windows משתמשים ב-/, שכן ההשלמה מופעלת על ידי / ולא \.
• יציאה ממצב מעטפת באמצעות Escape, Backspace או Ctrl+U בשורת הנחיה ריקה.
• הדבקת טקסט שמתחיל ב-! לתוך הנחיה ריקה נכנסת למצב מעטפת באופן אוטומטי.

פקודות במצב מעטפת רצות מחוץ ל-sandbox (אלא אם הוגדר strict sandbox), מכיוון שה-sandbox חל על פקודות שקלוד מריץ.

קלוד מגיב לפלט הפקודה באופן אוטומטי ברגע שהפלט נכנס לתמליל, כך שניתן להריץ ! npm test ולקבל הסבר על כשלים בלי הנחיה נוספת. התגובה עולה כמו הנחיה רגילה. כדי להחזיר את ההתנהגות שבה הפלט מתווסף להקשר ללא מענה, מגדירים respondToBashCommands כ-false בקובץ settings.json (לפני גרסה v2.1.186 מצב מעטפת הוסיף פלט ללא מענה כברירת מחדל).

#הכנסת הודעות לתור בזמן שקלוד עובד

ניתן להקליד הודעה וללחוץ Enter בזמן שקלוד עובד. קלוד קוד מכניס את ההודעה לתור במקום לקטוע את הסיבוב, ומציג את ההודעות הממתינות מעל תיבת הקלט עד לשליחתן. ניתן להכניס לתור פקודות מעטפת ! ואת רוב הפקודות הרגילות, מלבד פקודות כמו /status שרצות מיד עם שליחתן.

#מתי קלוד קוד שולח הודעות מהתור

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

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

לחיצה על Esc קוטעת את הסיבוב, משמרת את ההודעות שבתור ושולחת אותן מיד.

פקודות מסוימות רצות מיד ולא נכנסות לתור, בהן /model, /effort ו-/fast. כל אחת מהן משנה הגדרה:

• /model: לאחר אישור אזהרת המטמון (אם מוצגת), השינוי חל על הבקשה הבאה באותו סיבוב.
• /effort: לאחר אישור אזהרת המטמון (אם מוצגת), השינוי חל על הבקשה הבאה באותו סיבוב.
• /fast: שומר על הגדרת מצב מהיר שהייתה פעילה בתחילת הסיבוב, כך ששינוי המהירות יחול מהסיבוב הבא. אם המודל הנוכחי אינו תומך במצב מהיר, הפעלתו מחליפה מודל, והמודל החדש נכנס לשימוש כבר מהבקשה הבאה באותו סיבוב.

#החזרת הודעות מהתור

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

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

#הצעות הנחיה

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

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

• לחיצה על Tab או על חץ ימינה → מכניסה את ההצעה לשורת הקלט, ו-Enter שולח אותה.
• התחלת הקלדה מסירה את ההצעה.

ההצעות מיוצרות בבקשת רקע שעושה שימוש חוזר במטמון ההנחיות (prompt cache), בעלות מזערית.

#מתי קלוד קוד מדלג על הצעות

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

קלוד קוד מדלג על הצעות במצבים הבאים:

• מטמון ההנחיות קר (cold prompt cache).
• לאחר הסיבוב הראשון בסשנים מסוימים.
• התשובה הקודמת הסתיימה בשגיאה.
• בזמן עבודה במצב תוכנית (plan mode).
• החשבון קרוב למגבלת השימוש או הגיע אליה. כדי להשאיר הצעות פעילות עד להגעה למגבלה, מגדירים את CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=true (לפני גרסה v2.1.238 קלוד קוד דילג ליד המגבלה גם כשהמשתנה הוגדר).
• בסשנים של חברי צוות בתוך צוותי סוכנים (agent teams) כברירת מחדל (הסשן המוביל מציג הצעות).

במצב הדפסה (print mode), קלוד קוד אינו מייצר הצעות כברירת מחדל. העברת הדגל --prompt-suggestions יחד עם -p "<prompt>" --output-format stream-json --verbose גורמת לפליטת הודעת prompt_suggestion לאחר כל סיבוב שמייצר הצעה.

#כיבוי הצעות הנחיה

לכיבוי מלא של הצעות הנחיה:

• כיבוי Prompt suggestions ב-/config.
• הגדרת promptSuggestionEnabled ל-false בקובץ ההגדרות.
• הגדרת משתנה הסביבה CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false (מקבל עדיפות על פני ההגדרה בקובץ):

export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false

לכיבוי רוחבי בארגון, מגדירים promptSuggestionEnabled ל-false בהגדרות מנוהלות, ומגדירים CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION ל-false תחת מפתח env כדי שמשתמשים לא יוכלו להפעיל מחדש דרך הסביבה שלהם.

#קודים קצרים לאימוג'י

הקלדת : ואחריו קוד קצר בשורת הקלט מכניסה אימוג'י (דורש גרסה v2.1.217 ומעלה):

• הקלדת קוד מלא כמו :heart: מוחלפת מיד ב-❤️ עם הקלדת ה-: הסוגר.
• הקלדת : ולפחות שתי אותיות של שם, כגון :hea, פותחת תפריט הצעות, ולחיצה על Tab או Enter מכניסה את האימוג'י הנבחר.

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

לכיבוי התכונה, מגדירים emojiCompletionEnabled ל-false בקובץ settings.json. פעולה זו מכבה גם את תפריט ההצעות וגם את ההחלפה הישירה.

#בדיקת איות בזמן הקלדה

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

בדיקת איות כבויה כברירת מחדל, ואינה בודקת דבר במצב קורא מסך. דורש גרסה v2.1.235 ומעלה.

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

• התקנת aspell, hunspell או ispell ווידוא הימצאותם ב-PATH. קלוד קוד מריץ את התוכנה הראשונה מבין השלוש שהוא מוצא, בסדר זה, בכל הפלטפורמות (כולל shim מסוג .cmd ב-Windows).
• בדיקת תקינות בטרמינל באמצעות aspell --version, hunspell --version או ispell -v. שגיאת "command not found" מעידה שהתוכנה טרם הותקנה או שאינה ב-PATH.

#הפעלה או כיבוי של בדיקת איות

קלוד קוד קורא את הגדרת spellcheck משלושה מקומות, ומתעלם ממנה בקובצי פרויקט (.claude/settings.json ו-.claude/settings.local.json):

בהגדרות משתמש (~/.claude/settings.json):

{
  "spellcheck": { "enabled": true }
}

בשורת הפקודה דרך דגל --settings: שומרים בקובץ JSON (כגון spellcheck.json) ומריצים:

claude --settings spellcheck.json

בהגדרות מנוהלות של הארגון.

לבדיקה, מקלידים מילה שגויה ורווח. קלוד קוד מסמן את המילה בקו תחתי. לכיבוי, מגדירים enabled ל-false או מסירים את הבלוק.

שדות הגדרה נוספים:

• checker: ערך aspell, hunspell או ispell. קלוד קוד אינו נופל לתוכנה חלופית אם הוגדר בודק ספציפי, ומתייחס לכל ערך אחר כ-auto.
• language: שם מילון כגון en_GB. ערכים שאינם שם מילון רגיל נפסלים, והבודק משתמש במילון ברירת המחדל שלו.
• color: שם צבע כגון yellow, או ערך הקס #rrggbb, ערך rgb(r,g,b), ansi256(n) או ansi:<name>. ברירת המחדל היא צבע השגיאה של ערכת הנושא.

דוגמה מלאה:

{
  "spellcheck": {
    "enabled": true,
    "checker": "hunspell",
    "language": "en_GB",
    "color": "yellow"
  }
}

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

#מה מסומן בקו תחתי

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

• פקודות כמו /help, אזכורי @, כתובות URL, נתיבי קבצים ודגלים כגון --verbose.
• מילים עם ספרות, קווים תחתונים, אות רישית אחרי התו הראשון, וטקסט בתוך backticks.
• טקסט בשפות סינית, יפנית, קוריאנית, תאי, לאו, חמר ומיאנמר.

לקלוד קוד אין רשימת מילים משלו. מילה נחשבת שגויה רק לפי קביעת בודק האיות. להוספת מילה למילון אישי, עוקבים אחר תיעוד בודק האיות המותקן ומפעילים מחדש את קלוד קוד.

#מתי קלוד קוד אינו מסמן דבר

קלוד קוד אינו מציג קו תחתי כאשר אינו מצליח להפעיל את הבודק ברקע:

• שום בודק אינו מותקן, או שהבודק שהוגדר ב-checker חסר.
• הבודק כשל פעמיים ברצף (בהפעלה או במהלך הסשן). קלוד קוד מנסה להפעילו מחדש לאחר הכשל הראשון, ומפסיק לבדוק לאחר הכשל השני עד להפעלה מחדש של קלוד קוד.
• הבודק ממתין מעל 15 שניות לתשובה, 3 פעמים. בכל פעם המילים נשארות ללא סימון, ולאחר הפעם השלישית הבדיקה מופסקת עד להפעלה מחדש של התוכנית.

לבירור הסיבה, מפעילים claude --debug עם בדיקת איות מופעלת ומקלידים מילה. ביומן הדיבאג בנתיב ~/.claude/debug/<session-id>.txt, שורות עם [spellcheck] מפרטות את התוכנית שנבחרה, שגיאות מילון חסר או סיבת העצירה.

#סקירת שינויים עם /diff

הרצת /diff מציגה את השינויים בעץ העבודה לצד עריכות שקלוד ביצע בסשן. תת-מודול של git מופיע כרשומה בודדת ורק כאשר ה-commit שאליו הוא מצביע משתנה (עריכות בתוך קובצי תת-המודול אינן מופיעות שם).

ברינדור fullscreen, הפקודה /diff פותחת חלונית diff לצד השיחה שנשארת פתוחה ומתעדכנת תוך כדי עבודה. ברינדור קלאסי, נפתח מציג diff במקום שורת ההנחיה, ונסגר בסיום הקריאה.

#חלונית diff

חלונית ה-diff מציגה רשימת קבצים שנשתנו עם מספרי שורות שנוספו והוסרו, ומתחתיה את ה-diff של כל קובץ. החלונית מתרעננת בכל פעם שקלוד עורך קובץ או מריץ פקודת מעטפת. לסגירה, מריצים /diff שוב או לוחצים על ✕ בכותרת החלונית.

דרישות לפתיחת החלונית:

• מנוע רינדור fullscreen.
• מאגר git.
• טרמינל ברוחב 110 עמודות לפחות.
• גרסת קלוד קוד v2.1.260 ומעלה.

כאשר התנאים אינם מתקיימים, /diff פותח את מציג ה-diff במקום או מציג הסבר.

החלונית נפתחת אוטומטית ברגע שקלוד מתחיל לערוך קבצים, אם הטרמינל ברוחב 144 עמודות לפחות. לאחר פתיחה ידנית עם /diff, סשנים עתידיים יפתחו אותה ברגע שקלוד יערוך קובץ בכל טרמינל רחב מספיק. סגירת החלונית משאירה אותה סגורה עד להרצה חוזרת של /diff.

פעולות בחלונית הפתוחה:

• קפיצה לקובץ: לחיצה על שורת הקובץ ברשימה. גלילה באמצעות גלגלת העכבר, או באמצעות Alt+Up/Alt+Down או Ctrl+Up/Ctrl+Down כאשר רשימת הקבצים ארוכה.
• שאלת קלוד על שורות מסוימות: בחירת שורות בחלונית באמצעות העכבר. קלוד קוד מצרף את הבחירה להנחיה הבאה ומציג מונה שורות בקלט עד לשליחה. להסרת הבחירה בלי לשלוח אותה, מזיזים את הסמן ממש אחרי מחוון מונה השורות ולוחצים Backspace (דורש גרסה v2.1.271 ומעלה).
• הצגת קבצים שהושמטו: הרשימה מדלגת על קובצי בדיקות וקבצים מיוצרים (generated files), ומאחדת שינויים שבוצעו לפני הסשן לשורה תחתונה אחת. לחיצה על שורת המונה פורשת את הפרטים.
• שינוי בסיס ההשוואה: לחיצה על Ctrl+X B עוברת מחזורית בין שינויי הסשן הנוכחי, כל השינויים שטרם נשמרו ב-commit, וכל השינויים מאז שהענף התפצל מענף ברירת המחדל. הבחירה נשמרת לכל פרויקט.

#מציג diff

מציג ה-diff (הקלאסי) תופס את מקום ההנחיה עד לסגירתו. תצוגת Current מציגה שינויים מ-git שטרם נשמרו ב-commit, או תוספות מול ענף ברירת המחדל. בנוסף קיימת תצוגת סיבוב (turn view) עבור כל הנחיה שבעקבותיה קלוד ערך קבצים. תצוגות הסיבוב נבנות מעריכות הקבצים של קלוד ולא מ-git, כך ששינוי שבוצע בפקודת מעטפת מופיע רק תחת Current.

מקשי ניווט במציג:

• חץ ימינה ושמאלה: מעבר בין Current לתצוגות הסיבובים.
• חץ למעלה ולמטה: בחירת קובץ ברשימה.
• Enter: פתיחת ה-diff של הקובץ הנבחר (גלילה באמצעות חצים למעלה/למטה או PageUp/PageDown).
• Esc: חזרה מ-diff של קובץ לרשימה, או סגירת המציג מתוך הרשימה.

#שאלות צדדיות עם /btw

הפקודה /btw מאפשרת לשאול שאלה על העבודה הנוכחית בלי להעמיס על היסטוריית השיחה:

/btw what was the name of that config file again?

קלוד עונה מתוך מה שכבר קיים בהקשר: הודעות, תשובות ותוצאות כלים שנאספו. ניתן לשאול על קוד שקלוד כבר קרא, החלטות שהתקבלו מוקדם יותר, או כל פרט מהסשן. שאלה מאוחרת רואה גם שאלות צדדיות קודמות: קלוד קוד משחזר עד 20 חילופי דברים אחרונים בכל שאלה. השאלה והתשובה אינן נכנסות להיסטוריית השיחה. בטרמינל הן מופיעות בשכבת כיסוי (overlay) שניתנת לסגירה. הטרמינל שומר את השרשור בזיכרון: לחיצה על x מנקה חילופי דברים קודמים, והשרשור נמחק ביציאה מקלוד קוד.

בתוסף VS Code (גרסה v2.1.227 ומעלה), הפקודה /btw פותחת פאנל ייעודי בצ'אט ומאפשרת שאלות המשך ישירות בתוכו, והשרשור נשמר גם לאחר טעינה מחדש של החלון.

מאפייני שאלות צדדיות:

• זמינות בזמן שקלוד עובד: ניתן להריץ /btw גם כשקלוד מעבד תשובה. השאלה רצה עצמאית ואינה קוטעת את הסיבוב הראשי. היא רואה את כל מה שבשיחה עד כה, מלבד התשובה שקלוד כותב באותו רגע.
• ללא גישה לכלים: התשובה מבוססת על ההקשר הקיים בלבד. קלוד אינו יכול לקרוא קבצים, להריץ פקודות או לחפש. אם קלוד כותב קריאות כלים כטקסט, התשובה מסתיימת בהערה ששום דבר לא הופעל.
• תשובה בודדת: אין סיבובי המשך בשכבת הכיסוי. להמשך שואלים שאלה נוספת עם /btw, או לוחצים f כדי לפצל את השאלה והתשובה לסוכן משנה ברקע (forked subagent).
• עלות נמוכה: כאשר מטמון ההנחיות חם, העלות מזערית.
• 5 השאלות הקודמות מופיעות ברשימה מעומעמת מעל התשובה הנוכחית.
• לחזרה לשכבת הכיסוי לאחר סגירתה, מריצים /btw ללא שאלה (לפני גרסה v2.1.212 הוצגה הודעת שימוש).

מקשי שכבת הכיסוי:

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

#רשימת משימות של קלוד

רשימת המשימות היא רשימת ה-to-do שקלוד יוצר כדי לתכנן עבודה מרובת שלבים, עם מחווני סטטוס המציגים מה ממתין, מה בתהליך ומה הושלם. זו אינה תצוגת משימות הרקע (/tasks).

הרשימה מתמלאת רק בסשנים בעלי כלי מעקב משימות, הכלולים כברירת מחדל במודלים Claude 3.x, Opus 4 עד 4.7, Sonnet 4 עד 4.6 ו-Haiku 4.5. במודלים אחרים הרשימה נשארת ריקה אלא אם מפעילים CLAUDE_CODE_ENABLE_TODO_TOOLS=1.

מאפייני הרשימה:

• לחיצה על Ctrl+T פותחת או סוגרת את תצוגת הרשימה (עד 5 משימות בו-זמנית). אם קלוד טרם יצר משימות, לחיצה על המקש אינה מציגה דבר.
• השארת הרשימה פתוחה משמרת את המצב הפתוח בעת הפעלה מחדש לסשן שעדיין יש בו משימות (באמצעות --resume או --continue).
• לצפייה בכל המשימות או למחיקתן, פונים לקלוד ישירות: "show me all tasks" או "clear all tasks".
• משימות נשמרות גם בעת צמצום הקשר (context compaction).
• לשיתוף רשימת משימות בין סשנים, מגדירים את משתנה הסביבה CLAUDE_CODE_TASK_LIST_ID לשימוש בתיקייה בנתיב ~/.claude/tasks/:

CLAUDE_CODE_TASK_LIST_ID=my-project claude

#תקציר סשן

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

הרצת /recap מפיקה סיכום לפי דרישה. קלוד קוד מגביל הן תקצירים אוטומטיים והן את פלט /recap ל-400 תווים לכל היותר. לכיבוי תקצירים אוטומטיים, פותחים את /config ומכבים את Session recap.

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

#המתנה לאיפוס מכסת שימוש

כאשר מגבלת שימוש של claude.ai עוצרת את קלוד באמצע משימה, קלוד קוד ממתין בסשן וממשיך את המשימה באופן עצמאי לאחר איפוס המגבלה. המשך אוטומטי מופעל כברירת מחדל בסשנים אינטראקטיביים עם מנוי claude.ai (דורש גרסה v2.1.234 ומעלה).

בזמן ההמתנה, שורה בתחתית הסשן מציגה את מועד ההמשך:

Usage limit reached · continuing automatically at 3:45pm · esc to cancel

התנהגות בסיום ההמתנה:

• בעת האיפוס: השורה מציגה continuing shortly, לאחר מכן Usage limit reset · continuing automatically, וקלוד קוד שולח הנחיה קבועה להמשך המשימה מהנקודה שבה נעצרה (אינו שולח שוב את הודעתך האחרונה).
• לאחר שינה של המחשב: אם המחשב ישן מעל 30 דקות והמגבלה התאפסה בזמן השינה, השורה מציגה Your usage limit has reset · press enter to continue. לוחצים Enter להמשך. לאחר שינה קצרה יותר, קלוד קוד ממשיך בעצמו.
• סיום מוקדם: בעת הוספת קרדיטים באמצעות /usage-credits, כניסה מחדש לאחר /upgrade, או החלפת מודל באמצעות /model בזמן ההמתנה, קלוד קוד בודק זמינות וממשיך מיד. תחת הגדרת opusplan והגדרות דומות שמריצות מצב תוכנית על מודל אחר, קלוד קוד ממתין לאיפוס.

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

#ביטול ההמתנה

לוחצים Esc בשורת הנחיה ריקה, או Ctrl+C בזמן שהשורה מוצגת, או מריצים /rate-limit-options ובוחרים באפשרות Don't continue automatically.

ההמתנה מסתיימת ללא המשך משימה גם במקרים הבאים:

• שליחת הנחיה חדשה (קלוד קוד מריץ את ההנחיה החדשה במקום להמתין).
• יציאה מקלוד קוד (ההמתנה אינה מתחדשת בהמשך הסשן).
• החלפת ידיים בשיחה: החלפת חשבון עם /login, ניקוי או rewind של השיחה, /resume לסשן אחר, משיכה עם /teleport, הפעלה מחדש עם /tui, או העברת הסשן ל-Claude Desktop, לסשן רקע או לענן.
• כיבוי ההגדרה, או מועד איפוס שרחוק מ-24 שעות (מסיים רק המתנה שהחלה אוטומטית).
• חסימת ההמשך על ידי hook מסוג UserPromptSubmit או כשל לפני הגעה למודל.

#הפעלת המתנה באופן ידני

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

• סשנים של Remote Control או של חברי צוות ב-agent team (אדם בטרמינל יכול להתחיל ידנית).
• איפוס שרחוק ביותר מ-24 שעות (כמו מגבלה שבועית).
• מגבלת Opus או Sonnet כאשר רץ מודל מחוץ למשפחה זו.

במקרים אלו, קלוד קוד פותח תפריט אפשרויות עם הגעה למגבלה. בוחרים בשורה שמתחילה ב-Wait here, then continue automatically. בסשן Remote Control או חבר צוות, מריצים /rate-limit-options לפתיחת התפריט.

ההמתנה אינה מוצעת כלל במקרים הבאים:

• סשנים ברקע והרצות עם הדגל -p.
• מפתחות API, ספקי ענן וחיוב לפי שימוש (metered billing).
• שער LLM ללא התחברות שמורה של claude.ai.

#כיבוי המשך אוטומטי

ב-/config, מכבים את Continue automatically at usage limit, או מגדירים autoContinueAtUsageLimit ל-false בהגדרות המשתמש. הפקודה /config autoContinueAtUsageLimit=false פועלת גם היא (כולל עם -p), אך אינה יכולה להחזיר את ההגדרה ל-true כיוון שהיא מעניקה הרשאת הרצה ללא השגחה.

#סטטוס סקירת PR ובקשות מיזוג ב-GitLab

בעת עבודה על ענף עם pull request פתוח, קלוד קוד מציג בכותרת התחתונה קישור לחיץ כגון "PR #446". לקישור יש קו תחתי צבעוני המציין את סטטוס הסקירה:

• ירוק: מאושר (approved).
• צהוב: ממתין לסקירה (pending review).
• אדום: נדרשים שינויים (changes requested).
• אפור: טיוטה (draft).

התג נעלם ברגע שה-pull request ממוזג או נסגר.

לחיצה על הקישור עם Cmd+click (ב-macOS) או Ctrl+click (ב-Windows ובלינוקס) פותחת את ה-pull request בדפדפן.

הסטטוס מתרענן ברגע שפקודת git push, או פקודת gh pr שמשנה את ה-PR (כגון gh pr create או gh pr merge), מצליחה בסשן.

קלוד קוד מרנדר את התג כהיפר-קישור גם אם אינו מזהה תמיכה בכך בטרמינל (תופעה נפוצה ב-SSH או ב-tmux). הגדרת FORCE_HYPERLINK=0 מציגה את התג כטקסט רגיל.

הגדרת משתנה הסביבה CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC מונעת מקלוד קוד לבדוק סטטוס pull request או merge request.

זיהוי PR ב-GitHub דורש טוקן:

• ב-github.com: טוקן במשתנים GH_TOKEN או GITHUB_TOKEN, או טוקן שנשמר מ-gh auth login. ללא טוקן, הכותרת מציגה install gh for PR status כש-gh אינו מותקן, או gh auth login for PR status כשהוא מותקן.
• במארח GitHub Enterprise שמוגדר ב-GH_HOST: טוקן ב-GH_ENTERPRISE_TOKEN או GITHUB_ENTERPRISE_TOKEN, או טוקן שנשמר מ-gh auth login --hostname <host>.
• בכל מארח GitHub אחר: טוקן שנשמר מ-gh auth login --hostname <host>.

#בקשות מיזוג ב-GitLab

בעת עבודה על ענף עם merge request פתוח ב-GitLab, מוצג תג לחיץ MR !N במיקום המיועד ל-PR (הסימון !N הוא תחביר ההפניה של GitLab לבקשת מיזוג מספר N). קו תחתי צבעוני מציין את המצב:

• ירוק: GitLab מדווח שהבקשה ניתנת למיזוג (mergeable).
• צהוב: כל מצב פתוח אחר.
• אפור: טיוטה (draft).

התג נעלם לאחר מיזוג או סגירה, ומתרענן לאחר git push או פקודת glab mr שמשנה את הבקשה (כגון glab mr create או glab mr merge).

דרישות לתג GitLab:

• גרסת קלוד קוד v2.1.234 ומעלה.
• מאגר מרוחק שמצביע למארח GitLab (בין אם gitlab.com ובין אם מופע פרטי בהתקנה עצמית).
• ה-CLI של glab מותקן ב-PATH ומאומת באמצעות glab auth login.

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

#קישורי הפניה ל-Issues

כאשר קלוד מציין issue בתבנית owner/repo#123, ניתן ללחוץ על ההפניה כדי לפתוח אותה, בתנאי שהטרמינל תומך בהיפר-קישורים. אם קלוד קוד אינו מזהה תמיכה כזו בטרמינל, מגדירים FORCE_HYPERLINK=1 להפעלת קישורים, או FORCE_HYPERLINK=0 להשארתם כטקסט רגיל.

קישור נוצר רק עבור תבנית שני החלקים owner/repo#123. המקרים הבאים נשארים טקסט רגיל:

• אזכור בודד של #123.
• נתיב GitLab מקונן כגון group/subgroup/project#123.
• אזכור בתוך קוד (code span או code block).

היעד של הקישור נבנה לפי המארח של המאגר שזוהה מתוך ה-remote ב-git, ולא לפי שם המאגר שמוזכר בהפניה: