📘 תיעוד 121

ניהול עלויות ביעילות

עקבו אחרי שימוש בטוקנים, הגדירו מגבלות הוצאה לצוות, והפחיתו את עלויות Claude Code באמצעות ניהול הקשר, בחירת מודל, הגדרות חשיבה מורחבת, ו-hooks של עיבוד מקדים.

Claude Code גובה לפי צריכת טוקנים של ה-API. למחירי תוכניות מנוי (Pro, Max, Ultra, Team, Enterprise), ראו claude.com/pricing. העלות לכל מפתח משתנה במידה רבה לפי בחירת המודל, גודל בסיס הקוד, ודפוסי שימוש כגון הרצת כמה מופעים או אוטומציה.

בפריסות ארגוניות, העלות הממוצעת היא בערך $13 למפתח ליום פעיל ו-$150-250 למפתח לחודש, והעלויות נשארות מתחת ל-$30 ליום פעיל עבור 90% מהמשתמשים. כדי להעריך הוצאה לצוות שלכם, התחילו בקבוצת פיילוט קטנה והשתמשו בכלי המעקב שלהלן כדי לקבוע קו בסיס לפני פריסה רחבה יותר.

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

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

#שימוש בפקודה /usage

[!NOTE]

בלוק ה-Session ב-/usage מציג שימוש בטוקנים של ה-API ומיועד למשתמשי API. למנויי Claude Pro, Max ו-Ultra השימוש כלול במנוי, ולכן נתון עלות הסשן אינו רלוונטי לצורכי חיוב. מנויים רואים פסי שימוש בתוכנית, סטטיסטיקות פעילות, ופירוט שימוש באותו מסך.

בלוק ה-Session בראש /usage מציג סטטיסטיקות מפורטות של שימוש בטוקנים לסשן הנוכחי.

Claude Code מחשב את סכום הדולרים באופן מקומי מספירות הטוקנים לפי מחיר מחירון, אלא אם טבלת modelPricing בתוקף. מנהל מגדיר אחת בהגדרות המנוהלות של הארגון כדי שהסכום ישתמש בתעריפים החוזיים שלכם, וכל עוד טבלה בתוקף שורת Total cost נושאת את ההערה at your organization's configured rates. הסכום הוא הערכה, ולכן לחיוב סמכותי ראו ניהול עלויות לארגון שלכם.

Total cost:            $0.55
Total duration (API):  6m 20s
Total duration (wall): 6h 33m 10s
Total code changes:    0 lines added, 0 lines removed
Usage by model:
   claude-sonnet-4-6:  1.2k input, 5.3k output, 940.0k cache read, 50.0k cache write ($0.55)

הסכומים האלה מתאפסים כש-/clear מתחיל סשן חדש, כך שעלות הסשן הבא מתחילה ב-$0. לפני v2.1.211, הם המשיכו להצטבר מעבר ל-/clear למשך חיי תהליך Claude Code.

לתשובה מ-Claude API שמחויבת בתעריף 1.1× של תמחור data residency, Claude Code מכפיל את מחיר המחירון של הטוקנים של אותה תשובה ב-1.1 בנתון עלות הסשן. אותו סכום מופיע בשדה העלות בשורת הסטטוס, והסכום המוכפל נספר גם לקראת --max-budget-usd.

#סטטיסטיקות של מטמון הפרומפט

אחרי תשובת ה-API הראשונה של השיחה הראשית, Claude Code מוסיף גם שורת Prompt cache (main) לבלוק ה-Session, שמסכמת את השימוש של הסשן במטמון פרומפט: מספר הבקשות, החלק של טוקני הקלט שסופקו מהמטמון, החטאות מטמון, והאם המטמון חם כרגע. נדרש Claude Code v2.1.251 או מאוחר יותר.

Prompt cache (main):   14 requests · 91% of input tokens from cache · 2 misses (last 6m 10s ago, 310.2k tokens re-cached) · 1 expected rebuild (compaction or tool-result clearing) · warm (1h TTL, last activity 40s ago)

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

• Misses: בקשות שעיבדו מחדש תוכן שהמטמון כבר החזיק, עם הזמן של ההחטאה האחרונה וכמה טוקנים הבקשות האלה כתבו בחזרה למטמון. פעולות שמבטלות את המטמון מפרטות את הסיבות הרגילות. כש-Claude Code יכול לזהות סיבה סבירה להחטאה האחרונה, השורה מציינת גם אותה, לדוגמה likely cause: tool definitions changed. טקסט הסיבה הסבירה דורש Claude Code v2.1.260 או מאוחר יותר.
• Expected rebuilds: כש-Claude Code עצמו כתב מחדש את השיחה זה עתה, באמצעות דחיסה או באמצעות ניקוי תוצאות כלים ישנות מההקשר, הוא סופר את אותו סוג החטאה כבנייה מחדש צפויה במקום זאת. החלק הזה מופיע רק אחרי שלפחות בנייה מחדש צפויה אחת התרחשה.
• Warm or cold: האם הקידומת שנשמרה במטמון עדיין בתוך משך חיי המטמון שלה, עם ה-TTL שבתוקף. כשהמטמון קר, השורה מראה כמה זמן הסשן היה לא פעיל. כשאף תשובה לא דיווחה על טוקני מטמון, השורה מסתיימת ב-no prompt caching reported by the API במקום זאת.

הספירות מגיעות משדות טוקני המטמון בתשובות ה-API, ולכן השורה עובדת בכל ספק ושער. היא מכסה את השיחה הראשית בלבד, לא subagents. /clear מאפס אותה עם שאר בלוק ה-Session.

סקריפטים של שורת הסטטוס יכולים לקרוא את אותם מספרים מאובייקט prompt_cache.

#פירוט שימוש בתוכנית

בתוכנית Pro, Max, Ultra, Team או Enterprise, /usage מציג גם פירוט של מה שנמנה מול מגבלות התוכנית, עם המלצות:

• Attribution: שימוש אחרון שמיוחס ל-skills, ל-subagents, לתוספים, ולשרתי MCP בודדים, וכל אחד מוצג כאחוז מהסך. החלק של שרת MCP נספר רק לבקשות שצרכו אחת מתוצאות הכלים שלו. לפני v2.1.222, אחרי קריאה אחת לשרת MCP, Claude Code ייחס כל בקשה לאחר מכן לאותו שרת, והפריז בחלקו.
• Recommendations: שינויים מוצעים, אחד בכל שורה. כל שורה מתחילה בחלק מהשימוש האחרון שלכם, לפחות 10%, כמו ב-25% Trim ~/code/api/CLAUDE.md · 49k tokens per request.
  • איך לקרוא את החלק: הוא אומר לכם על כמה מהשימוש שלכם השורה חלה, לא כמה השינוי חוסך. בקשה אחת יכולה להיספר לכמה שורות, ולכן החלקים יכולים להסתכם ביותר מ-100%.
  • איך ליישם המלצות: כדי ש-Claude Code יישם את אלה שהוא יכול, ראו יישום המלצות עם קיצור התיקון
• Loops: שורה לכל אחת מהמשימות המתוזמנות הכבדות ביותר ברמת הסשן מסוג /loop או אחרות שרצו לאחרונה, מסודרות לפי סך הטוקנים, עם ספירה של השאר. נדרש Claude Code v2.1.242 או מאוחר יותר.
  • מה כל שורה מדווחת: כמה פעמים המשימה מופעלת, כמה פעמים היא רצה, הטוקנים הכוללים ולכל הרצה, ומתי היא רצה לאחרונה
  • לולאות שנעצרו ונוצרו מחדש: Claude Code ממפתח שורה לפי הפרומפט של המשימה, כך שלולאה שאתם עוצרים ויוצרים מחדש נשארת שורה אחת

לחצו d או w כדי לעבור בין 24 השעות האחרונות ל-7 הימים האחרונים. הנתונים מקורבים ומחושבים מהיסטוריית הסשנים המקומית במכונה הזו, ולכן שימוש ממכשירים אחרים או מ-claude.ai אינו כלול.

בתוסף VS Code, חלקי הייחוס וההמלצות מופיעים בתיבת הדו-שיח Account & usage עם מתג Day ו-Week, בלי שורות ה-Loops.

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

כשכותרת התחתונה של /usage מציגה רמז כמו f to fix 2 of 3, לחצו f כדי ש-Claude Code יפעל על ההמלצות שהוא יכול. קיצור f דורש Claude Code v2.1.305 או מאוחר יותר.

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

כדי לראות מה לחיצה על f עושה עם כל אחת מהשורות שלכם, מצאו את צורת השורה בעמודה הראשונה:

ב-f to fix 2 of 3, המספר הראשון סופר את השורות ש-Claude Code פועל עליהן כשלוחצים f, והשני סופר את השורות שמוצגות. רמז בלי of בתוכו, כמו f to fix both, אומר ש-Claude Code פועל על כל שורה שמוצגת.

בזמן ש-Remote Control מחובר, הכותרת התחתונה לא מציגה רמז f. אם לחיצה על f סוגרת את /usage עם Nothing was sent. Turn off Remote Control to use fixes., Remote Control התחבר בזמן ש-/usage היה פתוח. כדי להשתמש ב-f שוב, נתקו את Remote Control, ואז הריצו /usage בשורת הפקודה של Claude Code ולחצו f שוב.

#בדיקת ההוצאה על usage credits

/usage מציג גם שורת usage credits בזמן ש-usage credits פועלים. מה שהשורה מציגה תלוי בתוכנית:

• Pro, Max, and Ultra: ההוצאה שלכם לחודש הנוכחי, שנמדדת מול מגבלת ההוצאה החודשית כשהגדרתם אחת. כשלא הגדרתם מגבלה, השורה מציגה Unlimited ובלי נתון הוצאה.
• Team and Enterprise: ההוצאה שלכם לחודש הנוכחי, שנמדדת מול כל מגבלה שהארגון שלכם הגדיר שחלה עליכם. מגבלה שמכסה את כל הארגון לא מופיעה בשורה. כשאין לכם מגבלה משלכם, השורה מציגה את ההוצאה שלכם בלי מגבלה לצדה. בזמן ש-usage credits כבויים עבורכם, /usage לא מציג שורת usage credits.

כשיש לכם מגבלת הוצאה, השורה מופיעה ברגע ש-usage credits פועלים ומציגה 0% עד שאתם מוציאים usage credits בפעם הראשונה. לפני v2.1.236, /usage הציג את השורה רק בתוכניות Pro, Max ו-Ultra, ושורה עם מגבלת הוצאה נשארה מוסתרת עד שהוצאתם משהו.

#כשהבקשה לשימוש נכשלת

כשהבקשה למגבלות התוכנית נכשלת, לרוב כי נקודת הקצה של השימוש מוגבלת בקצב, /usage מציג את פסי השימוש האחרונים שהוא טען במכונה הזו בתוך 60 הדקות האחרונות, יחד עם הערה Showing last-known usage שמציינת לפני כמה זמן הנתונים האלה נשלפו. לחצו r כדי לנסות שוב. ניסיון מוצלח מחליף את הפסים הידועים האחרונים בנתונים טריים. בלי צילום מצב מ-60 הדקות האחרונות, /usage מדווח שנקודת הקצה של השימוש מוגבלת בקצב ומציע את אותו קיצור לניסיון חוזר. לפני v2.1.208, בקשה מוגבלת בקצב בסשן שעדיין לא טען שימוש תמיד הציגה את השגיאה בלי פסים.

הודעה כמו rate limited until 3:14am ב-/usage אומרת ש-Claude Code לא יכול לשלוף שוב את מגבלות התוכנית עד אז, לא שהעבודה שלכם עם Claude מוגבלת. אם תלחצו r מוקדם יותר, צפו לאותה הודעה. לחצו r אחרי הזמן הזה לנתונים טריים.

#קריאת ספירת הטוקנים ליד הספינר

בזמן ש-Claude עובד בשיחה הראשית, השורה ליד הספינר יכולה להסתיים בזמן שחלף ובספירת טוקנים, כמו ב-Deciphering… (10m 27s · ↓ 5.5k tokens). זו ספירה חיה ומקורבת של הפלט שהתור הנוכחי ייצר עד כה. החץ ליד הספירה מצביע למטה בזמן שפלט מגיע או שכלים רצים.

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

הוא לא יתאים לנתוני הפלט של Usage by model בבלוק ה-Session של /usage, שמסכמים את כל הסשן ולא תור אחד. הוא גם שונה מספירת הטוקנים שמצב verbose מוסיף, כי הספירה הזו מודדת את גודל ההקשר שלכם ולא את הפלט של תור אחד.

#ניתוח דפוסי השימוש שלכם

הריצו /insights לדוח על איך אתם עובדים ולא על כמה טוקנים השתמשתם. הוא מנתח את הסשנים האחרונים שלכם במכונה הזו וכותב דוח HTML שמכסה על מה אתם עובדים, נקודות חיכוך כגון בקשות שהובנו לא נכון או קוד עם באגים, והצעות לשימוש יעיל יותר ב-Claude Code. הרצה אחת מנתחת עד 200 סשנים שהיא לא ראתה קודם ומדלגת על סשנים קצרים מאוד. כשסשנים מושמטים, כותרת הדוח מציגה את מספר הסשנים שנותחו עם הסך בסוגריים, לדוגמה 200 sessions (412 total).

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

Claude Code כותב את הדוח האחרון אל ~/.claude/usage-data/report.html ושומר עותק עם חותמת זמן של כל הרצה באותה תיקייה, כך שדוחות קודמים לא נדרסים. Claude Code מוחק דוחות באותו לוח זמנים כמו שאר נתוני הסשן: בהפעלה, הוא מסיר קבצים ישנים מ-cleanupPeriodDays, 30 ימים כברירת מחדל.

אפשר להריץ /insights בכל תוכנית ועם כל ספק. הניתוח רץ דרך אותו ספק ואותו חשבון כמו הסשנים הרגילים שלכם, והטוקנים נספרים מול התוכנית או שימוש ה-API. סשנים ממכשירים אחרים ומ-claude.ai אינם כלולים.

#הוספת usage credits למנוי

Usage credits מאפשרים להמשיך לעבוד מעבר למגבלת השימוש של התוכנית. כדי לנהל אותם, הריצו /usage-credits אחרי התחברות עם מנוי claude.ai דרך /login. הפקודה אינה זמינה עם אימות מפתח API. בארגוני Enterprise בשירות עצמי, בניסיונות Enterprise, ובארגוני Enterprise שמחויבים דרך AWS Marketplace, הפקודה דורשת Claude Code v2.1.248 או מאוחר יותר. גרסאות קודמות דוחות אותה עם Unknown command: /usage-credits. מה שנפתח תלוי בתפקיד שלכם:

לחברי Team ו-Enterprise בלי גישת חיוב, האישור מופיע רק בסשנים אינטראקטיביים: במצב לא אינטראקטיבי עם הדגל -p ומ-Remote Control, הפקודה לא שולחת בקשה ואומרת להריץ אותה בסשן אינטראקטיבי.

אם מריצים /usage-credits שוב בזמן שהבקשה הקודמת ממתינה למנהל, Claude Code אומר שכבר נשלחה בקשה במקום לשלוח כפילות. אחרי שמנהל דוחה את הבקשה, הרצת הפקודה שוב שולחת בקשה חדשה. לפני v2.1.222, בקשה שנדחתה גם חסמה בקשות חדשות.

בתוכניות Pro, Max ו-Ultra, כשמגיעים למגבלת ההוצאה ונשארו usage credits, Claude Code מבקש להעלות או להסיר את המגבלה בלי לצאת מה-CLI. אם השרת דוחה את השינוי, ראו לא ניתן היה לעדכן את מגבלת ההוצאה.

#ניהול עלויות לארגון

הבקרות שעומדות לרשותך תלויות באופן שבו הארגון ניגש אל Claude Code: תוכנית Claude for Teams או Enterprise, ה-Claude Console, או ספק ענן. בתוכניות Teams ו-Enterprise השימוש נמשך ממכסת המושב של כל חבר. ב-Console ואצל ספקי ענן השימוש מחויב לפי טוקן לארגון. אם הארגון מערבב שיטות כניסה, כל מפתח נמדד לפי השיטה שבה הוא ביצע אימות.

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

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

#דיווח הוצאה לפי התעריפים החוזיים שלך

כברירת מחדל, Claude Code מחשב כל נתון עלות שהוא מציג למפתחים לפי מחיר מחירון. לכן, אם הארגון משלם תעריפים חוזיים, המספרים ב-/usage, בשורת המצב וב-OpenTelemetry לא תואמים לחשבונית. כדי שיתאימו, הגדר את הגדרת הניהול modelPricing לתעריפים שלך. ההגדרה משנה את מה ש-Claude Code מדווח, לא את מה ש-Anthropic גובה. נדרש Claude Code בגרסה v2.1.242 או חדשה יותר.

1. קח את התעריפים מהחוזה

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

2. כתוב את ההגדרה

הגדר את multiplier מתחת ל-1 להנחה אחידה או מעל 1 לתוספת מחיר, רשום את ארבעת התעריפים לכל טוקן של כל מודל תחת overrides, או עשה את שניהם. תוספת מחיר דורשת Claude Code בגרסה v2.1.271 או חדשה יותר. לערך modelPricing יש את המבנה ודוגמה מוכנה להדבקה.

3. פרוס אותו דרך הגדרות מנוהלות

מסור אותו כהגדרות מנוהלות: הגדרות שמנוהלות בשרת, מדיניות MDM, managed-settings.json, או עוזר מדיניות. Claude Code מתעלם מהמפתח בהגדרות משתמש, פרויקט ומקומיות, וב---settings.

כדי לוודא שהתעריפים בתוקף, הרץ את /usage בסשן שקיבל את ההגדרות המנוהלות: שורת Total cost בבלוק Session נושאת את ההערה at your organization's configured rates. המספרים עדיין הערכות, לא חשבונית. מחירי המיליון טוקנים בבורר /model נשארים במחיר מחירון.

#Claude for Teams ו-Enterprise

בתוכניות Claude for Teams ו-Enterprise, השימוש של כל חבר ב-Claude Code נמשך ממכסה לכל מושב שמתאפסת בחלון מתגלגל של חמש שעות ובחלון שבועי. המכסה משותפת עם Claude chat ועם Cowork, וגודלה תלוי בדרגת המושב של החבר (Standard או Premium). הבקרות נמצאות במסוף הניהול של claude.ai, לא ב-Claude Console.

• צפייה בהוצאה: דוח ההוצאות באנליטיקה של הארגון מציג הוצאה משוערת לכל משתמש ולכל מודל, עם ייצוא CSV, ומתעדכן מדי יום. הדוח מכסה הוצאה של קרדיטי שימוש ומופיע אחרי שקרדיטי השימוש מופעלים. שימוש בתוך מכסת המושב לא נמדד בדולרים.
• צפייה באימוץ: לוח האנליטיקה מציג משתמשים פעילים יומיים, סשנים ומדדי תרומה, עם ייצוא CSV של נתוני תרומה. ראה מעקב אחרי שימוש הצוות עם אנליטיקה.
• הגבלת הוצאה: מכסת המושב היא התקרה כברירת מחדל. כדי לאפשר לחברים להמשיך מעבר לה, הפעל קרדיטי שימוש והגדר מגבלות הוצאה ברמת הארגון, הקבוצה או החבר הבודד.
• שליפת מספרים לכל משתמש: בתוכנית Enterprise, ה-Enterprise Analytics API מחזיר דוחות שימוש ועלות לכל משתמש בכל משטחי Claude, כולל Claude Code. Primary Owner יוצר מפתח עם ההיקף read:analytics ב-claude.ai/analytics/api-keys. בתוכנית Teams, ייצא את CSV של דוח ההוצאות, שמפרט שימוש בטוקנים והוצאה משוערת לכל משתמש ולכל מודל.

מדריך הצריכה של Claude Enterprise הוא מקור התכנון למנהלים. הוא מסביר איך הצריכה שונה בין Claude chat, Claude Code ו-Cowork, ונותן נקודות פתיחה בדולרים לכל משתמש לצורך תקצוב. תקצב יותר למושב קידוד מאשר למושב צ'אט: כל תור ב-Claude Code נושא תוכן קבצים, קריאות כלים והיסק רב שלבי, ולכן סשן ניפוי שגיאות אחד יכול לצרוך יותר מיום של צ'אט.

#Claude Console

ארגוני API מנהלים את הוצאת Claude Code דרך workspaces. אפשר להגדיר מגבלות הוצאה של workspace על סך הוצאת Claude Code ולצפות בדיווח עלות ושימוש ב-Console.

[!NOTE]

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

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

לדיווח לכל משתמש, לוח הבקרה של Console מציג הוצאה ושורות שהתקבלו לכל חבר, וה-Claude Code Analytics API מחזיר מדדים יומיים לכל משתמש באופן תכנותי עם מפתח Admin API. ראה אנליטיקה ללקוחות API.

#המלצות למגבלת קצב

כשמגדירים את Claude Code לצוותים, שקול את ההמלצות האלה לכל משתמש עבור Token Per Minute (TPM) ו-Request Per Minute (RPM), לפי גודל הארגון:

לדוגמה, אם יש 200 משתמשים, אפשר לבקש 20k TPM לכל משתמש, או 4 מיליון TPM בסך הכל (200*20,000 = 4 million).

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

[!NOTE]

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

#ספקי ענן

ב-Amazon Bedrock, ב-Agent Platform של Google Cloud וב-Microsoft Foundry, Claude Code מחויב לפי טוקן לחשבון הענן שלך, ובקרות ההוצאה נמצאות במסוף החיוב של ספק הענן. Claude Code לא שולח מדדים מהענן שלך בחזרה אל Anthropic, ולכן לוחות האנליטיקה וה-Claude Code Analytics API לא מכסים את השימוש הזה.

לייחוס עלות לכל משתמש יש שלוש אפשרויות:

• OpenTelemetry: ייצוא מדדים מהמחשב של כל מפתח אל מחסנית התצפית שלך. זה נותן ספירות טוקנים, עלויות ופעילות כלים לכל משתמש, בלי תלות בספק.
• שער אפליקציות Claude: שער אפליקציות Claude שמתארח אצלך מספק ייחוס שימוש לכל משתמש, מדדי OTLP עם ספירות טוקנים, ומגבלות הוצאה לכל משתמש אצל הספקים האלה.
• שער LLM: ניתוב כל תעבורת Claude Code דרך פרוקסי שעוקב אחרי הוצאה לכל מפתח. כמה ארגונים גדולים דיווחו שהם משתמשים ב-LiteLLM, כלי בקוד פתוח שעוקב אחרי הוצאה לפי מפתח. הפרויקט הזה לא קשור ל-Anthropic ולא עבר ביקורת אבטחה.

#כשמפתח שואל על מגבלה

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

• "You've hit your session limit" או "You've hit your weekly limit": חלון שימוש מבוסס מושב בתוכנית מנוי, משותף לכל המודלים, ולכן המפתח לא יכול להחזיר גישה על ידי החלפת מודל עם /model. ההודעה מציגה מתי החלון מתאפס. אחרי ההודעה הספציפית למודל "You've hit your Opus limit" או "You've hit your Sonnet limit", מעבר עם /model למודל מחוץ למשפחה הזו כן משאיר את המפתח בעבודה. ראה שגיאות מגבלת שימוש. מה שהמפתח יכול לעשות בינתיים:
  • להריץ את /usage-credits כדי לבקש שימוש מעבר למכסה, אם קרדיטי שימוש מופעלים אצלך.
  • ב-Claude Code בגרסה v2.1.234 או חדשה יותר, להמתין ולהמשיך את המשימה שהופסקה באופן אוטומטי אחרי האיפוס. הסעיף הזה מפרט מתי Claude Code מתחיל את ההמתנה בעצמו ומתי המפתח בוחר אותה מ-/rate-limit-options. כדי לשלוט עבור הצי אם Claude Code מתחיל את ההמתנה הזו בעצמו, הגדר את autoContinueAtUsageLimit בהגדרות מנוהלות.
• "You've hit your individual spend limit", "org's monthly spend limit", או "team's shared budget": הבקשה של המפתח הייתה מחויבת לקרדיטי שימוש, והקרדיטים האלה הגיעו למגבלת הוצאה שהגדרת. כדי לאפשר למפתח להמשיך, עבור אל Organization settings > Usage והגדל את המגבלה שההודעה מציינת. כשההודעה מציינת גם זמן איפוס של התוכנית, המפתח יכול במקום זאת להמתין עד אז. ראה את מאגר השגיאות לכל וריאנט.
• הודעת מגבלת הוצאה משער אפליקציות Claude: המפתח עבר תקרת הוצאה שהגדרת בשער המתארח אצלך, והשער חוסם את הבקשות עד שהתקופה מתאפסת או עד שמעלים את התקרה. ראה מגבלות הוצאה של השער לתקרות, ללוחות איפוס ולהודעה שהמפתח רואה.
• אזהרת הקשר או auto-compact: זו לא מגבלת שימוש. השיחה גדלה ומתקרבת לחלון ה-auto-compact של הסשן, הסף שבו Claude Code מסכם היסטוריה ישנה יותר כדי לפנות מקום. הפנה את המפתח אל הפחתת שימוש בטוקנים.
• הוצאה גבוהה באופן לא צפוי בתוכנית API או אצל ספק ענן: בדרך כלל נובעת מסשנים ארוכים שלא נוקו, או מ-Opus שנשאר מודל ברירת המחדל. ההרגלים בעלי ההשפעה הגבוהה ביותר לשיתוף הם ניקוי בין משימות לא קשורות והתאמת המודל לעבודה, ושניהם מכוסים בהפחתת שימוש בטוקנים.

#עלויות טוקנים של צוות סוכנים

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

כדי לשמור על עלויות צוות הסוכנים ניתנות לניהול:

• השתמש ב-Sonnet לחברי צוות. הוא מאזן בין יכולת לעלות במשימות תיאום.
• שמור על צוותים קטנים. כל חבר צוות מריץ חלון הקשר משלו, ולכן השימוש בטוקנים בערך פרופורציונלי לגודל הצוות.
• שמור על הנחיות spawn ממוקדות. חברי הצוות טוענים את CLAUDE.md, שרתי MCP ומיומנויות באופן אוטומטי, אבל כל מה שנמצא בהנחיית ה-spawn מתווסף להקשר שלהם מההתחלה.
• כבה חברי צוות כשהעבודה שלהם הסתיימה. כל חבר צוות פעיל ממשיך לצרוך טוקנים עד שהוא יוצא או עד שהסשן מסתיים.
• צוותי סוכנים מושבתים כברירת מחדל. הגדר את CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 ב-settings.json או בסביבה כדי להפעיל אותם. ראה הפעלת צוותי סוכנים.

#צמצום שימוש בטוקנים

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

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

#ניהול הקשר באופן יזום

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

• ניקוי בין משימות: השתמשו ב-/clear כדי להתחיל מחדש כשעוברים לעבודה לא קשורה. הקשר ישן מבזבז טוקנים בכל הודעה לאחר מכן. השתמשו ב-/rename לפני הניקוי כדי שתוכלו למצוא את הסשן אחר כך, ואז ב-/resume כדי לחזור אליו.
• הוספת הוראות דחיסה מותאמות: /compact Focus on code samples and API usage אומר לקלוד מה לשמר במהלך הסיכום.

אפשר גם להתאים את התנהגות הדחיסה בקובץ CLAUDE.md בשורש הפרויקט:

# Compact instructions

When you are using compact, please focus on test output and code changes

#בחירת המודל המתאים

Sonnet מטפל היטב ברוב משימות התכנות ועולה פחות מ-Opus. שמרו את Opus להחלטות ארכיטקטורה מורכבות או לחשיבה מרובת שלבים. השתמשו ב-/model כדי להחליף מודל באמצע סשן, או הגדירו ברירת מחדל ב-/config. מעבר ל-Opus חל גם על סוכני המשנה שיורשים את מודל הסשן. למשימות פשוטות של סוכן משנה, ציינו model: haiku בהגדרת סוכן המשנה.

#הפחתת תקורה של שרתי MCP

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

• העדפת כלי CLI כשהם זמינים: כלים כמו gh, aws, gcloud ו-sentry-cli עדיין יעילים יותר בהקשר משרתי MCP, כי הם לא מוסיפים רישום לכל כלי. קלוד יכול להריץ פקודות CLI ישירות.
• השבתת שרתים שלא בשימוש: הריצו /mcp כדי לראות את השרתים המוגדרים והשביתו כל שרת שאינכם משתמשים בו באופן פעיל.

#התקנת תוספי בינת קוד לשפות עם טיפוסים

תוספי בינת קוד נותנים לקלוד ניווט סמלים מדויק במקום חיפוש מבוסס טקסט, ומפחיתים קריאות קבצים מיותרות כשחוקרים קוד לא מוכר. קריאת "go to definition" אחת מחליפה מה שעלול להיות אחרת grep ואחריו קריאה של כמה קבצי מועמדים. שרתי שפה מותקנים גם מדווחים על שגיאות טיפוס אוטומטית אחרי עריכות, כך שקלוד תופס טעויות בלי להריץ מהדר.

#העברת עיבוד ל-hooks ול-skills

hooks מותאמים יכולים לעבד נתונים מראש לפני שקלוד רואה אותם. במקום שקלוד יקרא קובץ לוג של 10,000 שורות כדי למצוא שגיאות, hook יכול להריץ grep על ERROR ולהחזיר רק שורות תואמות, ולהפחית את ההקשר מעשרות אלפי טוקנים למאות.

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

לדוגמה, ה-hook הזה מסוג PreToolUse מסנן פלט בדיקות כך שיוצגו רק כשלונות:

settings.json

הוסיפו זאת ל-settings.json כדי להריץ את ה-hook לפני כל פקודת Bash:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/filter-test-output.sh"
          }
        ]
      }
    ]
  }
}

filter-test-output.sh

ה-hook קורא לסקריפט הזה. צרו את התיקייה עם mkdir -p ~/.claude/hooks, שמרו את הסקריפט למטה כ-~/.claude/hooks/filter-test-output.sh, והפכו אותו לניתן להרצה עם chmod +x ~/.claude/hooks/filter-test-output.sh. הוא בודק אם הפקודה היא מריץ בדיקות ומשנה אותה כך שתציג רק כשלונות:

#!/bin/bash
input=$(cat)
cmd=$(echo "$input" | jq -r '.tool_input.command')

# If running tests, filter to show only failures
pattern='^(npm test|pytest|go test)( [^;&|<>`$#\\[:cntrl:]]*)?$'
if [[ "$cmd" =~ $pattern ]]; then
  filtered_cmd="$cmd 2>&1 | grep -A 5 -E '(FAIL|ERROR|error:)' | head -100"
  echo "$input" | jq --arg filtered "$filtered_cmd" \
    '{hookSpecificOutput: {hookEventName: "PreToolUse", updatedInput: (.tool_input + {command: $filtered})}}'
else
  echo "{}"
fi

כדי לאמת את ההגדרה, הריצו /hooks ובדקו שה-hook מופיע תחת PreToolUse. אפשר גם להפעיל את Claude Code עם claude --debug-file ./claude-debug.txt ולבקש מקלוד להריץ npm test. כשה-hook משכתב את הפקודה, קובץ הלוג הזה מכיל שורה modified tool input keys שמפרטת את command ואת שאר שדות הקלט של Bash.

#העברת הוראות מ-CLAUDE.md אל skills

קובץ CLAUDE.md נטען להקשר בתחילת הסשן. אם הוא מכיל הוראות מפורטות לתהליכי עבודה מסוימים (כמו סקירות PR או מיגרציות מסד נתונים), הטוקנים האלה נוכחים גם כשעושים עבודה לא קשורה. Skills נטענים לפי דרישה רק כשמפעילים אותם, כך שהעברת הוראות מתמחות אל skills שומרת על הקשר הבסיסי קטן יותר. שאפו לשמור את CLAUDE.md מתחת ל-200 שורות על ידי הכללת היסודות בלבד.

#התאמת חשיבה מורחבת

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

למשימות פשוטות יותר שבהן אין צורך בחשיבה עמוקה, אפשר להפחית עלויות על ידי הורדת רמת המאמץ עם /effort או ב-/model, או על ידי השבתת החשיבה ב-/config. אי אפשר לכבות חשיבה ב-Opus 5.5, Sonnet 5.5, Haiku 5.5 או במודלי Fable, שתמיד משתמשים בחשיבה מורחבת.

במודלים עם תקציב חשיבה קבוע, אפשר גם להוריד את התקציב על ידי הגדרת משתנה הסביבה MAX_THINKING_TOKENS, לדוגמה MAX_THINKING_TOKENS=8000. מודלי חשיבה מסתגלת מתעלמים מתקציבים שאינם אפס, אז השתמשו שם ברמות מאמץ.

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

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

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

#ניהול עלויות צוות סוכנים

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

#כתיבת הנחיות ספציפיות

בקשות מעורפלות כמו "improve this codebase" מפעילות סריקה רחבה. בקשות ספציפיות כמו "add input validation to the login function in auth.ts" מאפשרות לקלוד לעבוד ביעילות עם מינימום קריאות קבצים.

#עבודה יעילה במשימות מורכבות

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

• שימוש במצב תוכנית למשימות מורכבות: לחצו Shift+Tab כדי לעבור למצב תוכנית לפני המימוש. קלוד חוקר את בסיס הקוד ומציע גישה לאישור שלכם, ומונע עבודה חוזרת יקרה כשהכיוון הראשוני שגוי.
• תיקון כיוון מוקדם: אם קלוד מתחיל ללכת בכיוון שגוי, לחצו Escape כדי לעצור מיד. השתמשו ב-/rewind או בלחיצה כפולה על Escape כדי להחזיר את השיחה והקוד לנקודת ביקורת קודמת.
• מתן יעדי אימות: כללו מקרי בדיקה, הדביקו צילומי מסך, או הגדירו פלט צפוי בהנחיה. כשקלוד יכול לאמת את העבודה שלו, הוא תופס בעיות לפני שצריך לבקש תיקונים.
• בדיקה הדרגתית: כתבו קובץ אחד, בדקו אותו, ואז המשיכו. זה תופס בעיות מוקדם.

#שימוש בטוקנים ברקע

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

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

#למה השימוש עולה בסשן ארוך

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

• הקשר ארוך: Claude Code שולח את כל השיחה עם כל בקשה, ובכל פעם שקלוד משתמש בכלים הוא שולח בקשה נוספת שנושאת את אצוות תוצאות הכלים. עם מטמון הנחיות, Claude Code קורא מחדש את ההיסטוריה הזאת בתעריף טוקן במטמון, כך ששאלה של שורה אחת בסשן שפתוח כל היום עדיין מושכת שימוש עבור כל השיחה. ראו ניהול הקשר באופן יזום לדרכים לשמור על הקשר קטן
• החטאות מטמון: ההודעה הראשונה אחרי הפסקה ארוכה ממשך חיי המטמון מחמיצה את המטמון ומעבדת מחדש את כל ההקשר. ראו איזה משך חיים הבקשות מקבלות והבקרות להגדרתו
• משימות מתוזמנות: משימה מתוזמנת ברמת הסשן מופעלת במרווח שלה גם כשהסשן לא פעיל, ושולחת את כל ההקשר בכל פעם
• הודעות בין סשנים: Claude Code מוסר הודעה מסשן אחר שלכם כתור חדש כשהסשן הזה יושב ללא פעילות, ושולח את כל ההקשר בכל פעם. כדי להחזיק הודעות נכנסות במקום למסור אותן, הגדירו את crossSessionInbound ל-hold
• בדיקות יעד: בזמן שעבודה ברקע מחזיקה יעד פעיל שממתין, Claude Code מבקש מקלוד לבדוק את העבודה הזאת גם כשהסשן יושב ללא פעילות, ומתחיל תור חדש ששולח את כל ההקשר. Claude Code מתחיל לכל היותר שלוש בדיקות בחוסר פעילות לכל יעד בין ההנחיות שלכם. לפני v2.1.246, בדיקות בחוסר פעילות לא היו מוגבלות. כדי לכבות בדיקות, הגדירו את CLAUDE_CODE_GOAL_CHECKIN_MINUTES ל-0. בדיקות בחוסר פעילות דורשות Claude Code v2.1.236 או מאוחר יותר
• סוכני משנה ותהליכי עבודה: כל סוכן משנה, וכל סוכן שתהליך עבודה דינמי יוצר, שולח בקשות משלו בנוסף לשיחה הראשית. פירוט הייחוס מציג את חלקם של סוכני המשנה
• חברי צוות סוכנים: כל חבר צוות פעיל ממשיך לצרוך טוקנים עד שהוא יוצא
• דחיסה: /compact קורא את השיחה שהוא מסכם, כך שדחיסת הקשר גדול היא בעצמה בקשה גדולה. כשרוצים התחלה חדשה במקום המשכיות, /clear לא עולה כלום

כדי לראות מה לשנות בתוכנית Pro, Max, Ultra, Team או Enterprise, הריצו /usage בשורת Claude Code. הפירוט שלו ממליץ על שינוי להתנהגויות שעומדות מאחורי 10% או יותר מהשימוש האחרון. ההתנהגויות האלה כוללות הקשר ארוך והחטאות מטמון.

#הבנת שינויים בהתנהגות Claude Code

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

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

• תוכניות מנוי (Pro, Max, Ultra, Team, Enterprise): התחברו ב-claude.ai, לחצו על ראשי התיבות בפינה השמאלית התחתונה, ובחרו Get help
• חיוב Console (API): התחברו ב-platform.claude.com, לחצו על ראשי התיבות, ובחרו Get help

ראו איך לקבל תמיכה לתהליך המלא, כולל מי יכול להגיע לנציג אנושי בכל תוכנית.