תיעוד 94

הגדרה מתקדמת

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

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

#דרישות מערכת

Claude Code רץ על הפלטפורמות והתצורות הבאות:

מערכת הפעלה:
- macOS 13.0+
- Windows 10 1809+ או Windows Server 2019+
- Ubuntu 20.04+
- Debian 10+
- Alpine Linux 3.19+
חומרה: 4 GB+ RAM, מעבד x64 או ARM64
רשת: נדרש חיבור לאינטרנט. ראה הגדרת רשת.
מעטפת: Bash, Zsh, PowerShell או CMD.
מיקום: מדינות נתמכות של Anthropic

#תלויות נוספות

ripgrep: בדרך כלל כלול עם Claude Code. אם החיפוש נכשל, ראה פתרון בעיות חיפוש.
Git: אופציונלי. אם git מותקן, claude plugin eval דורש 2.31 או גרסה חדשה יותר. העלאות של מאגר מקומי לסשן ענן מ-macOS, Linux או WSL צריכות git 2.31 או גרסה חדשה יותר. הרץ git --version כדי לראות את הגרסה שלך.

#התקנת Claude Code

[!TIP]

מעדיף ממשק גרפי? אפליקציית שולחן העבודה מאפשרת להשתמש ב-Claude Code בלי הטרמינל. הורד אותה עבור macOS, Windows, או Linux.

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

#התקנה מקורית (מומלץ)

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

ב-Windows, ההנחיה מציגה PS C:\ כשאתה ב-PowerShell, ו-C:\ בלי PS כשאתה ב-CMD.

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

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

אם אתה רואה The token '&&' is not a valid statement separator, אתה ב-PowerShell, לא ב-CMD. אם אתה רואה 'irm' is not recognized as an internal or external command, אתה ב-CMD, לא ב-PowerShell.

אם פקודת ההתקנה נכשלת עם syntax error near unexpected token '<', 403, או כל שגיאה אחרת, ראה פתרון בעיות התקנה כדי להתאים את השגיאה לתיקון ולשיטות התקנה חלופיות.

Git for Windows מומלץ ב-Windows מקורי כדי ש-Claude Code יוכל להשתמש בכלי Bash. אם Git for Windows לא מותקן, Claude Code משתמש ב-PowerShell ככלי המעטפת במקום. הגדרות WSL לא צריכות Git for Windows.

[!NOTE]

התקנות מקוריות מתעדכנות אוטומטית ברקע כדי להשאיר אותך בגרסה האחרונה.

#Homebrew

brew install --cask claude-code

Homebrew מציע שני casks. claude-code עוקב אחרי ערוץ השחרור היציב, שבדרך כלל נמצא בערך שבוע מאחור ומדלג על שחרורים עם רגרסיות גדולות. claude-code@latest עוקב אחרי הערוץ האחרון ומקבל גרסאות חדשות ברגע שהן יוצאות.

[!NOTE]

התקנות Homebrew לא מתעדכנות אוטומטית. הרץ brew upgrade claude-code או brew upgrade claude-code@latest, לפי ה-cask שהתקנת, כדי לקבל את התכונות ותיקוני האבטחה האחרונים.

#WinGet

winget install Anthropic.ClaudeCode

[!NOTE]

התקנות WinGet לא מתעדכנות אוטומטית. הרץ winget upgrade Anthropic.ClaudeCode מדי פעם כדי לקבל את התכונות ותיקוני האבטחה האחרונים.

אפשר גם להתקין עם apt, dnf, או apk ב-Debian, Fedora, RHEL ו-Alpine.

אחרי שההתקנה מסתיימת, פתח טרמינל בפרויקט שבו אתה רוצה לעבוד והפעל את Claude Code:

claude

Claude Code פותח סשן אינטראקטיבי בטרמינל שלך.

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

#הגדרה ב-Windows

אפשר להריץ את Claude Code באופן מקורי ב-Windows או בתוך WSL. בחר לפי המיקום של הפרויקטים שלך ולפי התכונות שאתה צריך:

אפשרות	דורש	Sandboxing	מתי להשתמש
Windows מקורי	אין; Git for Windows אופציונלי	לא נתמך	פרויקטים וכלים מקוריים ל-Windows
WSL 2	WSL 2 מופעל	נתמך	שרשראות כלים של Linux או הרצת פקודות בארגז חול
WSL 1	WSL 1 מופעל	לא נתמך	אם WSL 2 לא זמין

#התקנה ב-Windows מקורי

הרץ את פקודת ההתקנה מ-PowerShell או CMD. אין צורך להריץ כ-Administrator. התקנת Git for Windows אופציונלית. היא מספקת Git Bash, שכלי Bash וכלי Monitor צריכים.

ההתקנה מ-PowerShell או מ-CMD משפיעה רק על איזו פקודת התקנה אתה מריץ. ההנחיה מציגה PS C:\Users\YourName> ב-PowerShell ו-C:\Users\YourName> בלי PS ב-CMD. אם אתה חדש בטרמינל, מדריך הטרמינל עובר על כל צעד.

אחרי ההתקנה, הפעל claude מכל טרמינל.

בלי Git for Windows, Claude Code מריץ פקודות מעטפת דרך כלי PowerShell.
עם Git for Windows, Claude Code משתמש ב-Git Bash עבור כלי Bash. אם Claude Code לא מוצא את Git Bash, הגדר את הנתיב בקובץ settings.json:
```
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}
```

כש-Git for Windows מותקן, כלי PowerShell זמין לצד Bash: מופעל כברירת מחדל עבור חשבונות claude.ai ו-Console, ומופעל עם CLAUDE_CODE_USE_POWERSHELL_TOOL=1 בסשנים של Amazon Bedrock, Google Cloud's Agent Platform ו-Microsoft Foundry. הגדר אותו ל-0 כדי לכבות את הכלי. ראה כלי PowerShell להגדרה ולמגבלות.

#התקנה ב-WSL

פתח את הפצת ה-WSL שלך והרץ את מתקין Linux מתוך הוראות ההתקנה. אתה מתקין ומפעיל את claude בתוך טרמינל WSL, לא מ-PowerShell או CMD.

#Alpine Linux והפצות מבוססות musl

התקנת Claude Code על Alpine ועל הפצות אחרות מבוססות musl/uClibc דורשת bash ו-curl עבור פקודת ההתקנה, ו-libgcc, libstdc++ ו-ripgrep בזמן ריצה. Alpine לא כולל bash או curl כברירת מחדל, ולכן פקודת ההתקנה המתועדת נכשלת עם שגיאת not found עד שתתקין אותם. התקן את החבילות האלה באמצעות מנהל החבילות של ההפצה שלך, ואז הגדר USE_BUILTIN_RIPGREP=0.

הדוגמה הזו מתקינה את החבילות הנדרשות ב-Alpine:

apk add bash curl libgcc libstdc++ ripgrep

ב-Alpine, ripgrep נמצא במאגר community. אם apk מדווח שהחבילה חסרה, הוסף את מאגר community אל /etc/apk/repositories, באמצעות גרסת Alpine שלך:

echo "https://dl-cdn.alpinelinux.org/alpine/v3.22/community" >> /etc/apk/repositories

הרץ apk update כדי לרענן את אינדקס החבילות, ונסה שוב את פקודת apk add.

ואז הגדר את USE_BUILTIN_RIPGREP ל-0 בקובץ settings.json שלך:

{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

#אימות ההתקנה

אחרי ההתקנה, אשר ש-Claude Code עובד:

claude --version

התקנה תקינה מדפיסה מספר גרסה כגון 2.1.211 (Claude Code).

אם זה נכשל עם command not found או שגיאה אחרת, ראה פתרון בעיות התקנה והתחברות.

לבדיקה מפורטת יותר של ההתקנה והתצורה, הרץ claude doctor:

claude doctor

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

#אימות

Claude Code דורש חשבון Pro, Max, Ultra, Team, Enterprise או Console. התוכנית החינמית של claude.ai לא כוללת גישה ל-Claude Code. אפשר גם להשתמש ב-Claude Code עם ספק API צד שלישי כמו Amazon Bedrock, Google Cloud's Agent Platform, או Microsoft Foundry.

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

#עדכון Claude Code

התקנות native מתעדכנות אוטומטית ברקע. אפשר להגדיר את ערוץ ההפצה כדי לשלוט אם מקבלים עדכונים מיד או לפי לוח זמנים יציב מאוחר, או לבטל עדכונים אוטומטיים לגמרי. התקנות של Homebrew, WinGet ושל מנהל חבילות Linux דורשות עדכונים ידניים כברירת מחדל.

#עדכונים אוטומטיים

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

מריצים את claude doctor במעטפת כדי לראות את התוצאה של ניסיון העדכון האחרון ש-Claude Code רשם. בהתקנת native, אם הוא מדווח על ניסיון שנכשל, ראו Auto-update failed בכותרת התחתונה של הסשן למה לעשות בהמשך.

ב-macOS וב-Linux, המתקין ה-native מנהל את המשגר ב-~/.local/bin/claude כקישור סימבולי אל תוך ~/.local/share/claude/versions/. אם מחליפים את המשגר הזה בסקריפט או בקישור סימבולי משלכם, עדכון אוטומטי ו-claude update משאירים אותו במקום: גרסאות חדשות עדיין מותקנות תחת ספריית versions/, והמשגר שלכם מחליט איזו גרסה רצה.

עם משגר מותאם אישית, Claude Code גם שומר כל גרסה מותקנת על הדיסק כי הוא לא יכול לדעת איזו גרסה המשגר צריך. claude doctor מדווח על משגר שהמתקין ה-native לא יצר.

כדי לאפשר ל-Claude Code לנהל שוב את המשגר, מסירים את ~/.local/bin/claude ומריצים claude update.

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

[!NOTE]

התקנות Homebrew, WinGet, apt, dnf ו-apk לא מתעדכנות אוטומטית כברירת מחדל. ראו בהמשך איך להצטרף עבור Homebrew ו-WinGet. כדי לשדרג את Homebrew ידנית, מריצים brew upgrade claude-code או brew upgrade claude-code@latest, לפי ה-cask שהותקן. עבור WinGet, מריצים winget upgrade Anthropic.ClaudeCode. עבור מנהלי חבילות Linux, ראו את פקודות השדרוג בהתקנה עם מנהלי חבילות Linux.

כדי ש-Claude Code יריץ עבורכם את פקודת השדרוג ב-Homebrew או ב-WinGet, מגדירים את CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE ל-1. Claude Code מריץ אז את השדרוג ברקע כשגרסה חדשה זמינה, ומציג בקשת הפעלה מחדש בהצלחה. השדרוג מכוון רק לחבילת Claude Code ואינו משפיע על תוכנות אחרות שהותקנו.

ב-WinGet השדרוג עלול להיכשל בזמן ש-Claude Code רץ, כי Windows נועל את קובץ ההרצה. במקרה הזה Claude Code מציג את הפקודה הידנית. apt, dnf ו-apk ממשיכים לדרוש שדרוג ידני, כי הפקודות האלה צריכות הרשאות מוגברות.

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

Homebrew שומר גרסאות ישנות על הדיסק אחרי שדרוגים. מריצים brew cleanup מדי פעם כדי לשחרר מקום בדיסק.

#הגדרת ערוץ הפצה

שולטים באיזה ערוץ הפצה Claude Code עוקב אחריו לעדכונים אוטומטיים ול-claude update באמצעות ההגדרה autoUpdatesChannel:

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

מגדירים את זה דרך /config ← Auto-update channel, או מוסיפים את זה לקובץ settings.json:

{
  "autoUpdatesChannel": "stable"
}

מודל שהושק זה עתה יכול לדרוש גרסת Claude Code חדשה יותר ממה שערוץ stable מספק. כדי להריץ את המודל עכשיו, עוברים לערוץ latest.

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

התקנות Homebrew בוחרות ערוץ לפי שם ה-cask במקום ההגדרה הזו: claude-code עוקב אחרי stable ו-claude-code@latest עוקב אחרי latest.

התקנות ממאגרי apt, dnf ו-apk בוחרות ערוץ לפי המאגר במקום ההגדרה הזו. כדי להחליף ערוץ, פועלים לפי התקנה עם מנהלי חבילות Linux.

#נעיצת גרסת מינימום

ההגדרה minimumVersion קובעת רצפה. עדכונים אוטומטיים ברקע ו-claude update מסרבים להתקין כל גרסה מתחת לערך הזה, כך שמעבר לערוץ "stable" לא מוריד את הגרסה אם כבר נמצאים ב-build חדש יותר של "latest".

מעבר מ-"latest" ל-"stable" דרך /config מבקש להישאר בגרסה הנוכחית או לאפשר את הירידה לגרסה ישנה יותר. בחירה להישאר מגדירה את minimumVersion לגרסה הזו. חזרה ל-"latest" מנקה אותו.

מוסיפים אותו לקובץ settings.json כדי לנעוץ רצפה במפורש:

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

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

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

#ביטול עדכונים אוטומטיים

מגדירים את DISABLE_AUTOUPDATER ל-"1" במפתח env של קובץ settings.json:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

בהתקנת native או npm, מאשרים שהשינוי נכנס לתוקף על ידי הרצת claude doctor ובדיקה ששורת Auto-updates מציגה disabled (set by env: DISABLE_AUTOUPDATER) במקום enabled.

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

#עדכון ידני

כדי להחיל עדכון מיד בלי להמתין לבדיקת הרקע הבאה, מריצים:

claude update

כשעדכון מותקן, הפקודה מדווחת Successfully updated from <old version> to version <new version>. אם כבר נמצאים בגרסה החדשה ביותר, היא מדווחת Claude Code is up to date (<version>). התקנות שמנוהלות על ידי Homebrew, WinGet או apk מדווחות Claude is up to date!.

#אפשרויות התקנה מתקדמות

האפשרויות האלה מיועדות לנעיצת גרסה, למנהלי חבילות של לינוקס, ל-npm, לאחסון ברשת, ולאימות שלמות הקובץ הבינארי.

#התקנת גרסה מסוימת

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

להתקנת הגרסה העדכנית ביותר (ברירת המחדל):

macOS, Linux, WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

להתקנת גרסת stable:

macOS, Linux, WSL

curl -fsSL https://claude.ai/install.sh | bash -s stable

Windows PowerShell

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd stable && del install.cmd

להתקנת מספר גרסה מסוים:

macOS, Linux, WSL

curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

Windows PowerShell

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 2.1.89 && del install.cmd

כדי לאשר איזו גרסה הותקנה, הריצו claude --version: הפקודה מדפיסה את הגרסה המדויקת שהועברה, למשל 2.1.89 (Claude Code).

#התקנה עם מנהלי חבילות בלינוקס

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

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

apt

עבור Debian ו-Ubuntu. פקודות ההתקנה למטה מורידות את מפתח החתימה עם curl ומאמתות אותו עם gpg, שייתכן שאינם כלולים בהתקנות Debian ו-Ubuntu חדשות. אם אחת מהפקודות מדווחת command not found, התקינו את שתיהן קודם:

sudo apt install curl gnupg

הורדת מפתח החתימה:

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc

אם ההורדה נכשלת, apt update נכשל אחר כך עם NO_PUBKEY BAA929FF1A7ECACE. אשרו שהמפתח ירד ושייך ל-Anthropic לפני שממשיכים:

gpg --show-keys /etc/apt/keyrings/claude-code.asc

טביעת האצבע ש-gpg מדפיס צריכה להיות 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. אם gpg מדווח שאי אפשר לפתוח את הקובץ או שהוא אינו מכיל נתוני OpenPGP תקינים, ההורדה נכשלה או החזירה תוכן שגוי: אשרו שהרשת יכולה להגיע אל downloads.claude.ai, ואז הריצו שוב את פקודת ההורדה.

רישום המאגר בערוץ stable והתקנה:

echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

כדי להשתמש בערוץ latest, גם נתיב ה-URL וגם שם ה-suite משתנים. השתמשו בשורת deb הזו:

echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list

כדי לשדרג אחר כך, הריצו sudo apt update && sudo apt upgrade claude-code.

dnf

עבור Fedora ו-RHEL. הפקודות הבאות מגדירות את ערוץ stable:

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

כדי להשתמש בערוץ latest, הגדירו את baseurl למאגר latest:

baseurl=https://downloads.claude.ai/claude-code/rpm/latest

dnf מוריד את המפתח בהתקנה הראשונה ומבקש לאשר את טביעת האצבע. ודאו שהיא תואמת ל-31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE לפני האישור.

כדי לשדרג אחר כך, הריצו sudo dnf upgrade claude-code.

apk

עבור Alpine Linux. הפקודות הבאות מגדירות את ערוץ stable:

wget -O /etc/apk/keys/claude-code.rsa.pub \
  https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code

כדי לעבור לערוץ latest, הסירו את שורת מאגר stable והוסיפו את מאגר latest:

sed -i '\|downloads.claude.ai/claude-code/apk/stable|d' /etc/apk/repositories
echo "https://downloads.claude.ai/claude-code/apk/latest" >> /etc/apk/repositories

אמתו את המפתח שהורד עם sha256sum /etc/apk/keys/claude-code.rsa.pub, שאמור לדווח 395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6.

כדי לשדרג אחר כך, הריצו apk update && apk upgrade claude-code.

#התקנה עם npm

[!NOTE]

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

אפשר גם להתקין את Claude Code כחבילת npm גלובלית. חבילת ה-npm דורשת Node.js 22 או חדש יותר. בגרסת Node.js ישנה יותר, npm מדפיס אזהרת EBADENGINE במהלך ההתקנה במקום להיכשל. ההתקנה מסתיימת ו-claude עדיין רץ, כי החבילה מורידה קובץ בינארי נייטיבי שלא משתמש ב-Node.js שלכם בזמן ריצה.

npm install -g @anthropic-ai/claude-code

חבילת ה-npm מתקינה את אותו קובץ בינארי נייטיבי כמו המתקין העצמאי. npm מושך את הקובץ הבינארי דרך תלות אופציונלית לפי פלטפורמה, למשל @anthropic-ai/claude-code-darwin-arm64, ושלב postinstall מקשר אותו למקומו. הקובץ הבינארי claude שהותקן אינו מפעיל את Node בעצמו.

הפלטפורמות הנתמכות להתקנת npm הן darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64 ו-win32-arm64. מנהל החבילות חייב לאפשר תלויות אופציונליות. ראו פתרון בעיות אם הקובץ הבינארי חסר אחרי ההתקנה.

כדי לשדרג התקנת npm, הריצו npm install -g @anthropic-ai/claude-code@latest. הימנעו מ-npm update -g, שמכבד את טווח ה-semver מההתקנה המקורית וייתכן שלא יעביר אתכם לשחרור החדש ביותר.

[!WARNING]

אל תשתמשו ב-sudo npm install -g, כי זה עלול לגרום לבעיות הרשאה ולסיכוני אבטחה. אם נתקלים בשגיאות הרשאה, ראו פתרון בעיות בהרשאות.

#התקנה על אחסון רשת

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

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

התקנה בדיסק מקומי: שימו את הקובץ הבינארי במערכת הקבצים המקומית של כל מכונה, למשל עם מנהל חבילות של לינוקס או עם כלי הפריסה שלכם. קידומת npm לכל משתמש ותיקיית ברירת המחדל של המתקין הנייטיבי ~/.local/share/claude/versions/ נמצאות שתיהן בתיקיית הבית.
שמרו כל גרסה בתיקייה משלה: שדרוג התקנת npm במקום עם npm install -g מוחק את הקובץ הבינארי הקודם. באחסון שכמה מכונות חולקות, זה מסיר את הקובץ שסשנים במכונות האחרות עדיין מריצים. התקינו כל גרסה חדשה לצד הישנות והעבירו את המשתמשים אליה.
מחקו גרסה ישנה רק כשאף מכונה לא יכולה עדיין להריץ אותה: מכונה לא רואה תהליכים שרצים במכונות אחרות, ולכן בדיקת תהליכים רצים לפני המחיקה אינה מספיקה.
כבו את העדכונים של Claude Code עצמו: הגדירו את DISABLE_UPDATES והתקינו גרסאות חדשות עם הכלים שלכם. אחרת עדכון אוטומטי של התקנת npm במכונה אחת מריץ את אותו שדרוג במקום ומסיר את הקובץ הבינארי שסשנים במכונות אחרות מריצים. הגדרת DISABLE_AUTOUPDATER לבדה אינה מספיקה, כי משתמשים עדיין יכולים להריץ claude update ו-claude install. ראו כיבוי עדכונים אוטומטיים.

המתקין הנייטיבי מוחק גרסאות ישנות מ-~/.local/share/claude/versions/ בעצמו, וזה חשוב כשהתיקייה נמצאת באחסון משותף. מלבד הגרסה שאליה ה-launcher מצביע וכל גרסה שסשן באותה מכונה מריץ, הוא שומר את שתי הגרסאות החדשות ביותר ומוחק את השאר. סשן במכונה אחרת שמריץ גרסה שנמחקה מאבד את הקובץ הבינארי שלו. עם launcher מותאם, Claude Code שומר כל גרסה מותקנת ומשאיר את הניקוי לכם.

#שלמות בינארית וחתימת קוד

כל שחרור מפרסם manifest.json שמכיל סכומי ביקורת SHA256 לכל קובץ בינארי של פלטפורמה. המניפסט חתום במפתח GPG של Anthropic, ולכן אימות החתימה על המניפסט מאמת באופן עקיף כל קובץ בינארי שהוא מפרט.

#אימות חתימת המניפסט

שלבים 1-3 דורשים מעטפת POSIX עם gpg ו-curl. ב-Windows, הריצו אותם ב-Git Bash או ב-WSL. שלב 4 כולל אפשרות PowerShell.

1. הורדה וייבוא של המפתח הציבורי

מפתח החתימה של השחרור מתפרסם בכתובת קבועה.

curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import

הצגת טביעת האצבע של המפתח שיובא.

gpg --fingerprint [email protected]

אשרו שהפלט כולל את טביעת האצבע הזו:

31DD DE24 DDFA B679 F42D  7BD2 BAA9 29FF 1A7E CACE

2. הורדת המניפסט והחתימה

הגדירו את VERSION לשחרור שרוצים לאמת.

REPO=https://downloads.claude.ai/claude-code-releases
VERSION=2.1.89
curl -fsSLO "$REPO/$VERSION/manifest.json"
curl -fsSLO "$REPO/$VERSION/manifest.json.sig"

3. אימות החתימה

אמתו את החתימה המנותקת מול המניפסט.

gpg --verify manifest.json.sig manifest.json

תוצאה תקינה מדווחת Good signature from "Anthropic Claude Code Release Signing <[email protected]>".

gpg גם מדפיס WARNING: This key is not certified with a trusted signature! לכל מפתח שיובא זה עתה. זה צפוי. השורה Good signature מאשרת שהבדיקה הקריפטוגרפית עברה. השוואת טביעת האצבע בשלב 1 מאשרת שהמפתח עצמו אותנטי.

4. בדיקת הקובץ הבינארי מול המניפסט

השוו את סכום הביקורת SHA256 של הקובץ הבינארי לערך שרשום תחת platforms.<platform>.checksum ב-manifest.json. הפקודות למטה מניחות קובץ בינארי claude בתיקייה הנוכחית. כדי לאמת במקום זאת קובץ בינארי נייטיבי מותקן, הריצו את הפקודה על ~/.local/share/claude/versions/VERSION, והחליפו את VERSION בשחרור שהוגדר בשלב 2.

Linux

sha256sum claude

macOS

shasum -a 256 claude

Windows PowerShell

(Get-FileHash claude.exe -Algorithm SHA256).Hash.ToLower()

[!NOTE]

חתימות מניפסט זמינות לשחרורים מ-2.1.89 ואילך. שחרורים מוקדמים יותר מפרסמים סכומי ביקורת ב-manifest.json בלי חתימה מנותקת.

#חתימות קוד לפי פלטפורמה

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

macOS: חתום על ידי "Anthropic PBC" ועבר notarization של Apple. אמתו עם codesign --verify --verbose ./claude.
Windows: חתום על ידי "Anthropic, PBC". אמתו עם Get-AuthenticodeSignature .\claude.exe.
Linux: הקבצים הבינאריים אינם חתומים בקוד בנפרד. אם מורידים ישירות מדלי claude-code-releases או משתמשים במתקין הנייטיבי, אמתו שלמות עם חתימת המניפסט למעלה. אם מתקינים עם apt, dnf או apk, מנהל החבילות מאמת חתימות אוטומטית באמצעות מפתח החתימה של המאגר.

#הסרת Claude Code

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

#הסרת התקנה נייטיבית

הסירו את הקובץ הבינארי של Claude Code ואת קובצי הגרסאות:

macOS, Linux, WSL

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Windows PowerShell

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

#הסרה עם Homebrew

הסירו את ה-cask של Homebrew שהותקן. אם הותקן ה-cask של stable:

brew uninstall --cask claude-code

אם הותקן ה-cask של latest:

brew uninstall --cask claude-code@latest

#הסרה עם WinGet

הסירו את חבילת WinGet:

winget uninstall Anthropic.ClaudeCode

#הסרה עם apt, dnf או apk

הסירו את החבילה ואת הגדרת המאגר:

apt

sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

dnf

sudo dnf remove claude-code
sudo rm /etc/yum.repos.d/claude-code.repo

apk

apk del claude-code
sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories
rm /etc/apk/keys/claude-code.rsa.pub

#הסרה עם npm

הסירו את חבילת ה-npm הגלובלית:

npm uninstall -g @anthropic-ai/claude-code

#הסרת קובצי הגדרות

[!WARNING]

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

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

כדי להסיר הגדרות ונתונים במטמון של Claude Code:

macOS, Linux, WSL

# Remove user settings and state
rm -rf ~/.claude
rm ~/.claude.json

# Remove project-specific settings (run from your project directory)
rm -rf .claude
rm -f .mcp.json

Windows PowerShell

# Remove user settings and state
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

# Remove project-specific settings (run from your project directory)
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force