📘 תיעוד 126

הגדרת Claude Code (מצב מקומי) לארגון מוכן ל-HIPAA

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

תצורת HIPAA היא הגדרת ארגון בתוכניות Claude Enterprise, לארגונים שמטפלים במידע בריאותי מוגן (PHI) ויש להם הסכם שותף עסקי (BAA) עם Anthropic. היא חלה על Claude Code (מצב מקומי) ועל Cowork (מצב מקומי), והיא מגבילה תכונות בשני המוצרים.

הערה

"(מצב מקומי)" פירושו סשן מקומי, לא סשן ענן. סשנים מקומיים רצים באחד מהמקומות האלה:

• Claude Code בטרמינל
• Claude Code בלשונית Code של Claude Desktop
• Cowork ב-Claude Desktop

התוספים של Claude Code ל-VS Code ול-JetBrains אינם חלק מ-(מצב מקומי). הם ממשיכים לעבוד כשתצורת HIPAA מוחלת, אבל ה-BAA שלך לא מכסה אותם. ראה את מדריך היישום לרשימה המלאה של Eligible Services.

העמוד הזה מיועד למנהל ה-IT או האבטחה שמכין את מחשבי המפתחים. הבעלים הראשי של ארגון Claude שלך מחיל את התצורה עצמה. שימוש ב-Claude Code (מצב מקומי) וב-Cowork (מצב מקומי) בתוכנית Enterprise מוכנה ל-HIPAA מסביר מה ה-BAA שלך כולל, איך מחילים את התצורה, ואיך לקבוע את התאריך שבו היא מוחלת.

אם חברים בארגון שלך משתמשים גם ב-Cowork, פעל גם לפי הגדרת Cowork (מצב מקומי) לארגון מוכן ל-HIPAA. המדריך הזה מכסה את מדיניות Claude Desktop ואת הנתונים המקומיים של Cowork.

הטבלה מראה מתי לבצע כל חלק בהגדרה:

#הכנת מחשבים לפני שתצורת HIPAA מוחלת

מומלץ להתחיל במשימות בסעיף הזה ולהשלים אותן לפני שהתצורה מוחלת.

#בדיקה איך מפתחים נכנסים ומתחברים

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

הטבלה מראה אילו חיבורים זכאים. כדי לדעת אם ה-BAA שלך מכסה סשן בשורה של "לא", ראה שימוש ב-Claude Code (מצב מקומי) וב-Cowork (מצב מקומי) בתוכנית Enterprise מוכנה ל-HIPAA.

#בדיקה איך מחשב מתחבר

פתח טרמינל במחשב, הרץ claude, והזן /status בשורת הקלט. לשונית Status מציגה את השורות האלה:

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

#עדכון Claude Code ו-Claude Desktop

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

כדי לקרוא את גרסת Claude Code המותקנת, הרץ את הפקודה הזו בטרמינל. היא זהה ב-Bash, ב-Zsh וב-PowerShell:

claude --version

התקנה נתמכת מדפיסה 2.1.285 (Claude Code) או מספר גבוה יותר.

כדי לקרוא את גרסת Claude Desktop המותקנת, ראה בדיקת הגרסה.

#מה מפתחים רואים בגרסה ישנה יותר

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

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

#מתן גישת רשת

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

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

• שיטות התקנה אחרות ותכונות אופציונליות: דרישות גישת רשת מפרט את המארחים שהתקנות npm ו-Homebrew בודקות לעדכונים, ואת המארחים לתכונות כמו התקנת plugins
• לשונית Code ו-Cowork: דרישות גישת רשת של Desktop מפרט את המארחים הנוספים ש-Claude Desktop צריך
• פרוקסי שבודקים TLS: אישורי CA מותאמים מראה איך לתת אמון באישור של הפרוקסי

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

Claude Code לומד שלארגון שלך יש את תצורת HIPAA על ידי שליפת מדיניות הארגון מ-api.anthropic.com, כשהוא מתחיל, ושוב בערך כל שעה בזמן שהסשן בשימוש. המדיניות היא רשומה של סטטוס HIPAA של הארגון ושל הגבלות התכונות שנובעות ממנו.

כדי לבדוק אם מחשב אחד שלף את המדיניות, ראה אימות התצורה במחשב.

#פריסת הגדרות מנוהלות

אפשר להשתמש בהגדרות מנוהלות כדי לכוון מפתחים להתחבר עם חשבון Claude Enterprise, לחסום ספקי ענן ו-gateways, ולהגדיר כמה ימים כל מחשב שומר נתוני סשן מקומיים. ההגדרות חלות בין שתצורת HIPAA בתוקף ובין שהיא לא בתוקף.

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

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

{
  "forceLoginMethod": "claudeai",
  "forceLoginOrgUUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "allowedProviders": ["anthropic"],
  "cleanupPeriodDays": 30
}

ל-managed-settings.json מלא יותר עם sandboxing, רשימת היתר לרשת, הגנות על פרטי גישה, ושמירת נתונים מקומיים, ראה settings-hipaa.json ו-README-hipaa.md במאגר דוגמאות ההגדרות.

#מה כל מפתח עושה

הטבלה מראה למה להגדיר כל מפתח, ומה Claude Code אוכף עבורו.

אזהרה

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

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

כש-forceLoginMethod או forceLoginOrgUUID מוגדרים, Claude Code גם מסרב לסשנים שמזדהים עם ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, או apiKeyHelper.

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

במחשב שיש בו את ההגדרות, הרץ claude, התחבר עם חשבון Claude Enterprise, והזן /status. השורה Setting sources מפרטת Enterprise managed settings ואחריו המקור בסוגריים, למשל (file), והשורה Allowed providers מציגה Anthropic API (managed allowedProviders). אם Setting sources לא מפרט את זה, או ששורת Allowed providers חסרה, ראה בדיקה שמדיניות בתוקף.

#סשנים שמפתחות ההגדרות המנוהלות לא חוסמים

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

• התחברויות Claude Console ופרטי גישה של federation: forceLoginOrgUUID בודק רק התחברויות claude.ai. הגבלת התחברות לארגון שלך מפרט מה Claude Code בודק בכל נתיב התחברות ובכל פרט גישה.
• הגדרות מנוהלות בשרת: אם הארגון שלך משתמש גם בהגדרות מנוהלות בשרת, בקש מבעלים להוסיף שם את אותם מפתחות. איך Claude Code משלב מקורות מנוהלים מסביר איזה מקור חל.
• גרסאות ישנות מ-v2.1.285: הגרסאות האלה מתעלמות מ-allowedProviders, ולכן הן עדיין יכולות להתחיל על ספק ענן או על gateway. כדי שגרסאות v2.1.163 עד v2.1.284 יסרבו להתחיל, אפשר להוסיף requiredMinimumVersion שמוגדר ל-"2.1.285" לאותן הגדרות מנוהלות כמו מפתחות הדוגמה. גרסאות לפני v2.1.163 מתעלמות גם מ-requiredMinimumVersion וגם מ-allowedProviders, ולכן עדכן את המחשבים האלה.

כדי לדעת אם ה-BAA שלך מכסה סשן שרץ בלי תצורת HIPAA, ראה שימוש ב-Claude Code (מצב מקומי) וב-Cowork (מצב מקומי) בתוכנית Enterprise מוכנה ל-HIPAA.

#הגבלת ההתחברות ב-Claude Desktop

אם מפתחים משתמשים בלשונית Code של Claude Desktop, הגדר גם את forceLoginOrgUUID במדיניות Claude Desktop, כפי שהגבלת התחברות לארגון שלך מתאר. פריסה של forceLoginMethod ו-forceLoginOrgUUID בהגדרות מנוהלות לא משנה את מסך ההתחברות של Claude Desktop.

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

הרץ את הבדיקה הזו במחשב מנוהל אחד אחרי שהתצורה הוחלה על הארגון שלך.

1. הפעלה מחדש של Claude Code

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

2. בדיקת הודעת ההפעלה

   אשר ש-Claude Code מדפיס Per your organization's policy, some features are limited · /status for details כשהוא מתחיל.

3. בדיקת הפוטר

   אשר שתג HIPAA configured מופיע בצד ימין של הפוטר, מתחת לשורת הקלט. לפני v2.1.286, התג היה HIPAA.

4. הרצת /status

   הזן /status בשורת הקלט. אשר שלשונית Status מפרטת HIPAA בשורה Organization configuration.

5. בדיקת Claude Desktop

   החלת תצורת HIPAA מכבה את לשונית Code עבור הארגון שלך. אם הארגון שלך משתמש בה, בקש מבעלים לעבור אל Organization settings > Claude Code ולהפעיל את המתג Desktop. עבור Cowork, ראה אימות תצורת HIPAA ב-Claude Desktop.

   טען מחדש את Claude Desktop או התחבר שוב. אשר ששורת הכותרת מציגה תווית HIPAA configured. ב-Mac, פתח את סרגל הצד כדי לראות אותה.

אם HIPAA חסר מ-/status, בדוק את הסיבות האלה לפי הסדר:

1. החשבון או החיבור הלא נכונים: אשר ש-/status מציג את הארגון שלך בשורה Organization, ולא מציג שורה API provider או Anthropic base URL. בדיקה איך מפתחים נכנסים ומתחברים מפרט אילו שיטות התחברות וחיבור לא זכאיות לתצורה.
2. שליפת מדיניות שנחסמה: חפש שורה Organization policy ב-/status, שמציינת את הסיבה. מחוץ לסשן, הרץ claude doctor וקרא את אותה שורה, שאומרת מאיפה Claude Code טען את המדיניות או למה המדיניות לא נטענה. אפשר את api.anthropic.com דרך הפרוקסי, ואז הפעל מחדש את Claude Code.
3. התצורה עדיין לא הוחלה: שאל את הבעלים הראשי אם הם החילו את התצורה.

#מה מפתחים רואים ב-Claude Code

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

#פרטי הזדהות של Anthropic בפקודות, ב-hooks ובשרתי MCP

כשהגדרת HIPAA מוחלת, Claude Code מסיר את פרטי ההזדהות שבהם הוא משתמש כדי להגיע ל-Anthropic, כגון ANTHROPIC_API_KEY ו-ANTHROPIC_AUTH_TOKEN, מסביבת הפקודות של המעטפת, ה-hooks ושרתי ה-MCP שהוא מפעיל.

הגדרת HIPAA לא מסירה פרטי הזדהות של ספק ענן או של GitHub, ולכן פקודה שדוחפת ל-GitHub או קוראת לשירות אחר עדיין עובדת עם הגישה של אותו מפתח. ה-BAA שלך עם Anthropic לא מכסה את הנתונים שנשלחים לשם. ראה את מדריך היישום לרשימה המלאה של Eligible Services.

כדי להגביל אילו פקודות ומארחים Claude יכול להשתמש בהם, ראה כללי הרשאות ואת ה-sandbox.

#ניהול נתוני סשן מקומיים

Claude Code (מצב מקומי) ו-Cowork (מצב מקומי) שומרים נתוני סשן במחשב של כל מפתח. אבטחת הנתונים האלה ומחיקתם הן באחריות הארגון שלך.

#נתוני Claude Code

נתוני יישום מפרטים מה Claude Code (מצב מקומי) שומר במחשב, מה סריקת השמירה מוחקת אחרי cleanupPeriodDays, ומה נשאר עד שמישהו מוחק אותו. אותו דף מציין מה שונה בארגון שהגדרת HIPAA מוחלת בו.

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

#נתוני לשונית Code

לשונית Code שומרת נתונים במקומות האלה:

• תמלילים: ב-~/.claude/projects/, לצד תמלילי הטרמינל. ניקוי אוטומטי מציין מתי סריקת השמירה מוחקת אותם.
• תיקיית הנתונים של Claude Desktop: ~/Library/Application Support/Claude ב-macOS. ב-Windows, %APPDATA%\Claude, או %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude עבור המתקין שהורד מ-Anthropic, לכן בדוק את שניהם. כשהגדרת HIPAA מוחלת, Claude Desktop מוחק סשנים מקומיים של לשונית Code שהיו לא פעילים יותר מ-cleanupPeriodDays, כולל כאלה שמסומנים בכוכב. הוא מוחק אותם רק בזמן שהוא רץ. Claude Desktop מטפל ב-worktree של סשן שנמחק באחת מהדרכים האלה:
  • אין שינויים שלא עברו commit, הסשן לא מסומן בכוכב ולא נעוץ, ואין סשן אחר שמשתמש ב-worktree: Claude Desktop מסיר את ה-worktree
  • כל מקרה אחר: ה-worktree נשאר במחשב

ב-Windows, ~ פירושו %USERPROFILE%.

#נתוני Cowork

ניהול נתוני Cowork בכל מחשב מפרט איפה Cowork (מצב מקומי) שומר נתונים ומה Claude Desktop מוחק.

#מחיקת נתוני סשן מיד

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

ב-Claude Code גרסה v2.1.288 ואילך, הרץ את claude purge:

claude purge --all --yes

בגרסאות v2.1.126 עד v2.1.287, הרץ את claude project purge, שמקבל את אותם דגלים:

claude project purge --all --yes

כל אחת מהפקודות מוחקת את התמלילים ואת ה-auto memory של כל פרויקט, את הרשומות ב-tasks/, ב-debug/ וב-file-history/, את history.jsonl, ואת רשומות הפרויקטים ב-~/.claude.json. בלי --yes, היא מדפיסה את התוכנית ושואלת קודם.

ה-purge משאיר נתיבים אחרים שיכולים להחזיק תוכן סשן, כגון טקסט שהודבק ב-paste-cache/. ניקוי נתונים מקומיים מפרט את הנתיבים שאפשר למחוק ידנית. כדי לנקות מחשב לגמרי, למשל לפני שמקצים אותו מחדש, אפס אותו.

#הסרת מפתח

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

#משאבים קשורים

• הגדרת Cowork (מצב מקומי) לארגון שמוכן ל-HIPAA
• פריסת הגדרות מנוהלות
• דוגמה להגדרות HIPAA
• הגדרת רשת ארגונית
• אפס שמירת נתונים
• משפטי ותאימות
• שימוש בנתונים