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

תיעוד 93

הגדרת Claude Code לארגון

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

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

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

[!NOTE]

SSO, הקצאת SCIM והקצאת מושבים מוגדרים ברמת חשבון Claude. ראו את Claude Enterprise Administrator Guide ואת הקצאת מושבים לשלבים האלה.

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

#בחירת ספק ה-API

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

ספקמתי לבחור בזה
Claude for Teams / Enterpriseרוצים את Claude Code ואת claude.ai תחת מנוי אחד לפי מושב, בלי תשתית להרצה. זו המלצת ברירת המחדל.
Claude Consoleהעבודה היא API-first, או שרוצים חיוב לפי שימוש
Amazon Bedrockרוצים לרשת בקרות תאימות וחיוב קיימים של AWS
Google Cloud's Agent Platformרוצים לרשת בקרות תאימות וחיוב קיימים של GCP
Microsoft Foundryרוצים לרשת בקרות תאימות וחיוב קיימים של Azure

חלק מתכונות Claude Code דורשות חשבון claude.ai. סשנים בענן, משימות ענן מתוזמנות, Code Review, Remote Control ותוסף Chrome אינם זמינים דרך מפתחות API של Console או דרך אישורי ספק ענן בלבד. אם אתם פורסים דרך Amazon Bedrock, Google Cloud's Agent Platform או Microsoft Foundry, תכננו אם המפתחים צריכים גם מושבים של Claude for Teams או Enterprise. כל דף תכונה מפרט את דרישות המסלול שלו.

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

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

#החלטה איך ההגדרות מגיעות למכשירים

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

מנגנוןאספקהעדיפותפלטפורמות
מנוהל בשרתקונסולת הניהול של claude.ai, או Claude apps gateway באירוח עצמי לכניסות דרך שערהגבוהה ביותרכולן
מדיניות plist / registrymacOS: com.anthropic.claudecode plist Windows: HKLM\SOFTWARE\Policies\ClaudeCodeגבוההmacOS, Windows
ניהול מבוסס קובץmacOS: /Library/Application Support/ClaudeCode/managed-settings.json Linux ו-WSL: /etc/claude-code/managed-settings.json Windows: C:\Program Files\ClaudeCode\managed-settings.jsonבינוניתכולן
רישום המשתמש ב-WindowsHKCU\SOFTWARE\Policies\ClaudeCodeהנמוכה ביותרWindows בלבד

Claude Code שולף הגדרות מנוהלות בשרת בהפעלה ומרענן אותן מדי שעה במהלך הסשן, בלי תשתית של נקודת קצה לפריסה. אספקה דרך קונסולת הניהול של claude.ai דורשת מסלול Claude for Teams או Enterprise. פריסות על Amazon Bedrock, Google Cloud's Agent Platform או Microsoft Foundry יכולות לקבל את אותה אספקה מרחוק באמצעות הרצת Claude apps gateway, או להשתמש באחד המנגנונים מבוססי הקובץ או ברמת מערכת ההפעלה.

אם הארגון מערבב ספקים, הגדירו הגדרות מנוהלות בשרת למשתמשי claude.ai, ובנוסף חלופה מבוססת קובץ או plist/registry, כדי שגם המשתמשים האחרים יקבלו מדיניות מנוהלת.

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

כברירת מחדל, WSL קורא רק את נתיב הקובץ של Linux ב-/etc/claude-code. כדי להרחיב את מדיניות רישום Windows ואת C:\Program Files\ClaudeCode אל WSL באותו מחשב, הגדירו wslInheritsWindowsSettings: true באחד ממקורות Windows האלה, שרק מנהל יכול לכתוב אליהם.

בכל מנגנון שתבחרו, ערכים מנוהלים גוברים על הגדרות משתמש ופרויקט, מלבד כמה חריגים רגישים לאבטחה. הגדרות מערך כמו permissions.allow ו-permissions.deny ממזגות רשומות מכל המקורות, כך שמפתחים יכולים להרחיב רשימות מנוהלות אבל לא להסיר מהן. עבור fallbackModel, availableModels ו-modelPicker, הערך המנוהל מחליף את השכבות הנמוכות יותר ולא ממזג אותן.

#סשנים של WSL ב-Claude Code Desktop

ב-Windows, Claude Code Desktop יכול להריץ סשנים של Code בתוך הפצה של WSL 2. תהליך Claude Code של הסשן רץ בתוך ההפצה, ולכן הוא פותר הגדרות מנוהלות דרך נתיב הגילוי של WSL שלמעלה: מקורות של Windows בלבד לא מגיעים אליו אלא אם נפרס wslInheritsWindowsSettings: true.

Claude Desktop מכבה סשנים של WSL כברירת מחדל במכשירים שהוא מזהה כמנוהלים על ידי הארגון, למשל כשקיים C:\Program Files\ClaudeCode\managed-settings.json. כדי להפעיל אותם, פרסו מדיניות ברישום Windows. נדרש Claude Desktop בגרסה v1.19367.0 או חדשה יותר:

  1. צרו ערך בשם disableWslSessions תחת HKLM\SOFTWARE\Policies\Claude והגדירו אותו למחרוזת REG_SZ עם הערך false, או ל-REG_DWORD עם הערך 0. הערך הזה נמצא תחת מפתח המדיניות של Claude Desktop, בנפרד ממפתח ClaudeCode שנושא את ההגדרות המנוהלות. פרסו את הערך תחת HKLM, וכתיבה אליו דורשת הרשאות מנהל. ערך תחת HKCU לא מפעיל סשנים של WSL.
  2. השאירו את C:\Program Files\ClaudeCode\managed-settings.json במקום אם אתם פורסים אותו. אחרי ש-disableWslSessions הוא false תחת HKLM, Desktop מתיר סשנים של WSL גם כשהקובץ הזה קיים.

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

אם מכשיר עדיין מסרב לסשנים של WSL, פתחו ב-Claude Desktop במכשיר הזה את Help > Troubleshooting > Show Logs in File Explorer. הפעולה שומרת עותק של תיקיית היומן ב-Downloads. חפשו בעותק הזה ב-main.log את [wslPolicyGate] denying WSL session. הסיבה לסירוב מופיעה אחרי זה בסוגריים, למשל (cli-file-present).

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

  1. פרסו wslInheritsWindowsSettings: true דרך רישום HKLM או דרך הקובץ C:\Program Files\ClaudeCode, כדי שסשנים של WSL יירשו את אותה מדיניות כמו סשנים של המארח.
  2. אמתו באמצעות הרצת /status בתוך סשן WSL וקריאה של שורת Setting sources. לפירוש מה שמופיע שם, ראו קריאת המקור ב-/status.

אם סשן WSL מתחיל במכשיר עם רשימת allowedWorkspaceFolders של Claude Desktop, רשומת ~ פירושה תיקיית הבית בתוך ההפצה.

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

#להחליט מה לאכוף

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

בקרהמה זה עושההגדרות מפתח
כללי הרשאותלאפשר, לבקש, או לדחות כלים ופקודות ספציפייםpermissions.allow, permissions.deny
נעילת הרשאותלהפוך את ההגדרות המנוהלות למקור ההגדרות היחיד של כללי הרשאות. להשבית את --dangerously-skip-permissionsallowManagedPermissionRulesOnly, permissions.disableBypassPermissionsMode
מצב הרשאות התחלתילבחור את מצב ההרשאות שבו מתחילות הפעלות הטרמינל של המפתחים, במקום מצב ההרשאות ההתחלתי המובנה, או להסיר את מצב auto. החלפת מצבי הרשאות מפרטת מתי תוסף VS Code קורא defaultMode שהגדרתםpermissions.defaultMode, permissions.disableAutoMode
Sandboxingבידוד מערכת קבצים ורשת ברמת מערכת ההפעלה, עם רשימות היתר של דומייניםsandbox.enabled, sandbox.network.allowedDomains
מדיניות מנוהלת CLAUDE.mdהנחיה התנהגותית לכל הארגון עבור Claude, ולא כלל שנאכף אצל הלקוחקובץ בנתיב המדיניות המנוהלת
שליטה בשרתי MCPלהגביל אילו שרתי MCP משתמשים יכולים להוסיף או להתחבר אליהם, לפרוס סט קבוע, או לספק שרתים מרוחקים לכל משתמש לצד השרתים שלוallowedMcpServers, deniedMcpServers, allowManagedMcpServersOnly, managedMcpServers, או קובץ managed-mcp.json שנפרס
שליטה בשוק התוספיםלהגביל מאילו מקורות שוק משתמשים יכולים להוסיף ולהתקין, ולדחות את דגלי ה-CLI שטוענים מהצד תוספים, סוכנים ושרתי MCP להרצה בודדת. לחסום מקורות תוסף מסוג command, ולהגדיר רשימת היתר של תוספים מאילו שווקים אפשר להציע בטרמינלstrictKnownMarketplaces, blockedMarketplaces, disableSideloadFlags, disableCommandPluginSources, pluginSuggestionMarketplaces
נעילת התאמה אישיתלחסום skills, סוכנים, hooks ושרתי MCP ממקורות של משתמש ופרויקט, כך שהם יכולים להגיע רק מתוספים או מהגדרות מנוהלות. נעילת skills גם עוצרת סנכרון של ה-skills שהמפתחים מפעילים ב-claude.aistrictPluginOnlyCustomization
השבתת סנכרון claude.aiלעצור את Claude Code מלטעון את ה-skills ואת התוספים שהמפתחים מפעילים ב-claude.ai. אם מכבים את Skills לארגון ב-claude.ai, Claude Code מפסיק לסנכרן את שניהם, ובגרסה v2.1.273 ואילך הוא גם מסיר את אלה שכבר סונכרנו. כדי לעצור אחד מהם בלי לכבות את Skills, הגדירו את המפתח שלו ל-false בהגדרות מנוהלותsyncClaudeAiSkills, syncClaudeAiPlugins
הגבלות hooksלהגביל אילו hooks רצים ולהגביל כתובות URL של HTTP hooks. ראו מה רץ תחת allowManagedHooksOnly לרשימת ההשפעות המלאהallowManagedHooksOnly, allowedHttpHookUrls
אכיפת התחברותלהגביל התחברות לשיטה מסוימת או לארגון Anthropic. הגבלת השיטה חלה על תוסף VS Code, Agent SDK, claude setup-token ו-/install-github-app, ומסך ההתחברות האינטראקטיבי בטרמינל, שאליו מגיעים דרך /login או דרך תהליך ההיכרות בהרצה הראשונה, בוחר מראש את השיטה בלי לאכוף אותה. Claude Code מאמת את הארגון עבור התחברויות של חשבון claude.ai בטרמינל, בתוסף VS Code וב-Agent SDK, ולא בודק אותו עבור התחברויות Claude Console או עבור התחברות דרך gateway. לפני v2.1.212, רק התחברויות בטרמינל החילו אחד מהמפתחות. כשההגדרה פעילה, הפעלות שמאומתות באמצעות ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN או apiKeyHelper נחסמות בהפעלה. הפעלות של ספק ענן אינן מושפעות, אלא אם אחד מהאישורים האלה, או מפתח API שנשמר מהתחברות קודמת ל-Claude Console, נמצא גם הואforceLoginMethod, forceLoginOrgUUID
הגבלות ספקלהגביל אילו ספקי API מכונה רשאית להשתמש בהם. הפעלה על ספק שאינו ברשימה נדחית בהפעלה, בהתחברות, ובפעם הבאה שהיא פונה ל-API. נדרש Claude Code גרסה v2.1.285 ואילךallowedProviders
השבתת תצוגת סוכןלכבות את claude agents, --bg, /background, ואת ה-supervisor לפי דרישהdisableAgentView
הגדרת המשגר הארגונילהוסיף קידומת של משגר ארגוני נדרש ל-supervisor של סוכן הרקע, ל-workers שלו, ולתהליכי הרקע הנוספים שהמשגר מכסה, במקום לכבות את תצוגת הסוכןprocessWrapper
הגבלות מודלavailableModels מסנן אילו מודלים מופיעים בבורר. הוספת enforceAvailableModels גם מגבילה את מודל ברירת המחדל שנבחר אוטומטית. ראו כיסוי משטחים לאופן שבו ההגדרה מגיעה ל-CLI, ל-web ול-IDEavailableModels, enforceAvailableModels
תקרת effortלהגביל את רמת ה-effort לכל מודל או לפי מודל, בכל ספקmaxEffortLevel
רצפת גרסהלמנוע מעדכון אוטומטי להתקין מתחת למינימום של כל הארגוןminimumVersion
טווח גרסה נדרשלסרב להפעלה לגמרי כשהגרסה הרצה נמצאת מחוץ לטווח שאושר על ידי הארגון. חזק יותר מ-minimumVersion, שחוסם רק שדרוגים לאחורrequiredMinimumVersion, requiredMaximumVersion
ביטול הסכמה לטלמטריהלכבות מדדי שימוש, דוחות שגיאה וסקרים שנשלחים אל Anthropic בכל מכשירenv עם CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC מוגדר ל-1. הסעיף המקושר מפרט את המשתנים לפי קטגוריה

אם החברים מתחברים דרך claude.ai או דרך Anthropic API, ואתם בתוכנית Claude Enterprise, אפשר גם לנהל מודלים מהגדרות הניהול של הארגון בלי לפרוס דבר:

אף אחת מהבקרות האלה לא מגיעה להפעלות על Amazon Bedrock, Agent Platform של Google Cloud, Microsoft Foundry, או Claude Platform on AWS. אצל הספקים האלה, השתמשו בהגדרות מנוהלות: availableModels להגבלות, model לברירת מחדל, ו-maxEffortLevel לתקרת effort.

להפעלות ענן יש משטחי ניהול משלהן ב-claude.ai:

כללי הרשאות ו-sandboxing מכסים שכבות שונות. דחיית WebFetch חוסמת את כלי ה-fetch של Claude, אבל אם Bash מותר, curl ו-wget עדיין יכולים להגיע לכל כתובת URL. Sandboxing סוגר את הפער הזה באמצעות רשימת היתר של דומיינים ברשת, שנאכפת ברמת מערכת ההפעלה.

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

#חשבונות GitHub מחוברים

בתוכניות Team ו-Enterprise, מקטע GitHub ב-Organization settings > Git providers מציג את ארגוני GitHub ואת החשבונות האישיים המקושרים לארגון Claude שלכם דרך Claude GitHub App. Claude Code, Claude Tag ו-Claude Security חולקים את הרשימה. פתיחת הדף דורשת תפקיד Owner בארגון Claude. תפקיד Admin לא יכול לפתוח אותו.

אפשר לקשר חשבון מדף ספקי ה-Git, או על ידי חיבור GitHub ל-Claude:

  • חיבור Owner: Owner לוחץ על Connect במקטע הזה, או על Add organization אחרי שחשבון מחובר, ומתקין את Claude GitHub App על ארגון GitHub. קישור ארגון בדרך הזו דורש Owner של ארגון Claude שלכם, שהוא גם בעלים של ארגון GitHub.
  • חיבור חבר: כשחבר מחבר את חשבון GitHub שלו ל-Claude, למשל בזמן הגדרת הפעלות ענן, Claude מקשר את חשבונות GitHub שבבעלות החבר הזה ושבהם Claude GitHub App כבר מותקן. זה יכול לכלול את החשבון האישי שלו וארגוני GitHub שבבעלותו.

שורה שמסומנת Not linked מגיעה מההתחברות שלכם ל-GitHub. זה חשבון שאפשר לראות ב-GitHub, ושבו Claude GitHub App מותקן.

כדי לנתק חשבון מארגון Claude, פתחו את התפריט של השורה ובחרו Unlink from this workspace. הניתוק משאיר את Claude GitHub App מותקן ב-GitHub, והחשבון מקושר שוב בפעם הבאה שאחד מהבעלים שלו מחבר את GitHub ל-Claude. כדי למנוע קישור מחדש, הסירו את Claude GitHub App מהחשבון הזה ב-GitHub.

בתוכניות Enterprise, סוגי הפעילות ב-Compliance API לקישור ולניתוק הם github_app_installation_linked ו-github_app_installation_unlinked.

#הגדרת נראות שימוש

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

יכולתמה מקבליםזמינותמאיפה להתחיל
ניטור שימושייצוא OpenTelemetry של הפעלות, כלים וטוקניםכל הספקיםניטור שימוש
לוח בקרה של אנליטיקהמדדי אימוץ ותרומה עם לוח מובילים ב-Teams / Enterprise. מדדי שימוש והוצאה לפי משתמש ב-ConsoleTeams / Enterprise ב-claude.ai/analytics, Console ב-platform.claude.com/claude-codeאנליטיקה
דיווח תכנותינתוני שימוש ועלות לפי משתמש דרך APIEnterprise Analytics API ל-Enterprise, Claude Code Analytics API ל-Consoleעלויות
בקרות הוצאהמגבלות הוצאה ומגבלות קצבהגדרות ארגון ל-Teams / Enterprise, מגבלות workspace ל-Console. בעננים של צד שלישי, בקרות תקציב של הענן או Claude apps gateway עם מגבלות הוצאה לפי משתמשעלויות

ב-Teams וב-Enterprise, מספרי השימוש וההוצאה לפי משתמש מגיעים מדוח ההוצאה בהגדרות האנליטיקה של הארגון, לא מלוח הבקרה של האנליטיקה. ספקי ענן מציגים הוצאה דרך AWS Cost Explorer, GCP Billing, או Azure Cost Management. לתכנון תקציבי ארגון על פני Claude chat, Claude Code ו-Cowork, ראו את מדריך הצריכה של Claude Enterprise.

#סקירת טיפול בנתונים

בתוכניות Team, Enterprise, Claude API וספקי ענן, Anthropic לא מאמנת מודלים על הקוד או על ההנחיות שלכם. ספק ה-API קובע את מדיניות השמירה ואת עמדת התאימות.

נושאמה חשוב לדעתמאיפה להתחיל
מדיניות שימוש בנתוניםמה Anthropic אוספת, כמה זמן זה נשמר, ומה אף פעם לא משמש לאימוןשימוש בנתונים
Zero Data Retention (ZDR)שום דבר לא נשמר אחרי שהבקשה מסתיימת. זמין לחשבונות שעומדים בתנאים ב-Claude for Enterpriseאפס שמירת נתונים
הגדרת HIPAAלארגוני Claude for Enterprise שבהם HIPAA מופעל. חלק מיכולות Claude Code (מצב מקומי) כבויות, ואחרות כבויות כברירת מחדלהגדרת Claude Code (מצב מקומי) לארגון מוכן ל-HIPAA
ארכיטקטורת אבטחהמודל רשת, הצפנה, אימות, נתיב ביקורתאבטחה

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

#אימות וקליטה

אחרי הגדרת ההגדרות המנוהלות, בקשו ממפתח להריץ /status בתוך Claude Code. בכרטיסייה Status, השורה Setting sources מציגה Enterprise managed settings ואחריו, בסוגריים, המקור שניצח. אימות אכיפה מפרט את התוויות.

שתפו את המשאבים האלה כדי לעזור למפתחים להתחיל:

לבעיות התחברות, הפנו מפתחים אל פתרון בעיות אימות. התיקונים הנפוצים ביותר הם:

  • להריץ /logout ואז /login כדי להחליף חשבונות
  • להריץ claude update אם אפשרות האימות הארגונית חסרה
  • להפעיל מחדש את הטרמינל אחרי עדכון

אם מפתח רואה "You haven't been added to your organization yet", המושב שלו לא כולל גישה ל-Claude Code, וצריך לעדכן אותו במסוף הניהול.

#הצעדים הבאים

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