מדריך · Headroom + קלוד קוד
Headroom לקלוד קוד: דחיסת קונטקסט שחוסכת טוקנים
Headroom הוא כלי קוד פתוח שיושב בין קלוד קוד למודל ומכווץ את כל מה שקלוד קורא: לוגים, קבצים, תוצאות חיפוש והיסטוריית שיחה. מתקינים אותו, מריצים headroom wrap claude, והכיווץ רץ אצלכם במחשב. בארבע בדיקות שפרסמו המפתחים החיסכון נע בין 21% ל-57% מהטוקנים (נכון לאוקטובר 2026).
מה זה Headroom?
אם אתם עובדים עם קלוד קוד כל יום, אתם מכירים את זה: סשן ארוך, הרבה קבצים, כמה הרצות של טסטים, ופתאום המכסה נגמרת או החשבון עולה. רוב הטוקנים האלה לא הולכים על השאלה שלכם. הם הולכים על מה שקלוד קורא בדרך.
Headroom הוא פרויקט קוד פתוח בגיטהאב שעושה דבר אחד: הוא מכווץ את כל מה שהסוכן קורא לפני שזה מגיע למודל. פלט של כלים, לוגים, קבצים, תוצאות חיפוש והיסטוריית השיחה. לפי ה-README שלו, התשובות נשארות אותן תשובות, רק עם חלק קטן מהטוקנים.
נכון ל-21 באוקטובר 2026 יש לפרויקט 76,736 כוכבים בגיטהאב, הגרסה האחרונה היא 0.41.0, והרישיון הוא Apache 2.0, כלומר חינם לשימוש גם בעבודה מסחרית.
לאן הולכים הטוקנים בקלוד קוד?
כל פעם שקלוד קוד מריץ פקודה, הוא קורא את כל מה שהיא מחזירה. טסט שנכשל יכול להחזיר מאות שורות לוג. חיפוש בקוד מחזיר עשרות תוצאות דומות. קובץ JSON גדול חוזר על אותו מבנה שוב ושוב. כל השורות האלה נכנסות לחלון ההקשר ונספרות כטוקנים, גם אם מה שקלוד באמת צריך זה שורה אחת של שגיאה.
בדמו של Headroom רואים את זה יפה: לוג של 10,144 טוקנים מתכווץ ל-1,260 טוקנים, ושורת ה-FATAL שהייתה צריכה להימצא עדיין שם, אותה שורה בדיוק. זה הרעיון כולו. לזרוק את החזרות ואת הרעש, ולהשאיר את מה שחשוב.
יש עוד דרכים לחסוך טוקנים בקלוד קוד, כמו לפתוח שיחה חדשה עם /clear כשעוברים למשימה אחרת, או לבחור מודל זול יותר למשימות פשוטות. כתבתי עליהן במדריך להרגלים שחוסכים טוקנים. Headroom משלים אותן: הוא לא משנה איך אתם עובדים, הוא מקטין את מה שעובר בצינור.
איך מתקינים את Headroom לקלוד קוד?
ההתקנה לוקחת כמה דקות, וצריך רק Python בגרסה 3.10 ומעלה על המחשב. אם אתם לא בטוחים מה זה אומר, תבקשו מקלוד קוד לבדוק לכם: "תבדוק איזו גרסה של פייתון מותקנת אצלי".
שלב 1: מתקינים את הכלי
הדרך שה-README ממליץ עליה היא דרך uv, שמתקין את הכלי בסביבה נפרדת ולא מתערבב עם שאר הדברים במחשב:
uv tool install --python 3.13 "headroom-ai[all]"אין לכם uv? אפשר גם עם pip הרגיל:
pip install "headroom-ai[all]"ולא בא לכם להתעסק עם הטרמינל? אפשר פשוט לבקש מקלוד קוד שיעשה את זה בשבילכם:
תתקין לי את Headroom לפי ה-README שלו בגיטהאב, headroomlabs-ai/headroom. תבדוק קודם שיש לי פייתון מתאים, ואם חסר משהו תסביר לי מה אתה מתקין ולמה.
שימו לב: יש גם חבילה בשם headroom-ai ב-npm, אבל היא ספרייה למפתחים בלבד ואין בה את הפקודה headroom. בשביל קלוד קוד צריך את ההתקנה מ-Python.
שלב 2: עוטפים את קלוד קוד
זאת הפקודה שעושה את כל העבודה. מריצים אותה מתוך התיקייה של הפרויקט:
headroom wrap claudeמה קורה מאחורי הקלעים? Headroom מרים שרת קטן על המחשב שלכם, מגדיר את קלוד קוד לשלוח את הבקשות דרכו, ופותח לכם את קלוד קוד כרגיל. כל מה שקלוד קורא עובר כיווץ בדרך החוצה. לפי ה-README, הפקודה גם מתקינה כלי בשם Serena שעוזר לקלוד לנווט בקוד, ורק לפרויקט הזה. לא רוצים אותו? מוסיפים --code-memory none.
חשוב: פותחים את קלוד קוד דרך הפקודה הזאת בכל פעם שרוצים שהחיסכון יעבוד. רוצים לחזור למצב הרגיל? גם זאת פקודה אחת:
headroom unwrap claudeשלב 3: בודקים שזה עובד
שתי פקודות שכדאי להכיר. הראשונה בודקת שהכול מחובר כמו שצריך, השנייה פותחת לוח בקרה בדפדפן עם החיסכון בזמן אמת (השרת של Headroom צריך לרוץ באותו זמן):
headroom doctor
headroom dashboard
כמה טוקנים Headroom באמת חוסך?
המפתחים פרסמו ארבע בדיקות שבנו מפלט אמיתי של כלים, ואפשר להריץ אותן בעצמכם ולקבל את אותם מספרים. אלה התוצאות, כפי שהן מופיעות ב-README נכון לאוקטובר 2026:
| תרחיש | לפני | אחרי | חיסכון |
|---|---|---|---|
| חיפוש בקוד (100 תוצאות) | 17,199 | 13,597 | 21% |
| דיבאג של תקלה בשרת | 55,957 | 24,340 | 57% |
| סיור בבסיס קוד | 58,801 | 33,895 | 42% |
| מיון באגים בגיטהאב | 46,067 | 32,429 | 30% |
אז ה-57% שאולי ראיתם בסרטון זה התרחיש הכי טוב מתוך הארבעה, לא ממוצע. ה-README עצמו כותב שהחיסכון תלוי בכמה התוכן חוזר על עצמו: לוגים ורשימות JSON ארוכות מתכווצים מאוד, וטקסט רגיל או קוד שכבר צפוף כמעט לא מתכווצים.
ומה עם הדיוק? זאת השאלה הכי חשובה, כי חיסכון שמקלקל תשובות לא שווה כלום. בבדיקת מתמטיקה של 100 שאלות (GSM8K) הציון היה 0.870 עם Headroom ובלעדיו, בדיוק אותו ציון. את המספר שנכון לכם מקבלים עם headroom savings על העבודה האמיתית שלכם.
איך Headroom לומד מהטעויות של קלוד?
זה החלק שהכי אהבתי. הפקודה headroom learn עוברת על סשנים קודמים, מוצאת איפה קלוד נכשל, למשל פקודה שהוא מריץ שוב ושוב בצורה הלא נכונה, וכותבת לו הוראות מתוקנות לקובץ. ככה בפעם הבאה הוא לא מבזבז טוקנים על אותה טעות.
headroom learnכברירת מחדל ההוראות נכתבות לקובץ CLAUDE.local.md, שלא עולה לגיטהאב, ואפשר לבחור גם את CLAUDE.md הרגיל. בדמו הרשמי הפקודה ניתחה 7 סשנים עם 104 כשלונות, וכל הוראה שהיא הציעה הגיעה עם הערכה של כמה טוקנים היא חוסכת בכל סשן, למשל בערך 1,200.
הניתוח עצמו רץ דרך מודל של קלוד, אז גם הוא צורך קצת טוקנים. שווה להריץ אותו פעם בכמה ימים, לא אחרי כל סשן.
למי Headroom מתאים?
- אתם עובדים עם קלוד קוד כמה שעות ביום, והמכסה נגמרת לכם באמצע
- אתם משלמים על טוקנים דרך API, וכל אחוז חיסכון מורגש בחשבון
- הסשנים שלכם מלאים בלוגים, טסטים, חיפושים וקבצי JSON
- אתם עובדים גם עם Codex או סוכנים אחרים, ורוצים כלי אחד שעוטף את כולם
חשוב לדעת לפני שמתחילים
- החיסכון משתנה. בארבע הבדיקות הרשמיות הוא נע בין 21% ל-57%. בשיחות קצרות או בכתיבת טקסט כמעט לא תרגישו הבדל, וה-README אומר את זה בעצמו.
- הכיווץ מקומי, השאלה לא. הכיווץ רץ אצלכם ושום קובץ לא נשלח למקום אחר כדי להתכווץ. אבל הבקשה המכווצת עדיין נשלחת לקלוד כרגיל.
- מערכת הפעלה. יש התקנות מוכנות למק עם מעבד של אפל, ללינוקס ולווינדוס. במק ישן עם מעבד אינטל ה-README מתאר שלבים נוספים, ושם הכי פשוט להשתמש ב-Docker.
- עלות. הכלי חינמי וקוד פתוח. יש גם גרסה בתשלום לצוותים בשם Headroom Enterprise, ולשימוש אישי לא צריך אותה.
- צריך להיזכר לעטוף. החיסכון עובד רק כשפותחים את קלוד קוד דרך
headroom wrap claude. סשן שנפתח בדרך הרגילה לא עובר דרכו. - פרויקט צעיר שזז מהר. הגרסה עדיין לפני 1.0, אז פקודות יכולות להשתנות.
headroom updateמעדכן לגרסה האחרונה.
השורה התחתונה
Headroom לא משנה איך אתם עובדים. הוא מוריד את הרעש ממה שקלוד קורא, ובסשנים ארוכים עם הרבה לוגים זה מצטבר לחיסכון שמרגישים.
שאלות נפוצות על Headroom וחיסכון בטוקנים
האם Headroom חינמי?
כן. Headroom הוא קוד פתוח ברישיון Apache 2.0, ומתקינים אותו בחינם. יש גרסה בתשלום לצוותים בשם Headroom Enterprise, אבל לשימוש אישי עם קלוד קוד לא צריך אותה.
Headroom פוגע באיכות התשובות של קלוד?
לפי הבדיקות שפורסמו ב-README, לא נמצא הבדל: במבחן מתמטיקה של 100 שאלות הציון היה 0.870 עם Headroom ובלעדיו. הכלי שומר את המקור אצלכם במחשב, וקלוד יכול לבקש את הטקסט המלא כשהוא צריך אותו.
כמה טוקנים זה באמת חוסך?
בארבע הבדיקות הרשמיות החיסכון היה בין 21% ל-57%, נכון לאוקטובר 2026. לוגים וקבצי JSON מתכווצים הכי הרבה, וטקסט רגיל כמעט לא. הפקודה headroom savings מראה לכם את המספר על העבודה שלכם.
הקבצים שלי נשלחים לשרת של Headroom?
לא. לפי ה-README, הכיווץ רץ על המחשב שלכם ושום תוכן לא נשלח למקום אחר כדי להתכווץ. הבקשה המכווצת ממשיכה לקלוד בדיוק כמו קודם.
איך מבטלים את Headroom?
מריצים headroom unwrap claude, והגדרות קלוד קוד חוזרות למה שהיה לפני. מעכשיו פותחים את קלוד קוד בדרך הרגילה.