תיעוד 57

הגדרה מתקדמת

דרישות מערכת, התקנה לפי פלטפורמה, ניהול גרסאות והסרת התקנה עבור 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
רשת: נדרש חיבור לאינטרנט. ראו הגדרות רשת.
מעטפת (Shell): Bash, Zsh, PowerShell, או CMD.
מיקום: מדינות הנתמכות על ידי Anthropic

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

ripgrep: בדרך כלל כלול עם Claude Code. אם החיפוש נכשל, ראו פתרון בעיות חיפוש.

#התקנת Claude Code

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

חדשים במסוף? עיינו במדריך למסוף להוראות שלב אחר שלב.

כדי להתקין את Claude Code, השתמשו באחת מהשיטות הבאות:

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

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

אם אתם רואים את השגיאה The token '&&' is not a valid statement separator, אתם נמצאים ב-PowerShell ולא ב-CMD. אם אתם רואים את השגיאה 'irm' is not recognized as an internal or external command, אתם ב-CMD ולא ב-PowerShell. שורת הפקודה מציגה PS C:\ כאשר אתם ב-PowerShell, ו-C:\ ללא ה-PS כאשר אתם ב-CMD.

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

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

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

Homebrew:

brew install --cask claude-code

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

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

WinGet:

winget install Anthropic.ClaudeCode

מידע: התקנות 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` אינו זמין

אפשרות 1: Windows מקורי

הריצו את פקודת ההתקנה מתוך PowerShell או CMD. אין צורך להריץ כמנהל מערכת (Administrator). התקנת Git for Windows היא אופציונלית. היא מאפשרת שימוש בכלי Bash על ידי אספקת Git Bash.

השאלה אם אתם מתקינים מ-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 להגדרה ומגבלות.

אפשרות 2: 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 מדווח שהחבילה חסרה, הוסיפו את מאגר הקהילה אל /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 מדפיסה אבחון לקריאה בלבד של ההתקנה וההגדרות מבלי להתחיל הפעלה, כולל תקינות ההתקנה, שגיאות אימות בקובץ ההגדרות, וכל אזהרה עם הצעות לתיקון.

#אימות חשבון (Authenticate)

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

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

#עדכון Claude Code

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

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

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

הריצו claude doctor כדי לראות את תוצאת ניסיון העדכון האחרון.

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

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

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

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

הערה: התקנות Homebrew, WinGet, apt, dnf ו-apk אינן מתעדכנות אוטומטית כברירת מחדל; ראו להלן כדי להפעיל זאת עבור Homebrew ו-WinGet. כדי לשדרג את Homebrew ידנית, הריצו brew upgrade claude-code או brew upgrade claude-code@latest, בהתאם למארז שהתקנתם. עבור 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"
}

עבור פריסות ארגוניות, תוכלו לאכוף ערוץ גרסאות אחיד בארגון שלכם באמצעות הגדרות מנוהלות (managed settings).

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

#קיבוע גרסת מינימום

ההגדרה minimumVersion קובעת רף תחתון. עדכונים אוטומטיים ברקע והפקודה claude update יסרבו להתקין כל גרסה מתחת לערך זה, כך שמעבר לערוץ "stable" אינו משנמך (downgrade) אתכם אם אתם כבר נמצאים בגרסת "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"
  }
}

בהתקנה מקורית או בהתקנת 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! במקום זאת.

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

אפשרויות אלו נועדו לקיבוע גרסאות, מנהלי חבילות של Linux, 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

להתקנת הגרסה היציבה:

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).

#התקנה באמצעות מנהלי חבילות של Linux

Claude Code מפרסם מאגרי apt, dnf ו-apk חתומים. כל מאגר מציע שני ערוצים: stable מספק גרסה שבדרך כלל בת כשבוע, תוך דילוג על גרסאות עם נסיגות משמעותיות, ו-latest מספק כל גרסה ברגע שהיא מופצת. הפקודות להלן מגדירות את ערוץ stable, המתאים לרוב המשתמשים. כל לשונית מציגה גם את כתובת ה-URL של מאגר 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 name) משתנים. השתמשו בשורת 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

באפשרותכם גם להתקין את Claude Code כחבילת npm גלובלית. החל מגרסה v2.1.198, חבילת ה-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. מנהל החבילות שלכם חייב לאפשר תלויות אופציונליות (optional dependencies). ראו פתרון בעיות אם הקובץ הבינארי חסר לאחר ההתקנה.

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

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

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

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

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

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

הורדה וייבוא של המפתח הציבורי: מפתח חתימת הגרסאות מפורסם בכתובת URL קבועה.
```
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
```

הורדת המניפסט והחתימה: הגדירו את 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"

אימות החתימה: אמתו את החתימה הנפרדת (detached signature) מול המניפסט.
```
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 מאשרת שהמפתח עצמו אותנטי.
בדיקת הקובץ הבינארי מול המניפסט: השוו את סכום הביקורת מסוג 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()
```

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

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

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

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

#הסרת התקנה של Claude Code

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

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

הסירו את הקובץ הבינארי ואת קובצי הגרסאות של 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

הסירו את מארז ה-Homebrew שהתקנתם. אם התקנתם את המארז היציב:

brew uninstall --cask claude-code

אם התקנתם את המארז העדכני ביותר:

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

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

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

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

כדי להסיר את הגדרות 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

הגדרה מתקדמת

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

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

#התקנת Claude Code

#הגדרה ב-Windows

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

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

#אימות חשבון (Authenticate)

#עדכון Claude Code

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

#הגדרת ערוץ הגרסאות

#קיבוע גרסת מינימום

#השבתת עדכונים אוטומטיים

#עדכון ידני

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

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

#התקנה באמצעות מנהלי חבילות של Linux

#apt

#dnf

#apk

#התקנה באמצעות npm

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

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

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

#הסרת התקנה של Claude Code

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

#התקנת Homebrew

#התקנת WinGet

#apt / dnf / apk

#npm

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

#`apt`

#`dnf`

#`apk`