תיעוד 97
הגדרת הגדרות שמנוהלות בשרת
הגדרה מרכזית של Claude Code עבור הארגון דרך הגדרות שנמסרות מהשרת, בלי לדרוש תשתית לניהול מכשירים.
הגדרות שמנוהלות בשרת מאפשרות לבעלי הארגון (Owners) להגדיר את Claude Code באופן מרכזי מתוך Organization settings > Claude Code > Managed settings במסוף claude.ai. לקוחות Claude Code מושכים את ההגדרות האלה אוטומטית כשמשתמשים מאמתים את עצמם עם אישור מתאים בפלטפורמה שבה מסירה שמנוהלת בשרת נתמכת. ראו זמינות פלטפורמות לגבי האישורים והפלטפורמות שעומדים בתנאים.
[!NOTE]
הגדרות שמנוהלות בשרת זמינות ללקוחות Claude for Teams וללקוחות Claude for Enterprise.
#דרישות
כדי להשתמש בהגדרות שמנוהלות בשרת, צריך:
- תוכנית Claude for Teams או Claude for Enterprise
- תפקיד Owner או Primary Owner בארגון Claude, כדי לצפות בהגדרה ולערוך אותה
- גישת רשת אל
api.anthropic.com
#בחירה בין הגדרות שמנוהלות בשרת להגדרות שמנוהלות בנקודת קצה
Claude Code תומך בשתי גישות להגדרה מרכזית. הגדרות שמנוהלות בשרת מוסרות הגדרות משרתי Anthropic. הגדרות שמנוהלות בנקודת קצה נפרסות ישירות למכשירים דרך מדיניות מקורית של מערכת ההפעלה (העדפות מנוהלות ב-macOS, הרישום של Windows) או דרך קובצי הגדרות מנוהלים.
| גישה | מתאים ל | מודל אבטחה |
|---|---|---|
| הגדרות שמנוהלות בשרת | ארגונים בלי MDM, או משתמשים במכשירים לא מנוהלים | הגדרות ש-Claude Code מושך משרתי Anthropic בהפעלה ומרענן מדי שעה במהלך הסשן |
| הגדרות שמנוהלות בנקודת קצה | ארגונים עם MDM או ניהול נקודות קצה | הגדרות שנפרסות למכשירים דרך פרופילי תצורה של MDM, מדיניות רישום, או קובצי הגדרות מנוהלים |
אם המכשירים רשומים ב-MDM או בפתרון לניהול נקודות קצה, הגדרות שמנוהלות בנקודת קצה נותנות ערבויות אבטחה חזקות יותר כי אפשר להגן על קובץ ההגדרות מפני שינוי על ידי המשתמש ברמת מערכת ההפעלה. הגדרות שמנוהלות בנקודת קצה אינן מגיעות אל סשנים בענן בסביבות שמתארחות אצל Anthropic, ולכן ארגונים שהמפתחים שלהם מריצים סשנים בענן צריכים להגדיר גם הגדרות שמנוהלות בשרת. סשנים בסביבה באירוח עצמי קוראים גם הם את קובץ ההגדרות המנוהל בתמונת ה-runner. קדימות ההגדרות בהמשך אומרת מתי הקובץ הזה חל.
#הגדרת הגדרות שמנוהלות בשרת
1. פתיחת מסוף הניהול
במסוף claude.ai, עברו אל Organization settings > Claude Code > Managed settings.
בארגון Team או Enterprise, אם העמוד אומר שאין לכם גישה, בקשו מ-Owner או Primary Owner לבצע את השינוי.
2. הגדרת ההגדרות
הוסיפו את התצורה כ-JSON. כל ההגדרות הזמינות ב-settings.json נתמכות, חוץ מאלה שמוגבלות למסירה במדיניות ברמת מערכת ההפעלה. ראו מגבלות נוכחיות לרשימה הקצרה הזו. זה כולל hooks, משתני סביבה, והגדרות למנוהל בלבד כמו allowManagedPermissionRulesOnly.
הדוגמה הזו אוכפת רשימת דחייה של הרשאות, מונעת ממשתמשים לעקוף הרשאות, ומגבילה כללי הרשאה לאלה שמוגדרים בהגדרות המנוהלות. הכלל Bash(curl *) תואם ל-curl כפי ש-Claude כותב אותו, ולא ל-/usr/bin/curl או ל-sh -c 'curl …'. לאכיפת רשת שאינה תלויה בטקסט הפקודה, הוסיפו בלוק sandbox עם allowManagedDomainsOnly.
{
"permissions": {
"deny": [
"Bash(curl *)",
"Read(./.env)",
"Read(./.env.*)",
"Read(./secrets/**)"
],
"disableBypassPermissionsMode": "disable"
},
"allowManagedPermissionRulesOnly": true
}Hooks משתמשים באותו פורמט כמו ב-settings.json.
הדוגמה הזו מריצה סקריפט ביקורת אחרי כל עריכת קובץ בכל הארגון:
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{ "type": "command", "command": "/usr/local/bin/audit-edit.sh" }
]
}
]
}
}מכיוון ש-hooks מריצים פקודות מעטפת, משתמשים בסשנים אינטראקטיביים רואים תיבת אישור אבטחה לפני ש-Claude Code מחיל אותם.
כדי להגדיר את המסווג של מצב אוטומטי כך שידע אילו מאגרים, דליים ודומיינים הארגון סומך עליהם, מסרו בלוק autoMode באותה דרך. ראו הגדרת מצב אוטומטי לגבי האופן שבו רשומות autoMode משפיעות על מה שהמסווג חוסם, ולגבי אזהרות חשובות על השדות environment, allow, soft_deny ו-hard_deny.
3. שמירה ופריסה
שמרו את השינויים. לקוחות Claude Code מקבלים את ההגדרות המעודכנות בהפעלה הבאה או במחזור הסקרים השעתי.
העורך בודק את ה-JSON מול סכמת ה-JSON שפורסמה להגדרות Claude Code. אם הוא מוצא בעיה ב-JSON שניתן לנתח, הוא מציג אזהרה ומשנה את התווית של כפתור השמירה. התווית היא Update with errors כשההגדרות כבר נשמרו, ו-Add with errors כשעדיין לא נשמרו הגדרות. הכפתור הזה עדיין שומר, כי אזהרת סכמה אינה חוסמת את השמירה.
הסכמה יכולה לפגר אחרי המהדורות החדשות ביותר, ולכן העורך יכול לסמן מפתח או ערך שהפניית ההגדרות מתעדת. Claude Code מקבל את המפתחות והערכים ששמרתם ומריץ אימות משלו כשהוא טוען אותם.
#אימות מסירת ההגדרות
כדי לאשר שההגדרות מוחלות, בקשו ממשתמש להפעיל מחדש את Claude Code. אם התצורה כוללת הגדרות שמפעילות את תיבת אישור האבטחה, המשתמש רואה הנחיה שמתארת את ההגדרות המנוהלות בפעם הבאה ש-Claude Code מושך אותן: בהפעלה הבאה, או בתוך שעה בסשן אינטראקטיבי שרץ. אפשר גם לאמת שכללי הרשאה מנוהלים פעילים בכך שמשתמש יריץ /permissions כדי לראות את כללי ההרשאה בפועל.
כדי לבדוק את תוצאת המשיכה במכונה מסוימת, בקשו מהמשתמש להריץ claude doctor ולקרוא את השורה Managed settings (remote). נדרש Claude Code בגרסה v2.1.248 או חדשה יותר. השורה מדווחת על אחת מארבע תוצאות:
- ההגדרות שנמסרו נטענו
- לארגון אין הגדרות שמנוהלות בשרת
- המשיכה נכשלה, עם הסיבה ועם ציון אם מדיניות שמורה במטמון עדיין חלה
- Claude Code דילג על המשיכה, עם הסיבה. ראו זמינות פלטפורמות לגבי הספקים והתצורות שמדלגים עליה
בזמן שהמשיכה עדיין מתבצעת, השורה מדווחת על כך במקום.
בסשן שרץ, /status מציג את אותה שורה אחרי משיכה שנכשלה, ולגבי חלק מסיבות הדילוג על המשיכה, כמו משתנה של ספק צד שלישי או ANTHROPIC_BASE_URL מותאם שיוצא במעטפת של המשתמש.
#בקרת גישה
התפקידים הבאים יכולים לנהל הגדרות שמנוהלות בשרת:
- Primary Owner
- Owner
הגבילו את הגישה לאנשי סגל מהימנים, כי שינויי הגדרות חלים על כל המשתמשים בארגון.
#הגדרות למנוהל בלבד
רוב מפתחות ההגדרות פועלים בכל היקף. קומץ מפתחות נקראים רק מהגדרות מנוהלות ואין להם השפעה כשהם ממוקמים בקובצי הגדרות של משתמש או של פרויקט. ראו הגדרות למנוהל בלבד לגבי בקרות ההרשאה והתוספים, או קראו את עמודת Scope באינדקס כל ההגדרות לקבוצה המלאה.
#מגבלות נוכחיות
להגדרות שמנוהלות בשרת יש המגבלות הבאות:
ההגדרות חלות באופן אחיד על כל המשתמשים בארגון. תצורות לפי קבוצה אינן נתמכות עדיין.
אי אפשר להפיץ קובץ
managed-mcp.jsonדרך הגדרות שמנוהלות בשרת. מסרו שם במקום זאת את מפתחות המדיניותallowedMcpServersו-deniedMcpServers. ב-Claude Code בגרסה v2.1.259 או חדשה יותר אפשר גם לספק שרתים מרוחקים עםmanagedMcpServers, שמקבל רק שרתיhttpו-sseואינו נוטל שליטה בלעדית כפי שהקובץ עושה.Claude Code קורא
managed-mcp.jsonשנפרס בנתיב המערכת שלו בנפרד משכבת ההגדרות המנוהלות, ולכן הקובץ עדיין חל כשהגדרות שמנוהלות בשרת בתוקף.הגדרות שמוגבלות למקורות מדיניות ברמת מערכת ההפעלה, כמו
policyHelperו-wslInheritsWindowsSettings, אינן מכובדות. פרסו אותן דרך MDM או דרך קובץ מערכתmanaged-settings.json.policyHelperשנפרס כך רץ רק כשהמקור שלו הוא זה שנבחר תחת קדימות בתוך השכבה המנוהלת.
#מסירת הגדרות
#קדימות הגדרות
הגדרות שמנוהלות בשרת והגדרות שמנוהלות בנקודת קצה תופסות שתיהן את השכבה הגבוהה ביותר בהיררכיית ההגדרות של Claude Code. מפתח שמוגדר כאן גובר על אותו מפתח בקובצי ההגדרות של המשתמש או בערך --settings, מלבד החריגים לקדימות של הגדרות מנוהלות.
בתוך השכבה המנוהלת, Claude Code משתמש כברירת מחדל במקור הראשון שמספק לפחות מפתח מדיניות אחד, ובודק קודם הגדרות שמנוהלות בשרת ואחר כך הגדרות שמנוהלות בנקודת קצה, מלבד מפתחות החריגה שמכוסים בהמשך. איך Claude Code משלב מקורות מנוהלים כולל את הדירוג המלא, את החריגה למפתחות הבקרה, ואת הבחירה שחלה על כל מקור.
אם המקור שנבחר הוא מדיניות MDM או קובץ הגדרות מנוהל ש-policyHelper שלו מספק הגדרות מנוהלות, הפלט של ה-helper מחליף את המקור הזה כתצורה המנוהלת היחידה להרצה. Claude Code אינו מתייעץ עם policyHelper שמוגדר ב-MDM או בהגדרות מבוססות קובץ בזמן שהגדרות שמנוהלות בשרת מספקות מפתח מדיניות.
אם משיכה מאוחרת יותר מוצאת שההגדרות שמנוהלות בשרת הוסרו, Claude Code מריץ את ה-helper הזה מיד, ולא בהפעלה הבאה. הרשומה policyHelper מכסה את מה שקורה כשההרצה הזו נכשלת.
אם מנקים את התצורה שמנוהלת בשרת במסוף הניהול מתוך כוונה לחזור למדיניות plist או רישום שמנוהלת בנקודת קצה, יש לשים לב שהגדרות במטמון נשארות במכונות הלקוח עד המשיכה המוצלחת הבאה, והמפתחות שחלים רק בהפעלה הבאה, כמו model, נשארים בתוקף עד שכל לקוח מופעל מחדש. הריצו /status כדי לראות איזה מקור מנוהל פעיל.
#חריגים לפי מפתח בין מקורות מנוהלים
המפתחות האלה הם חריגים לכלל שאין מיזוג:
מפתחות נעילה בין מקורות: קבוצה קטנה של מפתחות, כמו נעילות רשימת ההיתר של ה-sandbox, שמפורטים בעמוד ההגדרות המנוהלות. Claude Code מכבד אותם כשכל מקור מנוהל בשליטת מנהל מגדיר אותם. שכבת הרישום HKCU שניתנת לכתיבה על ידי המשתמש אינה כלולה.
כש-
policyHelperמספק הגדרות מנוהלות, הפלט שלו הוא המקור היחיד שהבדיקות האלה קוראות, מלבדforceRemoteSettingsRefresh, ש-Claude Code קורא ישירות ממקורות הניהול בהפעלה.בלוק
env: מלבד יחידת הטלמטריה ומשתני הניתוב שמזווגים למפתח אישור, ושניהם מכוסים בהמשך, הוא מתמזג לפי מפתח בין המקורות שבשליטת מנהל. לכל משתנה סביבה, המקור בעדיפות הגבוהה ביותר שמגדיר אותו מנצח, ומקורות ניהול נמוכים יותר ממלאים משתנים שהמקורות הגבוהים משאירים לא מוגדרים. רשומתenvשמנוהלת בנקודת קצה חלה אפוא בכל פעם שהתצורה שמנוהלת בשרת משאירה את המשתנה לא מוגדר, או בזמן שערך שרת שמור במטמון עבורו מושהה עד לאישור השרת. נדרש Claude Code בגרסה v2.1.223 או חדשה יותר. לפני v2.1.223, Claude Code מחיל רק את כל בלוקenvשל המקור שנבחר.- יחידת טלמטריה: מפתחות הייצוא
OTEL_EXPORTER_OTLP_*, מתגי לכידת התוכןOTEL_LOG_*,OTEL_LOGS_EXPORTER, ומשתני המעקב בבטאENABLE_BETA_TRACING_DETAILEDו-BETA_TRACING_ENDPOINTעוקבים אחרי המקור הגבוה ביותר שמגדיר אחד מהם, כיחידה. מקור שמספק את מפתח האישורotelHeadersHelperתובע גם את היחידה, אבל ממקם את המשתנים האלה רק כשהוא המקור שנבחר: מקור שלא נבחר אבל מספק את המפתח אינו תורם אף אחד מהם, ועדיין חוסם מקורות נמוכים יותר ממילוי שלהם. בכל מקרה, נקודת קצה של ייצוא ממקור אחד אינה יכולה להזדווג עם אישורים ממקור אחר. - ניתוב מזווג לאישור: מקור שמזווג משתני ניתוב למפתח אישור שחל רק על המקור שנבחר, כמו
apiKeyHelperאוotelHeadersHelper, תורם את משתני הניתוב האלה רק כשהוא זוכה במקום.
- יחידת טלמטריה: מפתחות הייצוא
allowedProviders: רשימה שמוגדרת במכונה ורשימה שמנוהלת בשרת מתחברות כפי שהערת Scope של הרשומה מציינת. נדרש Claude Code בגרסה v2.1.285 או חדשה יותרמפתחות כניסה של צד ראשון:
forceLoginOrgUUIDוהערכים"claudeai"ו-"console"שלforceLoginMethod. אם פורסים גם מדיניות MDM או קובץ הגדרות מנוהל, הגדירו אותם שם וגם בהגדרות שמנוהלות בשרת מ-claude.ai עד שכל לקוח מריץ v2.1.299 או גרסה חדשה יותר. לגבי המקום שבו מגדירים את המפתחות אחר כך, ואיזה ערך של איזה מקור חל, ראו איזה מקור מנוהל מספק מפתחות כניסה.מפתחות כניסה של שער: Claude Code לעולם אינו קורא את
forceLoginGatewayUrl, אתgatewayInternalNetworks, או את הערך"gateway"שלforceLoginMethodמהגדרות שמנוהלות בשרת, ולכן ערך שם אינו חל ואינו מסתיר ערך שהוגדר במדיניות MDM או בקובץ הגדרות מנוהל. הרשומהmanagedSourcesBehaviorאומרת איזה מקור ניהול במכונה מספק אותם.
#כש-apiKeyHelper במכונה אינו בתוקף
כשההגדרות שמנוהלות בשרת הן המקור שנבחר, apiKeyHelper בקובץ ההגדרות המנוהל של המכונה או במדיניות MDM אינו בתוקף. Claude Code אז מסרב להנחיות בסשן שהיה משתמש בכניסה שמורה ל-claude.ai, בתנאי ששני אלה מתקיימים:
- הקובץ או המדיניות מפעילים ספק ענן, או שכל מקור מגדיר כתובת API שאינה של Anthropic
- ההגדרות שמנוהלות בשרת אינן מגדירות helper ואינן מציינות את כתובת ה-API של Anthropic
כדי לבטל את הסירוב, השאירו את ה-helper ואת כתובת ה-API שלו בתוקף, ציינו את כתובת ה-API של Anthropic בהגדרות שמנוהלות בשרת, או הסירו את ה-helper ממדיניות המכונה. הסירוב דורש Claude Code בגרסה v2.1.314 או חדשה יותר.
#התנהגות שליפה ומטמון
Claude Code שולף הגדרות משרתי Anthropic בהפעלה ובודק עדכונים מדי שעה במהלך סשנים פעילים.
לקוח שמחובר דרך שער יישומי Claude שולף את ההגדרות שלו מהשער וממתין לשליפה הזו לפני שהסשן מתחיל, ולכן השליפה ברשימות שלהלן לא חלה עליו. אכיפת הפעלה סגורה בכשל מכסה מה קורה כשהשליפה הזו נכשלת.
[!NOTE]
בהתחברות Team או Enterprise של claude.ai ששמורה במחשב, Anthropic יכולה לדרוש את הגדרות הארגון לפני שסשן מתחיל. כשזה קורה, בלי קשר למה שהרשימות שלהלן אומרות, מפתח לא יכול להתחיל סשן במקרים כמו אלה:
- ההתחברות שלו פגה, עד שהוא מריץ
claude auth login- ל-Claude Code אין את ההגדרות וגם אין עותק שמור עדכני במטמון. בדקו שהמחשב יכול להגיע אל
api.anthropic.comהודעת הפעלה עם
before a session can startאוYour Claude session has expiredאומרת שהדרישה חלה.
הפעלה ראשונה בלי הגדרות במטמון:
- כשמפתח מתחבר בהפעלה, למשל בהרצה ראשונה או אחרי
/logout, Claude Code ממתין עד חמש שניות לשליפה לפני שהוא פותח את הסשן. כשהמדיניות מגיעה בזמן, Claude Code אוכף אותה מהמסך הראשון ומציג עליו אתcompanyAnnouncements. כשהמטען צריך אישור אבטחה, Claude Code מסיים את ההמתנה ומחיל את המטען אחרי שהמפתח מאשר - בכל הפעלה אחרת, וכשחמש השניות האלה נגמרות, Claude Code פותח את הסשן בזמן שהשליפה ממשיכה, כך שחלון קצר עובר לפני שההגדרות נטענות וההגבלות נכנסות לתוקף
- אם השליפה נכשלת, Claude Code ממשיך בלי הגדרות שמנוהלות בשרת ומזהיר בסשנים אינטראקטיביים ובלשונית Code של Claude Desktop שלא חלה מדיניות מרוחקת. הגדרות שמנוהלות בנקודת קצה עדיין חלות. אם מקור מנוהל מגדיר
forceRemoteSettingsRefresh, Claude Code יוצא במקום זה
הפעלות הבאות עם הגדרות במטמון:
- הגדרות במטמון חלות מיד בהפעלה, חוץ מערכי
modelPricingו-managedMcpServersשבמטמון, משתני הסביבה ש-Claude Code מונע עד שהשרת מאשר את המטען, ההסרה, ההזזה או ההשבתה של ההגנה המובנית על ידי רשימת תוספים במטמון, ובמחשב שבו מקור שמנוהל בנקודת קצה מציין או מפעיל תוספים משלו, המעמד הארגוני של תוסף שרק רשימה במטמון מפעילה modelPricingבמטמון לא חל עד שהשליפה של הסשן מאשרת את המטען. עד אז, נתוני העלות שהמפתחים רואים ב-/usageובשורת המצב הם במחיר המחירון- בלוק
managedMcpServersבמטמון לא חל עד שהשליפה של הסשן מאשרת את המטען. Claude Code ממתין עד 30 שניות לשליפה הזו לפני שהוא מתחבר לשרתי MCP. אם השליפה נכשלת או שזמן ההמתנה נגמר, הסשן מתחיל בלי שרתי הארגון,/statusאומר זאת, והם מתחברים אחרי ששליפה מאוחרת יותר מאשרת אותם. ראו מתי שרתים שסופקו מתחברים להתנהגות המלאה, כולל הפעלה ראשונה. נדרש Claude Code v2.1.259 או גרסה מאוחרת יותר - ערך
prependPlugins,appendPluginsאוenabledPluginsבמטמון לא יכול להסיר את ההגנה המובנית, לשנות את המיקום שלה, או לכבות אותה עד שהשליפה של הסשן מאשרת את המטען - במחשב שבו מקור שמנוהל בנקודת קצה מציין או מפעיל תוספים משלו, תוסף שרק רשימה במטמון מפעילה נחשב של המשתמש, לא של הארגון, עד שהשליפה מאשרת את המטען
- Claude Code שולף הגדרות טריות ברקע
- הגדרות במטמון נשמרות גם כשיש כשלי רשת. אם שליפת ההפעלה נכשלת, Claude Code מזהיר בסשנים אינטראקטיביים ובלשונית Code שהמדיניות שבמטמון בתוקף
- עד ששליפה מצליחה, הערכים שנמנעו בהפעלה נשארים מנועים
Claude Code מונע כמה קטגוריות של משתנים בבלוק env שבמטמון עד שהשרת מאשר את המטען לסשן. זה מונע מערך proxy, רשות אישורים, נקודת קצה או אישור שבמטמון להפנות, ליירט או לאמת מחדש את שליפת ההגדרות שמאשרת את המטען. החיזוק חל רק על מטמון ההגדרות שנשלף מהשרת: הגדרות שמנוהלות בנקודת קצה שנפרסות דרך MDM או managed-settings.json לא מושפעות. הקטגוריות שנמנעות כוללות:
- הגדרות proxy ו-TLS, כמו
HTTPS_PROXY,NODE_EXTRA_CA_CERTS, ומשתני אישור הלקוח של mTLSCLAUDE_CODE_CLIENT_CERTו-CLAUDE_CODE_CLIENT_KEY - ניתוב API ובחירת ספק, כולל
ANTHROPIC_BASE_URL, משתני בחירת הספק כמוCLAUDE_CODE_USE_BEDROCKו-CLAUDE_CODE_USE_VERTEX, וכתובות נקודות הקצה של הספק כמוANTHROPIC_BEDROCK_BASE_URL - אישורי אימות, כמו
ANTHROPIC_API_KEY,ANTHROPIC_AUTH_TOKENו-CLAUDE_CODE_OAUTH_TOKEN - בורר תיקיית התצורה
CLAUDE_CONFIG_DIR - בוררי מקור אישורים ותיקיית תצורה, ב-Claude Code v2.1.223 או גרסה מאוחרת יותר: משתני Workload Identity Federation כמו
ANTHROPIC_FEDERATION_RULE_IDו-ANTHROPIC_IDENTITY_TOKEN, בוררי הפרופיל ותיקיית התצורהANTHROPIC_PROFILEו-ANTHROPIC_CONFIG_DIR, ומשתני תיקיות מערכת ההפעלהHOME,XDG_CONFIG_HOME,APPDATAו-USERPROFILE
Claude Code קורא את משתני Workload Identity Federation ואת הבוררים ANTHROPIC_PROFILE ו-ANTHROPIC_CONFIG_DIR רק בהפעלה, ולכן ערך שמגיע מהשרת עבורם לא מחליף את מקור האישורים של הסשן גם אחרי שהשליפה מצליחה. כדי להעביר את הבוררים האלה ב-Claude Code v2.1.223 או גרסה מאוחרת יותר, השתמשו בהגדרות שמנוהלות בנקודת קצה כמו MDM או managed-settings.json. עבור CLAUDE_CONFIG_DIR ומשתני תיקיות מערכת ההפעלה, המניעה עצמה היא ההגנה: הערך שבמטמון נשאר מחוץ לסביבה עד שהשרת מאשר את המטען.
כל מפתח אחר בבלוק env שבמטמון חל בהפעלה. אחרי שהשרת מאשר את המטען, ואחרי שאתם מאשרים אותו אם הוא צריך אישור אבטחה, המשתנים שנמנעו חלים לשאר הסשן.
אם הארגון צריך proxy כדי להגיע אל api.anthropic.com, המניעה משפיעה רק על בלוק env שמגיע מהשרת עצמו: proxy שמוגדר בבלוק env שמנוהל בנקודת קצה דרך MDM או managed-settings.json, בסביבת המעטפת, או בהגדרות משתמש מגיע אל שליפת ההגדרות. המקור שמנוהל בנקודת קצה דורש Claude Code v2.1.223 או גרסה מאוחרת יותר: ערך ה-proxy שמנוהל בשרת ושמור במטמון נמנע עד שהשליפה מאשרת אותו, ולכן הערך שמנוהל בנקודת קצה ממלא לפי מפתח ומגיע אל השליפה עצמה. לפני v2.1.223, השתמשו בסביבת המעטפת או בהגדרות משתמש כדי שה-proxy יחול לצד מטען שרת שבמטמון. בהפעלה הראשונה אין מטמון, ולכן עדיין נדרש מקור שמנוהל בנקודת קצה, סביבת המעטפת, או הגדרות משתמש לשליפה הראשונית.
Claude Code מחיל את רוב עדכוני ההגדרות על סשנים רצים בלי הפעלה מחדש. חלק מהעדכונים חלים רק בהפעלה הבאה, כולל תצורת מייצא OpenTelemetry, המפתח model, והסרה של משתנה מבלוק env.
#רשומות לא תקינות בהגדרות שנמסרו
כשחלק ממטען נכשל באימות הסכמה, Claude Code מציג שגיאת אימות ומחיל כל הגדרה תקינה שנשארה. רשומות לא תקינות בהגדרות מנוהלות אומר מה הוא משמיט ואילו מפתחות חוזרים לערך מחמיר יותר. נדרש Claude Code v2.1.169 או גרסה מאוחרת יותר.
מסירה שמנוהלת בשרת מוסיפה את ההתנהגויות האלה:
הפעלה שרצה על המטמון ב-
~/.claude/remote-settings.jsonמתייחסת לרשומות לא תקינות כמו השליפה שכתבה את המטמון:- רשומות שנכשלו באימות נשארות מושמטות.
- מפתחות שנכשלים בסגירה שומרים על הערכים המחמירים שלהם.
- ערך לא תקין של
cleanupPeriodDaysאוdesktopSessionCleanupPeriodDaysנשאר בעותק שבמטמון ולעולם לא מוחל.
Claude Code לא מחיל דבר ממטען ומשאיר את המטמון בלי שינוי כשכל שלושת אלה נכונים:
- כל הגדרה במטען נכשלת באימות.
- אף אחת מהן לא חוזרת לערך מחמיר יותר.
- המטען מכיל מפתח שאינו אחד משני מפתחות השמירה האלה.
הודעת ההפעלה,
/statusו-claude doctorמדווחים אז על טעינה שנכשלה עם הסיבהno setting in the server response could be applied as written, והרשומה הזו אומרת על איזו מדיניות הסשן רץ. לקוחות שאוכפים הפעלה סגורה בכשל יוצאים בהפעלה במקום זה. אם ההפעלה נעצרת עם הודעה שהארגון דורש את ההגדרות שלוbefore a session can start, ראו Claude Code לא הצליח לטעון את הגדרות הארגון.תיבת אישור האבטחה מעריכה את המטען שחולץ, ולכן רשומה לא תקינה שהוסרה לעולם לא מוצגת לאישור ולעולם לא רצה.
כדי לנפות בעיות מסירה, הריצו claude --debug-file <path> וחפשו ביומן את Remote settings. אמתו שינוי מטען עם claude doctor במכונת בדיקה לפני הפצה לארגון.
#אכיפת הפעלה סגורה בכשל
כברירת מחדל, אם שליפת ההגדרות המרוחקות נכשלת בהפעלה, ה-CLI ממשיך עם ההגדרות שבמטמון מהשליפה המוצלחת האחרונה. הערכים ש-Claude Code מונע נשארים מנועים עד ששליפה מצליחה. במחשב שמעולם לא שלף אותן, ה-CLI ממשיך בלי הגדרות שמנוהלות בשרת ועדיין מחיל כל הגדרות שמנוהלות בנקודת קצה במכשיר. Anthropic יכולה לדרוש את ההגדרות במקום זה.
כדי לעצור לקוחות מלהתחיל על הגדרות שמנוהלות בשרת שבמטמון או חסרות, הגדירו forceRemoteSettingsRefresh: true בהגדרות המנוהלות.
לקוחות שמחוברים דרך שער יישומי Claude ממתינים לשליפת ההפעלה בלי תלות בהגדרה הזו, ומטפלים בשליפה שנכשלה כך:
- אם השער עונה להפעלה אינטראקטיבית מלווה ב-
401וההגדרה הזו כבויה, השער סיים את ההתחברות הזו. Claude Code מדפיסCloud gateway session expired , run /login to reconnect.ופותח את הסשן מנותק מהשער עד שהמשתמש מריץ/login. - כשהשליפה נכשלת בכל דרך אחרת, או בכל סוג אחר של הפעלה חוץ מתת פקודה
claude auth, הלקוח יוצא עם שגיאה.
כשההגדרה הזו פעילה בסשן ששולף הגדרות שמנוהלות בשרת, ה-CLI נחסם בהפעלה עד שההגדרות המרוחקות נשלפות מחדש. אם השליפה נכשלת, ה-CLI יוצא במקום להמשיך בלי המדיניות. ההגדרה הזו משמרת את עצמה: אחרי שהיא נמסרת מהשרת, היא גם נשמרת במטמון מקומי כך שהפעלות הבאות אוכפות את אותה התנהגות עוד לפני השליפה המוצלחת הראשונה של סשן חדש. סשן שלא שולף הגדרות שמנוהלות בשרת מתחיל בלי להמתין.
כדי להפעיל זאת, הוסיפו את המפתח לתצורת ההגדרות המנוהלות:
{
"forceRemoteSettingsRefresh": true
}אפשר גם להגדיר את המפתח הזה בפרופיל MDM שמנוהל בנקודת קצה או בקובץ מערכת managed-settings.json כדי לאכוף התנהגות סגורה בכשל בהפעלה הראשונה, לפני שכל מטען שרת הגיע. הדגל הזה הוא חריג לכלל הקדימות שלמעלה: Claude Code מכבד אותו כשכל מקור מנוהל בשליטת מנהל מגדיר אותו, גם אם קיים גם מטען שמנוהל בשרת במטמון, כך שהוא מכבד ערך שנמסר ב-MDM כשקיימות הגדרות שמנוהלות בשרת.
כש-policyHelper מספק הגדרות מנוהלות, הפלט שלו מחליף כל מקור מנוהל אחר עבור המפתחות ש-Claude Code קורא אחרי ההפעלה. למקורות שמהם Claude Code קורא את המפתח הזה, ראו את רשומת ההגדרות שלו. רשומת policyHelper אומרת מאילו מקורות Claude Code קורא את העוזר ומתי הוא רץ.
שליפת ההגדרות גם שולחת כותרת Cache-Control: no-cache כדי שפרוקסי HTTP ביניים לא יגישו תשובה ישנה.
לפני שמפעילים את ההגדרה הזו, ודאו שמדיניות הרשת מאפשרת קישוריות אל api.anthropic.com. אם נקודת הקצה הזו לא נגישה, ה-CLI יוצא בהפעלה ומשתמשים לא יכולים להתחיל את Claude Code.
תת הפקודות claude auth כמו claude auth login פטורות מהבדיקה הזו ומיציאת ההפעלה של השער, כך שמשתמשים יכולים לאמת מחדש כשאישורים שפגו הם הסיבה ששליפת ההגדרות נכשלת.
#תיבות דו-שיח לאישור אבטחה
הגדרות מסוימות שעלולות להוות סיכוני אבטחה דורשות אישור מפורש של המשתמש לפני ש-Claude Code מחיל אותן בסשן אינטראקטיבי:
- הגדרות פקודות shell: הגדרות שמריצות פקודות shell, כגון
apiKeyHelper,statusLineו-otelHeadersHelper - הגדרות קבצי הרצה של sandbox:
sandbox.bwrapPath,sandbox.socatPathו-sandbox.ripgrep. כל אחת מההגדרות האלה מצביעה על קובץ הרצה, ו-Claude Code מריץ את קובץ ההרצה הזה - הגדרות רשת ובידוד של sandbox: הגדרות sandbox שמאפשרות לפרוקסי של ה-sandbox לקרוא, לנתב מחדש או לאמת תעבורה, או שמחלישות את הבידוד של ה-sandbox:
sandbox.network.tlsTerminate,sandbox.network.httpProxyPort,sandbox.network.socksProxyPort,sandbox.credentials,sandbox.allowAppleEvents,sandbox.allowNestedUserNamespaces,sandbox.enableWeakerNestedSandbox,sandbox.enableWeakerNetworkIsolation,sandbox.filesystem.disabled,sandbox.network.allowAllUnixSockets,sandbox.network.allowUnixSocketsו-sandbox.network.allowMachLookup. בלוקsandbox.credentialsשמכיל רק כלליdenyלא דורש אישור, כי הוא מגביל את ה-sandbox בלי לתת לפרוקסי אישור גישה. לפני v2.1.251, Claude Code החיל את ההגדרות האלה בלי אישור - משתני סביבה מותאמים אישית: משתני
envשנמסרו שדורשים את אישור המשתמש, כגון משתני פרוקסי וכתובת בסיס. ראו משתני סביבה ותיבת הדו-שיח לאישור - תצורות hook: כל הגדרת hook
כשההגדרות האלה קיימות, המשתמשים רואים תיבת דו-שיח לאבטחה שמסבירה מה מוגדר. המשתמשים חייבים לאשר כדי להמשיך. אם משתמש דוחה את ההגדרות, Claude Code יוצא.
קובץ CLAUDE.md מנוהל שנמסר דרך המפתח claudeMd לא דורש אישור, כי זה טקסט הנחיה עבור Claude ולא פקודה ש-Claude Code מריץ. Claude Code עדיין בודק הרשאות עבור הכלים ש-Claude משתמש בהם בזמן שהוא עוקב אחרי ההנחיות האלה. לפני v2.1.260, גם ערך claudeMd דרש אישור.
#זיכרון אישור
Claude Code רושם את האישור שלך בספריית התצורה שלך, ~/.claude, אלא אם הגדרת CLAUDE_CONFIG_DIR. מה שנרשם תלוי באישור הגישה שבו שליפת ההגדרות משתמשת:
התחברות ל-claude.ai שנשמרה על ידי
/loginאוclaude auth login, או התחברות ל-Console בלי מפתח: אישור אחד לכל ארגון, שנשמר אצל החשבון שאישר לאחרונה.התחברות ל-Claude apps gateway: אישור אחד לכל gateway.
אם התנתקת והתחברת מחדש לאותו gateway, Claude Code לא מציג שוב את תיבת הדו-שיח כל עוד ההגדרות שדורשות אישור לא השתנו. Claude Code מציג אותה שוב כשההגדרות האלה משתנות, כשאתה מתחבר ל-gateway אחר, וכשאתה מקבל אישור חדש לאותו gateway.
Claude Code לא שומר אישור עבור gateway פיתוח ב-loopback שאליו מגיעים דרך HTTP רגיל, ולכן תיבת הדו-שיח מופיעה שוב אחרי כל התחברות.
כל אישור גישה אחר, כגון מפתח API או
CLAUDE_CODE_OAUTH_TOKEN: אישור אחד עבור ההגדרות שנמסרו, שנשמר יחד עם העותק השמור במטמון של ההגדרות בספריית התצורה הזו. Claude Code מציג שוב את תיבת הדו-שיח כשההגדרות שדורשות אישור משתנות, ואחרי שמריצים/logoutאוclaude auth logout, שכל אחד מהם מוחק את העותק השמור במטמון.
אישור עבור sandbox.credentials או sandbox.network.tlsTerminate מכסה גם את רשומות sandbox.network.allowedDomains באותן הגדרות שנמסרו, כי שתי ההגדרות פועלות על רשימת ההיתר הזו. תיבת הדו-שיח מופיעה שוב כשהמנהל מוסיף או מסיר אחת מהרשומות האלה, אף על פי ש-sandbox.network.allowedDomains לא דורש אישור בפני עצמו.
עם התחברות שמורה ל-claude.ai:
- אם התנתקת והתחברת מחדש, או עברת לארגון אחר וחזרת מאוחר יותר, Claude Code לא מציג שוב את תיבת הדו-שיח כל עוד ההגדרות האלה לא השתנו, אלא אם חשבון אחר אישר אותן עבור הארגון הזה באותה ספריית תצורה בינתיים.
- אם התחברת לאותו ארגון עם חשבון אחר, Claude Code מציג שוב את תיבת הדו-שיח גם כשההגדרות לא השתנו. האישור של החשבון הזה מחליף את הקודם, כך שכשאתה חוזר, Claude Code מציג את תיבת הדו-שיח פעם נוספת.
Claude Code לא תמיד יכול להציג את תיבת הדו-שיח. כל מקרה להלן מציין אילו הגדרות חלות כשהוא לא יכול, ומתי תראה את תיבת הדו-שיח בפעם הבאה:
סשן אינטראקטיבי שלא יכול להציג את תיבת הדו-שיח: Claude Code לא מחיל את ההגדרות שנמסרו ושומר את ההגדרות שאושרו לאחרונה. תיבת הדו-שיח מופיעה בסשן הבא שיכול להציג אותה.
claude installאוclaude update: Claude Code לא מציג את תיבת הדו-שיח במהלך אף אחת מהפקודות. הפקודה רצה עם ההגדרות שאושרו לאחרונה, ותיבת הדו-שיח מופיעה בסשן האינטראקטיבי הבא שלך. אם Claude Code ממתין לשליפת ההגדרות בהפעלה, כגון כש-forceRemoteSettingsRefreshמוגדר או בפריסת Claude apps gateway, הוא מציג את תיבת הדו-שיח במהלך הפקודה במקום זאת, והרצת התקנה מתוך צינור נכשלת. ראוRaw mode is not supportedduring install. לפני v2.1.246, Claude Code ניסה להציג את תיבת הדו-שיח גם במהלך הפקודות האלה.פקודת
claude pluginשמדפיסה לטרמינל אבל לא יכולה לקרוא מהמקלדת: כש-Claude Code לא ממתין לשליפת ההגדרות בהפעלה, הפקודה לא מחילה את ההגדרות שנמסרו. בלי הגדרות במטמון, פקודה שמשנה את התוספים או את ה-marketplaces שלך נעצרת עם שגיאה. עם הגדרות במטמון, היא רצה עם ההגדרות שאושרו לאחרונה. תיבת הדו-שיח מופיעה כשתריץ בפעם הבאהclaudeבטרמינל.הפקודה לא יכולה לקרוא מהמקלדת כשמעבירים בצינור או מפנים מחדש את הקלט שלה, וב-macOS וב-Linux היא גם לא יכולה לפתוח את
/dev/tty. אם מעבירים בצינור או מפנים מחדש גם את הפלט שלה, ההרצה היא לא אינטראקטיבית במקום זאת, וההגדרות שנמסרו חלות עבור ההרצה הזו בלבד.שגיאה סוגרת את תיבת הדו-שיח לפני שאתה עונה: Claude Code לא מחיל את ההגדרות שנמסרו ושומר את ההגדרות שאושרו לאחרונה. הוא מציג שוב את תיבת הדו-שיח בסשן הבא שיכול להציג אותה.
הרצה לא אינטראקטיבית, כגון
claude -p, סשן Agent SDK, או סשן בלוח הצ'אט של תוסף VS Code או בלשונית Code של אפליקציית שולחן העבודה: Claude Code לא יכול להציג את תיבת הדו-שיח. כשההגדרות שנמסרו היו דורשות אישור, הן חלות עבור ההרצה הזו בלבד.Claude Code לא רושם את ההגדרות כמאושרות ולא כותב אותן ל-מטמון המקומי, והסשן האינטראקטיבי הבא מציג את תיבת הדו-שיח. עד שמשתמש מאשר בסשן אינטראקטיבי, כל הרצה לא אינטראקטיבית שולפת שוב את ההגדרות בהפעלה.
#משתני סביבה ותיבת הדו-שיח לאישור
Claude Code מחיל חלק ממשתני env שנמסרו בלי להציג למשתמש את תיבת הדו-שיח לאישור, כולל:
- מתגי תכונות ופקודות
- הגדרות בחירת מודל והתנהגות, כגון
ANTHROPIC_MODEL,DISABLE_PROMPT_CACHINGו-CLAUDE_CODE_EFFORT_LEVEL - הגדרות חלון הקשר ודחיסה, כגון
DISABLE_AUTO_COMPACT, אבל לאCLAUDE_CODE_DISABLE_1M_CONTEXT - אפשרויות ממשק טרמינל ונגישות
- מגבלות מספריות, תקציבים וזמני המתנה
משתנים אחרים שנמסרו יכולים לדרוש את אישור המשתמש לפני שהם נכנסים לתוקף. לדוגמה, בסשנים אינטראקטיביים אלה תמיד דורשים זאת, בכל ערך לא ריק:
- משתנה פרוקסי או כתובת בסיס
OTEL_EXPORTER_OTLP_ENDPOINTCLAUDE_CODE_DISABLE_1M_CONTEXT
כשמשתנה שנמסר צריך אישור, תיבת הדו-שיח מציינת אותו בשם, כך שהמשתמש רואה בדיוק מה המדיניות מבקשת להגדיר.
Claude Code מחליט אם ארבעה מתגי פרטיות צריכים אישור לפי הערך שנמסר ולא לפי שם המשתנה: CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_ERROR_REPORTING, DISABLE_TELEMETRY ו-DO_NOT_TRACK. ערך אמיתי כגון 1 או true רק מכבה מעקב, דיווח או תעבורה לא חיונית אחרת, ולכן Claude Code מחיל אותו בלי לשאול את המשתמש. עבור כל ערך לא ריק אחר, Claude Code מציג את תיבת הדו-שיח.
Claude Code גם מחליט אם API_FORCE_IDLE_TIMEOUT צריך אישור לפי הערך שנמסר: ערך אמיתי רק מפעיל את זמן הסרק של הגוף, ולכן Claude Code מחיל אותו בלי לשאול את המשתמש. עבור כל ערך לא ריק אחר, Claude Code מציג את תיבת הדו-שיח. לפני v2.1.248, כל ערך לא ריק הפעיל את תיבת הדו-שיח.
גם אם ANTHROPIC_CUSTOM_HEADERS צריך אישור תלוי בערך שנמסר. כותרות שרק מתייגות בקשות, כגון Accept-Language, חלות בלי תיבת הדו-שיח. שורה שמציינת אישור גישה, בורר ארגון או tenant, דריסת ניתוב או מארח, או כותרת התנהגות API, כגון Authorization, X-Api-Key, Host, anthropic-beta, או כותרות X-Amzn-Bedrock-*, דורשת אישור. שורה גם דורשת אישור כששמה אינו אסימון כותרת HTTP תקין, או כשערכה מכיל תו שכותרת HTTP לא יכולה לשאת. הבדיקה מתאימה מילים בתוך שם הכותרת, ולכן X-Client-Version, שמכיל client ו-version, דורש אישור גם כן. לפני v2.1.251, כל ערך ANTHROPIC_CUSTOM_HEADERS הוחל בלי זה.
ערך שקרי כגון 0 או false עבור ENABLE_BETA_TRACING_DETAILED או OTEL_LOG_RAW_API_BODIES חל בלי תיבת הדו-שיח, כי הוא רק מכבה מעקב מפורט או לכידת גוף API גולמי. כל ערך לא ריק אחר עבור אחד מהמשתנים דורש אישור.
#זמינות לפי פלטפורמה
הגדרות מנוהלות בשרת דורשות חיבור ישיר אל api.anthropic.com. המסירה גם דורשת שהסשן יאמת את עצמו עם אחד מאישורי הגישה האלה:
- התחברות OAuth של Team או Enterprise
- אסימון OAuth שסופק דרך
CLAUDE_CODE_OAUTH_TOKEN - מפתח API שהוגדר ישירות
- פרופיל Anthropic מסוג
user_oauth, אלא אם הפרופיל מגדירbase_urlשאינו Anthropic API. דורש Claude Code v2.1.257 או חדש יותר.
לא מפתחות שמוחזרים על ידי סקריפט apiKeyHelper ולא אישורי גישה של Workload Identity Federation מפעילים את שליפת ההגדרות.
סשן מקבל את ההגדרות המנוהלות של הארגון שבבעלותו אישור הגישה שאיתו הוא מאמת. מפתח API מ-Claude Console שייך לארגון ה-Console שבו הוא נוצר, שהוא ארגון נפרד מארגון Team או Enterprise שלך ב-claude.ai. לכן הגדרות שאתה מגדיר ב-Admin Settings של claude.ai לא מגיעות לסשן שמאמת עם המפתח הזה, כגון משימת CI שמשתמשת במפתח API של Console של החברה שלך. כדי להחיל אותן על המשימה הזו, השתמש באחת מהאפשרויות האלה. אפשרות אסימון ה-OAuth לא חלה על משימה שרצה עם --bare, כי מצב bare לא קורא את CLAUDE_CODE_OAUTH_TOKEN.
- אסימון OAuth: צור אסימון עם
claude setup-token, אשר אותו עבור ארגון Team או Enterprise שלך, והגדר אותו כ-CLAUDE_CODE_OAUTH_TOKENבסביבה של המשימה. הסר מהסביבה הזו כל אישור גישה שקודם לאסימון, כגוןANTHROPIC_API_KEY. - הגדרות מנוהלות בנקודת קצה: פרוס קובץ הגדרות מנוהל למכונה שמריצה את המשימה.
בסשן Cowork באפליקציית Claude Desktop, Claude Code לא שולף הגדרות מנוהלות בשרת מקונסולת הניהול של claude.ai, גם כשהמשתמש מתחבר עם חשבון Team או Enterprise. איפה ומתי מדיניות חלה מכסה איזו מדיניות מגיעה לסשני Cowork במכונה של המשתמש ולסשני Cowork מרוחקים. claude.ai עדיין מחיל בעצמו את הרשימות strictKnownMarketplaces ו-blockedMarketplaces כשמשתמש Cowork מוסיף marketplace ממאגר git ב-claude.ai או מ-Customize ב-Cowork. איך ההגבלות עובדות מתאר את הבדיקה הזו.
אם אתה מייצא משתנה ספק CLAUDE_CODE_USE_* או ANTHROPIC_BASE_URL שאינו ברירת המחדל ב-shell שלך, Claude Code מדלג על שליפת ההגדרות עבור הסשנים שלך. claude doctor ו-/status מדווחים על השליפה שדולגה ועל הסיבה שלה.
אי אפשר לבטל את הייצוא עם בלוק env מנוהל בשרת, כי הבלוק מגיע דרך השליפה שהייצוא מונע. גם בלוק env של הגדרות מנוהלות בנקודת קצה לא משחזר את השליפה: Claude Code בודק זכאות לפני שהוא מחיל בלוקי env מנוהלים, כך שהערך המנוהל בנקודת הקצה משנה את בחירת הספק של הסשן, אבל השליפה נשארת מדולגת.
כדי לשחזר מסירה מנוהלת בשרת, הסר את הייצוא מה-shell שלך, או הגדר את המשתנה ל-"" בבלוק env של הגדרות המשתמש שלך, שחל לפני בדיקת הזכאות. כדי לאכוף מדיניות בלי להסתמך על משתמשים שישנו את ה-shell שלהם, מסור את ההגדרות דרך ערוץ ניהול נקודת הקצה במקום זאת.
עבור פריסות Amazon Bedrock, Agent Platform של Google Cloud, Microsoft Foundry ו-Claude Platform on AWS, Claude apps gateway באירוח עצמי מספק את המסירה המקבילה של הגדרות מנוהלות מרחוק: לקוחות שמחוברים דרך ה-gateway שולפים הגדרות מנוהלות מה-gateway במקום מ-api.anthropic.com. סמנטיקת הכשל שונה בהפעלה: לקוח gateway שלא יכול להגיע ל-gateway יוצא עם שגיאה במקום לחזור להגדרות במטמון, בעוד שהרענון ברקע מדי שעה הוא fail-open בשני הערוצים.
#רישום ביקורת
אירועי יומן ביקורת עבור שינויי הגדרות זמינים דרך ה-compliance API או ייצוא יומן ביקורת. פנה לצוות החשבון שלך ב-Anthropic כדי לקבל גישה.
אירועי ביקורת כוללים את סוג הפעולה שבוצעה, את החשבון ואת המכשיר שביצעו את הפעולה, והפניות לערכים הקודמים ולערכים החדשים.
#שיקולי אבטחה
הגדרות שמנוהלות בשרת מספקות אכיפת מדיניות מרכזית, אבל הן פועלות כבקרה בצד הלקוח, לא כגבול אבטחה. במכשירים שאינם מנוהלים, משתמש לא צריך הרשאת admin או sudo כדי לעקוף אותן.
| תרחיש | התנהגות |
|---|---|
| המשתמש עורך את קובץ ההגדרות שנשמר במטמון | קובץ ששונה חל בהפעלה, למעט הערכים ש-Claude Code מונע עד שהשרת מאשר את המטען. השליפה הבאה מהשרת משחזרת את ההגדרות הנכונות, למעט המפתחות שחלים רק בהפעלה הבאה, כמו model או משתנה שנוסף לבלוק env, שנשארים בתוקף עד הפעלה מחדש |
| המשתמש מוחק את קובץ ההגדרות שנשמר במטמון | מתרחשת התנהגות ההפעלה הראשונה |
| המשתמש מריץ קובץ בינארי של Claude Code ששונה | משתמש שיכול להריץ לקוח ששונה יכול לעקוף כל בקרה בצד הלקוח |
| המשתמש מריץ גרסה ישנה יותר של Claude Code | גרסאות שקדמו להגדרות שמנוהלות בשרת לא שולפות אותן ולא מחילות אותן |
| ה-API אינו זמין | הגדרות שנשמרו במטמון חלות אם הן זמינות. בלי מטמון, Claude Code לא אוכף הגדרות שמנוהלות בשרת עד השליפה המוצלחת הבאה. התנהגות שליפה ושמירה במטמון מפרטת את החריגים, כולל מתי Anthropic דורשת את ההגדרות. עם forceRemoteSettingsRefresh: true, ה-CLI יוצא במקום להמשיך, למעט פקודות המשנה claude auth. לקוחות שנכנסו דרך שער אפליקציות Claude יוצאים בהפעלה בלי ההגדרה הזו, עם אותו פטור של claude auth |
| המשתמש מאמת מול ארגון אחר | הגדרות לא נמסרות לחשבונות מחוץ לארגון המנוהל, כולל סשן שמאמת עם מפתח API של Console |
| המשתמש מגדיר ספק מודלים של צד שלישי | הגדרות שמנוהלות בשרת נעקפות. זה כולל הגדרה של CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_MANTLE, CLAUDE_CODE_USE_VERTEX, CLAUDE_CODE_USE_FOUNDRY, CLAUDE_CODE_USE_ANTHROPIC_AWS, או ANTHROPIC_BASE_URL שאינו ברירת המחדל |
| תעבורת הרשת מיורטת או מופנית מחדש | אימות TLS כבוי או תעבורה מיורטת יכולים לשנות את ההגדרות שהלקוח מקבל |
כדי לרשום עריכות לקובצי הגדרות מקומיים, כולל managed-settings.json, השתמשו ב-hooks של ConfigChange. Claude Code לא מריץ אותם כשהגדרות שמנוהלות בשרת מגיעות או מתרעננות, או כשפרופיל MDM או מדיניות registry משתנים, ו-hook לא יכול לחסום שינוי של policy_settings.
כדי להגביל לאילו ארגונים המשתמשים שלכם יכולים לגשת עם אישורים שהלקוח מספק, ראו Enforce network-level access control with Tenant Restrictions במרכז העזרה של Claude. להבטחות אכיפה חזקות יותר, השתמשו ב-הגדרות שמנוהלות בנקודת קצה במכשירים שנרשמו בפתרון MDM.
#ראו גם
דפים קשורים לניהול תצורת Claude Code:
- כל ההגדרות: כל מפתח הגדרות
- הגדרות שמנוהלות בנקודת קצה: הגדרות מנוהלות שנפרסות למכשירים על ידי IT
- אימות: הגדרת גישת משתמש ל-Claude Code
- אבטחה: אמצעי הגנה של אבטחה ושיטות מומלצות