📘 תיעוד 53

פתרון בעיות בהתקנה ובהתחברות

פתרון שגיאות של פקודה לא נמצאה, PATH, הרשאות, רשת ואימות בעת התקנה או התחברות אל Claude Code.

אם ההתקנה נכשלת או שאינך מצליח להתחבר, מצא את השגיאה שלך להלן. לבעיות בזמן ריצה לאחר ש-Claude Code כבר עובד, ראה Troubleshooting. לבעיות תצורה כגון הגדרות שאינן חלות או הוקים שאינם מופעלים, ראה Debug your configuration.

#מצא את השגיאה שלך

התאם את הודעת השגיאה או התסמין שאתה רואה לפתרון:

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

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

#הפעל בדיקות אבחון

#בדוק קישוריות רשת

המתקין מוריד קבצים מ-downloads.claude.ai. ודא שבאפשרותך להגיע אליו:

macOS/Linux:

curl -sI https://downloads.claude.ai/claude-code-releases/latest

Windows PowerShell:

curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest

‏PowerShell מגדיר את curl ככינוי עבור Invoke-WebRequest, שדוחה את הדגלים -sI, לכן קרא ל-curl.exe באופן מפורש.

הגעת אל השרת אם השורה הראשונה מציגה סטטוס 200. אתה תראה HTTP/2 200 ב-macOS וב-Linux, ו-HTTP/1.1 200 OK מתוך curl.exe שמגיע עם Windows. תוצאות אחרות מצביעות על הגורם:

• 403: בדרך כלל פרוקסי או מסנן רשת שחוסם את המארח, או ש-Claude Code אינו זמין באזור שלך
• 5xx: בדרך כלל תקלת שירות זמנית, המתן מספר דקות ונסה שוב

אם אינך רואה שום פלט, מופיע Could not resolve host, או שחלה פקיעת זמן של החיבור (timeout), הרשת שלך חוסמת את החיבור. גורמים נפוצים:

• חומות אש ארגוניות או שרתי פרוקסי החוסמים את downloads.claude.ai
• הגבלות רשת אזוריות: נסה VPN או רשת חלופית
• בעיות TLS/SSL: עדכן את אישורי ה-CA של המערכת שלך, או בדוק אם HTTPS_PROXY מוגדר

אם אתה מאחורי פרוקסי ארגוני, הגדר את HTTPS_PROXY ואת HTTP_PROXY לכתובת הפרוקסי שלך לפני ההתקנה. בקש מצוות ה-IT שלך את כתובת ה-URL של הפרוקסי אם אינך יודע אותה, או בדוק את הגדרות הפרוקסי בדפדפן שלך.

דוגמה זו מגדירה את שני משתני הפרוקסי, ולאחר מכן מפעילה את המתקין דרך הפרוקסי שלך:

macOS/Linux:

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

$env:HTTP_PROXY = 'http://proxy.example.com:8080'
$env:HTTPS_PROXY = 'http://proxy.example.com:8080'
irm https://claude.ai/install.ps1 | iex

#ודא את ה-PATH שלך

אם ההתקנה הצליחה אך אתה מקבל שגיאת command not found או not recognized בעת הרצת claude, ספריית ההתקנה אינה נמצאת ב-PATH שלך. המעטפת שלך מחפשת תוכניות בספריות הרשומות ב-PATH, והמתקין מציב את claude בנתיב ~/.local/bin/claude ב-macOS/Linux או בנתיב %USERPROFILE%\.local\bin\claude.exe ב-Windows.

הערה: הרחבת VS Code אינה מציבה את claude במיקום זה. היא כוללת עותק פרטי של ה-CLI בתוך ספריית ההרחבה עבור חלונית הצ'אט שלה ואינה מוסיפה אותו ל-PATH. אם התקנת רק את ההרחבה, הנתיב ~/.local/bin/claude לא יהיה קיים. הפעל את ההתקנה העצמאית כדי להשתמש ב-claude מתוך טרמינל, ולאחר מכן המשך להלן.

בדוק אם ספריית ההתקנה נמצאת ב-PATH שלך על ידי הצגת רשומות ה-PATH וסינון עבור local/bin:

macOS/Linux:

echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

אם זה מדפיס /Users/you/.local/bin או /home/you/.local/bin, הספרייה נמצאת ב-PATH שלך ואתה יכול לדלג אל בדוק אם יש התקנות מתנגשות. אם אין פלט, הוסף אותה לתצורת המעטפת שלך.

עבור Zsh, ברירת המחדל ב-macOS:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

עבור Bash, ברירת המחדל ברוב הפצות Linux:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

לחלופין, סגור ופתח מחדש את הטרמינל שלך.

עבור מעטפות אחרות כגון fish או Nushell, הוסף את ~/.local/bin ל-PATH שלך באמצעות תחביר התצורה של המעטפת שלך, ולאחר מכן הפעל מחדש את הטרמינל.

ודא שהתיקון עבד:

claude --version

Windows PowerShell:

$env:PATH -split ';' | Select-String '\.local\\bin'

אם אין פלט, הוסף את ספריית ההתקנה ל-PATH של המשתמש שלך:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

הפעל מחדש את הטרמינל כדי שהשינוי ייכנס לתוקף.

ודא שהתיקון עבד:

claude --version

Windows CMD:

echo %PATH% | findstr /i "local\bin"

אם אין פלט, פתח את הגדרות המערכת (System Settings), עבור אל משתני סביבה (Environment Variables), והוסף את %USERPROFILE%\.local\bin למשתנה ה-PATH של המשתמש שלך. הפעל מחדש את הטרמינל.

ודא שהתיקון עבד:

claude --version

#בדוק אם יש התקנות מתנגשות

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

macOS/Linux:

הצג את כל הקבצים הבינאריים של claude שנמצאו ב-PATH שלך:

which -a claude

אם זה אינו מדפיס דבר, אין עדיין claude ב-PATH שלך. חזור אל ודא את ה-PATH שלך.

בדוק את שלושת המיקומים שמהם בינארי של claude יכול להגיע. ~/.local/bin/claude הוא המתקין המקורי, ~/.claude/local/ היא התקנת npm מקומית מדור קודם שנוצרה על ידי גרסאות ישנות יותר של Claude Code, ורשימת ה-npm הגלובלית מציגה התקנת -g:

ls -la ~/.local/bin/claude

התקנה מקורית מציגה קישור סימבולי (symlink) אל תוך ~/.local/share/claude/versions/. סקריפט או קישור סימבולי שיצרת בעצמך בנתיב זה הוא מפעיל מותאם אישית, שעדכון אוטומטי משאיר במקומו.

אם אחת מפקודות ה-ls מדפיסה No such file or directory, זו אינה שגיאה. המשמעות היא ששום דבר אינו מותקן במיקום זה, לכן המשך לבדיקה הבאה.

ls -la ~/.claude/local/

npm -g ls @anthropic-ai/claude-code 2>/dev/null

Windows PowerShell:

הצג את כל הקבצים הבינאריים של claude שנמצאו ב-PATH שלך:

where.exe claude

בדוק אם המתקין המקורי הציב קובץ בינארי:

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

אם אתה מוצא מספר התקנות, שמור רק אחת. ההתקנה המקורית ב-~/.local/bin/claude ב-macOS/Linux או ב-%USERPROFILE%\.local\bin\claude.exe ב-Windows היא המומלצת. הסר את ההתקנות המיותרות:

הסר התקנת npm גלובלית:

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

הסר את התקנת ה-npm המקומית מדור קודם:

macOS/Linux:

rm -rf ~/.claude/local

Windows PowerShell:

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local"

הסר התקנת Homebrew ב-macOS. אם התקנת את ה-cask בשם claude-code@latest, החלף בשם זה:

brew uninstall --cask claude-code

הסר התקנת WinGet ב-Windows:

winget uninstall Anthropic.ClaudeCode

#בדוק הרשאות ספריות

המתקין זקוק להרשאת כתיבה אל ~/.local/bin/ ואל ~/.claude/ ב-macOS וב-Linux. ב-Windows מיקום ההתקנה נמצא תחת %USERPROFILE%, שפתוח לכתיבה עבור המשתמש שלך כברירת מחדל, לכן סעיף זה כמעט ואינו רלוונטי שם.

בדוק אם הספריות פתוחות לכתיבה:

test -w ~/.local/bin && echo "writable" || echo "not writable"
test -w ~/.claude && echo "writable" || echo "not writable"

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

sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.local

#ודא שהקובץ הבינארי עובד

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

ודא שהקובץ הבינארי קיים וניתן להפעלה:

macOS/Linux:

ls -la "$(command -v claude)"

Windows PowerShell:

Get-Command claude | Select-Object Source

ב-Linux, בדוק אם חסרות ספריות משותפות. אם ldd מציג ספריות חסרות, ייתכן שתצטרך להתקין חבילות מערכת. ב-Alpine Linux ובהפצות אחרות המבוססות על musl, ראה הגדרת Alpine Linux.

ldd "$(command -v claude)" | grep "not found"

ודא שהקובץ הבינארי מסוגל לרוץ:

claude --version

#בעיות התקנה נפוצות

אלו הן בעיות ההתקנה הנפוצות ביותר והפתרונות שלהן.

#סקריפט ההתקנה מחזיר HTML במקום סקריפט מעטפת

בעת הרצת פקודת ההתקנה, אתה עשוי לראות אחת מהשגיאות הבאות:

bash: line 1: syntax error near unexpected token `<'
bash: line 1: `<!DOCTYPE html>'

ב-PowerShell, אותה בעיה מופיעה כשגיאות פענוח המצביעות אל הדף שהוחזר, כאשר iex מנסה להריץ HTML ו-CSS בתור PowerShell:

iex : At line:1 char:2310
+ ... igin="anonymous"/><script type="text/javascript">!function(o,c){var n ...
Missing argument in parameter list.
...

הניסוח משתנה בהתאם לגרסת PowerShell ושפת המערכת: ייתכן שתראה Missing expression after unary operator '--' או ParserError עם ParseException במקום זאת. תגיות HTML או CSS בטקסט המצוטט מזהות כשל זה. אם תוריד באמצעות -OutFile install.ps1 במקום זאת, הקובץ השמור יהיה אותו דף אינטרנט, כך שגם זה לא יעזור.

בהתאם לאופן שבו הבקשה נותבה, ייתכן שבמקום זאת תראה 403 ללא גוף HTML:

curl: (22) The requested URL returned error: 403

כל אלה מצביעים על כך שכתובת ה-URL של ההתקנה החזירה דף HTML או סטטוס שגיאה במקום את סקריפט ההתקנה. אם דף ה-HTML מציג "App unavailable in region", ‏Claude Code אינו זמין במדינה שלך. ראה מדינות נתמכות.

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

אחרת, הדבר יכול להתרחש כתוצאה מבעיות רשת, ניתוב אזורי או שיבוש זמני בשירות.

פתרונות:

1. השתמש בשיטת התקנה חלופית:

   ב-macOS, התקן דרך Homebrew:

   העתק

   brew install --cask claude-code

   ב-Windows, התקן דרך WinGet:

   העתק

   winget install Anthropic.ClaudeCode

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

2. נסה שוב לאחר מספר דקות: הבעיה היא לעיתים קרובות זמנית. המתן ונסה שוב את הפקודה המקורית.

#command not found: claude לאחר ההתקנה

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

פירוש הדבר שספריית ההתקנה אינה נמצאת בנתיב החיפוש של המעטפת שלך. ראה ודא את ה-PATH שלך עבור התיקון בכל פלטפורמה.

#curl: (56) Failure writing output to destination

הפקודה curl ... | bash מורידה את הסקריפט ומעבירה אותו בצינור אל Bash להפעלה. שגיאה זו, והשגיאה הקשורה curl: (23) Failure writing output to destination, מעידות על כך ש-Bash לא קיבל את הסקריפט השלם. קוד יציאה 56 מציין שההורדה עצמה נקטעה, וקוד יציאה 23 מציין ש-curl לא הצליח לכתוב את מה שקיבל אל הצינור, בדרך כלל בגלל ש-Bash יצא מוקדם.

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

#Homebrew cask אינו זמין או לא מעודכן

‏Homebrew מדווח על Error: Cask 'claude-code' is unavailable: No Cask with this name exists כאשר העותק המקומי שלך של אינדקס ה-cask של Homebrew קודם לפרסום ה-cask. רענן את האינדקס ונסה שוב:

brew update
brew install --cask claude-code

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

#שגיאות חיבור TLS או SSL

שגיאות כמו curl: (35) TLS connect error, schannel: next InitializeSecurityContext failed, או שגיאת PowerShell של Could not establish trust relationship for the SSL/TLS secure channel מעידות על כשלי לחיצת יד של TLS.

פתרונות:

1. עדכן את אישורי ה-CA של המערכת שלך:

   ב-Ubuntu/Debian:

   העתק

   sudo apt-get update && sudo apt-get install ca-certificates

   ב-macOS, ה-curl של המערכת משתמש במאגר המהימן של ה-Keychain, עדכון של macOS עצמה מעדכן את אישורי השורש.

2. ב-Windows, הפעל את TLS 1.2 ב-PowerShell לפני הרצת המתקין:

   העתק

   [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
   irm https://claude.ai/install.ps1 | iex

3. בדוק הפרעות מצד פרוקסי או חומת אש: שרתי פרוקסי ארגוניים המבצעים בדיקת TLS עלולים לגרום לשגיאות אלו, כולל unable to get local issuer certificate ו-SELF_SIGNED_CERT_IN_CHAIN. עבור שלב ההתקנה, הגדר להורדת ההתקנה לתת אמון ב-CA של הפרוקסי הארגוני שלך:

   macOS/Linux:

   העתק

   curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash

   Windows PowerShell:

   מתקין ה-PowerShell מוריד דרך .NET, אשר מאמת TLS מול מאגר האישורים של Windows. בקש מצוות ה-IT שלך להוסיף את אישור ה-CA של הפרוקסי למאגר של Windows אם הוא אינו נמצא שם כבר, ולאחר מכן הפעל את המתקין:

   העתק

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

   עבור Claude Code עצמו לאחר שהותקן, הגדר את NODE_EXTRA_CA_CERTS כך שבקשות API יתנו אמון באותה חבילה:

   macOS/Linux:

   העתק

   export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem

   Windows PowerShell:

   העתק

   $env:NODE_EXTRA_CA_CERTS = 'C:\path\to\corporate-ca.pem'

   בקש מצוות ה-IT שלך את קובץ האישור אם אין לך אותו. באפשרותך גם לנסות בחיבור ישיר כדי לוודא שהפרוקסי הוא אכן הגורם.

4. ב-Windows, עקוף בדיקות ביטול חסומות. השגיאות CRYPT_E_NO_REVOCATION_CHECK (0x80092012) ו-CRYPT_E_REVOCATION_OFFLINE (0x80092013) מצביעות על כך ש-curl הגיע אל השרת אך הרשת שלך חוסמת את חיפוש ביטול האישור, דבר שנפוץ מאחורי חומות אש ארגוניות. אם הפקודה שנכשלת היא ה-curl שמוריד את install.cmd, הפעל אותה מחדש מתוך שורת הפקודה (Command Prompt) בתוספת --ssl-revoke-best-effort:

   העתק

   curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

   כאשר ההורדות הפנימיות של הסקריפט עצמו נתקלות באותן שגיאות, הוא מנסה אותן שוב באופן אוטומטי עם בדיקת ביטול בשיטת מיטב המאמצים (best-effort), כך שהדגל נחוץ רק בפקודה שאתה מריץ בעצמך. בדיקת מיטב המאמצים סובלת מצב שבו שרת הביטולים אינו נגיש, אך עדיין דוחה אישור שידוע כמבוטל, בדומה לאופן שבו דפדפנים מטפלים בביטול אישורים. באפשרותך גם להימנע לחלוטין מבדיקת הביטול של curl על ידי הרצת מתקין ה-PowerShell מתוך PowerShell, אשר מוריד דרך .NET ואינו נכשל כאשר שרת הביטולים אינו נגיש:

   העתק

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

   באפשרותך גם להתקין באמצעות winget install Anthropic.ClaudeCode, מה שנמנע משימוש ב-curl לחלוטין.

#Failed to fetch version from downloads.claude.ai

המתקין לא הצליח להגיע לשרת ההורדות. בדרך כלל פירוש הדבר הוא ש-downloads.claude.ai חסום ברשת שלך. ראה בדוק קישוריות רשת.

#פקודת התקנה שגויה ב-Windows

אם אתה רואה 'irm' is not recognized, The token '&&' is not valid, A parameter cannot be found that matches parameter name 'fsSL', או 'bash' is not recognized as the name of a cmdlet, העתקת את פקודת ההתקנה עבור מעטפת אחרת או מערכת הפעלה אחרת. אם הפקודה מדפיסה את הטקסט של הסקריפט במקום להתקין משהו, הרצת רק חלק ממנה.

• irm לא מזוהה: אתה נמצא ב-CMD ולא ב-PowerShell. עומדות בפניך שתי אפשרויות:

  פתח את PowerShell על ידי חיפוש "PowerShell" בתפריט התחלה, ולאחר מכן הרץ את פקודת ההתקנה המקורית:

  העתק

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

  או הישאר ב-CMD והשתמש במתקין של CMD במקום זאת:

  העתק

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

• && אינו תקף: אתה נמצא ב-PowerShell אך הרצת את פקודת המתקין של CMD. השתמש במתקין של PowerShell:

  העתק

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

• A parameter cannot be found that matches parameter name 'fsSL': הרצת את מתקין ה-macOS/Linux של curl -fsSL ... | bash בתוך Windows PowerShell, שבו curl הוא כינוי עבור Invoke-WebRequest ודוחה את הדגלים -fsSL. השתמש במתקין של PowerShell במקום זאת:

  העתק

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

• bash לא מזוהה: הרצת את המתקין של macOS/Linux ב-Windows. השתמש במתקין של PowerShell במקום זאת:

  העתק

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

• הפקודה מדפיסה טקסט של סקריפט במקום להתקין: הרצת את חלק ההורדה של הפקודה ללא החלק שמבצע אותה. הפקודה irm https://claude.ai/install.ps1 בפני עצמה מדפיסה את הסקריפט שהורד לטרמינל. העבר אותה בצינור אל iex כדי להריץ אותה:

  העתק

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

  ב-CMD, הפקודה curl -fsSL https://claude.ai/install.cmd ללא -o מדפיסה את סקריפט ה-batch במקום לשמור אותו. הרץ את הפקודה המלאה:

  העתק

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

בכל מתקין שתבחר להשתמש, ודא שהוא עבד: פתח טרמינל חדש והרץ claude --version, מה שמדפיס מספר גרסה כגון 2.1.211 (Claude Code).

#running scripts is disabled on this system

התקנה או הרצה של Claude Code דרך npm ב-Windows עלולה להיכשל עם SecurityError:

npm : File C:\Program Files\nodejs\npm.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.
...
    + CategoryInfo          : SecurityError: (:) [], PSSecurityException

אותה שגיאה מציינת את claude.ps1 כאשר אתה מריץ את claude לאחר התקנת npm. מדיניות ביצוע הסקריפטים של PowerShell חוסמת את סקריפטי ההפעלה מסוג .ps1 ש-npm יוצר עבור הפקודות שלו. המדיניות חלה על קובצי סקריפט, לכן היא אינה משפיעה על מתקין ה-PowerShell irm https://claude.ai/install.ps1 | iex, אשר מריץ ישירות את הטקסט שהורד.

פתרונות:

1. אפשר סקריפטים שנוצרו מקומית עבור המשתמש שלך, ולאחר מכן נסה שוב:

   העתק

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

2. קרא למפעיל ה-.cmd במקום זאת: npm.cmd ו-claude.cmd מבצעים את אותה הפעולה, והמדיניות אינה חלה עליהם.

3. השתמש במתקין PowerShell במקום ב-npm. הוא מתקין קובץ בינארי ולא סקריפט מסוג .ps1.

#The process cannot access the file במהלך התקנה ב-Windows

אם מתקין ה-PowerShell נכשל עם Failed to download binary: The process cannot access the file ... because it is being used by another process, המתקין לא הצליח לכתוב אל %USERPROFILE%\.claude\downloads. פירוש הדבר בדרך כלל הוא שניסיון התקנה קודם עדיין פועל, או שתוכנת אנטי וירוס סורקת קובץ בינארי שהורד חלקית בתיקייה זו.

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

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex

#ההתקנה נהרגה (Killed) בשרתי Linux בעלי זיכרון מועט

הודעת Killed במהלך ההתקנה פירושה בדרך כלל שרוצח ה-OOM (out-of-memory killer) של Linux עצר את שלב claude install מכיוון שאזל הזיכרון הפנוי במערכת. דבר זה נפוץ בשרתי VPS ובמופעי ענן קטנים. סקריפט ההתקנה מדווח על הסיבה ויוצא עם קוד 137. בדוגמה זו, מספר השורה ומזהה התהליך משתנים בין מהדורות והרצות:

Setting up Claude Code...
bash: line 183: 34803 Killed    "$binary_path" install ${TARGET:+"$TARGET"}
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

ההתקנה דורשת בערך 512 MB של זיכרון פנוי, והרצת Claude Code דורשת יותר. ראה את דרישות המערכת.

פתרונות:

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

   צור קובץ swap של 2 GB והפעל אותו:

   העתק

   sudo fallocate -l 2G /swapfile
   sudo chmod 600 /swapfile
   sudo mkswap /swapfile
   sudo swapon /swapfile

   לאחר מכן נסה את ההתקנה שוב:

   העתק

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

2. סגור תהליכים אחרים כדי לפנות זיכרון לפני ההתקנה.

3. השתמש במופע גדול יותר אם הדבר אפשרי. ‏Claude Code דורש לפחות 4 GB של RAM.

#ההתקנה נתקעת ב-Docker

בעת התקנת Claude Code בתוך קונטיינר של Docker, התקנה בתור root אל תוך / עלולה לגרום לתקיעות.

פתרונות:

1. הגדר ספריית עבודה לפני הפעלת המתקין. כאשר הוא מופעל מתוך /, המתקין סורק את כל מערכת הקבצים, מה שגורם לשימוש מופרז בזיכרון. הגדרת WORKDIR מגבילה את הסריקה לספרייה קטנה:

   העתק

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

2. הקצה ל-Docker יותר זיכרון אם אתה משתמש ב-Docker Desktop. קונטיינרים של בנייה חולקים את הזיכרון שהוקצה למכונה הווירטואלית של Docker Desktop, לכן פתח את Settings > Resources ב-Docker Desktop, העלה את מגבלת הזיכרון, והרץ את הבנייה מחדש.

#Raw mode is not supported במהלך ההתקנה

כאשר הגדרות מנוהלות שרת של הארגון שלך כוללות שינויים שדורשים אישור אבטחה, גרסאות Claude Code שלפני 2.1.246 מנסות להציג את תיבת הדו שיח של האישור במהלך claude install. תיבת הדו שיח דורשת טרמינל ב-stdin. כאשר המתקין מריץ את claude install מתוך צינור, כפי ש-curl -fsSL https://claude.ai/install.sh | bash עושה, ה-stdin הוא הצינור ולא טרמינל, ולכן ההתקנה נכשלת עם שגיאה המכילה Raw mode is not supported.

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

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

macOS/Linux:

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

Windows PowerShell:

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

הפקודה claude --version מדפיסה את הגרסה שההרצה החוזרת התקינה.

#claude update או claude doctor נתקעים

הפקודות claude update ו-claude doctor סורקות את קובצי תצורת המעטפת שלך לאיתור כינוי לא מעודכן של claude: הקבצים ~/.zshrc, ~/.bashrc ו-~/.config/fish/config.fish, ובנוסף ב-macOS הראשון מבין הקבצים ~/.bash_profile, ~/.bash_login או ~/.profile שקיים. אם הגדרת את ZDOTDIR, קובץ ה-Zsh הוא $ZDOTDIR/.zshrc במקום זאת. כאשר אחד מהנתיבים הללו הוא ספרייה, Claude Code מדלג עליו ושתי הפקודות מסתיימות כרגיל. לפני גרסה v2.1.214, ספרייה באחד מהנתיבים הללו גרמה לשתי הפקודות להיתקע והותירה את מקטע הדיאגנוסטיקה של המערכת בפקודה /status ריק. הפקודה claude doctor נתקעה ללא שום פלט, ו-claude update נתקע מיד לאחר הדפסת Checking for updates.

אם נתקלת בתקיעה זו בגרסה מוקדמת יותר, מצא את הספרייה. בפלט של פקודה זו, שורה המתחילה באות d מסמנת נתיב זה כספרייה. שורה של No such file or directory פירושה ששום דבר אינו קיים בנתיב זה ואינה הסיבה:

ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish

העבר את הספרייה הצידה, או עדכן לגרסה v2.1.214 ומעלה. מכיוון ש-claude update נתקע בגרסאות המושפעות, עדכן על ידי הרצה מחדש של סקריפט ההתקנה במקום זאת.

#Claude Desktop עוקף את הפקודה claude ב-Windows

אם התקנת גרסה ישנה יותר של Claude Desktop, היא עשויה לרשום קובץ Claude.exe בספריית WindowsApps שמקבל עדיפות ב-PATH על פני ה-CLI של Claude Code. הרצת claude פותחת את אפליקציית הדסקטופ במקום את ה-CLI.

עדכן את Claude Desktop לגרסה העדכנית ביותר כדי לתקן בעיה זו.

#Claude Code ב-Windows דורש Git for Windows (עבור bash) או PowerShell

התוכנה Git for Windows היא אופציונלית. ‏Claude Code משתמש בכלי ה-PowerShell כאשר Git Bash אינו נוכח, ולכן שגיאה זו מעידה על כך שאף אחת מהמעטפות לא נמצאה.

אם PowerShell חסר ב-PATH שלך, מיקום ברירת המחדל שלו הוא C:\Windows\System32\WindowsPowerShell\v1.0\. הוסף ספרייה זו ל-PATH שלך, או התקן את PowerShell 7, המספק את pwsh.

כדי להתקין Git for Windows במקום זאת, הורד אותו מ-git-scm.com/downloads/win. במהלך ההתקנה, בחר "Add to PATH". הפעל מחדש את הטרמינל לאחר ההתקנה. התקנתו מאפשרת את כלי ה-Bash, שימושי בעבודה עם סקריפטים וכלים המבוססים על Bash.

אם Git כבר מותקן אך Claude Code אינו מוצא אותו, השווה את מיקומו מול המקומות ש-Claude Code בודק. כאשר CLAUDE_CODE_GIT_BASH_PATH אינו מוגדר, Claude Code מחפש את bash.exe בסדר הבא:

1. מיקומי ברירת המחדל של ההתקנה C:\Program Files\Git ו-C:\Program Files (x86)\Git.
2. ה-git שב-PATH שלך, תוך שימוש ב-bin\bash.exe מאותה התקנת Git.

בשלב 2, Claude Code מדלג על git שנמצא בתיקייה שממנה הפעלת את Claude Code, או מתחתיה בנתיב המכיל node_modules או תיקיית סביבה וירטואלית כגון .venv או env, לדוגמה C:\dev\env\myproject\Git כאשר הפעלת מתוך C:\dev\env\myproject. הדבר מונע מ-Claude Code להריץ קובץ הפעלה שפרויקט הציב שם. אם ה-Git שלך נמצא במיקום כזה, כוון את CLAUDE_CODE_GIT_BASH_PATH אליו.

כדי לכוון את Claude Code להתקנת Git ספציפית, מצא אותה על ידי הרצת where.exe git ב-PowerShell, ולאחר מכן הגדר את הנתיב של bin\bash.exe מאותה התקנה בתור CLAUDE_CODE_GIT_BASH_PATH בתוך קובץ settings.json שלך:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

אם CLAUDE_CODE_GIT_BASH_PATH מוגדר לנתיב הנכון והקובץ קיים אך Claude Code עדיין אינו משתמש בו, בדוק תחילה את שם הקובץ. ‏Claude Code מקבל רק קובץ בשם bash.exe, sh.exe, bash או sh. בכל שם אחר, כגון מפעיל git-bash.exe של Git for Windows, הוא מתעלם מהמשתנה ומזהה אוטומטית את Git Bash כאילו המשתנה לא הוגדר, תוך רישום אזהרה ביומן שנראית באמצעות --debug. נתיב שאינו קיים מקבל את אותה נסיגה (fallback) ואזהרה. לפני גרסה v2.1.219, ‏Claude Code השתמש בכל קובץ קיים כמעטפת מבלי לבדוק את שמו, ויצא בעת ההפעלה עם Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path כאשר הנתיב לא היה קיים.

אם שם הקובץ תקין, ייתכן שתוכנת אבטחת נקודות קצה כגון AppLocker, מדיניות הגבלת תוכנה של מדיניות קבוצתית (Group Policy), או סוכני EDR מפריעים. בקש מצוות ה-IT שלך להכניס לרשימת ההיתרים את claude.exe ואת התהליכים שהוא מייצר, כולל cmd.exe ו-bash.exe, במדיניות הגנת נקודות הקצה שלך.

#Claude Code אינו תומך ב-Windows בגרסת 32 סיביות

מערכת Windows כוללת שתי רשומות PowerShell בתפריט התחלה: Windows PowerShell ו-Windows PowerShell (x86). הרשומה של x86 רצה כתהליך של 32 סיביות ומפעילה שגיאה זו אפילו במחשב של 64 סיביות. כדי לבדוק באיזה מקרה אתה נמצא, הרץ זאת באותו חלון שיצר את השגיאה:

[Environment]::Is64BitOperatingSystem

אם זה מדפיס True, מערכת ההפעלה שלך תקינה. סגור את החלון, פתח את Windows PowerShell ללא הסיומת x86, והרץ את פקודת ההתקנה שוב.

אם זה מדפיס False, אתה נמצא במהדורת 32 סיביות של Windows. ‏Claude Code דורש מערכת הפעלה של 64 סיביות. ראה את דרישות המערכת.

#אי התאמה של בינארי musl או glibc ב-Linux

אם אתה רואה שגיאות לגבי ספריות משותפות חסרות כמו libstdc++.so.6 או libgcc_s.so.1 לאחר ההתקנה, ייתכן שהמתקין הוריד גרסת בינארי שגויה עבור המערכת שלך.

Error loading shared library libstdc++.so.6: No such file or directory

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

פתרונות:

1. בדוק באיזו libc המערכת שלך משתמשת:

   העתק

   ldd --version 2>&1 | head -1

   פלט המציין GNU libc או GLIBC פירושו glibc. פלט המציין musl פירושו musl.

2. אם אתה נמצא על glibc אך קיבלת את הבינארי של musl, הסר את ההתקנה והתקן מחדש. באפשרותך גם להוריד ידנית את הבינארי הנכון באמצעות המניפסט בכתובת https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json. פתח דיווח ב-GitHub עם הפלט של ldd --version ושל ls /lib/libc.musl*.

3. אם אתה אכן נמצא על musl, כגון Alpine Linux, התקן את החבילות הנדרשות:

   העתק

   apk add libgcc libstdc++ ripgrep

   ב-Alpine, החבילה ripgrep נמצאת במאגר הקהילה. אם apk מדווח שהחבילה חסרה, ראה הגדרת Alpine Linux.

#Illegal instruction

אם הרצת claude או המתקין מדפיסה Illegal instruction, הקובץ הבינארי המקורי משתמש בהוראות CPU שהמעבד שלך אינו תומך בהן. ישנם שני גורמים שונים.

אי התאמה בארכיטקטורה. המתקין הוריד את הבינארי הלא נכון, לדוגמה x86 בשרת ARM. בדוק בעזרת uname -m ב-macOS או ב-Linux, או בעזרת $env:PROCESSOR_ARCHITECTURE ב-PowerShell. אם התוצאה אינה תואמת לבינארי שקיבלת, פתח דיווח ב-GitHub עם הפלט.

ערכת הוראות AVX חסרה. אם הארכיטקטורה שלך נכונה אך אתה עדיין רואה Illegal instruction, ככל הנראה ל-CPU שלך חסרה תמיכה ב-AVX או בהוראה אחרת שהבינארי דורש. הדבר משפיע בערך על מעבדי Intel ו-AMD מלפני שנת 2013, ועל מכונות וירטואליות שבהן מנהל המכונות הווירטואליות (hypervisor) אינו מעביר את תמיכת AVX למערכת האורחת.

בשרת VPS או במכונה וירטואלית, הרץ grep -m1 -ow avx /proc/cpuinfo. תוצאה ריקה פירושה ש-AVX אינו זמין למערכת האורחת.

אין מעקף לקובץ הבינארי המקורי. עקוב אחר דיווח מס' 50384 כדי לראות את הסטטוס, וכלול את דגם ה-CPU שלך מתוך grep -m1 "model name" /proc/cpuinfo ב-Linux או מתוך sysctl -n machdep.cpu.brand_string ב-macOS בעת הדיווח.

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

#dyld: cannot load ב-macOS

אם אתה רואה dyld: Symbol not found, dyld: cannot load, או Abort trap: 6 במהלך ההתקנה, הקובץ הבינארי אינו תואם לגרסת macOS או לחומרה שלך.

שגיאת Symbol not found המתייחסת אל libicucore פירושה שגרסת macOS שלך ישנה יותר ממה שהקובץ הבינארי תומך:

dyld: Symbol not found: _ubrk_clone
  Referenced from: claude-darwin-x64 (which was built for Mac OS X 13.0)
  Expected in: /usr/lib/libicucore.A.dylib

הטוען (loader) יכול במקום זאת לדחות את פקודות הטעינה של הבינארי, מה שמעיד גם כן על כך שגרסת ה-macOS שלך ישנה מדי:

dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)
Abort trap: 6

פתרונות:

1. בדוק את גרסת macOS שלך: ‏Claude Code דורש את macOS 13.0 ומעלה. פתח את תפריט Apple ובחר About This Mac כדי לבדוק את הגרסה שלך.
2. עדכן את macOS אם אתה בגרסה ישנה יותר. הקובץ הבינארי משתמש בפקודות טעינה ובספריות מערכת שגרסאות ישנות יותר של macOS אינן תומכות בהן. שיטות התקנה חלופיות כמו Homebrew מורידות את אותו קובץ בינארי ולא יפתרו שגיאה זו.

#Exec format error ב-WSL1

אם הרצת claude ב-WSL מדפיסה cannot execute binary file: Exec format error, אתה נמצא ב-WSL1 ונתקל ברגרסיה מוכרת בבינארי המקורי הנעקבת בדיווח מס' 38788. כותרות התוכנית של הבינארי השתנו באופן שטוען ה-WSL1 אינו מסוגל להתמודד איתו.

התיקון הנקי ביותר הוא להמיר את ההפצה שלך ל-WSL2 מתוך PowerShell:

wsl --set-version <DistroName> 2

אם אתה צריך להישאר ב-WSL1, הפעל את הבינארי דרך המקשר הדינמי. הוסף פונקציה זו אל ~/.bashrc בתוך WSL, תוך החלפת הנתיב אם ספריית הבית שלך שונה:

claude() {
  /lib64/ld-linux-x86-64.so.2 "$(readlink -f "$HOME/.local/bin/claude")" "$@"
}

לאחר מכן הרץ source ~/.bashrc ונסה להריץ שוב את claude.

#שגיאות התקנת npm ב-WSL

בעיות אלו חלות אם התקנת את Claude Code באמצעות npm install -g בתוך WSL. אם השתמשת במתקין המקורי, דלג על סעיף זה.

בעיות בזיהוי מערכת הפעלה או פלטפורמה. אם npm מדווח על אי התאמה של פלטפורמה במהלך ההתקנה, סביר להניח ש-WSL קולט את ה-npm של Windows. הרץ תחילה npm config set os linux, ולאחר מכן התקן באמצעות npm install -g @anthropic-ai/claude-code --force. אל תשתמש ב-sudo.

exec: node: not found בעת הרצת claude. סביבת ה-WSL שלך משתמשת ככל הנראה בהתקנת ה-Windows של Node.js. ודא זאת באמצעות which npm ו-which node: נתיבים המתחילים ב-/mnt/c/ הם קבצים בינאריים של Windows, בעוד שנתיבי Linux מתחילים ב-/usr/. כדי לתקן זאת, התקן את Node דרך מנהל החבילות של הפצת ה-Linux שלך או דרך nvm.

התנגשויות גרסאות nvm. אם מותקן אצלך nvm גם ב-WSL וגם ב-Windows, החלפת גרסאות Node ב-WSL עלולה להישבר מכיוון ש-WSL מייבא את ה-PATH של Windows כברירת מחדל וה-nvm של Windows מקבל עדיפות. הסיבה הנפוצה ביותר היא ש-nvm אינו נטען במעטפת שלך. הוסף את טוען ה-nvm אל ~/.bashrc או ~/.zshrc:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

או טען אותו בהפעלה הנוכחית שלך:

source ~/.nvm/nvm.sh

אם nvm נטען אך נתיבי Windows עדיין מקבלים עדיפות, הקדם את נתיב ה-Node של Linux באופן מפורש:

export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"

אזהרה: הימנע מביטול ייבוא ה-PATH של Windows באמצעות appendWindowsPath = false מכיוון שהדבר שובר את היכולת לקרוא לקובצי הפעלה של Windows מתוך WSL. באופן דומה, הימנע מהסרת התקנת Node.js מ-Windows אם אתה משתמש בו לפיתוח ב-Windows.

#שגיאות הרשאה במהלך ההתקנה

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

אם התקנת בעבר באמצעות npm ואתה נתקל בשגיאות הרשאה ייעודיות ל-npm, עבור למתקין המקורי:

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

#בינארי מקורי לא נמצא לאחר התקנת npm

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

Error: claude native binary not installed.

Either postinstall did not run (--ignore-scripts, some pnpm configs)
or the platform-native optional dependency was not downloaded
(--omit=optional).

Run the postinstall manually (adjust path for local vs global install):
  node node_modules/@anthropic-ai/claude-code/install.cjs

Or reinstall without --ignore-scripts / --omit=optional.

ב-Windows, הקובץ bin/claude.exe הוא אותו סקריפט מעטפת המשמש כמציין מקום במקום קובץ הפעלה אמיתי, לכן PowerShell ו-CMD מדווחים שאינם יכולים להריץ את הקובץ במקום להדפיס הודעה זו.

בדוק את הסיבות הבאות:

• תלויות אופציונליות מנוטרלות. הסר את --omit=optional מפקודת התקנת ה-npm שלך, את --no-optional מ-pnpm, או את --ignore-optional מ-yarn, ובדוק שקובץ .npmrc אינו מגדיר optional=false. לאחר מכן התקן מחדש. הקובץ הבינארי המקורי מסופק אך ורק כתלות אופציונלית, כך שאין חלופת JavaScript אם מדלגים עליו, והרצת install.cjs מחדש לא תוכל להציב בינארי שמעולם לא הורד.
• סקריפטי התקנה מנוטרלים. הדגל --ignore-scripts ותצורות pnpm מסוימות מדלגים על שלב ה-postinstall אך עדיין מורידים את חבילת הפלטפורמה. הרץ node node_modules/@anthropic-ai/claude-code/install.cjs כפי שההודעה מציעה, או התקן מחדש ללא הדגל. אם שלב ה-postinstall אינו יכול לרוץ בסביבה שלך כלל, node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs מוצא את החבילה שהורדה ומפעיל אותה, במחיר של תהליך Node נוסף בכל הפעלה. אם המעטפת מדפיסה Could not find native binary package במקום זאת, חבילת הפלטפורמה מעולם לא הורדה, לכן תקן תחילה את סיבת התלויות האופציונליות לעיל.
• פלטפורמה שאינה נתמכת. קבצים בינאריים שנבנו מראש מפורסמים עבור darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64 ו-win32-arm64. ‏Claude Code אינו מספק בינארי עבור פלטפורמות אחרות. ראה את דרישות המערכת. ב-FreeBSD, המתקין מדווח על הפלטפורמה כלא נתמכת. לפני גרסה v2.1.205, הוא התייחס ל-FreeBSD בתור Linux והוריד קובץ בינארי שלא יכול היה לרוץ.
• מראה ארגונית של npm חסרה את חבילות הפלטפורמה. ודא שה-registry שלך משקף את כל שמונה חבילות הפלטפורמה של @anthropic-ai/claude-code-* בנוסף לחבילת המטא.

#שגיאת ENOTEMPTY של npm במהלך עדכון או התקנה מחדש

כאשר אתה מריץ npm install -g @anthropic-ai/claude-code על גבי התקנה קיימת, npm עלול להיכשל בעת העברת ספריית החבילה הישנה הצידה:

npm error code ENOTEMPTY
npm error syscall rename
npm error path /home/you/.nvm/versions/node/v22.13.1/lib/node_modules/@anthropic-ai/claude-code
npm error dest /home/you/.nvm/versions/node/v22.13.1/lib/node_modules/@anthropic-ai/.claude-code-tVWAnUUt
npm error errno -39
npm error ENOTEMPTY: directory not empty, rename '...'

השורה npm error path מציינת את הספרייה ש-npm לא הצליח להעביר. מחק את הספרייה הזו וכל ספריית .claude-code-* שנותרה לצידה, שהרצות מוקדמות יותר שנקטעו עלולות להשאיר אחריהן. הפקודות שלהלן מוצאות את ספריית החבילות הגלובלית שלך באמצעות npm root -g. אם הספרייה ששורת ה-npm error path מציינת אינה תחת הספרייה ש-npm root -g מדפיס, למשל בגלל שהחלפת גרסאות Node באמצעות nvm, מחק במקום זאת את הספריות שהשגיאה מציינת:

macOS/Linux:

rm -rf "$(npm root -g)/@anthropic-ai/claude-code"

לאחר מכן הסר ספריות זמניות שנותרו. אם zsh מדפיס no matches found, לא היו כאלה להסרה:

rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*

Windows PowerShell:

Remove-Item -Recurse -Force "$(npm root -g)/@anthropic-ai/claude-code", "$(npm root -g)/@anthropic-ai/.claude-code-*"

לאחר מכן התקן מחדש:

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

ודא באמצעות claude --version, מה שמדפיס מספר גרסה כגון 2.1.211 (Claude Code).

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

סעיפים אלה עוסקים בכשלי התחברות, שגיאות OAuth ובעיות בטוקנים.

#אפס את ההתחברות שלך

כאשר ההתחברות נכשלת והסיבה אינה ברורה, אימות מחדש ונקי פותר את רוב המקרים:

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

אם הדפדפן אינו נפתח אוטומטית במהלך ההתחברות, לחץ על c כדי להעתיק את כתובת ה-OAuth ללוח שלך, ולאחר מכן הדבק אותה בדפדפן באופן ידני. דבר זה עובד גם כאשר כתובת ה-URL נשברת על פני מספר שורות בטרמינל צר או בטרמינל SSH ולא ניתן ללחוץ עליה ישירות.

#OAuth error: Invalid code

אם אתה רואה OAuth error: Invalid code. Please make sure the full code was copied, קוד ההתחברות פג תוקף או נקטע במהלך ההעתקה וההדבקה.

פתרונות:

• לחץ על Enter כדי לנסות שוב והשלם את ההתחברות במהירות לאחר שהדפדפן נפתח
• הקלד c כדי להעתיק את כתובת ה-URL המלאה אם הדפדפן אינו נפתח אוטומטית
• אם אתה משתמש בהפעלת remote/SSH, הדפדפן עשוי להיפתח במחשב הלא נכון. העתק את כתובת ה-URL המוצגת בטרמינל ופתח אותה בדפדפן המקומי שלך במקום זאת.

#403 Forbidden לאחר התחברות

אם אתה רואה API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}} לאחר ההתחברות:

• משתמשי Claude Pro/Max: ודא שהמנוי שלך פעיל בכתובת claude.ai/settings
• משתמשי Anthropic Console: ודא שלחשבון שלך מוקצה התפקיד "Claude Code" או "Developer". מנהלים מקצים זאת ב-Anthropic Console תחת Settings ← Members.
• מאחורי פרוקסי: שרתי פרוקסי ארגוניים עלולים להפריע לבקשות API. ראה הגדרת תצורת רשת להגדרת פרוקסי.

#ארגון זה הושבת על אף מנוי פעיל (This organization has been disabled with an active subscription)

אם אתה רואה API Error: 400 ... "This organization has been disabled" למרות שיש לך מנוי Claude פעיל, משתנה הסביבה ANTHROPIC_API_KEY עוקף את המנוי שלך. הדבר קורה לעיתים קרובות כאשר מפתח API ישן ממעסיק קודם או מפרויקט קודם עדיין מוגדר בפרופיל המעטפת שלך.

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

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

macOS/Linux:

unset ANTHROPIC_API_KEY
claude

Windows PowerShell:

Remove-Item Env:ANTHROPIC_API_KEY
claude

בדוק את הקבצים ~/.zshrc, ~/.bashrc או ~/.profile לאיתור שורות export ANTHROPIC_API_KEY=... והסר אותן כדי להפוך את השינוי לקבוע. ב-Windows, בדוק את פרופיל ה-PowerShell שלך ב-$PROFILE ואת משתני הסביבה של המשתמש עבור ANTHROPIC_API_KEY. הרץ /status בתוך Claude Code כדי לוודא איזו שיטת אימות פעילה.

#התחברות OAuth נכשלת ב-WSL2, ב-SSH או בקונטיינרים

כאשר Claude Code פועל ב-WSL2, במכונה מרוחקת דרך SSH או בתוך קונטיינר, הדפדפן נפתח בדרך כלל במארח אחר וההפניה מחדש שלו אינה יכולה להגיע אל שרת ה-callback המקומי של Claude Code. לאחר שאתה מתחבר, הדפדפן מציג קוד התחברות במקום להפנות חזרה אוטומטית. הדבק קוד זה בטרמינל בשורת ההנחיה Paste code here if prompted כדי להשלים את ההתחברות.

אם הדפדפן אינו נפתח כלל מתוך WSL2, הגדר את משתנה הסביבה BROWSER לנתיב הדפדפן שלך ב-Windows:

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude

לחלופין, לחץ על c בהנחיית ההתחברות האינטראקטיבית כדי להעתיק את כתובת ה-OAuth, או העתק את כתובת ה-URL ש-claude auth login מדפיס, ופתח אותה בדפדפן במחשב המקומי שלך.

אם הדבקת הקוד בהנחיה האינטראקטיבית אינה עושה דבר, סביר להניח שקיצור ההדבקה של הטרמינל שלך אינו מגיע לשדה הקלט. נסה את קיצור ההדבקה החלופי של הטרמינל שלך, לרוב קליק ימני או Shift+Insert ב-Windows Terminal, או השתמש ב-claude auth login במקום זאת, אשר קורא את הקוד המודבק מקלט סטנדרטי:

claude auth login

חלופה זו תקפה גם ב-Windows מקורי או בכל טרמינל שבו הדבקה בהנחיה האינטראקטיבית נכשלת.

#לא מחובר או שטוקן פג תוקף (Not logged in or token expired)

אם Claude Code מבקש ממך להתחבר שוב לאחר הפעלה, ייתכן שתוקף טוקן ה-OAuth שלך פג.

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

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

ב-macOS, ‏Claude Code שומר אישורי גישה ב-Keychain של ההתחברות. כאשר ה-Keychain דוחה את הכתיבה, כגון כאשר הוא נעול בהפעלת SSH או כאשר הסיסמה שלו אינה מסונכרנת עם סיסמת החשבון שלך, Claude Code שומר את ההתחברות שלך בקובץ הטקסט הפשוט ~/.claude/.credentials.json במקום זאת. התחברות לקונסול שיוצרת מפתח API תיכשל עד שה-Keychain יהיה פתוח שוב לכתיבה.

כדי להפוך את ה-Keychain לפתוח שוב לכתיבה ולהחזיר את ההתחברות שלך אל תוך ה-Keychain המוצפן:

1. בדוק גישה ל-Keychain: הרץ claude doctor כדי לבדוק גישה ל-Keychain. כאשר ה-Keychain דוחה כתיבה, הדוח מציג אזהרה המתחילה ב-macOS Keychain is not writable, ולאחריה הצעה לתיקון. כאשר הדוח אינו מציג אזהרת Keychain, ה-Keychain פתוח לכתיבה ואתה יכול לדלג לשלב האחרון.

2. בטל את נעילת ה-Keychain:

   העתק

   security unlock-keychain ~/Library/Keychains/login.keychain-db

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

3. סנכרן מחדש את סיסמת ה-Keychain אם ביטול הנעילה אינו עוזר: פתח את Keychain Access, בחר ב-keychain בשם login, ובחר ב-Edit > Change Password for Keychain "login" כדי לסנכרן אותה מחדש עם סיסמת החשבון שלך. לאחר מכן הרץ שוב את claude doctor. המשך לשלב הבא ברגע שהדוח כבר אינו מציג את אזהרת ה-Keychain.

4. התנתק והתחבר שוב: ברגע שה-Keychain פתוח שוב לכתיבה, Claude Code יעביר את אישורי הגישה חזרה בפעם הבאה שהוא יכתוב אישור גישה. כדי לאלץ זאת כעת, הרץ /logout ולאחר מכן /login. התנתקות מסירה את כל אישורי הגישה המאוחסנים, כולל תוכן קובץ הטקסט הפשוט, התחברויות שמורות של שרתי MCP, וערכים רגישים של תוספים, לכן צפה לאשר מחדש שרתי MCP ולהזין מחדש סודות של תוספים לאחר מכן. התחברות מחדש שומרת את ההתחברות שלך ב-Keychain.

#אישורי גישה עבור Bedrock, Agent Platform או Foundry אינם נטענים

אם הגדרת את Claude Code להשתמש בספק ענן ואתה רואה Could not load credentials from any providers ב-Amazon Bedrock, Could not load the default credentials ב-Google Cloud's Agent Platform, או ChainedTokenCredential authentication failed ב-Microsoft Foundry, סביר להניח שה-CLI של ספק הענן שלך אינו מאומת במעטפת הנוכחית.

עבור Amazon Bedrock, ודא שאישורי ה-AWS שלך תקפים:

aws sts get-caller-identity

עבור Agent Platform של Google Cloud, ודא ש-ANTHROPIC_VERTEX_PROJECT_ID ו-CLOUD_ML_REGION מוגדרים במעטפת שלך, ולאחר מכן הגדר אישורי ברירת מחדל של יישום:

gcloud auth application-default login

עבור Microsoft Foundry, ודא ש-ANTHROPIC_FOUNDRY_API_KEY מוגדר, או התחבר באמצעות Azure CLI כדי ששרשרת אישורי ברירת המחדל תוכל למצוא את החשבון שלך:

az login

אם אישורי הגישה עובדים בטרמינל שלך אך לא בהרחבה של VS Code או JetBrains, סביר להניח שתהליך ה-IDE לא ירש את סביבת המעטפת שלך. הגדר את משתני הסביבה של הספק בהגדרות של ה-IDE עצמו, או הפעל את ה-IDE מתוך טרמינל שבו הם כבר מיוצאים.

ראה Amazon Bedrock, Google Cloud's Agent Platform, או Microsoft Foundry להגדרה מלאה של הספקים.

#עדיין תקוע

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

1. בדוק במאגר GitHub בעיות מוכרות, או פתח בעיה חדשה עם מערכת ההפעלה שלך, פקודת ההתקנה שהרצת ופלט השגיאה המלא
2. אם claude --version עובד אך משהו אחר אינו תקין, הרץ claude doctor לקבלת דוח אבחון אוטומטי
3. אם באפשרותך להתחיל הפעלה, השתמש ב-/feedback בתוך Claude Code כדי לדווח על הבעיה
4. אם הבעיה היא בחשבון שלך ולא בהתקנה, כגון לולאת התחברות, מנוי שאינו מזוהה, או ארגון שהושבת, צור קשר עם התמיכה של Anthropic: התחבר בכתובת claude.ai (משתמשי קונסול: platform.claude.com), לחץ על ראשי התיבות של שמך בפינה השמאלית התחתונה, ובחר ב-Get help. ראה כיצד לקבל תמיכה לתהליך המלא.