מדריך קלוד קוד בעברית

תיעוד 157

משתני סביבה

מקור לעיון במשתני סביבה ששולטים בהתנהגות של Claude Code.

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

הדף הזה מכסה איך:

#הגדרת משתני סביבה

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

#הגדרת משתנים במעטפת

הגדירו את המשתנה לפני שמפעילים את claude:

macOS, Linux, WSL

export API_TIMEOUT_MS="1200000"
claude

כדי להגדיר אותו לכל סשן, הוסיפו את שורת ה-export ל-~/.bashrc, ל-~/.zshrc, או לקובץ הפרופיל של המעטפת.

Windows PowerShell

$env:API_TIMEOUT_MS = "1200000"
claude

כדי להגדיר אותו לכל סשן, הריצו [Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User") ופתחו טרמינל חדש.

Windows CMD

set API_TIMEOUT_MS=1200000
claude

כדי להגדיר אותו לכל סשן, הריצו setx API_TIMEOUT_MS "1200000" ופתחו טרמינל חדש.

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

macOS, Linux, WSL

echo $API_TIMEOUT_MS

Windows PowerShell

echo $env:API_TIMEOUT_MS

Windows CMD

echo %API_TIMEOUT_MS%

#הגדרת משתנים בקבצי הגדרות

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

~/.claude/settings.json

{
  "env": {
    "API_TIMEOUT_MS": "1200000",
    "BASH_DEFAULT_TIMEOUT_MS": "300000"
  }
}

Claude Code מעתיק את הערכים האלה לסביבה שלו כפי שהם כתובים. אף מעטפת לא מעבדת אותם, ולכן קיצור כמו ~ או $HOME נשאר כפי שהוקלד. למשתנה שמקבל נתיב, כמו CLAUDE_CONFIG_DIR, כתבו את הנתיב המוחלט: "CLAUDE_CONFIG_DIR": "/home/you/.claude-work".

הקובץ שבוחרים קובע על מי המשתנים חלים:

קובץחל על
~/.claude/settings.jsonעליכם, בכל פרויקט
.claude/settings.jsonעל כל מי שעובד בפרויקט, ומוכנס לבקרת המקור
.claude/settings.local.jsonעליכם, בפרויקט הזה בלבד. הקובץ נכנס ל-gitignore כש-Claude Code שומר אליו הגדרה. הוסיפו אותו ל-gitignore אם יצרתם אותו ידנית
Managed settingsעל כולם בארגון, ומופץ על ידי מנהל

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

#קדימות

לחלק מההתנהגויות יש גם משתנה סביבה וגם מפתח הגדרות ייעודי, והשאלה את מה Claude Code קורא קודם משתנה לפי המפתח. עבור ANTHROPIC_MODEL ו-CLAUDE_CODE_AUTO_CONNECT_IDE, Claude Code קורא קודם את המשתנה ומשתמש בהגדרת model או autoConnectIde רק כשהמשתנה לא מוגדר. עבור הזוג שאתם מגדירים, בדקו את השורה של המשתנה בהמשך ואת הרשומה של המפתח במקור ההגדרות.

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

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

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

האופן שבו משתנה סביבה פועל עם דגלי CLI ופקודות בתוך הסשן משתנה לפי התכונה: --model ו-/model דורסים את ANTHROPIC_MODEL, בעוד CLAUDE_CODE_EFFORT_LEVEL דורס את --effort ואת /effort. כשמשתנה פועל עם מקור הגדרה אחר, השורה שלו ברשימת המשתנים מציינת את הקדימות או מקשרת לדף שמתעד אותה.

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

#משתנים

משתנים מספריים כמו זמני קצוב, תקציבי טוקנים ומספרי ניסיונות חוזרים מקבלים כתיב מדעי וכתיב עם מפריד ספרות בנוסף לספרות רגילות, חוץ ממקום שבו השורה של משתנה מציינת שהוא מקבל ספרות רגילות בלבד. לדוגמה, Claude Code קורא את 2e3 כ-2000 ואת 64_000 כ-64000. לפני v2.1.211, הכתיבים האלה יכלו להגדיר בשקט ערך קטן בהרבה, למשל 1e6 שהגדיר זמן קצוב ל-1.

[!NOTE]

למשתנים שמפעילים או מכבים התנהגות, הגדירו 1, true, yes, או on כדי להפעיל, ו-0, false, no, או off כדי לכבות, בכל סוג אותיות.

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

  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
  • DISABLE_TELEMETRY
  • DISABLE_ERROR_REPORTING
  • CLAUDE_CODE_TMUX_TRUECOLOR
  • IS_DEMO

השורה של כל משתנה מציינת גם את הכלל שלו.

משתנהמטרה
ANTHROPIC_API_KEYמפתח API שנשלח ככותרת X-Api-Key. כשהוא מוגדר, המפתח הזה משמש במקום מנוי Claude Pro, Max, Ultra, Team או Enterprise, גם אם אתם מחוברים. במצב לא אינטראקטיבי (-p), המפתח תמיד בשימוש כשהוא קיים. במצב אינטראקטיבי, אתם מתבקשים לאשר את המפתח פעם אחת לפני שהוא דורס את המנוי. כדי להשתמש במנוי במקומו, הריצו unset ANTHROPIC_API_KEY
ANTHROPIC_AUTH_TOKENערך מותאם אישית לכותרת Authorization (לערך שתגדירו כאן תתווסף הקידומת Bearer )
ANTHROPIC_AWS_API_KEYמפתח API של סביבת עבודה עבור Claude Platform on AWS, שנוצר ב-AWS Console. נשלח כ-x-api-key וגובר על AWS SigV4
ANTHROPIC_AWS_BASE_URLדריסת כתובת נקודת הקצה של Claude Platform on AWS. לשימוש באזורים מותאמים אישית או כשמנתבים דרך שער LLM. ברירת המחדל היא https://aws-external-anthropic.{region}.api.aws. Claude Code מפענח את האזור לפי אותו סדר עדיפויות כמו ב-Amazon Bedrock
ANTHROPIC_AWS_WORKSPACE_IDנדרש עבור Claude Platform on AWS. נשלח בכל בקשה ככותרת anthropic-workspace-id
ANTHROPIC_BASE_URLדריסת נקודת הקצה של ה-API כדי לנתב בקשות דרך פרוקסי או שער. למה שקורה כשהשער הזה דוחה חיפוש כלי MCP, ראו חיפוש כלים דרך שער LLM. החל מ-v2.1.196, Remote Control מושבת כשהמשתנה מצביע על מארח שאינו api.anthropic.com, בהתאמה להתנהגות שלו ב-Amazon Bedrock, ב-Google Cloud's Agent Platform וב-Microsoft Foundry
ANTHROPIC_BEDROCK_BASE_URLדריסת כתובת נקודת הקצה של Amazon Bedrock. לשימוש בנקודות קצה מותאמות של Amazon Bedrock או כשמנתבים דרך שער LLM. ראו Amazon Bedrock
ANTHROPIC_BEDROCK_MANTLE_BASE_URLדריסת כתובת נקודת הקצה של Amazon Bedrock Mantle. ראו נקודת קצה Mantle
ANTHROPIC_BEDROCK_REGION_PREFIXקידומת של פרופיל הסקה בין אזורים (us, eu, apac, jp, au או global) ש-Claude Code מנסה ראשונה, במקום זו שנגזרת מאזור AWS. מתעלמים ממנה באזורי AWS GovCloud. דורש Claude Code v2.1.224 ואילך. ראו Amazon Bedrock
ANTHROPIC_BEDROCK_SERVICE_TIERרמת שירות של Amazon Bedrock (default, flex או priority). ראו Amazon Bedrock
ANTHROPIC_BETASרשימה מופרדת בפסיקים של ערכי כותרת anthropic-beta נוספים לכלול בבקשות API. Claude Code כבר שולח את כותרות הבטא שהוא צריך. השתמשו בזה כדי להצטרף ל-בטא של Anthropic API לפני ש-Claude Code מוסיף תמיכה מובנית. בניגוד לדגל --betas, שדורש אימות במפתח API, המשתנה הזה עובד עם כל שיטות האימות, כולל מנוי Claude.ai
ANTHROPIC_CUSTOM_HEADERSכותרות מותאמות אישית להוספה לבקשות (פורמט Name: Value, מופרדות בשורה חדשה לכמה כותרות). אם שם או ערך מכיל תו שכותרת HTTP לא יכולה לשאת, כגון מרכאות מסולסלות או רווח ברוחב אפס, הבקשה נכשלת עם שגיאה שמזהה את הזוג לפי מיקום. דורש Claude Code v2.1.227 ואילך. Invalid request header value מפרט את קבוצת התווים המדויקת ואת המקום שבו הבדיקה רצה. ערך שמגדיר כותרת של אישור, ארגון או דייר, ניתוב, או התנהגות API, כגון Authorization או Host, נחשב להגדרה שדורשת אישור כשהגדרות שמנוהלות בשרת מעבירות אותו. מהגדרות פרויקט או הגדרות מקומיות, ערך כזה כפוף לכללים למתי ערכי env חלים
ANTHROPIC_CUSTOM_MODEL_OPTIONמזהה מודל להוספה כרשומה מותאמת אישית בבורר /model. השתמשו בזה כדי לאפשר בחירה במודל לא סטנדרטי או ייעודי לשער, בלי להחליף כינויים מובנים. ראו הגדרת מודל
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTIONתיאור תצוגה לרשומת המודל המותאם בבורר /model. ברירת המחדל היא Custom model (<model-id>) כשלא מוגדר
ANTHROPIC_CUSTOM_MODEL_OPTION_NAMEשם תצוגה לרשומת המודל המותאם בבורר /model. כשלא מוגדר, הרשומה מציגה את שם המודל אם Claude Code מזהה את המזהה, ואת מזהה המודל אחרת
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIESרשימה מופרדת בפסיקים של יכולות שהמודל המותאם תומך בהן, לדוגמה effort,thinking. ראו הגדרת מודל
ANTHROPIC_DEFAULT_FABLE_MODELמזהה מודל שאליו הכינוי fable מתורגם, והמזהה ש-Claude Code מזהה כמודל Fable עבור נפילה אוטומטית למודל אצל ספקים צד שלישי. ראו הגדרת מודל
ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTIONתיאור תצוגה למודל Fable הנעוץ בבורר /model. כשלא מוגדר, השורה מציגה תיאור ברירת מחדל שמתחיל ב-Custom Fable model. ראו הגדרת מודל
ANTHROPIC_DEFAULT_FABLE_MODEL_NAMEשם תצוגה למודל Fable הנעוץ בבורר /model. כשלא מוגדר, השורה מציגה את שם המודל אם Claude Code מזהה את המזהה הנעוץ, ואת המזהה הנעוץ אחרת. ראו הגדרת מודל
ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIESרשימה מופרדת בפסיקים של יכולות שמודל Fable הנעוץ תומך בהן, לדוגמה effort,thinking. ראו הגדרת מודל
ANTHROPIC_DEFAULT_HAIKU_MODELמזהה מודל שאליו הכינוי haiku מתורגם, ומשמש גם לפונקציונליות רקע. ראו הגדרת מודל
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTIONתיאור תצוגה למודל Haiku הנעוץ בבורר /model. כשלא מוגדר, השורה מציגה תיאור ברירת מחדל שמתחיל ב-Custom Haiku model. ראו הגדרת מודל
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAMEשם תצוגה למודל Haiku הנעוץ בבורר /model. כשלא מוגדר, השורה מציגה את שם המודל אם Claude Code מזהה את המזהה הנעוץ, ואת המזהה הנעוץ אחרת. ראו הגדרת מודל
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIESרשימה מופרדת בפסיקים של יכולות שמודל Haiku הנעוץ תומך בהן, לדוגמה effort,thinking. ראו הגדרת מודל
ANTHROPIC_DEFAULT_MODELהמודל שסשנים חדשים מתחילים עליו כברירת מחדל. דורש Claude Code v2.1.236 ואילך. ראו הגדרת מודל ברירת מחדל לסשנים חדשים
ANTHROPIC_DEFAULT_OPUS_MODELמזהה מודל שאליו הכינוי opus מתורגם, וש-opusplan משתמש בו בזמן ש-Plan Mode פעיל. ראו הגדרת מודל
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTIONתיאור תצוגה למודל Opus הנעוץ בבורר /model. כשלא מוגדר, השורה מציגה תיאור ברירת מחדל שמתחיל ב-Custom Opus model. ראו הגדרת מודל
ANTHROPIC_DEFAULT_OPUS_MODEL_NAMEשם תצוגה למודל Opus הנעוץ בבורר /model. כשלא מוגדר, השורה מציגה את שם המודל אם Claude Code מזהה את המזהה הנעוץ, ואת המזהה הנעוץ אחרת. ראו הגדרת מודל
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIESרשימה מופרדת בפסיקים של יכולות שמודל Opus הנעוץ תומך בהן, לדוגמה effort,thinking. ראו הגדרת מודל
ANTHROPIC_DEFAULT_SONNET_MODELמזהה מודל שאליו הכינוי sonnet מתורגם, וש-opusplan משתמש בו כש-Plan Mode אינו פעיל. ראו הגדרת מודל
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTIONתיאור תצוגה למודל Sonnet הנעוץ בבורר /model. כשלא מוגדר, השורה מציגה תיאור ברירת מחדל שמתחיל ב-Custom Sonnet model. ראו הגדרת מודל
ANTHROPIC_DEFAULT_SONNET_MODEL_NAMEשם תצוגה למודל Sonnet הנעוץ בבורר /model. כשלא מוגדר, השורה מציגה את שם המודל אם Claude Code מזהה את המזהה הנעוץ, ואת המזהה הנעוץ אחרת. ראו הגדרת מודל
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIESרשימה מופרדת בפסיקים של יכולות שמודל Sonnet הנעוץ תומך בהן, לדוגמה effort,thinking. ראו הגדרת מודל
ANTHROPIC_FEDERATION_RULE_IDמזהה כלל פדרציה עבור Workload Identity Federation. כשמגדירים אותו יחד עם ANTHROPIC_ORGANIZATION_ID, Claude Code בוחר אישורי פדרציה, שמדרגים מעל אישור ה-/login שלכם. ראו סדר עדיפויות אימות
ANTHROPIC_FOUNDRY_API_KEYמפתח API לאימות Microsoft Foundry (ראו Microsoft Foundry)
ANTHROPIC_FOUNDRY_AUTH_TOKENאסימון Bearer לאימות Microsoft Foundry, כגון אסימון גישה של Microsoft Entra. Claude Code שולח אותו ככותרת Authorization: Bearer. גובר על ANTHROPIC_FOUNDRY_API_KEY ועל שרשרת אישורי ברירת המחדל של Azure. ראו Microsoft Foundry. דורש Claude Code v2.1.203 ואילך
ANTHROPIC_FOUNDRY_BASE_URLכתובת בסיס מלאה למשאב Microsoft Foundry (לדוגמה, https://my-resource.services.ai.azure.com/anthropic). חלופה ל-ANTHROPIC_FOUNDRY_RESOURCE (ראו Microsoft Foundry)
ANTHROPIC_FOUNDRY_RESOURCEשם משאב Microsoft Foundry (לדוגמה, my-resource). Claude Code מסרב לכתובת URL או לשם מארח. נדרש אם ANTHROPIC_FOUNDRY_BASE_URL לא מוגדר (ראו Microsoft Foundry)
ANTHROPIC_MODELשם הגדרת המודל לשימוש (ראו הגדרת מודל)
ANTHROPIC_ORGANIZATION_IDמזהה ארגון עבור Workload Identity Federation. הגדירו אותו יחד עם ANTHROPIC_FEDERATION_RULE_ID. ראו סדר עדיפויות אימות
ANTHROPIC_PROFILEשם פרופיל Anthropic לאימות, כגון פרופיל שנוצר על ידי ant auth login או על ידי כניסה לחשבון Console בלי מפתח API. ראו סדר עדיפויות אימות
ANTHROPIC_SMALL_FAST_MODEL[DEPRECATED] שם של מודל ברמת Haiku למשימות רקע
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGIONדריסת אזור AWS עבור המודל ברמת Haiku בשימוש ב-Amazon Bedrock או ב-Amazon Bedrock Mantle. ב-Amazon Bedrock, זה נכנס לתוקף רק כשגם ANTHROPIC_DEFAULT_HAIKU_MODEL או ANTHROPIC_SMALL_FAST_MODEL המיושן מוגדרים, כי אחרת Amazon Bedrock מריץ משימות רקע על מודל Sonnet ברירת המחדל או המודל הראשי באזור הסשן
ANTHROPIC_VERTEX_BASE_URLדריסת כתובת נקודת הקצה של Google Cloud's Agent Platform. לשימוש בנקודות קצה מותאמות של Google Cloud's Agent Platform או כשמנתבים דרך שער LLM. ראו Google Cloud's Agent Platform
ANTHROPIC_VERTEX_PROJECT_IDמזהה פרויקט GCP שאליו מופנות בקשות Google Cloud's Agent Platform. ראו הגדרת אישורי GCP
ANTHROPIC_WORKSPACE_IDמזהה סביבת עבודה עבור workload identity federation. הגדירו את זה כשכלל הפדרציה שלכם חל על יותר מסביבת עבודה אחת, כדי שחילוף האסימון יידע לאיזו סביבת עבודה לכוון
API_FORCE_IDLE_TIMEOUTדריסת פסק הזמן של חוסר פעילות בגוף התשובה, בן 5 דקות, שמבטל תשובת מודל בזרימה כשלא מגיעים בתים. הגדירו ל-0 כדי לכבות את פסק הזמן, לדוגמה כששער איטי או מודל מקומי עוצר יותר מ-5 דקות בין מקטעים, או ל-1 כדי להשאיר אותו פעיל לכל ספק. כשלא מוגדר, פסק הזמן פעיל אצל ספקים שאינם ה-API הישיר של Anthropic, Claude Platform on AWS, ו-Amazon Bedrock עם CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1 מוגדר. שומרי הזרימה רצים בנפרד ממנו ומבטלים השהיה שקטה ארוכה גם כשמגדירים כאן 0
API_TIMEOUT_MSהזמן במילישניות שיש לכל ניסיון של בקשת API כדי לקבל את כותרות התשובה שלו. הוא לא מגביל כמה זמן תשובה בזרימה רצה אחרי זה. ברירת המחדל היא 600000, או 10 דקות, והמקסימום הוא 2147483647. כשמגדירים ערך חיובי, כל ניסיון של בקשה שאינה בזרימה חייב להסתיים בתוכו. הגדילו את זה כשבקשות מגיעות לפסק זמן ברשתות איטיות או כשמנתבים דרך פרוקסי. הגדירו ל-0 כדי להסיר את המגבלה הזו, מה שדורש Claude Code v2.1.305 ואילך. עם 0, ניסיון שאינו בזרימה עדיין מגיע לפסק זמן אחרי 300 שניות בסשן מקומי
AWS_BEARER_TOKEN_BEDROCKמפתח API של Amazon Bedrock לאימות (ראו מפתחות API של Amazon Bedrock)
BASH_DEFAULT_TIMEOUT_MSפסק זמן ברירת מחדל לפקודת כלי Bash או PowerShell בחזית, במילישניות (ברירת מחדל: 120000, או 2 דקות). ערך מעל מגבלת הזמן ברירת המחדל לפקודות רקע מחליף את ברירת המחדל הזו בסשנים ללא השגחה. מגבלת הזמן ברקע דורשת Claude Code v2.1.285 ואילך
BASH_MAX_OUTPUT_LENGTHמספר התווים המרבי של פלט bash ש-Claude Code קורא בחזרה לתוך תוצאת פקודה (ברירת מחדל: 30000, מקסימום: 150000). אם מגדירים את ההגדרה bashOutputMaxChars, Claude Code מתעלם מהמשתנה הזה. ראו מגבלות פלט
משתנהמטרה
BASH_MAX_TIMEOUT_MSזמן קצוב מרבי שהמודל יכול לקבוע לפקודת כלי Bash או PowerShell בחזית, באלפיות שנייה (ברירת מחדל: 600000, או 10 דקות). התקרה האפקטיבית היא הגדול מבין ערך זה לבין BASH_DEFAULT_TIMEOUT_MS. תקרה אפקטיבית ארוכה משעתיים הופכת גם למגבלת הזמן המרבית לפקודות רקע בסשנים ללא השגחה. מגבלת הזמן לרקע דורשת Claude Code v2.1.285 או חדש יותר
BETA_TRACING_ENDPOINTנקודת קצה OTLP/HTTP עבור מעקב בטא מפורט: עם ENABLE_BETA_TRACING_DETAILED=1, יומנים ומעקבים הולכים לשם במקום אל המייצאים המוגדרים. הגדירו אותו במעטפת, בהגדרות משתמש, או בהגדרות מנוהלות. מתעלמים ממנו בהגדרות פרויקט ומקומיות
CCR_FORCE_BUNDLEהגדירו ל-1 כדי לכפות על claude --cloud לארוז ולהעלות את המאגר המקומי במקום לשכפל מהמרוחק שלו
CLAUDECODEמוגדר ל-1 בתהליכי משנה ש-Claude Code מפעיל (כלי Bash ו-PowerShell, סשני tmux, פקודות hook, פקודות שורת סטטוס, תהליכי משנה של שרת MCP ב-stdio). הרחבות IDE גם מגדירות זאת בטרמינלים המשולבים שלהן. השתמשו כדי לזהות מתי סקריפט רץ בתוך תהליך משנה ש-Claude Code הפעיל. כדי לבדוק אם התהליך הנוכחי הופעל ישירות על ידי קריאת כלי או hook, ולא בתוך שרת MCP ב-stdio ש-Claude Code הפעיל, השתמשו ב-CLAUDE_CODE_CHILD_SESSION במקום זאת
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTSהגדירו ל-1 כדי להשבית את כל סוגי סוכני המשנה המובנים, כגון Explore ו-Plan. חל רק במצב לא אינטראקטיבי (הדגל -p). שימושי למשתמשי SDK שרוצים לוח חלק. זה גם מסיר את general-purpose, סוכן המשנה ש-Claude Code מריץ כאשר קריאת כלי Agent משמיטה את subagent_type. קריאה כזו נכשלת אז עם subagent_type is required
CLAUDE_AGENT_SDK_MCP_NO_PREFIXהגדירו ל-1 כדי לדלג על הקידומת mcp__<server>__ בשמות כלים משרתי MCP שנוצרו על ידי ה-SDK. הכלים משתמשים בשמות המקוריים שלהם. שימוש ב-SDK בלבד
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MSזמן קצוב לתקיעה באלפיות שנייה עבור סוכני משנה. מכסה גם סוכני תהליך עבודה ב-Claude Code v2.1.286 או חדש יותר. ברירת מחדל 600000 (10 דקות). אם מעלים את CLAUDE_STREAM_IDLE_TIMEOUT_MS בזמן ששומר הזרימה פעיל, ברירת המחדל עולה איתו, כפי שמתאר טיפול בתגובות API איטיות או תקועות
CLAUDE_AUTOCOMPACT_PCT_OVERRIDEקובע את האחוז (1-100) מחלון הדחיסה האוטומטית שבו מופעלת דחיסה אוטומטית. השתמשו בערכים נמוכים יותר כמו 50 כדי לדחוס מוקדם יותר. המשתנה לא יכול להעלות את הסף, ולכן מתעלמים מערכים שמעל אחוז ברירת המחדל. הוא חל רק בסשנים שדוחסים לפני מגבלת ההקשר של המודל. חל גם על שיחות ראשיות וגם על סוכני משנה
CLAUDE_AUTO_BACKGROUND_TASKSהגדירו ל-1 כדי לכפות הפעלה של העברה אוטומטית לרקע של משימות סוכן ארוכות. כשמופעל, סוכן משנה עובר לרקע אחרי ריצה של כשתי דקות. אם Claude תור קריאת כלי כגון עריכת קובץ מאחורי סוכן המשנה, סוכן המשנה מסיים בחזית לפני שהקריאה מתחילה. מאפשר גם העברה אוטומטית לרקע של קריאות כלי MCP ארוכות במצב לא אינטראקטיבי ב-Claude Code v2.1.212 או חדש יותר
CLAUDE_AX_PREPARK_MSבמצב קורא מסך, כמה אלפיות שנייה Claude Code ממתין לפני שהוא כותב שורה חדשה או שהשתנתה. ברירת מחדל 0, כך ש-Claude Code לא ממתין. לפני v2.1.287, ברירת המחדל הייתה 50. Claude Code מגביל את ההמתנה ל-5000. מתעלמים ממנו בהגדרות פרויקט ומקומיות. דורש Claude Code v2.1.233 או חדש יותר
CLAUDE_AX_SCREEN_READERהגדירו ל-1 כדי לעבד פלט ידידותי לקורא מסך: טקסט שטוח בלי מסגרות דקורטיביות או אנימציות. הגדירו ל-0 כדי לכפות כיבוי של מצב קורא מסך גם כאשר axScreenReader הוא true. הדגל --ax-screen-reader גובר. מתעלמים ממנו בהגדרות פרויקט ומקומיות. דורש Claude Code v2.1.181 או חדש יותר
CLAUDE_AX_STARTUP_QUIET_MSבמצב קורא מסך, כמה אלפיות שנייה Claude Code מחזיק את עיבוד הממשק הראשון אחרי שורת אישור ההפעלה. קורא המסך יכול אז להקריא את השורה במלואה לפני שפלט חדש קוטע אותה. ברירת מחדל 3000. הגדירו 0 כדי לעבד מיד. Claude Code מגביל את ההחזקה ל-600000 (10 דקות). ההקשה הראשונה מסיימת את ההחזקה מוקדם. מתעלמים ממנו בהגדרות פרויקט ומקומיות. דורש Claude Code v2.1.217 או חדש יותר
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIRחזרה לתיקיית העבודה המקורית אחרי כל פקודת Bash או PowerShell בסשן הראשי
CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MSזמן קצוב באלפיות שנייה לשומר הסרק של זרימה ברמת בתים. כשמוגדר, הוא גובר על CLAUDE_STREAM_IDLE_TIMEOUT_MS עבור השומר הזה ומשאיר את שומר רמת האירועים ללא שינוי. Claude Code מצמיד את המשתנה הזה לטווח שבין 10 שניות ל-30 דקות. דורש Claude Code v2.1.210 או חדש יותר
CLAUDE_CLIENT_PRESENCE_FILEנתיב לקובץ שכלי חיצוני, כגון מאזין לנעילת מסך, יוצר כשפותחים את המסך ומוחק כשנועלים אותו. כל עוד הקובץ קיים, Claude Code מדלג על התראות דחיפה לנייד של Remote Control, כך שמפסיקים לקבל דחיפות בזמן שימוש פעיל במחשב. כשהקובץ חסר או לא קריא, ההתראות נשלחות כרגיל. Claude Code בודק את הקובץ פעם אחת לכל אירוע שמפעיל דחיפה, ולא בסריקה חוזרת. דורש Claude Code v2.1.181 או חדש יותר
CLAUDE_CODE_ACCESSIBILITYהגדירו ל-1 כדי להשאיר את סמן הטרמינל המקורי גלוי ולהשבית את מחוון הסמן של טקסט הפוך. מאפשר למגדילי מסך כמו macOS Zoom לעקוב אחרי מיקום הסמן
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MDהגדירו ל-1 כדי לטעון קובצי זיכרון מתיקיות שצוינו עם --add-dir. טוען את CLAUDE.md, .claude/CLAUDE.md, .claude/rules/*.md, ו-CLAUDE.local.md. כברירת מחדל, תיקיות נוספות לא טוענות קובצי זיכרון
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINTהגדירו ל-1 כדי לצייר מחדש את כל המסך בכל מסגרת בעיבוד מסך מלא במקום לשלוח עדכונים מצטברים. השתמשו בזה אם מצב מסך מלא מציג קטעי טקסט ישנים או במיקום שגוי. Claude Code מפעיל זאת אוטומטית לסשני רקע ולתצוגת סוכן ב-Windows
CLAUDE_CODE_ALWAYS_ENABLE_EFFORTהגדירו ל-1 כדי לשלוח את פרמטר המאמץ עם כל בקשה, גם כאשר Claude Code לא מזהה את מזהה המודל כתומך במאמץ. השתמשו בזה בעת ניתוב דרך שער LLM או ספק צד שלישי שמגיש מודלים תחת מזהים מותאמים. מודלים שדוחים את פרמטר המאמץ ב-API, כולל Claude Opus 4.1, Claude Sonnet 4.5, Claude Haiku 4.5, ומודלים מוקדמים יותר, עדיין מוחרגים כדי שהבקשות לא ייכשלו
CLAUDE_CODE_API_KEY_HELPER_TTL_MSמרווח באלפיות שנייה שבו יש לרענן אישורים (בעת שימוש ב-apiKeyHelper)
CLAUDE_CODE_ARTIFACT_AUTO_OPENהגדירו ל-0 כדי לעצור את Claude Code מפתיחת הדפדפן אוטומטית כשמתפרסם ארטיפקט חדש
CLAUDE_CODE_ARTIFACT_COMMENTSהגדירו ל-0 כדי לעצור את Claude מקריאה ומענה לתגובות על ארטיפקט. אין השפעה כאשר CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC כיבה ארטיפקטים. דורש Claude Code v2.1.221 או חדש יותר
CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACTהגדירו ל-0 כדי לעצור את Claude ממענה בעצמו לתגובות שנשלחו אליו. דורש Claude Code v2.1.228 או חדש יותר
CLAUDE_CODE_ARTIFACT_PUBLISH_EDITSהגדירו ל-0 כדי לעצור את Claude מהחלת שינויים קטנים על קובץ של ארטיפקט כחלק מפרסומו. Claude אז עורך את הקובץ בכלי עריכת הקבצים שלו ומפרסם אותו כשלב נפרד. דורש Claude Code v2.1.300 או חדש יותר
CLAUDE_CODE_ATTRIBUTION_HEADERהגדירו ל-0 כדי להשמיט את בלוק הייחוס, שנושא את גרסת הלקוח וטביעת אצבע של הפרומפט, מתחילת פרומפט המערכת. שמירה במטמון בחיבור ישיר ל-API של Anthropic לא מושפעת בכל מקרה. בחלק מהגדרות החיבור הישיר, Claude Code משאיר את הבלוק בבקשות מסווג של מצב אוטומטי גם כשמגדירים 0. בבלוק ייחוס בפרומפט המערכת, בדקו אילו חיבורים ואישורים זה מכסה. לפני v2.1.181 הבלוק כלל אסימון לכל בקשה בכתובות בסיס מותאמות ובחיבורי Microsoft Foundry, ולכן בגרסאות אלה הגדירו אותו ל-0 כאשר שער ה-LLM שומר במטמון לפי גוף הבקשה או מעביר בקשות לספק צד שלישי, או כאשר מתחברים ל-Microsoft Foundry ישירות
CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDSהוסר ב-v2.1.283. השתמשו ב-CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE במקום
CLAUDE_CODE_AUTO_COMPACT_WINDOWקובע את חלון הדחיסה האוטומטית, עד כמה ההקשר מתמלא לפני דחיסה, מ-100000 עד 1000000 אסימונים. ערכים עם סיומת כמו 200k דורשים v2.1.304 או חדש יותר. לגבי קדימות על פני הדרכים האחרות לקביעת החלון וההשפעה על used_percentage בשורת הסטטוס, ראו הגדרת חלון הדחיסה האוטומטית
CLAUDE_CODE_AUTO_CONNECT_IDEדריסה של חיבור IDE אוטומטי. כברירת מחדל, Claude Code מתחבר אוטומטית כשמופעל בתוך טרמינל משולב של IDE נתמך. הגדירו ל-false כדי למנוע זאת. הגדירו ל-true כדי לכפות ניסיון חיבור כשזיהוי אוטומטי נכשל, למשל כש-tmux מסתיר את הטרמינל ההורה. גובר על הגדרת התצורה הגלובלית autoConnectIde
CLAUDE_CODE_AUTO_MODE_MODELקובע את המודל לבקשות המסווג ש-Claude Code שולח במצב אוטומטי. השתמשו במזהה מודל מלא כמו claude-sonnet-4-6. למקרים שבהם Claude Code מתעלם ממנו, ראו בחירת מודל המסווג. דורש Claude Code v2.1.302 או חדש יותר
CLAUDE_CODE_AUTO_MODE_SERVERשולט אם Claude Code מבקש מהשרת לסקור פעולות מצב אוטומטי. הגדירו ל-0 כדי להשתמש בבקשות המסווג של Claude Code עצמו במקום. בחיבור ישיר ל-API של Anthropic, דורש v2.1.281 או חדש יותר. הסעיף המקושר מפרט אילו סשנים מבקשים מהשרת כשהמשתנה לא מוגדר, ומאיזו גרסה. דורש Claude Code v2.1.271 או חדש יותר
CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MSזמן באלפיות שנייה ש-Claude Code ממתין ששרשרת ספקי האישורים ברירת המחדל של AWS תפיק אישורים לפני שהבקשה נכשלת עם AWS default-chain credential resolve timed out (ברירת מחדל: 60000). העלו אותו כאשר שלב בשרשרת באמת צריך יותר זמן, למשל התחברות SSO מבוססת דפדפן עם MFA דרך מעטפת כמו aws-vault. חל על Amazon Bedrock, Claude Platform on AWS, ונקודת הקצה Mantle. ראו שמירת אישורים במטמון וזמן קצוב לפתרון. דורש Claude Code v2.1.207 או חדש יותר
CLAUDE_CODE_BASH_EDIT_DIFFהגדירו ל-0 כדי לכבות את ההבדל של הקבצים שהשתנו בזמן שפקודת Bash רצה, או ל-1 כדי לתעד אותו בכל מצב הרשאה. גובר על ההגדרה bashEditDiffEnabled. דורש Claude Code v2.1.269 או חדש יותר
CLAUDE_CODE_BG_TASKS_REPORT_RUNNINGהגדירו ל-0 כדי שסשן לא אינטראקטיבי ידווח סטטוס סרק למארח שלו בסוף כל תור, גם בזמן שעבודת רקע עדיין רצה. כברירת מחדל, הסשן ממשיך לדווח סטטוס ריצה אחרי סוף התור כל עוד עבודת רקע כמו סוכן רקע או ריצת תהליך עבודה עדיין חיה. זה מונע ממארח שעוקב אחרי הסטטוס, כמו רשימת סשנים מרוחקים, להכריז ש-Claude ממתין לקלט באמצע עבודה. פקודות מעטפת ברקע, כמו שרת פיתוח, לא מחזיקות את סטטוס הריצה. ברירת המחדל של סטטוס הריצה והיציאה עם 0 דורשות Claude Code v2.1.269 או חדש יותר. בגרסאות מוקדמות יותר, הגדירו 1 כדי להחזיק את סטטוס הריצה
CLAUDE_CODE_BRIDGE_SESSION_IDמוגדר אוטומטית בתהליכי משנה של כלי Bash ושל פקודת hook כל עוד לסשן יש חיבור Remote Control פעיל, ומוסר כשהחיבור מסתיים. הערך הוא מזהה הסשן בצורת session_, אותו מזהה שמופיע בכתובת claude.ai/code של הסשן, כך שסקריפט יכול לקשר חזרה לסשן שהריץ אותו. דורש Claude Code v2.1.199 או חדש יותר. בסשני ענן, קראו את CLAUDE_CODE_REMOTE_SESSION_ID במקום
CLAUDE_CODE_BS_AS_CTRL_BACKSPACEהגדירו ל-0 כדי ש-Claude Code יקרא את הבית 0x08, שנכתב גם ^H, כ-Backspace רגיל, או ל-1 כדי לקרוא אותו כ-Ctrl+Backspace. כל אחד מהערכים מחליף את ברירת המחדל של הפלטפורמה. כברירת מחדל, Claude Code קורא אותו כ-Ctrl+Backspace ב-Windows, למעט כאשר TERM_PROGRAM הוא mintty או TERM הוא cygwin, וכ-Backspace רגיל ב-macOS וב-Linux. הגדירו 0 בטרמינל Windows שבו Backspace מוחק מילה שלמה
CLAUDE_CODE_CERT_STOREרשימה מופרדת בפסיקים של מקורות אישורי CA לחיבורי TLS. bundled הוא ערכת ה-CA של Mozilla שמצורפת ל-Claude Code. system הוא מאגר האמון של מערכת ההפעלה, שנקרא רק בסביבות ריצה עם tls.getCACertificates: הבינארי המקורי, או Node 22.15 או חדש יותר בהתקנות npm. ראו מאגר אישורי CA. ברירת המחדל היא bundled,system
CLAUDE_CODE_CHILD_SESSIONמוגדר ל-1 בתהליכי משנה ש-Claude Code מפעיל דרך הכלים Bash, PowerShell, ו-Monitor, פקודות hook, ופקודות שורת סטטוס. לא מוגדר לתהליכי משנה של שרת MCP ב-stdio, שהם ארוכי חיים וממשיכים אחרי הסשן שהפעיל אותם. בניגוד ל-CLAUDECODE, זה מוגדר רק על ידי Claude Code עצמו כשהוא מפעיל תהליך משנה ולא על ידי הרחבות IDE, ולכן הוא מבדיל באופן אמין בין סשן מקונן לבין claude ברמה העליונה שהופעל בטרמינל משולב IDE. ממשק TUI אינטראקטיבי מקונן של claude שהתחיל כך מוחרג אוטומטית מ---resume, מ---continue, מהיסטוריית חץ למעלה, ומרשימת claude agents. סשנים לא אינטראקטיביים של claude -p עדיין נשמרים. הגדירו CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 כדי לדרוס את ההחרגה הזו. דורש Claude Code v2.1.172 או חדש יותר
CLAUDE_CODE_CLIENT_CERTנתיב לקובץ אישור לקוח לאימות mTLS
CLAUDE_CODE_CLIENT_KEYנתיב לקובץ מפתח פרטי של הלקוח לאימות mTLS
CLAUDE_CODE_CLIENT_KEY_PASSPHRASEביטוי סיסמה עבור CLAUDE_CODE_CLIENT_KEY מוצפן (אופציונלי)
משתנהמטרה
CLAUDE_CODE_CONNECT_TIMEOUT_MSהוסר בגרסה v2.1.186 וכעת הוא no-op. קודם לכן הגדיר פסק זמן נפרד לשלב החיבור, TLS וכותרת התגובה של בקשת API בזרימה. השתמשו ב-API_TIMEOUT_MS במקום. לשלב כותרת התגובה של בקשת זרימה, ראו CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS
CLAUDE_CODE_DEBUG_LOGS_DIRדורס את נתיב קובץ יומן הניפוי. למרות השם, זהו נתיב קובץ, לא תיקייה. דורש שמצב ניפוי יופעל בנפרד באמצעות --debug, /debug, או משתנה הסביבה DEBUG: הגדרת משתנה זה לבדו אינה מפעילה רישום. הדגל --debug-file עושה את שניהם בבת אחת. ברירת המחדל היא ~/.claude/debug/<session-id>.txt
CLAUDE_CODE_DEBUG_LOG_LEVELרמת היומן המינימלית שנכתבת לקובץ יומן הניפוי. ערכים: verbose, debug (ברירת מחדל), info, warn, error. הגדירו ל-verbose כדי לכלול אבחון בנפח גבוה כמו פלט מלא של פקודות שורת הסטטוס, או העלו ל-error כדי להפחית רעש
CLAUDE_CODE_DISABLE_1M_CONTEXTהגדירו ל-1 כדי לכבות תמיכה בחלון הקשר של 1M. Claude Code מסיר וריאנטי מודל [1m] מבורר המודלים ומחזיק מודלים שרצים עם חלון 1M כברירת מחדל בחלון של 200K. ראו כיבוי הקשר 1M. שימושי לסביבות ארגוניות עם דרישות תאימות. לתפקידו בתיקון החלון עבור מזהה מודל [1m] שלא זוהה, ראו תיקון החלון עבור שער או מזהה מודל מותאם
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKINGהגדירו ל-1 כדי להשבית חשיבה מסתגלת ב-Opus 4.6 וב-Sonnet 4.6 ולחזור לתקציב החשיבה הקבוע שנשלט על ידי MAX_THINKING_TOKENS. אין השפעה על מודלי Fable, Sonnet 5 ואילך, Haiku 5.5, או Opus 4.7 ואילך, שתמיד משתמשים בחשיבה מסתגלת
CLAUDE_CODE_DISABLE_ADVISOR_TOOLהגדירו ל-1 כדי להשבית את כלי היועץ. הפקודה /advisor הופכת ללא זמינה, כל advisorModel שהוגדר מתעלמים ממנו, והדגל --advisor מתקבל אך אין לו השפעה, כך שסקריפטים קיימים שמעבירים אותו ממשיכים לעבוד בלי שגיאות
CLAUDE_CODE_DISABLE_AGENT_VIEWהגדירו ל-1 כדי לכבות סוכני רקע ותצוגת סוכן: claude agents, --bg, /background, והמפקח לפי דרישה. שקול להגדרה disableAgentView
CLAUDE_CODE_DISABLE_ALTERNATE_SCREENהגדירו ל-1 כדי להשבית עיבוד מסך מלא ולהשתמש במעבד המסך הראשי הקלאסי. השיחה נשארת ב-scrollback המקורי של הטרמינל כך ש-Cmd+f ומצב ההעתקה של tmux עובדים כרגיל. גובר על CLAUDE_CODE_NO_FLICKER ועל הגדרת tui. אפשר גם לעבור עם /tui default. לא חל על סשני רקע שנפתחו מתצוגת סוכן, שתמיד משתמשים בעיבוד מסך מלא
CLAUDE_CODE_DISABLE_ARTIFACTהגדירו ל-1 כדי לכבות את כלי Artifact, שמפרסם את פלט הסשן כדף אינטרנט פרטי ב-claude.ai. לאחר ההגדרה, אף קובץ הגדרות לא מפעיל את הכלי מחדש. כדי לכבות את הכלי מקובץ הגדרות, הגדירו את enableArtifact ל-false. גם המפתח disableArtifact שהוצא משימוש מכבה אותו
CLAUDE_CODE_DISABLE_ATTACHMENTSהגדירו ל-1 כדי להשבית עיבוד קבצים מצורפים. אזכורי קבצים בתחביר @ נשלחים כטקסט רגיל במקום להתרחב לתוכן הקובץ. מתעלמים ממנו בהגדרות פרויקט ומקומיות
CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCKהגדירו ל-1 כדי שתהליך Claude Code יריץ בעצמו את פקודת gcpAuthRefresh או awsAuthRefresh במקום להמתין בזמן שתהליך אחר מריץ אותה. דורש Claude Code v2.1.286 או מאוחר יותר
CLAUDE_CODE_DISABLE_AUTO_MEMORYהגדירו ל-1 כדי להשבית זיכרון אוטומטי. הגדירו ל-0 כדי לכפות הפעלה של זיכרון אוטומטי גם כאשר מצב --bare או autoMemoryEnabled: false היו משביתים אותו אחרת. כאשר מושבת, Claude אינו יוצר או טוען קבצי זיכרון אוטומטי
CLAUDE_CODE_DISABLE_BACKGROUND_TASKSהגדירו ל-1 כדי להסיר את הפרמטר run_in_background מכלי Bash, PowerShell וסוכן המשנה, ולכבות את קיצור Ctrl+B והרצות רקע של מיומנויות מפוצלות. Claude Code גם מפסיק אז להעביר אוטומטית סוכני משנה, קריאות כלי MCP ארוכות ופקודות מעטפת שפסק הזמן שלהן תם לרקע. משימות MCP וכלי Monitor עדיין רצים ברקע. כדי לכבות גם סשני רקע, הגדירו את CLAUDE_CODE_DISABLE_AGENT_VIEW ל-1
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULTהגדירו ל-1 כדי למנוע מ-Claude Code להתייחס לתגובת זרימה של Amazon Bedrock עם כותרת Content-Type חסרה או ריקה כאל זרם האירועים הבינארי של Amazon Bedrock. כברירת מחדל, Claude Code מניח ששער הסיר את הכותרת מתגובה שלא שונתה אחרת, ולכן הוא מפענח את הגוף והזרימה ממשיכה לעבוד. הגדירו זאת רק עבור שער שגם פולט מחדש את הזרם כאירועי server-sent. Claude Code קורא אז את הגוף בלי כותרת כאירועי server-sent. דורש Claude Code v2.1.239 או מאוחר יותר
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARDהגדירו ל-1 כדי לדלג על הבדיקה שתגובת זרימה של Amazon Bedrock נושאת את סוג התוכן application/vnd.amazon.eventstream. בלי משתנה זה, כאשר תגובה נושאת סוג תוכן אחר, Claude Code נכשל בבקשה עם שגיאה שמציינת את הסוג הזה, וזה אומר ששער או פרוקסי משנים את התגובה. הגדירו את השער להעביר את כותרת Content-Type ואת הגוף בלי שינוי, במקום להגדיר משתנה זה. דורש Claude Code v2.1.208 או מאוחר יותר
CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFFהגדירו ל-1 כדי לעצור עבודה בתהליך של סשן רקע כאשר המפקח עוצר, מפעיל מחדש או מעדכן את תהליך הסשן הזה, במקום להעביר אותה לתהליך הבא של הסשן. העבודה הזו היא פקודות מעטפת הרקע הרצות של הסשן, ובנוסף סוכני משנה ברקע החל מ-v2.1.198. משפיע רק על העברה זו: העברת סשן לרקע עם ← או /background עדיין מעבירה איתה עבודת רקע בתהליך. דורש Claude Code v2.1.196 או מאוחר יותר
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAPהגדירו ל-1 כדי למנוע מ-Claude Code לסיים פקודות מעטפת ברקע תחת לחץ זיכרון. כברירת מחדל, ב-macOS וב-Linux, Claude Code מסיים מעטפות רקע כאשר מערכת ההפעלה מדווחת על לחץ זיכרון קריטי והסשן היה לא פעיל במשך 30 דקות בלי סבב או סוכן משנה רץ. ל-Windows אין אות לחץ זיכרון, ולכן למשתנה זה אין השפעה שם. דורש Claude Code v2.1.193 או מאוחר יותר
CLAUDE_CODE_DISABLE_BG_STABLE_PATHב-macOS עם המתקין המקורי, הגדירו ל-1 כדי להריץ את תהליך המארח של כל סשן רקע מהבינארי המותקן, לא מ-~/.local/share/claude/ClaudeCode.app. macOS עשוי אז לבקש שוב הרשאות כגון גישה לתיקיות, כולל אחרי כל עדכון. הגדירו אותו בבלוק env של הגדרות משתמש, קובץ הגדרות מנוהל, או מדיניות MDM, לא במעטפת שלכם. כדי להסיר את ClaudeCode.app, מחקו אותו בעצמכם. דורש Claude Code v2.1.295 או מאוחר יותר
CLAUDE_CODE_DISABLE_BUNDLED_SKILLSהגדירו ל-1 כדי להשבית את המיומנויות וזרימות העבודה הכלולות ב-Claude Code: מיומנויות וזרימות עבודה ארוזות מוסרות לגמרי, בעוד פקודות מובנות כמו /init נשארות ניתנות להקלדה אך מוסתרות מהמודל. /doctor נשאר ניתן להקלדה כמו הפקודות המובנות. הסתירו אותו עם DISABLE_DOCTOR_COMMAND. מיומנויות מתוספים, מ-.claude/skills/ ומ-.claude/commands/ אינן מושפעות. שקול להגדרה disableBundledSkills
CLAUDE_CODE_DISABLE_CFC_PROMPTעבור מארחים שמשבצים את Claude Code ומספקים הנחיית דפדפן משלהם. הגדירו ל-1 כדי להשאיר את כלי הדפדפן של Claude in Chrome זמינים תוך השמטת מקטע Chrome של הנחיית המערכת ושל המיומנות הארוזה /claude-in-chrome. ב-VS Code, התוסף בגרסה v2.1.314 או מאוחר יותר גם משמיט את הוראות Claude in Chrome מהודעות הסשן. דורש Claude Code v2.1.257 או מאוחר יותר
CLAUDE_CODE_DISABLE_CLAUDE_MDSהגדירו ל-1 כדי למנוע טעינה של קבצי זיכרון CLAUDE.md כלשהם להקשר, כולל קבצי משתמש, פרויקט וזיכרון אוטומטי
CLAUDE_CODE_DISABLE_CRONהגדירו ל-1 כדי להשבית משימות מתוזמנות ברמת הסשן. המיומנות /loop וכלי cron הופכים ללא זמינים וכל משימה שכבר תוזמנה מפסיקה לפעול, כולל משימות שכבר רצות באמצע הסשן
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUTהגדירו ל-1 כדי לכבות את מגבלת הזמן והסירובים של auto ושל bypassPermissions על הסרות בנתיב קריטי. ההסרות האלה עוברות אז למסווג במצב auto, ומקבלות בקשה בלי מגבלת זמן במצב bypassPermissions בכל מקום שבו Claude Code יכול להציג אחת. הגדירו אותו בסביבה שמפעילה את Claude Code, כי Claude Code מתעלם מעותק שנמסר דרך בלוק env בהגדרות. דורש Claude Code v2.1.281 או מאוחר יותר
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETASהגדירו ל-1 כדי להסיר מבקשות API כותרות בקשה anthropic-beta של טרום שחרור, שדות הגוף שמתאימים להן, ושדות סכמת כלי בטא כגון defer_loading ו-eager_input_streaming. השתמשו בזה כאשר שער פרוקסי דוחה בקשות עם שגיאת Unexpected value(s) עבור כותרת anthropic-beta או שגיאת Extra inputs are not permitted. השבתת יכולות טרום שחרור מפרטת מה המשתנה מסיר, כולל חיפוש כלי MCP, ומה Claude Code ממשיך לשלוח
CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTSהגדירו ל-1 כדי להשבית את סוכני המשנה המובנים Explore ו-Plan. Claude חוקר עם כלי החיפוש שלו או עם סוכן המשנה הכללי, ומצב תוכנית קורא קבצים ישירות במקום להפעיל סוכני Explore ו-Plan. סוכני משנה מותאמים בשם Explore או Plan אינם מושפעים. כדי להסיר כל סוג סוכן משנה מובנה ב-Agent SDK או במצב לא אינטראקטיבי, השתמשו ב-CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS. דורש Claude Code v2.1.198 או מאוחר יותר
CLAUDE_CODE_DISABLE_FAST_MODEהגדירו ל-1 כדי להשבית מצב מהיר
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEYהגדירו ל-1 כדי להשבית את סקרי איכות הסשן "How is Claude doing?". הסקרים מושבתים גם כאשר DISABLE_TELEMETRY, DO_NOT_TRACK, או CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC מוגדר, אלא אם CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL בוחר להצטרף מחדש. כדי להגדיר שיעור דגימה במקום השבתה מלאה, השתמשו בהגדרה feedbackSurveyRate. ראו סקרי איכות סשן
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTINGהגדירו ל-1 כדי להשבית נקודות ביקורת של קבצים. הפקודה /rewind לא תוכל לשחזר שינויי קוד. דורס את ההגדרה fileCheckpointingEnabled
CLAUDE_CODE_DISABLE_FILE_MENTIONSהגדירו ל-1 כדי למנוע מ-Claude Code להרחיב אזכורי @ של קבצים ותיקיות. Claude מקבל את הנתיבים שהוזכרו עם הערה לקרוא אותם באמצעות כלי הקבצים שלו. מתעלמים ממנו בהגדרות פרויקט ומקומיות. דורש Claude Code v2.1.299 או מאוחר יותר
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONSהגדירו ל-1 כדי להסיר מההקשר של Claude הוראות מובנות לזרימת עבודה של commit ו-PR ואת תמונת מצב git. שימושי כשמשתמשים במיומנויות זרימת עבודה של git משלכם. גובר על ההגדרה includeGitInstructions כאשר הוא מוגדר
CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPTהגדירו ל-1 כדי למנוע מ-Claude Code לקרוא סקריפטים שמועברים למעטפת עם -c, כגון bash -c 'rm -rf ~', לצורך הסרות בנתיב קריטי. Claude Code עדיין בודק את יעדי משתני המעטפת והפרמטרים המיקומיים בסקריפטים האלה, ושאר בדיקות הנתיב הקריטי ממשיכות לרוץ. הגדירו אותו בסביבה שמפעילה את Claude Code, כי Claude Code מתעלם מעותק שנמסר דרך בלוק env בהגדרות. דורש Claude Code v2.1.288 או מאוחר יותר
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAPהגדירו ל-1 כדי למנוע מיפוי מחדש אוטומטי של Opus 4 ושל Opus 4.1 לגרסת Opus הנוכחית ב-API של Anthropic. השתמשו כאשר רוצים בכוונה לנעוץ מודל ישן יותר. המיפוי מחדש אינו רץ ב-Amazon Bedrock, ב-Agent Platform של Google Cloud, או ב-Microsoft Foundry
CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUNDהגדירו ל-1 כדי ש-Claude ימתין לתוצאה של משימת MCP בסשן אינטראקטיבי. כאשר העברה אוטומטית לרקע פעילה, הוא עדיין מעביר את הקריאה לרקע אחרי שתי דקות כברירת מחדל. דורש Claude Code v2.1.304 או מאוחר יותר
CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACKהגדירו ל-1 כדי למנוע מ-Claude Code ב-Amazon Bedrock וב-Agent Platform של Google Cloud לעבור למודל ישן יותר כאשר החשבון מאבד גישה למודל של הסשן באמצע הסשן. הבקשה שנדחתה נכשלת מיד. שרשרת מודלי גיבוי שהגדרתם עדיין עוברת על הסירוב הזה, ובדיקות המודל בהפעלה עדיין נופלות חזרה בהפעלה. דורש Claude Code v2.1.285 או מאוחר יותר
CLAUDE_CODE_DISABLE_MOUNTED_DRIVE_RM_PROMPTהגדירו ל-1 כדי לכבות את בקשת הכונן המחובר עבור נתיבים כגון /Volumes/USB. הגדירו אותו בסביבה שמפעילה את Claude Code, כי Claude Code מתעלם ממנו בבלוק env בהגדרות. דורש Claude Code v2.1.304 או מאוחר יותר
CLAUDE_CODE_DISABLE_MOUSEהגדירו ל-1 כדי להשבית מעקב עכבר בעיבוד מסך מלא. גלילה במקלדת עם PgUp ו-PgDn עדיין עובדת. השתמשו בזה כדי לשמור על התנהגות ההעתקה בבחירה המקורית של הטרמינל
CLAUDE_CODE_DISABLE_MOUSE_CLICKSהגדירו ל-1 כדי להשבית טיפול בלחיצה, גרירה וריחוף בעיבוד מסך מלא תוך שמירה על גלילת גלגל העכבר. השתמשו בזה כאשר רוצים שגלילת הגלגל תעבוד בתוך Claude Code אבל לא רוצים שלחיצות ימקמו את הסמן, ירחיבו פלט כלי, או יפתחו קישורים. CLAUDE_CODE_DISABLE_MOUSE גובר כאשר שניהם מוגדרים. דורש Claude Code v2.1.195 או מאוחר יותר
משתנהמטרה
CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTIONהגדר ל-1 כדי לעצור את Claude Code מקריאה מחדש של אישור הלקוח והמפתח של mTLS כשבקשת API נכשלת עם שגיאה ברמת החיבור, כמו איפוס חיבור או שגיאת לחיצת יד של TLS. כשהטעינה מחדש מושבתת, Claude Code טוען קבצים שעברו רוטציה רק כשהוא מיישם הגדרות בפעם הבאה או בהפעלה הבאה. דורש Claude Code v2.1.232 או גרסה מאוחרת יותר
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICהגדר לכל ערך שאינו ריק, כמו 1, כדי להשבית תעבורת רשת לא חיונית: עדכונים אוטומטיים, טלמטריה, דיווח שגיאות, הפקודה /feedback, משוב שנוסח על ידי Claude, הערות גרסה, בדיקות תג הסטטוס של PR ו-MR, ובדיקות זמינות כמו בדיקת מצב מהיר. זה גם עוצר את ההרצות ברקע של מקורות command של תוספים, שהן פקודות מקומיות ולא תעבורת רשת, כי הן יכולות להפעיל התקנות תלויות. הגדרה ל-0 או ל-false עדיין משביתה את התעבורה הזו, בניגוד לרוב משתני ההפעלה והכיבוי. בטל את הגדרת המשתנה כדי לאפשר אותה שוב. משבית גם שליפת feature flags, מה שהופך את Remote Control ואת שאר היכולות שדורשות שליפת feature flags ללא זמינות. התקנה אוטומטית של שוק התוספים הרשמי לא מכוסה. השבת אותה עם CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL. לא משפיע על גילוי מודלים של שער, שיש לו הצטרפות נפרדת משלו
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACKהגדר ל-1 כדי להשבית את ה-fallback הלא סטרימינג כשבקשת סטרימינג נכשלת באמצע הזרם. שגיאות סטרימינג מועברות לשכבת הניסיונות החוזרים. שימושי כשפרוקסי או שער גורמים ל-fallback לייצר הרצת כלים כפולה
CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECKהגדר ל-1 כדי לשלוח את התראת שולחן העבודה של כלי PushNotification גם בזמן שאתה מקליד בטרמינל או ממוקד בו. כברירת מחדל הכלי מדלג גם על התראת שולחן העבודה וגם על הדחיפה לנייד כשהוא מזהה פעילות מקלדת לאחרונה או מיקוד בטרמינל. המשתנה הזה משבית רק את הבדיקה המקומית הזו, כך שהשרת עדיין יכול לדכא את הדחיפה לנייד כשהוא מזהה שאתה פעיל. דורש Claude Code v2.1.193 או גרסה מאוחרת יותר
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALLהגדר ל-1 כדי להשבית רישום אוטומטי של שוק התוספים הרשמי. Claude Code קורא את המשתנה כשהוא עומד לרשום את השוק, בדרך כלל במהלך ההפעלה האינטראקטיבית הראשונה של מכונה. אם המשתנה מוגדר בנקודה הזו, Claude Code מדלג על הרישום לצמיתות. ביטול הגדרת המשתנה מאוחר יותר לא מבטל את הדילוג. הרץ claude plugin marketplace add anthropics/claude-plugins-official כדי לרשום את השוק בכל עת
CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKSהגדר ל-1 כדי לעצור את Claude Code מהרצת הוקי Notification לבקשות הרשאה שלא נענו בסשנים שבהם Claude Code שולח אותן ל-callback canUseTool של Agent SDK, וכך Claude Desktop והרחבת VS Code מארחים את Claude Code. אין השפעה בסשני טרמינל. דורש Claude Code v2.1.233 או גרסה מאוחרת יותר
CLAUDE_CODE_DISABLE_POLICY_SKILLSהגדר ל-1 כדי לדלג על טעינת כישורים מספריית הכישורים המנוהלת בכל המערכת. שימושי לסשנים של קונטיינר או CI שלא אמורים לטעון כישורים שהמפעיל סיפק
CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENYהגדר ל-1 כדי לכבות את הבדיקה של כלי PowerShell שדוחה את הפקודות המובנות של cmd rd, rmdir, del ו-erase על נתיב מערכת, כמו שורש כונן או ספריית הבית שלך. Claude Code מתעלם מהמשתנה הזה בבלוק env של קובץ הגדרות. דורש Claude Code v2.1.283 או גרסה מאוחרת יותר
CLAUDE_CODE_DISABLE_REFUSAL_FALLBACKהגדר ל-1 כדי לכבות את המעבר האוטומטי בין מודלים כשמסווג בטיחות מסמן בקשה, ההתנהגות שההגדרה switchModelsOnFlag שולטת בה
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTSהגדר ל-1 כדי לעצור את Claude Code משליחת שדה הפלט המובנה output_config.format וערך anthropic-beta שמתאים לו, עבור שער LLM שה-upstream שלו דוחה אותם. זה משאיר פעילות את שאר היכולות שלפני השחרור ש-CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS מכבה. דורש Claude Code v2.1.288 או גרסה מאוחרת יותר
CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPTהגדר ל-1 כדי לכבות את בדיקת הנתיב הקריטי עבור rm רקורסיבי שהיעד שלו הוא כולו הפלט של החלפת פקודה, כמו rm -rf "$(pwd)". שאר בדיקות הנתיב הקריטי ממשיכות לרוץ. הגדר אותו בסביבה שמפעילה את Claude Code, כי Claude Code מתעלם מעותק שנמסר דרך בלוק env של הגדרות. דורש Claude Code v2.1.281 או גרסה מאוחרת יותר
CLAUDE_CODE_DISABLE_TERMINAL_TITLEהגדר ל-1 כדי להשבית עדכונים אוטומטיים של כותרת הטרמינל לפי הקשר השיחה. זה גם מדלג על בקשת הרקע למודל הקטן/המהיר שיוצרת כותרת סשן, ומכבה דיווחי סטטוס לטרמינל שלך
CLAUDE_CODE_DISABLE_THINKINGהגדר ל-1 כדי להשמיט את הפרמטר thinking מבקשות API לגמרי. זו אפשרות תאימות לפרוקסי ולשערים שדוחים את הפרמטר. במודלים שחושבים כברירת מחדל, השמטת הפרמטר אומרת שהמודל עדיין עשוי לחשוב. כדי להשבית במפורש חשיבה מורחבת ב-API של Anthropic, השתמש ב-MAX_THINKING_TOKENS=0 במקום. אף אחד משני המשתנים לא מכבה חשיבה ב-Opus 5.5, ב-Sonnet 5.5, ב-Haiku 5.5 או במודלי Fable, שאי אפשר לכבות בהם חשיבה. אצל ספקים צד שלישי, MAX_THINKING_TOKENS=0 גם משמיט את הפרמטר, כך ששני המשתנים מתנהגים שם אותו דבר
CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECKהגדר ל-1 כדי ש-claude ultrareview לא ייצא עם Error: Workspace not trusted בתיקייה שלא נתת בה אמון כשהוא לא יכול לבקש ממך לתת אמון, כמו ב-CI. הגדר אותו בסביבה שמפעילה את Claude Code, לא בבלוק env של הגדרות, ורק במקום שבו כל הרצה כזו מתחילה בתיקייה שאתה סומך עליה. הרצות שיכולות לשאול עדיין שואלות. דורש Claude Code v2.1.309 או גרסה מאוחרת יותר
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENTהגדר ל-1 כדי לדלג על דחיסה אוטומטית יזומה כש-Claude Code לא מזהה את מזהה המודל, כמו כינוי של שער LLM. בלי המשתנה הזה, Claude Code דוחס בחלון ההקשר שהוא מניח עבור המזהה. CLAUDE_CODE_MAX_CONTEXT_TOKENS יכול לתקן את החלון המשוער במקום. ראה תיקון החלון עבור שער או מזהה מודל מותאם למתי כל משתנה חל. דורש Claude Code v2.1.223 או גרסה מאוחרת יותר
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLLהגדר ל-1 כדי להשבית גלילה וירטואלית בעיבוד מסך מלא ולעבד כל הודעה בתמליל. השתמש בזה אם גלילה במצב מסך מלא מציגה אזורים ריקים במקום שבו הודעות אמורות להופיע
CLAUDE_CODE_DISABLE_WEB_FETCHהגדר ל-1 כדי לכבות את כלי WebFetch. כלי WebSearch נשאר זמין. דורש Claude Code v2.1.285 או גרסה מאוחרת יותר
CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHERהגדר ל-1 כדי להפעיל פקודות של כלי PowerShell ב-Windows ישירות, במקום דרך המשגר cmd.exe. כברירת מחדל, המשגר מאפשר לפקודת PowerShell שרצה ברקע לעבור לתהליך הבא של הסשן, כמו כשאתה מעביר את הסשן לרקע. אם תגדיר את המשתנה, פקודת PowerShell ברקע נעצרת כשתהליך הסשן יוצא. פקודות Bash לא מושפעות. דורש Claude Code v2.1.269 או גרסה מאוחרת יותר
CLAUDE_CODE_DISABLE_WORKFLOWSהגדר ל-1 כדי להשבית workflows. שקול להגדרה disableWorkflows
CLAUDE_CODE_EFFORT_LEVELהגדר את רמת המאמץ למודלים נתמכים. ערכים: low, medium, high, xhigh או max. הרמות הזמינות תלויות במודל. גובר על --effort, על /effort ועל ההגדרות modelSettings ו-effortLevel. תקרת maxEffortLevel עדיין חלה. הגדר ל-auto או ל-unset כדי ש-Claude Code לא ישלח רמת מאמץ, כך שה-API יחיל את ברירת המחדל שלו למודל. ראה התאמת רמת מאמץ
CLAUDE_CODE_EMIT_SESSION_STATE_EVENTSהגדר ל-1 כדי להוסיף הודעות session_state_changed, שנושאות את מצב הסשן, לזרם ההודעות. דורש את Agent SDK או את --print, --output-format stream-json ו---verbose
CLAUDE_CODE_ENABLE_AUTO_MODEמתקבל לתאימות עם גרסאות ישנות יותר ואין לו השפעה. מצב אוטומטי זמין כברירת מחדל אצל כל ספק, כולל Amazon Bedrock, Agent Platform של Google Cloud, Microsoft Foundry וסשנים מחוברים של שער יישומי Claude. ב-v2.1.158 עד v2.1.206, הגדרה ל-1 נדרשה כדי להפוך את מצב אוטומטי לזמין אצל הספקים האלה
CLAUDE_CODE_ENABLE_AWAY_SUMMARYדריסת זמינות סיכום סשן. הגדר ל-0 כדי לכפות כיבוי סיכומים בלי קשר למתג /config. הגדר ל-1 כדי לכפות הפעלת סיכומים כש-awaySummaryEnabled הוא false. גובר על ההגדרה ועל מתג /config
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESHהגדר ל-1 כדי לרענן את מצב התוסף בגבולות תור במצב לא אינטראקטיבי אחרי שהתקנה ברקע מסתיימת. כבוי כברירת מחדל כי הרענון משנה את הנחיית המערכת באמצע הסשן, מה שמבטל שמירת הנחיות במטמון עבור התור הזה
CLAUDE_CODE_ENABLE_CFCהגדר ל-1 כדי להתחיל סשן CLI עם שילוב Chrome מופעל, או ל-0 כדי להתחיל איתו כבוי. גובר על ההגדרה claudeInChromeDefaultEnabled. הדגלים --chrome ו---no-chrome גוברים על שניהם. Claude Code מתעלם מ-1 בהגדרות פרויקט והגדרות מקומיות
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTELהגדר ל-1 כדי לנתב את סקר איכות הסשן "How is Claude doing?" אל אספן OpenTelemetry שלך כשתעבורה לא חיונית שמיועדת ל-Anthropic חסומה. דירוגי הסקר נפלטים רק כאירועי OTEL לאספן שהגדרת. במצב הזה לא נשלחים נתוני סקר ל-Anthropic. חל כש-CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_TELEMETRY או DO_NOT_TRACK מוגדר, ואין לו השפעה אחרת. CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY ומדיניות משוב המוצר של הארגון גוברים
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMINGשולט אם קלטי קריאות כלים מוזרמים מה-API בזמן ש-Claude מייצר אותם. כשזה כבוי, קלט כלי גדול כמו כתיבת קובץ ארוכה מגיע רק אחרי ש-Claude מסיים לייצר אותו, מה שיכול להיראות כאילו הוא תקוע. מופעל כברירת מחדל ב-API של Anthropic. ב-Amazon Bedrock וב-Agent Platform של Google Cloud, מופעל לפי מודל כשהקונטיינר שנפרס תומך בזה. הגדר ל-0 כדי לבטל הצטרפות. הגדר ל-1 כדי לכפות הפעלה כשמנתבים דרך פרוקסי באמצעות ANTHROPIC_BASE_URL, ANTHROPIC_VERTEX_BASE_URL או ANTHROPIC_BEDROCK_BASE_URL. כבוי כברירת מחדל ב-Microsoft Foundry ובחיבורי שער
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERYהגדר ל-1 כדי למלא את בורר /model מנקודת הקצה /v1/models של השער שלך כש-ANTHROPIC_BASE_URL מצביע על שער תואם Anthropic כמו LiteLLM, Kong או פרוקסי פנימי. כבוי כברירת מחדל כי שערים שמגובים במפתח API משותף היו אחרת מציגים לכל משתמש כל מודל שהמפתח יכול לגשת אליו. מודלים שהתגלו עדיין מסוננים לפי רשימת היתר availableModels שהסשן מקבל. מסור את הרשימה דרך MDM או קובץ הגדרות מנוהל, כי מסירה שמנוהלת בשרת לא זמינה בתצורות שער
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODEהוסר ב-v2.1.142, כשברירת המחדל של מצב מהיר עברה מ-Opus 4.6 ל-Opus 4.7
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTIONהגדר ל-false כדי לכבות הצעות הנחיה, התחזיות האפורות שמופיעות בשדה קלט ההנחיה שלך. גובר על ההגדרה promptSuggestionEnabled, ואותה כותב המתג Prompt suggestions ב-/config. Claude Code גם משהה הצעות כשהחשבון שלך קרוב למגבלת השימוש או הגיע אליה. הגדר ל-true כדי שההשהיה הזו לא תחול עד שתגיע למגבלה. דורש Claude Code v2.1.238 או גרסה מאוחרת יותר. ראה הצעות הנחיה
CLAUDE_CODE_ENABLE_SHARE_BUNDLEהגדר ל-1 כדי ש-/share ישמור את הדוח שלו ואת כל תמליל הסשן בארכיון מקומי תחת ~/.claude/feedback-bundles/ במקום לשלוח את הדוח ל-Anthropic. אם מדיניות הארגון שלך מכבה את /share, אי אפשר להפעיל אותו מחדש עם המשתנה הזה. דורש Claude Code v2.1.299 או גרסה מאוחרת יותר
CLAUDE_CODE_ENABLE_TASKSבוחר אילו כלי מעקב משימות Claude Code מספק בסשנים שיש בהם אותם. כברירת מחדל, Claude Code מספק את כלי Task TaskCreate, TaskUpdate, TaskGet ו-TaskList. הגדר ל-0 כדי לקבל במקום זאת את כלי TodoWrite הישן. ראה רשימת משימות
CLAUDE_CODE_ENABLE_TELEMETRYהגדר ל-1 כדי להפעיל איסוף נתוני OpenTelemetry למדדים ולרישום. נדרש לפני הגדרת מייצאי OTel. הגדר אותו במעטפת, בהגדרות משתמש או בהגדרות מנוהלות. מתעלמים ממנו בהגדרות פרויקט והגדרות מקומיות. ראה ניטור
CLAUDE_CODE_ENABLE_TODO_TOOLSהגדר ל-1 כדי לקבל את כלי מעקב המשימות בכל מודל. בלעדיו, Claude Code מספק אותם כברירת מחדל רק במודלים שרשומים תחת זמינות כלי Task. CLAUDE_CODE_ENABLE_TASKS עדיין בוחר את כלי Task או את TodoWrite. דורש Claude Code v2.1.233 או גרסה מאוחרת יותר
משתנהמטרה
CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONSהגדר ל-1 כדי להריץ פקודות rm מסוכנות בלי בקשה במצב bypassPermissions, מה שמסיר בקשת בטיחות למחיקות הרסניות. הקטע המקושר מפרט איפה אין לזה השפעה. הגדר אותו בסביבה שמפעילה את Claude Code, כי Claude Code מתעלם ממנו בבלוק env של הגדרות. דורש Claude Code מגרסה v2.1.311 ואילך
CLAUDE_CODE_EXIT_AFTER_STOP_DELAYזמן במילישניות להמתין אחרי שלולאת השאילתה הופכת ללא פעילה לפני יציאה אוטומטית. שימושי לתהליכי עבודה אוטומטיים ולסקריפטים שמשתמשים במצב SDK
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMSהגדר ל-1 כדי להפעיל צוותי סוכנים. צוותי סוכנים הם ניסיוניים ומושבתים כברירת מחדל
CLAUDE_CODE_EXTRA_BODYאובייקט JSON למיזוג ברמה העליונה של גופי בקשות המודל, למעט בחלק מהבקשות מחוץ לשיחה, כמו בדיקות /model. שימושי להעברת פרמטרים ספציפיים לספק ש-Claude Code לא חושף ישירות. ערך שמיוצא ב-shell שלך חל גם על הפעלות הרקע שאתה משגר עם claude agents או --bg. לפני v2.1.206, הפעלות רקע התעלמו מערך שמיוצא ב-shell והשתמשו בכל עותק שתהליך המפקח ברקע ירש
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENSדריסת מגבלת הטוקנים כברירת מחדל לקריאות קבצים, שהיא 25,000 טוקנים. שימושי כשצריך לקרוא קבצים גדולים יותר במלואם. קריאה ש-Claude מבצע עם הפרמטר allow_large יכולה לעבור את המגבלה הזאת כשיש מקום בחלון ההקשר
CLAUDE_CODE_FORCE_SESSION_PERSISTENCEהגדר ל-1 כדי לכפות שמירת תמליל, היסטוריית בקשות, ורישום claude agents גם כשה-claude הזה הופעל מתוך הפעלת Claude Code אחרת. השתמש כשערך CLAUDE_CODE_CHILD_SESSION שעבר בירושה, למשל מהפעלת screen או ממפעיל רקע שהופעל לראשונה על ידי כלי Bash של Claude Code, גורם להפעלה אמיתית ברמה העליונה להיות מסווגת בטעות כמקוננת. החל מ-v2.1.178, Claude Code מזהה את מקרה tmux אוטומטית ומתעלם מהסמן שעבר בירושה, כך ש-tmux כבר לא צריך את המשתנה הזה. מכובד גם ב-v2.1.169 ובגרסאות מוקדמות יותר. אין לו השפעה ב-v2.1.170 וב-v2.1.171, שבהן זיהוי ההפעלה המקוננת שהוא דורס הוסר
CLAUDE_CODE_FORCE_STRIKETHROUGHהגדר ל-1 כדי לכפות עיבוד קו חוצה עבור ~~text~~ בתשובות של Claude כשהטרמינל תומך בזה אבל לא מזוהה אוטומטית, כמו מעל SSH בלי העברת TERM_PROGRAM. בלי זה, טרמינלים שלא זוהו מציגים את הסמנים המילוליים ~~ במקום לעבד את הטקסט כקו חוצה. דורש Claude Code מגרסה v2.1.186 ואילך
CLAUDE_CODE_FORCE_SYNC_OUTPUTהגדר ל-1 כדי לכפות הפעלה של מצב פרטי DEC 2026 פלט מסונכרן כשהטרמינל תומך בזה אבל לא מזוהה אוטומטית. שימושי לאמולטורים כמו Emacs eat שמממשים BSU/ESU אבל לא עונים לבדיקת היכולת. אין לו השפעה תחת tmux. בניגוד ל-CLAUDE_CODE_NO_FLICKER, שעובר לעיבוד במסך מלא, זה לא משנה את ה-renderer
CLAUDE_CODE_FORCE_TERMINAL_IMAGESהגדר ל-1 כדי לצייר רכיבי Image של mod כתמונות כשהטרמינל מצייר תמונות בפרוטוקול הגרפיקה של kitty עם מצייני מקום של Unicode ואתה עדיין רואה את טקסט alt המעומעם של Image. ראה אילו טרמינלים מציירים Image ואיפה לא להגדיר את המשתנה הזה
CLAUDE_CODE_FORK_SUBAGENTשולט במצב fork, שפועל כברירת מחדל ומאפשר ל-Claude להתחיל forks בעצמו. בזמן שמצב fork פועל, Claude גם לא יכול להמתין ל-subagent בטרמינל אינטראקטיבי, ב-VS Code, או בהפעלות שולחן עבודה במחשב שלך. הגדר ל-0 כדי לכבות את מצב fork. לגרסאות, ראה כיבוי מצב fork
CLAUDE_CODE_FORWARD_SUBAGENT_TEXTהגדר ל-1 כדי לפלוט בלוקי טקסט וחשיבה של subagent בפלט claude -p --output-format stream-json, אותה התנהגות כמו הדגל --forward-subagent-text. השתמש במשתנה כש-harness מפעיל את claude ולא יכול להעביר את הדגל בעצמו. בניגוד לדגל, שיוצא עם שגיאה מחוץ למצב לא אינטראקטיבי עם פלט stream-json, המשתנה מתעלמים ממנו שם כדי שהפעלות מקוננות ימשיכו לעבוד כשהוא מוגדר ברמת התהליך כולו. דורש Claude Code מגרסה v2.1.211 ואילך
CLAUDE_CODE_GATEWAY_HINT_HEADERSהגדר ל-1 כדי לשלוח את כותרות הרמז של ה-gateway, כמו x-claude-code-request-class ו-x-claude-code-compaction, על פרוקסי מותאם או ספק צד שלישי כמו Amazon Bedrock או Claude Platform on AWS. הגדר ל-0 כדי להפסיק לשלוח אותן בכל חיבור, כולל חיבור ישיר ל-API של Anthropic, שבו Claude Code שולח אותן כברירת מחדל. דורש Claude Code מגרסה v2.1.273 ואילך
CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MSזמן קצוב במילישניות לבקשת גילוי מודלים ב-gateway ש-CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY מפעיל (ברירת מחדל: 3000). העלה אותו כשה-gateway צריך יותר משלוש שניות כדי לענות ל-/v1/models בהפעלה. מקבל ספרות פשוטות בלבד. 0, ערכים שליליים, ואיותים אחרים שומרים על ברירת המחדל. דורש Claude Code מגרסה v2.1.269 ואילך
CLAUDE_CODE_GIT_BASH_PATHWindows בלבד: נתיב לקובץ ההרצה של Git Bash (bash.exe). השתמש כש-Git Bash מותקן אבל לא ב-PATH. אם הנתיב לא קיים או שהקובץ לא נקרא bash.exe, sh.exe, bash, או sh, Claude Code מתעלם מהמשתנה ומזהה את Git Bash אוטומטית כאילו לא הוגדר, ורושם אזהרה שגלויה עם --debug. לפני v2.1.219, Claude Code יצא בהפעלה כשהנתיב לא היה קיים, והשתמש בכל קובץ קיים כ-shell בלי לבדוק שהוא bash או sh. ראה הגדרת Windows
CLAUDE_CODE_GLOB_HIDDENהגדר ל-false כדי להוציא קובצי נקודה מהתוצאות כש-Claude מפעיל את כלי Glob. כלולים כברירת מחדל. לא משפיע על השלמה אוטומטית של קבצים עם @, על ls, על Grep, או על Read
CLAUDE_CODE_GLOB_NO_IGNOREהגדר ל-false כדי שכלי Glob יכבד תבניות .gitignore. כברירת מחדל, Glob מחזיר את כל הקבצים התואמים כולל כאלה ש-git מתעלם מהם. לא משפיע על השלמה אוטומטית של קבצים עם @, שיש לה הגדרת respectGitignore משלה
CLAUDE_CODE_GLOB_TIMEOUT_SECONDSזמן קצוב בשניות לחיפושי כלי Glob ו-Grep. ברירת המחדל היא 20 שניות ברוב הפלטפורמות ו-60 שניות ב-WSL
CLAUDE_CODE_GOAL_CHECKIN_MINUTESכמה דקות עבודת רקע יכולה להשאיר מטרה פעילה ממתינה לפני ש-Claude Code מבקש מ-Claude לבדוק אותה. ברירת מחדל 30. הגדר 0 כדי לכבות בדיקות. תן דקות שלמות בספרות פשוטות, לכל היותר 10080, שזה שבוע אחד. Claude Code מתייחס לכל ערך אחר כלא מוגדר ומשתמש בברירת המחדל. דורש Claude Code מגרסה v2.1.234 ואילך
CLAUDE_CODE_GZIP_REQUEST_BODIESהגדר ל-0 כדי לכבות דחיסת gzip של גופי בקשות Claude API, טלמטריה, ופרסום artifact שנשלחים ל-api.anthropic.com. כברירת מחדל, Claude Code דוחס גופי בקשות גדולים בחיבורים ישירים ומדלג על דחיסה כששולחים בקשות דרך פרוקסי, מגדירים אישור לקוח, או מגדירים NODE_EXTRA_CA_CERTS. השתמש ב-0 אם פרוקסי שבודק TLS ש-Claude Code לא יכול לזהות מטפל לא נכון בבקשות דחוסות
CLAUDE_CODE_HIDE_CWDהגדר ל-1 כדי להסתיר את ספריית העבודה בלוגו ההפעלה. שימושי לשיתופי מסך או להקלטות שבהן הנתיב חושף את שם המשתמש במערכת ההפעלה
CLAUDE_CODE_IDE_HOST_OVERRIDEדריסת כתובת המארח שמשמשת להתחברות להרחבת ה-IDE. כברירת מחדל Claude Code מזהה אוטומטית את הכתובת הנכונה, כולל ניתוב מ-WSL ל-Windows
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALLהגדר ל-1 כדי לעצור את /ide מהתקנת הרחבת ה-IDE. שקול להגדרת autoInstallIdeExtension ל-false
CLAUDE_CODE_IDE_SKIP_VALID_CHECKהגדר ל-1 כדי לדלג על אימות רשומות קובץ הנעילה של ה-IDE במהלך החיבור. השתמש כשהתחברות אוטומטית נכשלת למצוא את ה-IDE למרות שהוא רץ
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENSגודל הקשר, בטוקנים, שבו דחיסה בזמן חוסר פעילות חלה על שיחה (ברירת מחדל: 200000). מקבל מספר שלם חיובי, וכל דבר אחר מתעלמים ממנו. ערכים מתחת ל-100000 מועלים ל-100000, הסף הנמוך ביותר. דחיסה בזמן חוסר פעילות פועלת כברירת מחדל לשיחות שעומדות בתנאים שלה. כדי לכבות אותה, הגדר idleCompaction ל-false. דורש Claude Code מגרסה v2.1.290 ואילך
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTSכמה subagents יכולים לרוץ בהפעלה אחת לפני שכלי Agent מסרב להפעיל עוד אחד (ברירת מחדל: 20). מקבל מספר שלם חיובי בספרות פשוטות. כל דבר אחר מתעלמים ממנו, כך שהמשתנה יכול לכוונן את התקרה אבל לא יכול להשבית אותה. דורש Claude Code מגרסה v2.1.217 ואילך
CLAUDE_CODE_MAX_CONTEXT_TOKENSדריסת גודל חלון ההקשר ש-Claude Code מניח עבור המודל הפעיל. החל מ-v2.1.193, איך זה חל תלוי באיך Claude Code פותר את מזהה המודל. ראה תיקון החלון עבור מזהה מודל של gateway או מודל מותאם. השתמש בזה כשמנתבים למודל דרך ANTHROPIC_BASE_URL שחלון ההקשר שלו לא תואם את הגודל המובנה לשמו
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTHאורך מרבי בתווים של תיאורי כלי MCP ושל הוראות שרת MCP ש-Claude Code שולח למודל. הערך שאתה מגדיר מחליף את שתי מגבלות ברירת המחדל: 4096, ו-16384 לתיאור של כלי ש-Claude טוען דרך חיפוש כלים. מקבל מספר שלם חיובי בספרות פשוטות. כל דבר אחר מתעלמים ממנו וברירות המחדל חלות. דורש Claude Code מגרסה v2.1.280 ואילך
CLAUDE_CODE_MAX_OUTPUT_TOKENSהגדר את המספר המרבי של טוקני פלט לרוב הבקשות. ברירות מחדל ותקרות משתנות לפי מודל. ראה טוקני פלט מרביים. Claude Code מוריד ערך שמעל התקרה של מודל לתקרה. עבור מזהה מודל ש-Claude Code לא יכול לפתור למודל שהוא מכיר, ברירת המחדל היא 32000 והתקרה היא 128000. הגדלת הערך הזה מקטינה את חלון ההקשר האפקטיבי הזמין לפני שדחיסה אוטומטית מופעלת
CLAUDE_CODE_MAX_RETRIESדריסת מספר הפעמים לנסות שוב בקשות API שנכשלו (ברירת מחדל: 10). ניסיון חוזר יכול להיעצר מוקדם יותר בשגיאות עומס 529. לדוגמה, עם מפתח API במודל Opus, זה נעצר ב-529 השלישי ומציג שגיאות Repeated 529 Overloaded. אם הגדרת מודל גיבוי, Claude Code עובר למודל הזה במקום להציג את השגיאה. מוגבל ל-15 החל מ-v2.1.186. החל מ-v2.1.199, CLAUDE_CODE_RETRY_WATCHDOG מעלה את ברירת המחדל ומסיר את התקרה. להפעלות ללא השגחה שצריכות להמתין דרך השבתות ארוכות יותר, הגדר CLAUDE_CODE_RETRY_WATCHDOG במקום
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSIONהוסר ב-v2.1.224 ועכשיו הוא no-op. קודם הגביל את המספר הכולל של subagents ש-Claude יכול להפעיל עם כלי Agent בהפעלה אחת (ברירת מחדל: 200). הפעלה מעבר לתקרה נכשלה עם Subagent spawn limit reached. מגבלת ה-subagents המקבילים ומגבלת העומק עדיין חלות
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTHמספר שכבות subagent המותרות מתחת לשיחה הראשית (ברירת מחדל: 3). בברירת המחדל, subagents יכולים להפעיל subagents משלהם, ו-subagent בשכבה השלישית לא יכול להפעיל הלאה. הגדר 1 כדי לכבות קינון. ב-v2.1.217 עד v2.1.218, ברירת המחדל הייתה 1, כך ש-subagent לא יכול היה להפעיל משלו אלא אם העלית את המגבלה. v2.1.219 העלה את ברירת המחדל ל-3. מקבל מספר שלם חיובי בספרות פשוטות. כל דבר אחר מתעלמים ממנו, כך שאפשר לכוונן את המגבלה אבל לא להסיר אותה. דורש Claude Code מגרסה v2.1.217 ואילך
CLAUDE_CODE_MAX_TURNSהגבל את מספר התורות הסוכניות כשלא מועברת מגבלה מפורשת. שקול להעברת --max-turns, שקודמת כששניהם מוגדרים. ערך שאינו מספר שלם חיובי נדחה בהפעלה עם שגיאה במקום להיות מטופל כהיעדר תקרה
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSIONתקרה לקריאות WebSearch (ברירת מחדל: 200). כש-Claude מגיע לתקרה, קריאות WebSearch נוספות מחזירות הודעה שאומרת לו להמשיך עם המידע שכבר אסף ולומר זאת בתשובה שלו. מקבל מספר שלם חיובי בלי גבול עליון. כל דבר אחר מתעלמים ממנו וברירת המחדל חלה, כך שאפשר להעלות את התקרה אבל לא לכבות אותה. דורש Claude Code מגרסה v2.1.212 ואילך
CLAUDE_CODE_MCP_ALLOWLIST_ENVהגדר ל-1 כדי להפעיל שרתי MCP מסוג stdio רק עם סביבת בסיס בטוחה ועם env המוגדר של השרת, במקום לרשת את סביבת ה-shell שלך
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MSזמן שחלף במילישניות לפני שקריאת כלי MCP שעדיין רצה עוברת למשימת רקע (ברירת מחדל: 120000, או 2 דקות). הגדר ל-0 כדי לכבות מעבר אוטומטי לרקע, ובהפעלה אינטראקטיבית, כדי לגרום ל-Claude להמתין למשימות MCP. דורש Claude Code מגרסה v2.1.212 ואילך
CLAUDE_CODE_MCP_STARTUP_WAIT_MSכמה זמן במילישניות התור הראשון של הפעלה לא אינטראקטיבית ממתין לשרתי MCP שעדיין מתחברים, במקום ההמתנה של התור הראשון כברירת מחדל. בסביבה באירוח עצמי, זה משנה רק כמה זמן ההמתנה נמשכת. חלק מהשרתים שומרים על המתנה משלהם בלי קשר לערך. תזמון חיבור מפרט אותם. הגדר ל-0 כדי לדלג על ההמתנה לכל שרת אחר. דורש Claude Code מגרסה v2.1.274 ואילך
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUTזמן קצוב לחוסר פעילות במילישניות לקריאות כלי MCP. כששרת MCP מסוג stdio, HTTP, SSE, WebSocket, או מחבר claude.ai לא שולח תשובה ולא התראת התקדמות במשך הזמן הזה, קריאת הכלי נפסקת עם שגיאה במקום להמתין ל-MCP_TOOL_TIMEOUT הכולל. דורס את ברירות המחדל לפי תעבורה של 300000 (5 דקות) לשרתי רשת ו-1800000 (30 דקות) לשרתי stdio. הגדר ל-0 כדי להשבית את בדיקת חוסר הפעילות. ערכים מתחת ל-1000 מועלים לשנייה אחת, והערך מוגבל ל-MCP_TOOL_TIMEOUT האפקטיבי. timeout לכל שרת ב-.mcp.json של לפחות 1000 מעלה את חלון חוסר הפעילות של השרת הזה לפחות לערך timeout. לא חל על שרתי IDE או על שרתי SDK בתוך התהליך. דורש Claude Code מגרסה v2.1.187 ואילך. לפני v2.1.203, שרתי stdio היו פטורים מזמן הקצוב לחוסר פעילות
CLAUDE_CODE_MESSAGING_SOCKETמוגדר על ידי Claude Code, לא על ידך: בהפעלות שקושרות שקע inbox, Claude Code מייצא את הנתיב של השקע הזה ל-hooks ולפקודות Bash כשהוא קושר את השקע. בהפעלה שמתחילה עם messaging פועל, Claude Code קושר את השקע לפני שרץ hook כלשהו. הפעלות אחרות במחשב מעבירות הודעות לנתיב הזה. כל הפעלה מייצאת את השקע שלה ולא אחד שעבר בירושה מהורה, והודעות שמגיעות אליו עוברות דרך בקרות נכנסות של ההפעלה. בלוקי env בהגדרות לא יכולים להגדיר אותו. דורש Claude Code מגרסה v2.1.224 ואילך
משתנהמטרה
CLAUDE_CODE_MESSAGING_TOKENמוגדר על ידי Claude Code, ולא על ידך: בסשנים שקושרים שקע inbox, Claude Code מייצא את האסימון הזה לפי סשן אל hooks ואל פקודות Bash לצד CLAUDE_CODE_MESSAGING_SOCKET. סקריפט ששולח לשקע יכול לשלוח {"type":"auth","token":"<token>"} כשורה הראשונה שלו כדי להוכיח שהוא שייך לסשן. ב-Windows מקורי, Claude Code דורש את השורה הזו וסוגר כל חיבור שלא נפתח בשורה תקינה. כללי own-child אומרים מתי Claude Code מתייעץ באסימון. כל סשן מייצא את האסימון שלו, ולעולם לא אסימון שירש מסשן אב. בלוקי env בהגדרות לא יכולים להגדיר אותו. דורש Claude Code v2.1.228 או חדש יותר
CLAUDE_CODE_NATIVE_CURSORהגדר ל-1 כדי להציג את הסמן של הטרמינל עצמו בנקודת הקלט במקום בלוק מצויר. הסמן מכבד את הגדרות ההבהוב, הצורה והמיקוד של הטרמינל. הגדרה ל-0 נקראת כמו השארת המשתנה בלי ערך, ולכן היא לא מחזירה את הבלוק המצויר בסשן שבו הסמן של הטרמינל עצמו כבר דולק
CLAUDE_CODE_NEW_INITהגדר ל-1 כדי ש-/init יריץ תהליך הגדרה אינטראקטיבי. התהליך שואל אילו קבצים לייצר, כולל CLAUDE.md, skills ו-hooks, לפני שהוא חוקר את בסיס הקוד וכותב אותם. בלי המשתנה הזה, /init מייצר CLAUDE.md באופן אוטומטי בלי הנחיה
CLAUDE_CODE_NONBLOCKING_STDOUTהגדר ל-1 כדי לכתוב פלט טרמינל דרך מתאר קובץ שני שאינו חוסם, כך שטרמינל שמפסיק לקרוא, כמו חלונית tmux במצב שליטה שהושהתה או חיבור SSH שנתקע, לא יכול להקפיא את Claude Code באמצע הסשן. חל ב-macOS, ב-Linux וב-WSL כש-stdout הוא טרמינל. דורש Claude Code v2.1.261 או חדש יותר
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIESמגביל כמה פעמים Claude Code שולח מחדש בקשה שאינה בסטרימינג שפג זמנה. עם 0, הבקשה נכשלת בתום הזמן הראשון. ראה כוונון התנהגות ניסיונות חוזרים לגבי תום הזמן. דורש Claude Code v2.1.285 או חדש יותר
CLAUDE_CODE_NO_FLICKERהגדר ל-1 כדי להפעיל רינדור מסך מלא, תצוגה מקדימה מחקרית שמפחיתה הבהוב ושומרת על זיכרון שטוח בשיחות ארוכות. דורס את הגדרת tui. אפשר גם לעבור עם /tui fullscreen
CLAUDE_CODE_OAUTH_REFRESH_TOKENאסימון רענון OAuth לאימות מול claude.ai. כשהוא מוגדר, claude auth login מחליף את האסימון הזה ישירות במקום לפתוח דפדפן. דורש CLAUDE_CODE_OAUTH_SCOPES. שימושי להקצאת אימות בסביבות אוטומטיות. מתעלמים ממנו בהגדרות פרויקט והגדרות מקומיות
CLAUDE_CODE_OAUTH_SCOPESהיקפי OAuth מופרדים ברווחים שהאסימון לרענון הונפק איתם, כמו "user:profile user:inference user:sessions:claude_code". נדרש כש-CLAUDE_CODE_OAUTH_REFRESH_TOKEN מוגדר. מתעלמים ממנו בהגדרות פרויקט והגדרות מקומיות
CLAUDE_CODE_OAUTH_TOKENאסימון גישה OAuth לאימות מול claude.ai. חלופה ל-/login עבור SDK וסביבות אוטומטיות. מתעלמים ממנו בהגדרות פרויקט והגדרות מקומיות. מקבל עדיפות על אישורים שמורים ב-keychain. צור אחד עם claude setup-token. אלא אם מריצים /login, Claude Code משתמש באסימון שהגדרת לכל הסשן. כדי להחליף אסימון שפג תוקפו, צור אסימון חדש והפעל מחדש
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDEהוסר ב-v2.1.160 ועכשיו הוא no-op. בעבר קיבע את מצב מהיר ל-Claude Opus 4.6 במקום ברירת המחדל הנוכחית. Opus 4.6 כבר לא תומך במצב מהיר
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTHהאורך המרבי של מאפייני OpenTelemetry שנושאים תוכן (תשובות מודל, תוכן כלים, הנחיות מערכת, גופי API גולמיים), כולל סמן הקיטום, ביחידות קוד UTF-16 (ברירת מחדל: 61440, כלומר 60 KB). העלה אותו רק אם מערכת הטלמטריה שלך מקבלת ערכי מאפיינים גדולים מ-64 KB, או הורד אותו כדי לצמצם את נפח הטלמטריה. דורש Claude Code v2.1.214 או חדש יותר. ראה ניטור
CLAUDE_CODE_OTEL_DIAG_STDERRהגדר ל-1 כדי לכתוב שגיאות אבחון של מייצא OpenTelemetry אל stderr. כברירת מחדל השגיאות האלה מופיעות רק עם --debug, ולכן מייצא שמוגדר לא נכון, כמו התנגשות פורט של Prometheus, נכשל בשקט. דורש Claude Code v2.1.179 או חדש יותר. ראה ניטור
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MSתום זמן באלפיות שנייה לשטיפת spans ממתינים של OpenTelemetry (ברירת מחדל: 5000). ראה ניטור
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MSמרווח לרענון כותרות OpenTelemetry דינמיות באלפיות שנייה (ברירת מחדל: 1740000 / 29 דקות). ראה כותרות דינמיות
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MSתום זמן באלפיות שנייה לסיום מייצא OpenTelemetry בכיבוי (ברירת מחדל: 2000). הגדל אם מדדים נופלים ביציאה. ראה ניטור
CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MSהשהיית ההתחלה באלפיות שנייה, במקום ברירת המחדל 500, של ההמתנה המעריכית בין ניסיונות חוזרים אוטומטיים של בקשה שה-API דוחה עם שגיאת עומס 529. העלה אותה כדי לפרוס את הניסיונות החוזרים על חלון ארוך יותר כשה-API בתפוסה מלאה. תן אלפיות שנייה שלמות מ-500 עד 32000 בספרות רגילות. Claude Code מתייחס לכל ערך אחר כאל לא מוגדר. אין השפעה כש-CLAUDE_CODE_RETRY_WATCHDOG מוגדר ל-1, או כשהבקשה שנדחתה נשלחה במצב מהיר. דורש Claude Code v2.1.292 או חדש יותר
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MSתקרה באלפיות שנייה, במקום ברירת המחדל 32000, על ההמתנה המעריכית בין ניסיונות חוזרים אוטומטיים של בקשה שה-API דוחה עם שגיאת עומס 529. העלה אותה כדי שניסיונות חוזרים מאוחרים ימשיכו להתרחק זה מזה כשה-API בתפוסה מלאה. תן אלפיות שנייה שלמות מ-32000 עד 64000 בספרות רגילות. Claude Code מתייחס לכל ערך אחר כאל לא מוגדר. אין השפעה כש-CLAUDE_CODE_RETRY_WATCHDOG מוגדר ל-1, או כשהבקשה שנדחתה נשלחה במצב מהיר. דורש Claude Code v2.1.296 או חדש יותר
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATEהגדר ל-1 כדי לאפשר ל-Claude Code להריץ ברקע את פקודת השדרוג של מנהל החבילות שלך כשגרסה חדשה זמינה. חל על התקנות Homebrew ו-WinGet. מנהלי חבילות אחרים ממשיכים להציג את פקודת השדרוג בלי להריץ אותה. ראה עדכונים אוטומטיים
CLAUDE_CODE_PERFORCE_MODEהגדר ל-1 כדי להפעיל הגנת כתיבה שמודעת ל-Perforce. כשהוא מוגדר, Edit, Write ו-NotebookEdit נכשלים עם רמז p4 edit <file> אם לקובץ היעד חסר ביט הכתיבה של הבעלים, ש-Perforce מנקה בקבצים מסונכרנים עד ש-p4 edit פותח אותם. זה מונע מ-Claude Code לעקוף את מעקב השינויים של Perforce
CLAUDE_CODE_PLUGIN_CACHE_DIRדורס את ספריית השורש של התוספים. למרות השם, זה מגדיר את ספריית האב, ולא את המטמון עצמו: marketplaces ומטמון התוספים נמצאים בתת-ספריות מתחת לנתיב הזה. ברירת המחדל היא ~/.claude/plugins
CLAUDE_CODE_PLUGIN_DIRSספריות תוספים לטעון לסשן, וכל אחת נטענת כמו שדגל --plugin-dir טוען אותה. הפרד כמה נתיבים ב-: ב-Unix או ב-; ב-Windows. תן כל נתיב כנתיב מוחלט או התחל אותו ב-~, כי Claude Code מדלג על נתיבים יחסיים. דורש Claude Code v2.1.280 או חדש יותר. ראה טעינת תוסף לסשן אחד
CLAUDE_CODE_PLUGIN_DIR_WATCHשולט אם Claude Code טוען מחדש mod כשקובצי ה-mod משתנים. הטעינה מחדש חלה על mod שנטען מספרייה עם --plugin-dir, והיא דולקת כברירת מחדל בסשנים אינטראקטיביים. הגדר ל-1 כדי להפעיל אותה גם בסשנים לא אינטראקטיביים, או ל-0 כדי לכבות אותה בכל סשן. דורש Claude Code v2.1.287 או חדש יותר. ראה הגדרות mod ומשתני סביבה
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MSתום זמן באלפיות שנייה לשכפול או לרענון marketplace של תוספים (ברירת מחדל: 120000). הגדל את הערך הזה למאגרים גדולים או לחיבורי רשת איטיים. ראה Git clone הגיע לתום זמן
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILUREהגדר ל-1 כדי לדלג על ניסיון השכפול מחדש ולהמשיך להשתמש ב-checkout הקיים של ה-marketplace כשרענון marketplace לא מצליח להגיע אל ה-remote או לאמת מולו. שימושי בסביבות לא מקוונות או airgapped, שבהן שכפול מחדש ייכשל באותו אופן. ראה עדכוני marketplace נכשלים בסביבות לא מקוונות
CLAUDE_CODE_PLUGIN_PREFER_HTTPSהגדר ל-1 כדי לשכפל מקורות קיצור owner/repo ב-GitHub דרך HTTPS במקום SSH. חל על התקנת תוסף ועדכון תוסף, ועל /plugin marketplace add ו-update. שימושי ב-runners של CI, במכולות, או בכל סביבה בלי מפתח SSH מוגדר ל-github.com
CLAUDE_CODE_PLUGIN_SEED_DIRנתיב לספריית seed אחת או יותר של תוספים לקריאה בלבד, מופרדות ב-: ב-Unix או ב-; ב-Windows. השתמש בזה כדי לארוז ספריית תוספים מאוכלסת מראש לתוך תמונת מכולה. Claude Code רושם marketplaces מהספריות האלה בהפעלה ומשתמש בתוספים שנשמרו מראש במטמון בלי שכפול מחדש. ראה אכלוס מראש של תוספים למכולות
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICYהגדר ל-1 כדי לעצור את Claude Code מהעברת -ExecutionPolicy Bypass כשהוא מפעיל PowerShell לקריאות כלים, ל-hooks ולפקודות שורת מצב, ולכבד במקום זאת את מדיניות ההרצה בפועל של המכונה. כברירת מחדל Claude Code עוקף את מדיניות ההרצה בהיקף התהליך כדי שסקריפטים של .ps1 וייבוא מודולים יעבדו בהתקנות Windows שבברירת המחדל Restricted. עקיפה בהיקף תהליך לעולם לא דורסת את MachinePolicy או UserPolicy של Group Policy, בלי קשר להגדרה הזו
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MSתקרה באלפיות שנייה על המתנה במצב סרק לעבודה ברקע, כמו subagents ותהליכי עבודה, אחרי התור האחרון במצב לא אינטראקטיבי עם הדגל -p. המתנה במצב סרק מתחילה מחדש בכל פעם ש-Claude לוקח תור כדי לטפל בתוצאת רקע. ברירת מחדל: 600000, או 10 דקות. כשההמתנה במצב סרק מגיעה לתקרה, Claude Code מפסיק להמתין למשימות הרקע שנותרו. פקודת רקע רצה שהשיחה הראשית התחילה מחזיקה את הריצה פתוחה מעבר לזה. הגדר ל-0 כדי להמתין בלי הגבלה. דורש Claude Code v2.1.182 או חדש יותר
CLAUDE_CODE_PROCESS_WRAPPERמפעיל את התהליכים ש-Claude Code מתחיל מהבינארי שלו, כמו שירות הרקע שמארח סשנים של agent view, דרך משגר ארגוני שניתן כקידומת argv כמו /opt/corp/launcher. הגדר אותו בבלוק env של הגדרות משתמש או הגדרות מנוהלות, ולא כייצוא מעטפת, כדי ששירות הרקע המנותק יירש אותו. הגדרות פרויקט והגדרות מקומיות לא יכולות להגדיר אותו. שקול להגדרת processWrapper, שדורשת Claude Code v2.1.210 או חדש יותר. המשתנה הזה מקבל עדיפות כששניהם מוגדרים. הרחבת VS Code מגדירה את המשגר שלה בנפרד דרך ההגדרה claudeProcessWrapper. מתעלמים ממנו ב-Windows. ראה הרצת Claude Code מאחורי משגר ארגוני לפורמט הערך, למה שהמשגר מכסה, ולחוזה שהמשגר חייב לקיים. דורש Claude Code v2.1.208 או חדש יותר
CLAUDE_CODE_PROJECT_DIR_NAMEהגדר יחד עם CLAUDE_CONFIG_DIR כדי לבחור את שם ספריית projects/ שתחתיה Claude Code שומר את התמלילים ואת הזיכרון האוטומטי של הסשן הזה, במקום שם שנגזר מנתיב ספריית העבודה. לדוגמה, הפעלת Claude Code עם CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude שומרת אותם תחת /srv/tenant-a/projects/work/. Claude Code מתעלם מהמשתנה הזה כש-CLAUDE_CONFIG_DIR לא מוגדר, וקורא אותו רק מהסביבה שממנה מפעילים את claude, ולעולם לא מבלוק env של קובץ הגדרות. ראה מתן שם לספריית הפרויקט בעצמך. דורש Claude Code v2.1.234 או חדש יותר
CLAUDE_CODE_PROMPT_CACHE_TTLהגדר 5m או 1h, הערכים היחידים ש-Claude Code מקבל, כדי לבחור את TTL של מטמון ההנחיה לשיחה הראשית: התורות האינטראקטיביים שלך, תורות -p ותורות SDK, וגם העוזרים שרצים בתוך השורה איתם. מקבל עדיפות על הגדרת promptCacheTtl ועל ENABLE_PROMPT_CACHING_1H, ו-FORCE_PROMPT_CACHING_5M דורס אותו. ה-API מחייב כתיבות מטמון של שעה בתעריף גבוה יותר. דורש Claude Code v2.1.242 או חדש יותר
CLAUDE_CODE_PROPAGATE_TRACEPARENTהגדר ל-1 כדי להפיץ הקשר מעקב W3C כש-ANTHROPIC_BASE_URL מצביע על פרוקסי מותאם. ההפצה מכסה את כותרת traceparent בבקשות מודל ובבקשות HTTP MCP, ואת משתנה הסביבה TRACEPARENT לתהליכי משנה של Bash, PowerShell ו-hooks. כברירת מחדל, ההפצה מופעלת רק בחיבור ישיר ל-API של Anthropic. נוסף ב-v2.1.152. ראה מעקבים (בטא)
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOSTמוגדר על ידי פלטפורמות מארחות שמשבצות את Claude Code ומנהלות ניתוב ספק מודל בשמו. כשהוא מוגדר, Claude Code מתעלם ממשתני בחירת ספק, נקודת קצה ואימות כמו CLAUDE_CODE_USE_BEDROCK, ANTHROPIC_BASE_URL ו-ANTHROPIC_API_KEY בקובצי הגדרות, כך שהגדרות משתמש לא יכולות לדרוס את הניתוב של המארח. Claude Code מתעלם גם ממפתחות בחירת מודל כמו model, fallbackModel ו-modelOverrides בהגדרות מנוהלות, מכל מקור מנוהל שמספק אותם, כך שתצורת המודל של המארח מקבלת עדיפות על קיבוע מודל מנוהל שאינו מעודכן. Claude Code מתעלם גם ממשתני בחירת מודל כמו ANTHROPIC_MODEL ומשפחת ANTHROPIC_DEFAULT_*_MODEL בבלוק env מנוהל. רשימת היתר availableModels בהגדרות מנוהלות עדיין חלה, אלא אם המארח מספק רשימה משלו. Claude Code גם מדלג על ביטול ההסכמה האוטומטי לטלמטריה שהוא מחיל אחרת על ספקי צד שלישי כמו Amazon Bedrock, Claude Platform on AWS, Agent Platform של Google Cloud ו-Microsoft Foundry, כך שהטלמטריה עוקבת אחרי ביטול ההסכמה הרגיל DISABLE_TELEMETRY. ראה התנהגויות ברירת מחדל לפי ספק API
CLAUDE_CODE_PROXY_RESOLVES_HOSTSהגדר ל-1 כדי לאפשר לפרוקסי לבצע פתרון DNS במקום הקורא. הצטרפות מפורשת לסביבות שבהן הפרוקסי צריך לטפל בפתרון שמות מארח
CLAUDE_CODE_REMOTEמוגדר אוטומטית ל-true כש-Claude Code רץ כסשן ענן. קרא את זה מ-hook או מסקריפט הגדרה כדי לזהות אם אתה בסשן ענן
CLAUDE_CODE_REMOTE_SESSION_IDמוגדר אוטומטית בסשני ענן למזהה של הסשן הנוכחי. קרא את זה כדי לבנות קישור חזרה לתמליל הסשן. ראה קישור הפלט חזרה לסשן
CLAUDE_CODE_RESTRICTEDהגדר ל-1 כדי להתחיל את הסשן במצב מוגבל, כמו העברת --restricted. Claude Code מתעלם מהמשתנה הזה בבלוק env של קובץ הגדרות. דורש Claude Code v2.1.248 או חדש יותר
CLAUDE_CODE_RESUME_INTERRUPTED_TURNהגדר ל-1 כדי לחדש אוטומטית אם הסשן הקודם הסתיים באמצע תור. משמש במצב SDK כדי שהמודל ימשיך בלי לדרוש מה-SDK לשלוח מחדש את ההנחיה. כדי לכבות את זה, בטל את הגדרת המשתנה או הגדר אותו ל-0. ללוח הצ'אט של VS Code, ראה המשך שיחות אחרי טעינה מחדש
משתנהמטרה
CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MSהגיל המרבי במילישניות של הודעת התמליל האחרונה עבור סשן שהסתיים באמצע תור, כדי להמשיך אוטומטית בעת חידוש. כשההודעה האחרונה ישנה יותר מהגבול הזה, Claude Code מדלג על החידוש האוטומטי של CLAUDE_CODE_RESUME_INTERRUPTED_TURN ועל הודעת ההמשך של CLAUDE_CODE_RESUME_PROMPT, והסשן מתחיל במצב ממתין כדי שתמשיך במפורש. ערך לא מוגדר או 0 לא קובע גבול, חוץ מכך שחלק מהתורות מתחדשים רק בתוך שש שעות מההודעה האחרונה שלהם, למשל תור שהסתיים בשגיאת API. ערך חיובי מגביל כל תור, כולל אלה. ערך שלילי או לא מספרי מחיל גבול של שעה אחת. סקריפטים שיוצרים סוכנים ארוכי טווח יכולים להגדיר זאת כדי שהפעלה מחדש מול תמליל ישן לא תריץ מחדש הנחיה מיושנת. Claude Code עצמו קובע גבול של שעה אחת כשהוא מפעיל מחדש סשן תצוגת סוכן שקרס וירש את השיחה שלו מסשן אינטראקטיבי. דורש Claude Code v2.1.211 או חדש יותר
CLAUDE_CODE_RESUME_PROMPTמחליף את הודעת ההמשך ש-Claude Code שולח ל-Claude כש-CLAUDE_CODE_RESUME_INTERRUPTED_TURN ממשיך תור שנקטע במקום לשלוח מחדש את ההנחיה שלו, או כשאתה מחדש קריאת כלי שנדחתה עם -p. ברירת המחדל היא Continue from where you left off.. מחרוזת ריקה משתמשת בברירת המחדל
CLAUDE_CODE_RESUME_SHOWS_CUT_OFF_CALLSהגדר ל-1 כדי לשמור קריאות כלים שנקטעו, המסומנות כקטועות, בתור ש-CLAUDE_CODE_RESUME_INTERRUPTED_TURN ממשיך. כשלא מוגדר, הקריאות האלה מושמטות לפני שהתור ממשיך. חלק מהקריאות נשארות מושמטות, למשל קריאות לסוכני משנה, מיומנויות, תהליכי עבודה וכלים שממתינים לאדם. עבור לוח הצ'אט של VS Code, ראה המשך שיחות אחרי טעינה מחדש. דורש Claude Code v2.1.309 או חדש יותר
CLAUDE_CODE_RETRY_WATCHDOGהגדר ל-1 עבור סשנים ללא השגחה, כמו רתמות eval, עבודות CI או workers מרוחקים. מנסה שוב שגיאות קיבולת 429 ו-529 ללא הגבלה במקום להיכשל אחרי CLAUDE_CODE_MAX_RETRIES ניסיונות. Claude Code נכשל מיד כשבקשה במהירות רגילה מקבלת 429 שמדווח על מגבלת הוצאה או על קרדיטי שימוש שמוצו, גם כזה שמגיע מתקרת הוצאה של שער שמתאפסת לפי לוח זמנים. לפני v2.1.239, ה-watchdog ניסה את אלה שוב ללא הגבלה. עבור בקשות במצב מהיר, ראה טיפול במגבלות קצב. ה-watchdog מבצע backoff של עד 5 דקות בין ניסיונות, או עד שהמגבלה מתאפסת כשהתגובה נושאת זמן איפוס של מגבלת קצב, כך שסשן שנתקל במגבלת שימוש ממתין עד תום החלון הנותר. ב-v2.1.199 או חדש יותר הוא גם מעלה את מספר הניסיונות החוזרים של ברירת המחדל עבור שגיאות חולפות אחרות, כמו שגיאות שרת, פסקי זמן וחיבורים שנותקו, ל-300, בערך שלוש שעות של backoff, ומסיר את התקרה של 15 על CLAUDE_CODE_MAX_RETRIES אם אתה מגדיר את המשתנה הזה במפורש. דורש Claude Code v2.1.186 או חדש יותר
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MSהזמן המרבי במילישניות שכל בקשת API מבלה בהמתנה לשגיאות 429 ו-529 כש-CLAUDE_CODE_RETRY_WATCHDOG מוגדר. אחרי שהזמן הזה נוצל, השגיאה הבאה מסוג זה מסיימת את הבקשה. תן מספר שלם חיובי בספרות פשוטות, כמו 1800000 עבור 30 דקות. כשלא מוגדר, להמתנה אין גבול. דורש Claude Code v2.1.295 או חדש יותר
CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MSהמרווח המינימלי במילישניות בין בדיקות אם מגבלת שימוש כבר הוסרה, בזמן שבקשה ממתינה לאיפוס המגבלה הזו כש-CLAUDE_CODE_RETRY_WATCHDOG מוגדר. כשבדיקה מוצאת שהמגבלה הוסרה, הבקשה יוצאת מיד. תן מספר שלם בספרות פשוטות מ-60000, דקה אחת, עד 10800000, שלוש שעות. בדיקות נעשות רק עבור מגבלת סשן או מגבלה שבועית של מנוי claude.ai כל עוד קרדיטי שימוש אינם בשימוש, ולא כל עוד CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC מוגדר. כשהמשתנה הזה לא מוגדר או שהערך שלו מחוץ לטווח הזה, לא נעשות בדיקות. דורש Claude Code v2.1.305 או חדש יותר
CLAUDE_CODE_SAFE_MODEהגדר ל-1 כדי להתחיל במצב בטוח: CLAUDE.md, מיומנויות, תוספים, hooks, שרתי MCP, פקודות וסוכנים מותאמים, סגנונות פלט, תהליכי עבודה, ערכות נושא מותאמות, קיצורי מקשים מותאמים, פקודות שורת סטטוס והצעת קבצים, שרתי LSP וזיכרון אוטומטי לא נטענים, כדי לאתר תקלות בתצורה שבורה. מדיניות הגדרות מנוהלת עדיין חלה, כולל hooks, שורת סטטוס ופקודות הצעת קבצים שמוגדרים במדיניות. תוספים מנוהלים, מיומנויות מנוהלות, CLAUDE.md מנוהל ושרתי MCP שמוגדרים במדיניות לא חלים. שווה ערך להעברת --safe-mode. תהליכי בן שנוצרים ישירות יורשים את המשתנה
CLAUDE_CODE_SCRIPT_CAPSאובייקט JSON שמגביל כמה פעמים סקריפטים מסוימים רשאים להיקרא בכל סשן כש-CLAUDE_CODE_SUBPROCESS_ENV_SCRUB מוגדר. המפתחות הם מחרוזות חלקיות שמותאמות מול טקסט הפקודה. הערכים הם מגבלות קריאה במספרים שלמים. לדוגמה, {"deploy.sh": 2} מאפשר לקרוא ל-deploy.sh לכל היותר פעמיים. ההתאמה מבוססת על מחרוזת חלקית, כך שטריקים של הרחבת מעטפת כמו ./scripts/deploy.sh $(evil) עדיין נספרים במסגרת התקרה. התפצלות בזמן ריצה דרך xargs או find -exec לא מזוהה. זהו אמצעי בקרה של הגנה לעומק
CLAUDE_CODE_SCROLL_SPEEDמגדיר את מכפיל גלילת גלגל העכבר בעיבוד במסך מלא. מקבל כל ערך חיובי עד 20, כולל ערכים שבריים מתחת ל-1 כמו 0.5 כדי להאט גלילה מואצת של משטח מגע ושל גלגל במסופים שכבר מגבירים אירועי גלגל. הגדר ל-3 כדי להתאים ל-vim אם המסוף שלך שולח אירוע גלגל אחד לכל חריץ בלי הגברה. לא נלקח בחשבון במסוף של JetBrains IDE, שם Claude Code משתמש בטיפול הגלילה שלו
CLAUDE_CODE_SEND_FEEDBACKהגדר ל-0 כדי לכבות משוב שמנוסח על ידי Claude עבור סשן. הגדר ל-1 כדי להפעיל אותו במקום שבו לחשבון שלך כבר יש גישה. המשתנה לא יכול להעניק גישה בעצמו, והמתגים האחרים שמכבים משוב, כמו DISABLE_FEEDBACK_COMMAND וערך off של הגדרת feedbackDrafts, עדיין חלים
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MSמחליף את תקציב הזמן במילישניות עבור hooks של SessionEnd. הערך הוא גם ה-timeout של כל hook שלא מגדיר timeout משלו. חל על יציאה מסשן, /clear, ומעבר בין סשנים דרך /resume אינטראקטיבי. כברירת מחדל התקציב הוא 1.5 שניות, והוא מורם אוטומטית ל-timeout הגבוה ביותר לכל hook שמוגדר בקובצי ההגדרות, עד 60 שניות. ערכי timeout על hooks שמספק תוסף לא מעלים את התקציב
CLAUDE_CODE_SESSION_IDמוגדר אוטומטית למזהה הסשן הנוכחי בתהליכי משנה של כלי Bash ו-PowerShell, בתהליכי משנה של פקודת hook, ובתהליכי משנה של שרת MCP ב-stdio. עבור Bash, PowerShell ו-hooks זה תואם לשדה session_id בקלט ה-JSON של ה-hook, ומתעדכן ב-/clear. תהליך משנה של שרת MCP שומר את המזהה שאיתו נוצר. ב---resume <session-id> הוא מקבל את המזהה המחודש, בהתאמה ל-hooks ול-Bash. ב---continue או ב---resume בלי מזהה מפורש הוא עשוי לקבל במקום זאת את מזהה ההפעלה הראשוני. השתמש בו כדי לקשר סקריפטים וכלים חיצוניים לסשן Claude Code שהפעיל אותם
CLAUDE_CODE_SHELLמגדיר את המעטפת ש-Claude Code משתמש בה להרצת פקודות כלי Bash. מקבל נתיב לקובץ בינארי של bash או zsh, לדוגמה /opt/homebrew/bin/bash. מעטפות אחרות כמו fish אינן נתמכות. אם הערך אינו נתיב עובד של bash או zsh, Claude Code מתעלם ממנו וחוזר לזיהוי אוטומטי. הזיהוי האוטומטי משתמש ב-$SHELL שלך כשהוא מצביע על bash או zsh, אחרת הוא בוחר את zsh העובד הראשון ואחר כך את bash, שנמצאים ב-PATH שלך ובמיקומי התקנה סטנדרטיים
CLAUDE_CODE_SHELL_PREFIXקידומת פקודה שעוטפת פקודות מעטפת ש-Claude Code יוצר: קריאות לכלי Bash, פקודות hook, פקודות שורת סטטוס, ופקודות הפעלה של שרת MCP ב-stdio. hooks של PowerShell ו-hooks בצורת exec רצים בלי הקידומת. שימושי לרישום או לביקורת. הגדרת נתיב לקובץ הרצה חשוף כמו /path/to/logger.sh מריצה כל פקודה בתור /path/to/logger.sh '<command>'. העטיפה מקבלת את שורת הפקודה כארגומנט יחיד במירכאות מעטפת ב-$1, ולכן העטיפה חייבת להעריך מחדש את $1 עם מעטפת, לדוגמה exec bash -c "$1". התייחסות ל-$1 כנתיב לקובץ הרצה חשוף שוברת שרתי MCP ב-stdio שמעבירים ארגומנטים כמו npx -y <package>. עבור קריאות לכלי Bash, $1 מכיל את הפעלת המעטפת המלאה ש-Claude Code מרכיב, כולל הגדרת הסביבה, ולא רק את הפקודה ש-Claude הריץ
CLAUDE_CODE_SIMPLEהגדר ל-1 כדי לרוץ עם הנחיית מערכת מינימלית ורק עם הכלים Bash, קריאת קבצים ועריכת קבצים. כלי MCP מ---mcp-config עדיין זמינים. מבטל גילוי אוטומטי של hooks, מיומנויות, פקודות מותאמות, סוכני משנה, תוספים מותקנים, שרתי MCP, זיכרון אוטומטי ו-CLAUDE.md. מיומנויות בתיקייה שאתה מעביר עם --add-dir עדיין נטענות. אסימוני OAuth ואישורי keychain לא נקראים, ולכן אימות Anthropic חייב להגיע מ-ANTHROPIC_API_KEY או מ-apiKeyHelper ב---settings. שווה ערך להעברת --bare
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPTבוחר בין הנחיית המערכת המלאה של Claude Code לבין הנחיה קצרה יותר עם תיאורי כלים מקוצרים. כשלא מוגדר, Haiku 4.5, Sonnet 5, Opus 4.7 ומודלים מוקדמים יותר באותן משפחות משתמשים בהנחיה המלאה כברירת מחדל, ומודלים חדשים יותר משתמשים בקצרה. הגדר ל-1 כדי להשתמש בהנחיה הקצרה על כל מודל. הגדר ל-0, false, no או off כדי להשתמש בהנחיה המלאה על כל מודל, גם במקום שבו ניסוי או תצורת שרת היו בוחרים אחרת את הקצרה. כל אחת מההנחיות שומרת על סט הכלים המלא, על hooks, על שרתי MCP ועל גילוי CLAUDE.md
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTHדילוג על אימות בצד הלקוח עבור Claude Platform on AWS, עבור שערים שחותמים על בקשות בעצמם
CLAUDE_CODE_SKIP_AWS_CRED_CACHEהגדר ל-1 כדי לכבות את המטמון בתוך התהליך של אישורים שנפתרו משרשרת ספקי האישורים של ברירת המחדל ב-AWS, כך ש-Claude Code פותר את השרשרת בכל בקשת API. כשהמטמון כבוי, פרופיל שמגובה ב-SSO מבקש אישורים מ-IAM Identity Center בכל בקשה. ראה מטמון אישורים וזמן קצוב לפתרון. דורש Claude Code v2.1.207 או חדש יותר
CLAUDE_CODE_SKIP_BEDROCK_AUTHדילוג על אימות AWS עבור Amazon Bedrock (לדוגמה, כשמשתמשים בשער LLM)
CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORSהגדר ל-1 כדי להתייחס לבדיקת זמינות שנכשלה של מצב מהיר כאילו הוא זמין, עבור רשתות שחוסמות את הבקשה הישירה של הבדיקה אל api.anthropic.com. Claude Code עדיין מכבד תגובה של "disabled by your organization"
CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECKהגדר ל-1 כדי לדלג על בדיקת הזמינות בצד הלקוח של מצב מהיר, עבור פרוקסי שמיירטים את בקשת הבדיקה במקום לסרב לה. ה-API עדיין דוחה בקשות מצב מהיר כשמצב מהיר מושבת בארגון שלך
CLAUDE_CODE_SKIP_FOUNDRY_AUTHדילוג על אימות Azure עבור Microsoft Foundry, עבור פרוקסי או שער שמזריק כותרת Authorization משלו. Claude Code שולח בקשות בלי אישור Azure ושומר את כותרת Authorization שאתה מספק, לדוגמה דרך ANTHROPIC_CUSTOM_HEADERS. מתעלמים ממנו כש-ANTHROPIC_FOUNDRY_API_KEY או ANTHROPIC_FOUNDRY_AUTH_TOKEN מוגדר. לפני v2.1.203, המשתנה הזה השאיר את לקוח Microsoft Foundry לא מסוגל לשלוח בקשות אלא אם הוגדר גם מפתח API
CLAUDE_CODE_SKIP_MANTLE_AUTHדילוג על אימות AWS עבור Amazon Bedrock Mantle (לדוגמה, כשמשתמשים בשער LLM)
CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORYבדיקות המודלים בהפעלה ב-Amazon Bedrock וב-Agent Platform של Google Cloud זוכרות במכונה הזו אילו מודלים הן מצאו שהחשבון שלך לא יכול להפעיל, למשך עד יום. הגדר ל-1 כדי לכבות את הזיכרון הזה. דורש Claude Code v2.1.285 או חדש יותר
CLAUDE_CODE_SKIP_PROMPT_HISTORYהגדר ל-1 כדי לדלג על כתיבת היסטוריית הנחיות ותמלילי סשן לדיסק. סשנים שהתחילו כשהמשתנה הזה מוגדר לא מופיעים ב---resume, ב---continue או בהיסטוריית חץ למעלה. שימושי לסשנים מתוסרטים חולפים
CLAUDE_CODE_SKIP_VERTEX_AUTHדילוג על אימות Google עבור Agent Platform של Google Cloud (לדוגמה, כשמשתמשים בשער LLM)
CLAUDE_CODE_STARTUP_FAILURE_RESULTSהגדר ל-1 כדי שסשן שהתחיל עם --output-format stream-json יכתוב הודעת תוצאה שמציינת למה Claude Code סירב להתחיל עבור כשלי הפעלה שאחרת מסתיימים ב-stderr בלבד. דורש Claude Code v2.1.274 או חדש יותר
CLAUDE_CODE_STOP_HOOK_BLOCK_CAPהמספר המרבי של פעמים רצופות ש-hook של Stop או SubagentStop רשאי לחסום את סיום התור לפני ש-Claude Code עוקף אותו ומסיים את התור בכל מקרה (ברירת מחדל: 8). הגדר ל-0 כדי לבטל את התקרה. העלה את זה אם ה-hook שלך באמת צריך יותר איטרציות כדי להגיע לפתרון
CLAUDE_CODE_SUBAGENT_MODELמודל ברירת המחדל עבור סוכני משנה, חברי צוות בצוות סוכנים, וסוכני תהליך עבודה שלא הוקצה להם מודל בדרך אחרת. מקבל כינוי כמו haiku או שם מודל מלא. שני מקורות גוברים עליו: מודל ש-Claude מעביר כשהוא יוצר את הסוכן, ושדה model בהגדרת הסוכן, כולל inherit. כדי לשנות את זה, הגדר CLAUDE_CODE_SUBAGENT_MODEL_FORCE. ראה בחירת מודל לסדר המלא. הגדרת הערך ל-inherit זהה להשארתו לא מוגדר. לפני v2.1.251, המשתנה הזה דרס גם את המודל של כל הפעלה וגם את שדה model שבהגדרה
CLAUDE_CODE_SUBAGENT_MODEL_FORCEהגדר ל-1 כדי לכפות מודל אחד על סוכני משנה, חברי צוות וסוכני תהליך עבודה. הרצת כל סוכן משנה על מודל אחד מציינת איזה מודל זה. דורש Claude Code v2.1.257 או חדש יותר
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTLהגדר 5m או 1h, הערכים היחידים ש-Claude Code מקבל, כדי לבחור את TTL של מטמון ההנחיה עבור בקשות מחוץ לשיחה הראשית, כמו סוכני משנה, תהליכי עבודה ועבודה ברקע. גובר על הגדרת subagentPromptCacheTtl ועל ENABLE_PROMPT_CACHING_1H, ו-FORCE_PROMPT_CACHING_5M דורס אותו. ה-API מחייב כתיבות מטמון של שעה בשיעור גבוה יותר. דורש Claude Code v2.1.242 או חדש יותר
CLAUDE_CODE_SUBPROCESS_ENV_SCRUBהגדר ל-1 כדי להסיר אישורים מהסביבות של תהליכי המשנה ש-Claude Code מפעיל, כמו פקודות Bash, hooks ושרתי MCP ב-stdio. הניקוי מזהה אישור לפי שם המשתנה או לפי הערך שלו, ומשאיר אסימוני GitHub והגדרות פרוקסי במקומם. ראה מה ניקוי סביבת תהליך המשנה מסיר. claude-code-action מגדיר זאת אוטומטית כש-allowed_non_write_users מוגדר
CLAUDE_CODE_SYNC_PLUGIN_INSTALLהגדר ל-1 במצב לא אינטראקטיבי (הדגל -p) כדי להמתין להשלמת התקנת התוספים לפני השאילתה הראשונה. בלי זה, התוספים מותקנים ברקע וייתכן שלא יהיו זמינים בתור הראשון. שלב עם CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS כדי לתחום את ההמתנה
CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MSזמן קצוב במילישניות להתקנת תוספים סינכרונית. כשחורגים ממנו, Claude Code ממשיך בלי תוספים ורושם שגיאה. אין ברירת מחדל: בלי המשתנה הזה, התקנה סינכרונית ממתינה עד להשלמה
CLAUDE_CODE_SYNC_SKILLSהגדר ל-1 במצב לא אינטראקטיבי עם הדגל -p כדי ש-Claude Code יוריד בריצה הזו את המיומנויות שמופעלות עבור חשבון claude.ai שלך, וימתין לרשימה שלהן, עד CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS, לפני שהוא מריץ את השאילתה הראשונה. דורש אימות claude.ai. סשני מסוף שבהם אתה מתחבר עם חשבון claude.ai שלך מסנכרנים את המיומנויות האלה בלי המשתנה הזה, לכן הגדר אותו רק כשריצת -p צריכה את המיומנויות הנוכחיות שלך בשאילתה הראשונה שלה
משתנהמטרה
CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MSזמן קצוב במילישניות לסנכרון מחדש של skills שרץ באמצע סשן, כשאפליקציה שנבנתה על ה-Agent SDK טוענת מחדש skills (ברירת מחדל: 30000). כשחורגים ממנו, הטעינה מחדש ממשיכה עם ה-skills שכבר הגיעו, וההורדות שנותרו מסתיימות ברקע
CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MSזמן קצוב במילישניות שהשאילתה הראשונה ממתינה לרשימת ה-skills הראשונית כש-CLAUDE_CODE_SYNC_SKILLS מוגדר (ברירת מחדל: 5000). כשחורגים ממנו, השאילתה הראשונה רצה עם ה-skills שכבר הגיעו. ההורדות מסתיימות ברקע בכל מקרה, ו-Claude ממתין להורדה של skill כשהוא מפעיל את אותו skill
CLAUDE_CODE_SYNTAX_HIGHLIGHTהגדר ל-false כדי לבטל הדגשת תחביר בפלט diff. שימושי כשצבעים מפריעים להגדרת הטרמינל. כדי לבטל גם הדגשה בבלוקי קוד ובתצוגות מקדימות של קבצים, השתמש בהגדרה syntaxHighlightingDisabled
CLAUDE_CODE_TASK_LIST_IDשיתוף רשימת משימות בין סשנים. הגדר את אותו מזהה בכמה מופעים של Claude Code כדי לתאם רשימת משימות משותפת, בסשנים שיש בהם את כלי Task. ראה רשימת משימות
CLAUDE_CODE_TMPDIRדריסה של ספריית הקבצים הזמניים שמשמשת לקבצים זמניים פנימיים. Claude Code מוסיף /claude-{uid}/ לנתיב הזה ב-Unix, או /claude/ ב-Windows. ברירת מחדל: /tmp ב-macOS, os.tmpdir() ב-Linux וב-Windows. ב-macOS וב-Linux, תהליכי משנה של Bash ב-sandbox מקבלים $TMPDIR חלופי קצר תחת ברירת המחדל של המערכת כשהדריסה שלך היא נתיב ארוך, כי חלק מהכלים נכשלים כשנתיבים זמניים נעשים ארוכים מדי. פקודות Bash בלי sandbox יורשות את $TMPDIR של המעטפת כשהוא מוגדר. ב-Windows מקומי, כשהמעטפת לא מגדירה $TMPDIR, פקודת Bash שמפנה ל-$TMPDIR מקבלת את הדריסה שלך, או %TEMP% כשלא הגדרת אחת. הקבצים הזמניים של Claude Code עצמו תמיד משתמשים בדריסה שלך. הגדר אותו במעטפת, בהגדרות משתמש, או בהגדרות מנוהלות. מתעלמים ממנו בהגדרות פרויקט ומקומיות
CLAUDE_CODE_TMUX_TRUECOLORהגדר לכל ערך לא ריק, למשל 1, כדי לאפשר פלט truecolor של 24 סיביות בתוך tmux. הגדרה ל-0 או ל-false עדיין מאפשרת truecolor, בניגוד לרוב משתני ההפעלה והכיבוי. בטל את הגדרת המשתנה כדי להחזיר את ההגבלה ל-256 צבעים. כברירת מחדל, Claude Code מגביל ל-256 צבעים כש-$TMUX מוגדר, כי tmux לא מעביר רצפי escape של truecolor אלא אם הוא מוגדר לכך. הגדר את זה אחרי הוספת set -ga terminal-overrides ',*:Tc' לקובץ ~/.tmux.conf. ראה הגדרת טרמינל להגדרות tmux נוספות
CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDEב-Linux וב-WSL, הגדר לרשימה מופרדת בפסיקים של סוגי התהליכים ש-Claude Code מוציא מתקרת הזיכרון של הכלים, למשל mcp או lsp. הגדר none כדי להגביל כל סוג, או all-new כדי להגביל רק פקודות של כלי Bash, PowerShell ו-Monitor. Claude Code שומר את פקודות כלי Bash, PowerShell ו-Monitor מתחת לתקרה בכל רשימה שתגדיר. דורש Claude Code v2.1.246 או חדש יותר
CLAUDE_CODE_TOOL_MEMORY_LIMITב-Linux וב-WSL, הגדר לגודל כמו 4G כדי להגביל את הזיכרון שפקודות כלי Bash ו-PowerShell יכולות להשתמש בו, ופקודות כלי Monitor ב-v2.1.246 או חדש יותר. כתוב את הגודל בספרות רגילות, לבד למספר בתים או עם סיומת K, M, G או T. הגדר 0 או off כדי לכבות את התקרה. אחרי שהתהליך הראשון ש-Claude Code מפעיל הפעיל או כיבה את התקרה, ערך ששונה נכנס לתוקף בפעם הבאה שתפעיל claude. דורש Claude Code v2.1.233 או חדש יותר
CLAUDE_CODE_TRANSCRIPT_LOCAL_GCהגדר ל-1 כדי להגביל כמה גדול קובץ התמלול של סשן -p ארוך או של Agent SDK גדל. אחרי כל compaction, כשהקובץ גדול מ-5 MB, Claude Code מסיר את ההיסטוריה שלפני אותו compaction. ב-v2.1.296 או חדש יותר, הקובץ נשאר כמו שהוא כשהסרת ההיסטוריה הזו הייתה מקטינה אותו בפחות מ-10%. חידוש הסשן משחזר את אותה שיחה גם אם הקובץ קוצץ וגם אם לא. הגדר אותו בסביבה שממנה אתה מפעיל את Claude Code, כי בלוק env בהגדרות לא יכול להפעיל אותו. דורש Claude Code v2.1.287 או חדש יותר
CLAUDE_CODE_USER_DIALOG_TIMEOUT_MSמועד אחרון במילישניות לפני ש-Claude Code מבטל דיאלוג שהוא מעביר ללקוח מרוחק כמו Remote Control או מארח SDK, או את דיאלוג האישור להודעה מוחזקת בין סשנים. בקשות הרשאה ושאלות AskUserQuestion משתמשות בזרימות משלהן ואינן כפופות לו. ב-Claude Code v2.1.236 או חדש יותר, הוא גם מגביל את בקשת ההסכמה לקרדיטי שימוש של Fable באמצע סשן, בסשן שעשוי לרוץ ללא השגחה. שליטה בהודעות נכנסות וסשנים לא אינטראקטיביים מכסים את כללי התפוגה המלאים של הודעות מוחזקות, כולל המקרים שבהם המועד האחרון לא חל. דורס את הגדרת dialogExpiry. 0 או ערך שלילי מבטלים את המועד האחרון. מתעלמים ממנו בהגדרות פרויקט ומקומיות
CLAUDE_CODE_USE_ANTHROPIC_AWSשימוש ב-Claude Platform on AWS
CLAUDE_CODE_USE_BEDROCKשימוש ב-Amazon Bedrock
CLAUDE_CODE_USE_FOUNDRYשימוש ב-Microsoft Foundry
CLAUDE_CODE_USE_MANTLEשימוש ב-נקודת הקצה Mantle של Amazon Bedrock
CLAUDE_CODE_USE_POWERSHELL_TOOLשולט בכלי PowerShell. ב-Windows בלי Git Bash, הכלי מופעל אוטומטית. הגדר ל-0 כדי לבטל אותו. ב-Windows עם Git Bash מותקן, הכלי פועל כברירת מחדל לחשבונות claude.ai ו-Console. הגדר ל-1 כדי להפעיל אותו בסשנים של Amazon Bedrock, Google Cloud's Agent Platform ו-Microsoft Foundry, או ל-0 כדי לכבות אותו. ב-Linux, ב-macOS וב-WSL, הגדר ל-1 כדי להפעיל אותו, מה שדורש pwsh ב-PATH. כשהוא מופעל ב-Windows, Claude יכול להריץ פקודות PowerShell באופן מקומי במקום לנתב אותן דרך Git Bash. ראה כלי PowerShell
CLAUDE_CODE_USE_VERTEXשימוש ב-Google Cloud's Agent Platform
CLAUDE_CODE_WARN_DISK_FREE_GIBהגדר למספר שלם של GiB, למשל 10, כדי ש-Claude Code יזהיר את Claude כשהמקום הפנוי במערכת הקבצים של ספריית העבודה יורד מתחת לכמות הזו. האזהרה היא תזכורת מערכת שאומרת כמה פנוי. התזכורת כבויה כשהמשתנה לא מוגדר, 0, או לא ספרות רגילות. הגדר אותו בסביבה שמפעילה את Claude Code, כי Claude Code מתעלם מעותק שמגיע דרך בלוק env בהגדרות. דורש Claude Code v2.1.304 או חדש יותר
CLAUDE_CODE_WARN_MEMORY_FREE_GIBב-Linux וב-WSL, הגדר למספר שלם של GiB כמו 4 כדי ש-Claude Code יזהיר את Claude כשהזיכרון הזמין יורד מתחת לכמות הזו. האזהרה היא תזכורת מערכת שאומרת כמה זמין. התזכורת כבויה כשהמשתנה לא מוגדר, 0, או לא ספרות רגילות. הגדר אותו בסביבה שמפעילה את Claude Code, כי Claude Code מתעלם מעותק שמגיע דרך בלוק env בהגדרות. דורש Claude Code v2.1.304 או חדש יותר
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MSהגדר למספר המילישניות ש-WebFetch שומר במטמון את התגובה של כל כתובת URL שנשלפה. ברירת המחדל היא 900000, שהם 15 דקות. מקבל ספרות רגילות בלבד. 0, שבר עשרוני, או כל איות אחר שומרים את ברירת המחדל. Claude Code קורא את הערך פעם אחת בכל הפעלה, כך ששינוי בבלוק env בהגדרות חל כשתפעיל claude בפעם הבאה. דורש Claude Code v2.1.233 או חדש יותר
CLAUDE_CODE_WEBFETCH_DEADLINE_MSגבול עליון במילישניות לכמה זמן WebFetch ממתין להורדת עמוד, כולל כל הפניות שהוא עוקב אחריהן. הורדה שלא הושלמה עד אז נכשלת עם שגיאת מועד אחרון. ברירת המחדל היא 300000, שהן חמש דקות. הגדר ל-0 כדי להסיר את המגבלה. מקבל ספרות רגילות בלבד. שבר עשרוני או כל איות אחר שומרים את ברירת המחדל. דורש Claude Code v2.1.268 או חדש יותר
CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOURהקצב שבו מגבלת WebSearch של סשן מתמלאת מחדש, בקריאות לשעה. ברירת המחדל היא 100 בסשן טרמינל אינטראקטיבי. בסשן לא אינטראקטיבי ברירת המחדל היא 0, מה שמכבה את המילוי מחדש. מקבל ספרות רגילות בלבד. כל איות אחר נקרא כלא מוגדר. דורש Claude Code v2.1.290 או חדש יותר
CLAUDE_CODE_WORKER_CHECKIN_SCHEDULEכש-CLAUDE_AUTO_BACKGROUND_TASKS מוגדר ל-1, כמה זמן Claude Code ממתין לפני כל תזכורת ל-Claude לבדוק סוכני משנה ברקע שעדיין רצים. מקבל המתנה אחת או יותר מופרדות בפסיקים, בשניות שלמות מ-1 עד 86400, למשל 600 או 600,1800,3600. כל ערך הוא ההמתנה לפני התזכורת הבאה, והערך האחרון חוזר. מקבל ספרות רגילות בלבד. כל ערך או איות אחר נקרא כלא מוגדר. כשלא מוגדר, אין תזכורות. דורש Claude Code v2.1.283 או חדש יותר
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTSכמה סוכנים הרצה אחת של workflow מפעילה בבת אחת, מ-1 עד 256. כברירת מחדל, הרצה מפעילה עד 16 סוכנים בבת אחת, פחות כשל-Claude Code יש פחות מעבדים זמינים. קריאות agent() בתור ממתינות למשבצת פנויה. התמלול של כל סוכן רץ נשאר בזיכרון של Claude Code, כך שערכים גבוהים יותר מעלים את השימוש בזיכרון. מקבל ספרות רגילות בלבד. ערכים מחוץ לטווח ואיותים אחרים שומרים את ברירת המחדל. דורש Claude Code v2.1.269 או חדש יותר
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MSגבול עליון במילישניות לכמה זמן סוכן workflow ממתין לתחילת התגובה הראשונה של אח עם אותו קידומת, לפני שהוא שולח את הבקשה הראשונה שלו. כש-fan-out מפעיל כמה סוכנים שחולקים קידומת של מטמון פרומפט, Claude Code מחזיק את כל הסוכנים מלבד הראשון עד למשך הזה, כדי שהשאר יקראו את הקידומת מהמטמון במקום שכל אחד יעבד אותה בלי מטמון. ברירת מחדל 5000. הגדר ל-0 כדי לבטל את ההמתנה. כש-DISABLE_PROMPT_CACHING מוגדר, הסוכנים לא ממתינים. דורש Claude Code v2.1.229 או חדש יותר
CLAUDE_CODE_YOU_SHOULD_KNOW_DEBUGהגדר ל-1 כדי להציג, מעל הפרומפט, שורה לכל אחת משלוש הבדיקות האחרונות ש-מוד You should know עשה בסשן הזה. השתמש בו כדי לוודא שהמוד בודק כשלא מופיעות הערות. דורש Claude Code v2.1.287 או חדש יותר
CLAUDE_CONFIG_DIRדריסה של ספריית התצורה (ברירת מחדל: ~/.claude). כל ההגדרות, היסטוריית הסשנים והתוספים נשמרים תחת הנתיב הזה. לפרטי התחברות, ראה איפה Claude Code שומר פרטי התחברות. שימושי להרצת כמה חשבונות זה לצד זה: לדוגמה, alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'. הגדר אותו במעטפת, בהגדרות משתמש, או בהגדרות מנוהלות. בקובץ הגדרות, כתוב את הנתיב המוחלט. מתעלמים ממנו בהגדרות פרויקט ומקומיות
CLAUDE_EFFORTמוגדר אוטומטית בתהליכי משנה של כלי Bash ובפקודות hook להגדרת רמת effort כשתהליך המשנה מתחיל: low, medium, high, xhigh או max. תואם לשדה effort.level שמועבר ל-hooks. מוגדר רק כשהמודל הנוכחי תומך בפרמטר effort
CLAUDE_ENABLE_BYTE_WATCHDOGהגדר ל-1 כדי לאלץ הפעלה של watchdog של חוסר פעילות בסטרימינג ברמת הבייט, או הגדר ל-0 כדי לאלץ כיבוי שלו. 0 גם מכבה את המועד האחרון לבייט הראשון בחיבורים שבהם המועד האחרון הזה רץ. כשלא מוגדר, ה-watchdog מופעל כברירת מחדל לחיבורי Anthropic API ישירים ולחיבורי Claude Platform on AWS, ולתגובות סטרימינג בחיבורי gateway שמגיעים דרך ANTHROPIC_BASE_URL או ANTHROPIC_AWS_BASE_URL. לפני v2.1.222 הוא לא רץ על חיבורי gateway האלה, כך שה-watchdog ברמת האירוע יכול היה לדווח על עצירה שם גם בזמן ש-keep-alive pings הגיעו. לזמני קצוב ולאופן האינטראקציה בין הטיימרים, ראה Streaming idle watchdogs
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCKהגדר ל-1 כדי להפעיל את ה-watchdog של חוסר פעילות בסטרימינג ברמת הבייט על תגובות Amazon Bedrock מסוג vnd.amazon.eventstream, מה שמפעיל גם את המועד האחרון לבייט הראשון בבקשות סטרימינג של Bedrock. כבוי כברירת מחדל. הגדר את הזמן הקצוב עם CLAUDE_STREAM_IDLE_TIMEOUT_MS
CLAUDE_ENABLE_STREAM_WATCHDOGהגדר ל-0 כדי לאלץ כיבוי של ה-watchdog של חוסר פעילות בסטרימינג ברמת האירוע, או הגדר ל-1 כדי לאלץ הפעלה שלו. כשלא מוגדר, ה-watchdog פועל כברירת מחדל לכל הספקים. לפני v2.1.196, ברירת המחדל כשלא מוגדר הייתה בשליטת השרת ב-Anthropic API הישיר וכבויה אצל ספקים אחרים. הגדר את הזמן הקצוב עם CLAUDE_STREAM_IDLE_TIMEOUT_MS. לטיימרי העצירה האחרים שרצים לצד זה, ראה Streaming idle watchdogs
CLAUDE_ENV_FILEנתיב לסקריפט מעטפת שאת תוכנו Claude Code מריץ לפני כל פקודת Bash באותו תהליך מעטפת, כך ש-exports בקובץ גלויים לפקודה. השתמש כדי לשמור הפעלה של virtualenv או conda בין פקודות. פקודות PowerShell מקבלות גם את המשתנים שלו, ב-v2.1.296 או חדש יותר, לפי התנאים ב-משתנים שנשמרים בפקודות PowerShell. מתמלא גם באופן דינמי על ידי hooks של SessionStart, Setup, CwdChanged ו-FileChanged
CLAUDE_JOB_DIRמוגדר על ידי Claude Code בכל סשן רקע לספריית ~/.claude/jobs/<id> של אותו סשן. פקודות מעטפת שהסשן מריץ יורשות אותו. כתוב קבצי טיוטה אל $CLAUDE_JOB_DIR/tmp. קריאות Write ו-Edit של Claude שם לא מבקשות הרשאה, והספרייה מוסרת כשהסשן נמחק
CLAUDE_PIDClaude Code מגדיר את זה למזהה התהליך שלו בתהליכי המשנה שהוא מפעיל: פקודות כלי Bash ו-PowerShell ופקודות hook. ב-Linux, שילוב המעטפת של כלי Bash משתמש בו כדי לסרב לתבנית pkill שתתאים לתהליך Claude Code עצמו. ראה הפניית השגיאות. קרא אותו מהסקריפטים שלך כדי לזהות או לאותת במכוון לתהליך האב של Claude Code. דורש Claude Code v2.1.214 או חדש יותר
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIXקידומת לשמות סשן Remote Control שנוצרים אוטומטית כשלא מסופק שם מפורש. ברירת המחדל היא hostname של המכונה, ונוצרים שמות כמו myhost-graceful-unicorn. דגל ה-CLI --remote-control-session-name-prefix מגדיר את אותו ערך להפעלה אחת
CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MSמועד אחרון במילישניות לבייט התגובה הראשון של בקשת סטרימינג, בחיבורים שבהם המועד האחרון לבייט הראשון רץ. לאופן שבו Claude Code מגביל אותו, לזמן הנוסף שהוא מוסיף לגופי בקשה גדולים, ולאופן שבו הוא בוחר את המועד האחרון כשמשאירים את זה לא מוגדר, ראה אין תגובה מה-API. דורש Claude Code v2.1.242 או חדש יותר
משתנהמטרה
CLAUDE_STREAM_IDLE_TIMEOUT_MSזמן קצוב באלפיות שנייה לפני ששומרי הסרק של הסטרימינג, ברמת האירוע וברמת הבתים, סוגרים חיבור שנתקע. כשמגדירים את המשתנה הזה במפורש, המינימום הוא 300000 (5 דקות). ערכים נמוכים יותר מוצמדים בשקט אל המינימום כדי לספוג הפסקות חשיבה ממושכות וחציצה של פרוקסי, ושומר הסרק ברמת הבתים מגביל את הערך ל-30 דקות. CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS מקבל עדיפות על המשתנה הזה עבור שומר הסרק ברמת הבתים. לברירות המחדל כשכל שומר לא מוגדר, ראו שומרי סרק של סטרימינג
CLAUDE_SUBAGENT_BG_SHELL_MAX_MSהוסר ב-v2.1.260 וכעת הוא no-op. בעבר הגביל כמה זמן יכולה לרוץ פקודת מעטפת ברקע ש-תת סוכן הפעיל, באלפיות שנייה, עם ברירת מחדל של 60 דקות. ראו כללי משך החיים של פקודות רקע
DEBUGהגדירו ל-1 כדי להפעיל מצב דיבוג, שווה ערך להפעלה עם --debug. יומני הדיבוג נכתבים אל ~/.claude/debug/<session-id>.txt, או אל הנתיב שמוגדר ב-CLAUDE_CODE_DEBUG_LOGS_DIR. רק ערכי truthy 1, true, yes ו-on מפעילים מצב דיבוג, כך שתבניות מרחב שמות כמו DEBUG=express:* שהוגדרו לכלים אחרים לא מפעילות אותו
DISABLE_AUTOUPDATERהגדירו ל-1 כדי לבטל עדכוני רקע אוטומטיים. claude update ידני עדיין עובד. השתמשו ב-DISABLE_UPDATES כדי לחסום את שניהם
DISABLE_AUTO_COMPACTהגדירו ל-1 כדי לבטל דחיסה אוטומטית כשמתקרבים למגבלת ההקשר, יחד עם דחיסת סרק. הפקודה הידנית /compact נשארת זמינה. השתמשו כשרוצים שליטה מפורשת על מועד הדחיסה. דורס את ההגדרה autoCompactEnabled
DISABLE_COMPACTהגדירו ל-1 כדי לבטל כל דחיסה: גם דחיסה אוטומטית וגם הפקודה הידנית /compact
DISABLE_COST_WARNINGSהגדירו ל-1 כדי לבטל הודעות אזהרה על עלות
DISABLE_DOCTOR_COMMANDהגדירו ל-1 כדי להסתיר את מיומנות בדיקת ההגדרה /doctor ואת הכינוי /checkup שלה. שימושי בפריסות מנוהלות שבהן משתמשים לא אמורים להריץ אבחוני הגדרה מתוך סשן. לא משפיע על פקודת הטרמינל claude doctor. לפני v2.1.205, המשתנה הזה הסתיר את פקודת מסך האבחון /doctor
DISABLE_ERROR_REPORTINGהגדירו לכל ערך לא ריק, כמו 1, כדי לצאת מדיווח שגיאות. הגדרה ל-0 או ל-false עדיין מוציאה מדיווח, בניגוד לרוב משתני ההפעלה והכיבוי. בטלו את הגדרת המשתנה כדי להחזיר את דיווח השגיאות
DISABLE_EXTRA_USAGE_COMMANDהגדירו ל-1 כדי להסתיר את הפקודה /usage-credits שמאפשרת למשתמשים לרכוש שימוש נוסף מעבר למגבלות הקצב
DISABLE_FEEDBACK_COMMANDהגדירו ל-1 כדי לבטל את הפקודה /feedback ואת משוב שנוסח על ידי Claude. מבטל גם את /bug ואת /share, שמדווחים דרך אותו נתיב. לפני v2.1.212 הם היו כינויים של /feedback, ולכן הפקודה בוטלה תחת כל שם. גם השם הישן DISABLE_BUG_COMMAND מתקבל
DISABLE_GROWTHBOOKהגדירו ל-1 או ל-true כדי לבטל שליפת דגלי תכונות ולהשתמש בברירות המחדל בקוד עבור כל דגל. זה הופך את Remote Control ואת התכונות האחרות שדורשות שליפת דגלי תכונות ללא זמינות. הגדרה ל-0 או ל-false משאירה את השליפה פעילה. רישום אירועי טלמטריה נשאר פעיל אלא אם גם DISABLE_TELEMETRY מוגדר
DISABLE_INSTALLATION_CHECKSהגדירו ל-1 כדי לבטל אזהרות התקנה. השתמשו רק כשמנהלים ידנית את מיקום ההתקנה, כי זה עלול להסתיר בעיות בהתקנות רגילות
DISABLE_INSTALL_GITHUB_APP_COMMANDהגדירו ל-1 כדי להסתיר את הפקודה /install-github-app. כבר מוסתרת כשמשתמשים בספקים של צד שלישי (Amazon Bedrock, Google Cloud's Agent Platform, או Microsoft Foundry)
DISABLE_INTERLEAVED_THINKINGהגדירו ל-1 כדי למנוע שליחה של כותרת הבטא של חשיבה משולבת. שימושי כששער ה-LLM או הספק שלכם לא תומך ב-חשיבה משולבת
DISABLE_LOGIN_COMMANDהגדירו ל-1 כדי להסתיר את הפקודה /login. שימושי כשהאימות מטופל חיצונית דרך מפתחות API או apiKeyHelper
DISABLE_LOGOUT_COMMANDהגדירו ל-1 כדי להסתיר את הפקודה /logout
DISABLE_PROMPT_CACHINGהגדירו ל-1 כדי לבטל שמירת פרומפטים במטמון עבור כל המודלים (מקבל עדיפות על הגדרות לכל מודל)
DISABLE_PROMPT_CACHING_FABLEהגדירו ל-1 כדי לבטל שמירת פרומפטים במטמון עבור מודלי Fable
DISABLE_PROMPT_CACHING_HAIKUהגדירו ל-1 כדי לבטל שמירת פרומפטים במטמון עבור מודל Haiku ברירת המחדל, בכל מקום שהוא רץ
DISABLE_PROMPT_CACHING_OPUSהגדירו ל-1 כדי לבטל שמירת פרומפטים במטמון עבור מודל Opus ברירת המחדל
DISABLE_PROMPT_CACHING_SONNETהגדירו ל-1 כדי לבטל שמירת פרומפטים במטמון עבור מודל Sonnet ברירת המחדל
DISABLE_TELEMETRYהגדירו לכל ערך לא ריק, כמו 1, כדי לצאת מטלמטריה. הגדרה ל-0 או ל-false עדיין מוציאה מטלמטריה, בניגוד לרוב משתני ההפעלה והכיבוי. בטלו את הגדרת המשתנה כדי להחזיר את הטלמטריה. אירועי טלמטריה לא כוללים נתוני משתמש כמו קוד, נתיבי קבצים או פקודות Bash. מבטל גם שליפת דגלי תכונות. ראו כיבוי טלמטריה עבור הארגון
DISABLE_UPDATESהגדירו ל-1 כדי לחסום את כל העדכונים, כולל claude update ו-claude install ידניים. מחמיר יותר מ-DISABLE_AUTOUPDATER. השתמשו כשמפיצים את Claude Code בערוצים שלכם ומשתמשים לא אמורים לעדכן בעצמם
DISABLE_UPGRADE_COMMANDהגדירו ל-1 כדי להסתיר את הפקודה /upgrade
DO_NOT_TRACKהגדירו ל-1 כדי לצאת מטלמטריה, עם אותו אפקט כמו DISABLE_TELEMETRY, כולל על שליפת דגלי תכונות. Claude Code קורא את המשתנה הזה כבוליאני רגיל, כך ש-0 משאיר את הטלמטריה פעילה, ומכבד אותו כמוסכמה בין כלים שמוכרת על ידי CLI רבים למפתחים
ENABLE_BETA_TRACING_DETAILEDהגדירו ל-1, והגדירו את BETA_TRACING_ENDPOINT לנקודת הקצה של אספן OTLP/HTTP שלכם, כדי להפעיל מעקב בטא מפורט, שמוסיף מאפייני span שנושאים תוכן ואת ה-span claude_code.hook. סשני CLI אינטראקטיביים דורשים גם שהארגון שלכם יהיה ברשימת ההיתר של הבטא. שני המשתנים לא נלקחים בחשבון ב-הגדרות פרויקט והגדרות מקומיות
ENABLE_CLAUDEAI_MCP_SERVERSהגדירו ל-false כדי לעצור את Claude Code משליפת שרתי MCP של claude.ai. מופעל כברירת מחדל עבור משתמשים מחוברים. כדי לבטל לכל פרויקט או לכל ארגון, הגדירו את disableClaudeAiConnectors בהגדרות
ENABLE_PROMPT_CACHING_1Hהגדירו ל-1 כדי לבקש TTL של מטמון פרומפטים של שעה אחת במקום ברירת המחדל של 5 דקות. מיועד למשתמשי מפתח API, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ו-Claude Platform on AWS. עבור משתמשי מנוי בתוך השימוש הכלול, Claude Code מבקש את ה-TTL של שעה אחת אוטומטית ב-שיחה הראשית. משתמשי מנוי שמושכים מ-קרדיטי שימוש יכולים להגדיר אותו כדי לשמור על ה-TTL של שעה אחת. כתיבות מטמון של שעה אחת מחויבות בתעריף גבוה יותר. כדי לבחור את ה-TTL בנפרד לשיחה הראשית ולבקשות שמחוץ לה, השתמשו ב-CLAUDE_CODE_PROMPT_CACHE_TTL וב-CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, שמקבלים עדיפות על המשתנה הזה
ENABLE_PROMPT_CACHING_1H_BEDROCKהוצא משימוש. השתמשו ב-ENABLE_PROMPT_CACHING_1H. אין לו השפעה על סשנים של שער אפליקציות Claude, גם כשהשער מנתב אל Amazon Bedrock
ENABLE_TOOL_SEARCHשולט ב-חיפוש כלי MCP. כשהמשתנה לא מוגדר, או כשהערך הוא true, כלי MCP נדחים, למעט ב-מקרים שמשאירים את חיפוש הכלים כבוי. auto מפעיל חיפוש כלים ברגע שההגדרות מגיעות ל-10% מחלון ההקשר. auto:N מגדיר סף מותאם, כמו auto:5 עבור 5%. false טוען את כל הכלים מראש. אם שער דוחה חיפוש כלים, ראו חיפוש כלים דרך שער LLM
FORCE_AUTOUPDATE_PLUGINSהגדירו ל-1 כדי לכפות עדכונים אוטומטיים של תוספים גם כשהמעדכן האוטומטי הראשי כבוי דרך DISABLE_AUTOUPDATER
FORCE_HYPERLINKהגדירו ל-1 כדי להפעיל היפר קישורים OSC 8 לחיצים כשהטרמינל תומך בהם אבל לא מזוהה אוטומטית. כשהמשתנה לא מוגדר, Claude Code מפעיל את רוב ההיפר קישורים רק כשהוא מזהה תמיכת טרמינל. תג PR או בקשת מיזוג בכותרת התחתונה וכתובות התחברות ארוכות הם קישורים בכל מקרה. הגדירו 0, false, no או off כדי להציג את כולם כטקסט רגיל. לפני v2.1.314, false, no ו-off הפעילו היפר קישורים
FORCE_PROMPT_CACHING_5Mהגדירו ל-1 כדי לכפות TTL של מטמון פרומפטים של 5 דקות גם כש-TTL של שעה אחת היה חל אחרת. דורס את CLAUDE_CODE_PROMPT_CACHE_TTL, CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, ENABLE_PROMPT_CACHING_1H, ואת ההגדרות promptCacheTtl ו-subagentPromptCacheTtl
HTTP_PROXYציינו שרת פרוקסי HTTP עבור חיבורי רשת
HTTPS_PROXYציינו שרת פרוקסי HTTPS עבור חיבורי רשת
IS_DEMOהגדירו לכל ערך לא ריק, כמו 1, כדי להפעיל מצב הדגמה: מסתיר את האימייל ואת שם הארגון מהכותרת ומפלט /status, ומדלג על ההצטרפות. הגדרה ל-0 או ל-false עדיין מפעילה מצב הדגמה, בניגוד לרוב משתני ההפעלה והכיבוי. בטלו את הגדרת המשתנה כדי לכבות אותו. שימושי בזמן שידור או הקלטה של סשן
MAX_MCP_OUTPUT_TOKENSהמספר המרבי של טוקנים שמותר בתשובות כלי MCP (ברירת מחדל: 25000). Claude Code מציג אזהרה כשהפלט חורג מ-10,000 טוקנים. כלים שמצהירים על anthropic/maxResultSizeChars משתמשים במגבלת התווים הזו עבור תוכן טקסט, אבל תוכן תמונה מהכלים האלה עדיין כפוף למשתנה הזה. תוצאת טקסט מוצלחת ארוכה מ-50,000 תווים מכלי בלי ההערה הזו נשמרת לקובץ בלי קשר למשתנה הזה
MAX_STRUCTURED_OUTPUT_RETRIESמספר הניסיונות ש-Claude Code מאפשר כשתשובת המודל נכשלת באימות מול --json-schema במצב לא אינטראקטיבי עם הדגל -p. אחרי מספר כזה של ניסיונות כושלים בלי פלט תקין, הריצה נכשלת. אותה תקרה חלה כשפלט מובנה של תת סוכן ב-workflow נכשל באימות. ברירת המחדל היא 5, ניסיון ראשון ועוד ארבעה ניסיונות חוזרים
MAX_THINKING_TOKENSתקציב טוקנים קבוע ל-חשיבה מורחבת. Claude Code מגביל אותו לטוקן אחד מתחת למקסימום טוקני הפלט של הבקשה, ולעולם לא מתחת ל-1,024. ראו CLAUDE_CODE_MAX_OUTPUT_TOKENS לאופן קביעת המגבלה הזו. כשהמשתנה לא מוגדר וחשיבה מופעלת, מודלים עם הנמקה מסתגלת בוחרים בעצמם את עומק החשיבה, ומודלים אחרים משתמשים בתקרה. הגדירו ל-0 כדי לבטל חשיבה ב-API של Anthropic, למעט ב-Opus 5.5, Sonnet 5.5, Haiku 5.5 ובמודלי Fable, שאי אפשר לכבות בהם חשיבה. אצל ספקים של צד שלישי, 0 משמיט את הפרמטר thinking. כשחשיבה כבויה ב-API של Anthropic, Claude Code שולח מאמץ high במקום רמה גבוהה יותר למודלים שהוא יודע שלא מקבלים את השילוב הזה, כמו Opus 5. עבור ערך חיובי, Claude Code מתעלם מהמספר עצמו במודלים של הנמקה מסתגלת, למעט כש-CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING מכבה הנמקה מסתגלת
MCP_CLIENT_SECRETסוד לקוח OAuth עבור שרתי MCP שדורשים אישורים מוגדרים מראש. מונע את הבקשה האינטראקטיבית כשמוסיפים שרת עם --client-secret
MCP_CONNECTION_NONBLOCKINGשולט אם ההפעלה ממתינה לחיבור שרתי MCP לפני השאילתה הראשונה. הפעלת MCP היא לא חוסמת כברירת מחדל: השרתים מתחברים ברקע והכלים שלהם נעשים זמינים כשהם מסיימים. הגדירו ל-0 כדי ש-Claude Code ימתין לחיבור השרתים לפני השאילתה הראשונה. שרתים שמוגדרים עם alwaysLoad: true עדיין גורמים להפעלה להמתין בכל מקרה, למעט כשהם מוגשים מ-מטמון הגילוי, כי הכלים שלהם חייבים להיות נוכחים כשהפרומפט הראשון נבנה. במצב לא אינטראקטיבי (-p) בלי --input-format stream-json, Claude Code גם ממתין לשרתים שעדיין ממתינים לפני התור הראשון, בלי קשר למשתנה הזה. כשמעבירים --mcp-config במפורש, להמתנה יש דדליין ארוך יותר. ראו את הערך של הדגל הזה לחריג של שרת במטמון
MCP_CONNECT_TIMEOUT_MSכמה זמן הפעלת MCP חוסמת ממתינה, באלפיות שנייה, לאצוות החיבור לפני צילום רשימת הכלים (ברירת מחדל: 5000). חל כש-MCP_CONNECTION_NONBLOCKING=0 או עבור שרתים שמסומנים alwaysLoad: true. שרתים שעדיין ממתינים בדדליין ממשיכים להתחבר ברקע. נפרד מ-MCP_TIMEOUT, שתוחם ניסיון חיבור של שרת בודד
MCP_DISCOVERY_CACHEמפעיל או מכבה את מטמון גילוי MCP. כשהמטמון פועל, שרת HTTP או SSE מרוחק שכבר השתמשתם בו יכול להציג את סטטוס cached, ו-Claude Code מחבר אותו בקריאת הכלי הראשונה ולא בזמן ההפעלה. המטמון כבוי כברירת מחדל אלא אם השקה הדרגתית הפעילה אותו עבור החשבון שלכם. הגדירו ל-1 כדי להפעיל אותו, או ל-0 כדי להשאיר אותו כבוי גם כשההשקה הפעילה אותו. לפני v2.1.238, המטמון היה פועל כברירת מחדל. סטטוס cached דורש Claude Code v2.1.221 או חדש יותר
MCP_DISCOVERY_CACHE_MAX_STALE_Sגיל מרבי, בשניות, של רשומת מטמון גילוי (ברירת מחדל: 14400, או 4 שעות). בהפעלה שבה הרשומה ישנה יותר מזה, Claude Code משליך אותה ומחבר את השרת בהפעלה, כמו עם מטמון כבוי. Claude Code מגביל את הערך ל-7 ימים. לפני v2.1.238, ברירת המחדל הייתה 86400, או 24 שעות, ו-Claude Code לא הגביל את הערך
MCP_DISCOVERY_CACHE_STRIKESבהפעלה שבה רשומת מטמון גילוי ישנה יותר מ-MCP_DISCOVERY_CACHE_TTL_S, Claude Code מרענן אותה ברקע. המשתנה הזה קובע כמה רענונים ברצף יכולים להיכשל לפני ש-Claude Code משליך את הרשומה ומחבר את השרת בהפעלה הבאה (ברירת מחדל: 1). העלו אותו אם חיבור הרשת שלכם נופל מדי פעם, כדי שרענון כושל אחד לא ישליך את הרשומה. דורש Claude Code v2.1.238 או חדש יותר
MCP_DISCOVERY_CACHE_TTL_Sשניות שבהן Claude Code משתמש ברשומת מטמון גילוי בלי לרענן אותה (ברירת מחדל: 900). בהפעלה שבה הרשומה ישנה יותר מזה, Claude Code עדיין משתמש בה אבל מרענן אותה ברקע. ברגע שהרשומה ישנה יותר מ-MCP_DISCOVERY_CACHE_MAX_STALE_S, Claude Code משליך אותה. Claude Code מגביל את הערך ל-MCP_DISCOVERY_CACHE_MAX_STALE_S, שהוא 4 שעות כברירת מחדל. לפני v2.1.238, Claude Code לא הגביל את הערך
MCP_OAUTH_CALLBACK_PORTפורט קבוע ל-callback של הפניית OAuth, כחלופה ל---callback-port כשמוסיפים שרת MCP עם אישורים מוגדרים מראש
משתנהמטרה
MCP_PROTOCOL_NEGOTIATIONרק בסביבת הריצה של לקוח MCP בגרסה v2, קובע אם Claude Code בודק שרתים לגבי גרסת פרוטוקול MCP 2026-07-28. הגדר legacy כדי לדלג על הבדיקה, כך שכל שרת מתחבר עם לחיצת היד שלפני אותה גרסה. הגדר auto כדי לבדוק את סוגי השרתים שתומכים בבדיקה: שרתי HTTP ו-stdio, מחברים של claude.ai, והמחברים של סשנים בענן וב-Remote Control. כשהמשתנה לא מוגדר, Claude Code בודק את אותם סוגים כברירת מחדל. ראה סביבות ריצה של לקוח MCP. כל ערך אחר מתעלמים ממנו עם אזהרה ביומן הדיבוג. דורש Claude Code v2.1.221 או חדש יותר
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZEהמספר המרבי של שרתי MCP מרוחקים (HTTP/SSE) שמתחברים במקביל בזמן ההפעלה (ברירת מחדל: 20)
MCP_SDK_GENERATIONקובע באיזו סביבת ריצה של לקוח MCP התהליך הזה מתחבר לשרתי MCP: v1, שנבנתה על MCP TypeScript SDK 1.x, או v2, שנבנתה על MCP TypeScript SDK 2.0. בלי המשתנה, Claude Code משתמש ב-v2, החל מהגרסאות שרשומות באותו סעיף. ב-Claude Code v2.1.221 או חדש יותר, סביבת הריצה v2 בודקת את ה-issuer ששרת MCP OAuth מחזיר בתגובת ההרשאה שלו, ונכשלת בכניסה עם שגיאה שמתחילה ב-Issuer mismatch in authorization response כשאין התאמה. סביבת הריצה v1 לא מריצה את הבדיקה הזו. אם מגדירים ערך לא מזוהה, Claude Code מתעלם ממנו וכותב אזהרה ליומן הדיבוג. Claude Code קורא את הערך פעם אחת לכל תהליך. דורש Claude Code v2.1.218 או חדש יותר
MCP_SERVER_CONNECTION_BATCH_SIZEהמספר המרבי של שרתי MCP מקומיים (stdio) שמתחברים במקביל בזמן ההפעלה (ברירת מחדל: 3)
MCP_TIMEOUTזמן קצוב במילישניות להפעלת שרת MCP (ברירת מחדל: 30000, או 30 שניות)
MCP_TOOL_TIMEOUTזמן קצוב במילישניות להרצת כלי MCP (ברירת מחדל: 100000000, בערך 28 שעות). בשרת HTTP, SSE או מחבר claude.ai, כל בקשה גם מסתיימת בזמן קצוב אחרי 60 שניות כברירת מחדל. הגדר את המשתנה הזה, או את timeout לכל שרת, מעל 60000 כדי להעלות את מגבלת הזמן לכל בקשה. ערך נמוך יותר עדיין מקצר את הזמן הקצוב הכולל להרצת הכלי, אבל משאיר את המגבלה לכל בקשה על 60 שניות. לשרתי stdio ו-WebSocket אין טיימר לכל בקשה. שדה timeout לכל שרת ב-.mcp.json דורס את זה עבור אותו שרת. timeout לכל שרת של לפחות 1000 גם קובע את חלון הסרק המינימלי לקריאות הכלים של אותו שרת, כך ש-CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT אף פעם לא מפסיק אותן מוקדם יותר. הרצפה הזו דורשת Claude Code v2.1.203 או חדש יותר. עבור משתנה הסביבה, ערכים מתחת ל-1000 מעוגלים לשנייה אחת. עבור השדה לכל שרת, ערכים מתחת ל-1000 מתעלמים מהם
NO_PROXYרשימת דומיינים וכתובות IP שאליהם בקשות יישלחו ישירות, בלי לעבור דרך פרוקסי
OTEL_ATTRIBUTE_VALUE_LENGTH_LIMITמגבלת OpenTelemetry SDK הסטנדרטית על אורך ערך מאפיין. Claude Code מגביל מאפייני טלמטריה שנושאים תוכן לערך הקטן מבין זה ו-CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH, כך שסימן הקיצור נשאר בתוך מגבלת ה-SDK. Claude Code קורא את הווריאנטים OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT ו-OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT באותו אופן, והערך הקטן ביותר שהוגדר חל על כל האותות. דורש Claude Code v2.1.214 או חדש יותר. ראה ניטור
OTEL_LOG_ASSISTANT_RESPONSESהגדר ל-1 כדי לכלול את טקסט תשובת המודל באירועי יומן OpenTelemetry מסוג assistant_response. כשלא מוגדר, Claude Code משתמש בערך של OTEL_LOG_USER_PROMPTS במקום זאת. הגדר ל-0 כדי להשאיר תשובות מוסתרות גם כש-OTEL_LOG_USER_PROMPTS מוגדר. הגדר אותו במעטפת, בהגדרות משתמש או בהגדרות מנוהלות. מתעלמים ממנו בהגדרות פרויקט ומקומיות. דורש Claude Code v2.1.193 או חדש יותר. ראה ניטור
OTEL_LOG_MANAGED_SETTINGSהגדר ל-1 כדי להוסיף את ההגדרות המנוהלות המוסתרות, וגיבוב SHA-256 של ההגדרות לפני ההסתרה, לאירועי יומן OpenTelemetry מסוג managed_settings_resolved. מושבת כברירת מחדל. הגדר אותו במעטפת, בהגדרות משתמש או בהגדרות מנוהלות. ערך בהגדרות פרויקט או מקומיות לא מפעיל אותו. דורש Claude Code v2.1.274 או חדש יותר. ראה ניטור
OTEL_LOG_RAW_API_BODIESפולט JSON של בקשה ותשובה של Anthropic Messages API כאירועי יומן api_request_body / api_response_body. הגדר ל-1 עבור גופים בתוך האירוע שמקוצרים במגבלת התוכן, או file:<dir> כדי לכתוב גופים לא מקוצרים לדיסק ולפלוט במקום זאת נתיב body_ref. CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH מגדיר את מגבלת התוכן, 60 KB כברירת מחדל. מושבת כברירת מחדל. הגופים כוללים את כל היסטוריית השיחה. הגדר אותו במעטפת, בהגדרות משתמש או בהגדרות מנוהלות. מתעלמים ממנו בהגדרות פרויקט ומקומיות. ראה ניטור
OTEL_LOG_TOOL_CONTENTהגדר ל-1 כדי לכלול תוכן כלי באירוע span של OpenTelemetry מסוג tool.output. מאפייני span נושאים תוכן כלי תחת השערים שלהם. דורש מעקב. מושבת כברירת מחדל כדי להגן על נתונים רגישים. הגדר אותו במעטפת, בהגדרות משתמש או בהגדרות מנוהלות. מתעלמים ממנו בהגדרות פרויקט ומקומיות, מלבד ערכי הכיבוי שאותו סעיף מתאר. ראה ניטור
OTEL_LOG_TOOL_DETAILSהגדר ל-1 כדי לכלול ארגומנטים של קלט כלי, שמות שרתי MCP, שמות תהליכי עבודה שכתב המשתמש, מחרוזות שגיאה גולמיות בכשלי כלים, את category של הסירוב באירועי api_refusal, שמות אמיתיים של סוכן, skill, תוסף ושרת MCP במדדי עלות ואסימונים, ופרטי כלים נוספים במדדים, במעקבים וביומנים של OpenTelemetry. מושבת כברירת מחדל כדי להגן על PII. הגדר אותו במעטפת, בהגדרות משתמש או בהגדרות מנוהלות. מתעלמים ממנו בהגדרות פרויקט ומקומיות, מלבד ערכי הכיבוי שאותו סעיף מתאר. ראה ניטור
OTEL_LOG_USER_PROMPTSהגדר ל-1 כדי לכלול טקסט הנחיה של המשתמש במעקבים וביומנים של OpenTelemetry. מושבת כברירת מחדל (ההנחיות מוסתרות). הגדר אותו במעטפת, בהגדרות משתמש או בהגדרות מנוהלות. מתעלמים ממנו בהגדרות פרויקט ומקומיות, מלבד ערכי הכיבוי שאותו סעיף מתאר. ראה ניטור
OTEL_METRICS_INCLUDE_ACCOUNT_UUIDהגדר ל-false כדי להוציא את ה-UUID של החשבון ממאפייני המדדים (ברירת מחדל: כלול). ראה ניטור
OTEL_METRICS_INCLUDE_ENTRYPOINTהגדר ל-true כדי לכלול את נקודת הכניסה של הסשן במאפייני המדדים (ברירת מחדל: לא כלול). נוסף ב-v2.1.152. ראה ניטור
OTEL_METRICS_INCLUDE_REPOSITORYהגדר ל-true כדי לתייג מדדים ואירועים של OpenTelemetry במאפייני vcs.* שמזהים את המאגר של הסשן (ברירת מחדל: לא כלול). דורש Claude Code v2.1.269 או חדש יותר. ראה מאפייני מאגר
OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTESהחל מ-v2.1.161, Claude Code מצרף מפתחות OTEL_RESOURCE_ATTRIBUTES לתוויות של נקודות נתונים במדדים. הגדר ל-false כדי להוציא אותם (ברירת מחדל: כלולים). ראה ניטור
OTEL_METRICS_INCLUDE_SESSION_IDהגדר ל-false כדי להוציא את מזהה הסשן ממאפייני המדדים (ברירת מחדל: כלול). ראה ניטור
OTEL_METRICS_INCLUDE_VERSIONהגדר ל-true כדי לכלול את גרסת Claude Code במאפייני המדדים (ברירת מחדל: לא כלולה). ראה ניטור
SLASH_COMMAND_TOOL_CHAR_BUDGETדורס את תקציב התווים למטא-נתונים של skill שמוצגים לכלי Skill. התקציב משתנה דינמית ב-1% מחלון ההקשר, עם גיבוי של 8,000 תווים. השם הישן נשמר לתאימות לאחור
TASK_MAX_OUTPUT_LENGTHהוסר ב-v2.1.277 ועכשיו הוא no-op, יחד עם כלי TaskOutput שהגדיר את גודלו. בעבר קבע את המספר המרבי של תווים בפלט של משימת רקע שכלי TaskOutput שמר. Claude קורא את קובץ הפלט של משימת רקע עם Read במקום זאת
USE_BUILTIN_RIPGREPהגדר ל-0 כדי להשתמש ב-rg שמותקן במערכת במקום ב-rg שכלול עם Claude Code
VERTEX_REGION_CLAUDE_3_5_HAIKUדורס את האזור עבור Claude 3.5 Haiku בשימוש ב-Agent Platform של Google Cloud
VERTEX_REGION_CLAUDE_3_5_SONNETדורס את האזור עבור Claude 3.5 Sonnet בשימוש ב-Agent Platform של Google Cloud
VERTEX_REGION_CLAUDE_3_7_SONNETדורס את האזור עבור Claude 3.7 Sonnet בשימוש ב-Agent Platform של Google Cloud
VERTEX_REGION_CLAUDE_4_0_OPUSדורס את האזור עבור Claude Opus 4 בשימוש ב-Agent Platform של Google Cloud
VERTEX_REGION_CLAUDE_4_0_SONNETדורס את האזור עבור Claude Sonnet 4 בשימוש ב-Agent Platform של Google Cloud
VERTEX_REGION_CLAUDE_4_1_OPUSדורס את האזור עבור Claude Opus 4.1 בשימוש ב-Agent Platform של Google Cloud
VERTEX_REGION_CLAUDE_4_5_OPUSדורס את האזור עבור Claude Opus 4.5 בשימוש ב-Agent Platform של Google Cloud
VERTEX_REGION_CLAUDE_4_5_SONNETדורס את האזור עבור Claude Sonnet 4.5 בשימוש ב-Agent Platform של Google Cloud
VERTEX_REGION_CLAUDE_4_6_OPUSדורס את האזור עבור Claude Opus 4.6 בשימוש ב-Agent Platform של Google Cloud
VERTEX_REGION_CLAUDE_4_6_SONNETדורס את האזור עבור Claude Sonnet 4.6 בשימוש ב-Agent Platform של Google Cloud
VERTEX_REGION_CLAUDE_4_7_OPUSדורס את האזור עבור Claude Opus 4.7 בשימוש ב-Agent Platform של Google Cloud
VERTEX_REGION_CLAUDE_4_8_OPUSדורס את האזור עבור Claude Opus 4.8 בשימוש ב-Agent Platform של Google Cloud
VERTEX_REGION_CLAUDE_5_5_OPUSדורס את האזור עבור Claude Opus 5.5 בשימוש ב-Agent Platform של Google Cloud. נוסף ב-v2.1.280
VERTEX_REGION_CLAUDE_5_5_SONNETדורס את האזור עבור Claude Sonnet 5.5 בשימוש ב-Agent Platform של Google Cloud. נוסף ב-v2.1.284
VERTEX_REGION_CLAUDE_5_OPUSדורס את האזור עבור Claude Opus 5 בשימוש ב-Agent Platform של Google Cloud. נוסף ב-v2.1.219
VERTEX_REGION_CLAUDE_5_SONNETדורס את האזור עבור Claude Sonnet 5 בשימוש ב-Agent Platform של Google Cloud. נוסף ב-v2.1.197
VERTEX_REGION_CLAUDE_FABLE_5דורס את האזור עבור Claude Fable 5 בשימוש ב-Agent Platform של Google Cloud. נוסף ב-v2.1.170
VERTEX_REGION_CLAUDE_FABLE_5_1דורס את האזור עבור Claude Fable 5.1 בשימוש ב-Agent Platform של Google Cloud. נוסף ב-v2.1.257
VERTEX_REGION_CLAUDE_HAIKU_4_5דורס את האזור עבור Claude Haiku 4.5 בשימוש ב-Agent Platform של Google Cloud
VERTEX_REGION_CLAUDE_HAIKU_5_5דורס את האזור עבור Claude Haiku 5.5 בשימוש ב-Agent Platform של Google Cloud. נוסף ב-v2.1.293

נתמכים גם משתני ייצוא סטנדרטיים של OpenTelemetry (OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_METRIC_EXPORT_INTERVAL, OTEL_RESOURCE_ATTRIBUTES, ווריאנטים ייעודיים לאות). ראה ניטור לפרטי ההגדרה.

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

#מה הניקוי של סביבת תהליך משנה מסיר

כשמגדירים CLAUDE_CODE_SUBPROCESS_ENV_SCRUB ל-1, Claude Code מסיר אישורים מסביבות תהליכי המשנה שהוא מפעיל, כמו פקודות Bash, hooks ושרתי MCP מסוג stdio. זה מצמצם את מה שמתקפת הזרקת הנחיה יכולה לקרוא. תהליך Claude Code שומר את האישורים לקריאות ה-API שלו.

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

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

משתנה לדוגמהמה הניקוי עושה
ANTHROPIC_API_KEY, AWS_SECRET_ACCESS_KEYמסיר אותו
NPM_TOKEN, DB_PASSWORDמסיר אותו, כי השם נראה כמו אישור
DATABASE_URL שמכיל סיסמהמסיר אותו, כי הערך נראה כמו אישור
PIP_INDEX_URL או NPM_CONFIG_REGISTRY שמכיל סיסמהשומר את ה-URL וחותך ממנו את שם המשתמש והסיסמה
CLAUDE_CONFIG_DIRמסיר אותו
GITHUB_TOKEN, GH_TOKEN, GH_ENTERPRISE_TOKEN, GITHUB_ENTERPRISE_TOKENמשאיר אותו במקום, כדי ש-gh וסקריפטים שקוראים ל-API של GitHub ימשיכו לעבוד
HTTP_PROXY, HTTPS_PROXYמשאיר אותו במקום, כולל שם משתמש וסיסמה ב-URL. הארגז חול יכול להגדיר את המשתנים האלה בעצמו עבור פקודות בארגז חול
GIT_CONFIG_COUNT, GIT_CONFIG_KEY_<n>, GIT_CONFIG_VALUE_<n>משאיר אותו במקום, יהיה מה שיהיה בתוכו
סוד ששם המשתנה והערך שלו לא נראים כמו אישורמשאיר אותו במקום

מכיוון שהניקוי משאיר את GITHUB_TOKEN במקום, תן לעבודת GitHub Actions את permissions המצומצמות ביותר שהיא צריכה. כדי להסיר אסימון GitHub מפקודות Bash בארגז חול, הוסף רשומת deny תחת sandbox.credentials.

השאר את הניקוי לא מוגדר אם תהליך משנה צריך אחד מהמשתנים שהוסרו.

ב-Linux, הניקוי גם מריץ תהליכי משנה של Bash במרחב שמות PID מבודד, כך שהם לא יכולים לקרוא סביבות תהליכים של המארח דרך /proc. כתוצאת לוואי, ps, pgrep ו-kill לא יכולים לראות תהליכי מארח או לאותת להם.

לפני v2.1.251, הניקוי הסיר את ANTHROPIC_API_KEY ואת AWS_SECRET_ACCESS_KEY והשאיר את שאר משתני הדוגמה בטבלה בלי שינוי.

#תכונות שצריכות שליפה של דגלי תכונות

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

  • סשן שבו מגדירים את DISABLE_GROWTHBOOK, DISABLE_TELEMETRY, DO_NOT_TRACK, או CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC. השורה של כל משתנה בטבלת המשתנים מציינת אילו ערכים מכבים את השליפה
  • סשן אצל ספק צד שלישי, כגון Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, או Microsoft Foundry, אלא אם פלטפורמת מארח שמטמיעה את Claude Code מגדירה את CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
  • סשן של שער יישומי Claude

כשהשליפה כבויה, אי אפשר:

#הסשן הראשון אחרי התקנה או שדרוג

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

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

  • סביבה נקייה בכל הרצה: אם כל הרצה מתחילה בקונטיינר CI, או בכל סביבה אחרת בלי הדגלים שסשן קודם שמר, כל הרצה היא סשן ראשון
  • אסימון שער בלי מפתח API: אם מאמתים עם ANTHROPIC_AUTH_TOKEN ובלי מפתח API, ו-ANTHROPIC_BASE_URL מצביע על מארח שאינו של Anthropic, כגון שער LLM, ל-Claude Code אין אישור שאיתו אפשר לשלוף את הדגלים

#ראה גם