⚡ פרק 2

התקנה והגדרה ראשונית

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

אפשר לדלג על הטרמינל ולהשתמש באפליקציית Claude Code Desktop: היא מתקינה את Claude Code ומפעילה אותו בממשק גרפי, בלי הגדרה בשורת הפקודה. ב-macOS מ-הורדת ה-dmg, ב-Windows מ-claude.com/download. ב-Linux מתקינים את האפליקציה עם apt לפי הוראות ההתקנה ל-Linux של אפליקציית שולחן העבודה בתיעוד הרשמי.

#לפני שמתחילים

ודא שיש לך:

• טרמינל או שורת פקודה פתוחים.
• פרויקט קוד לעבוד עליו.
• מנוי Claude (Pro, Max, Ultra, Team או Enterprise), חשבון Claude Console, או גישה דרך ספק ענן נתמך.

מקרים שמכוסים במקומות אחרים:

• מעולם לא השתמשת בטרמינל: התחל במדריך terminal guide הרשמי.
• רוצה את Claude Code לא רק בטרמינל: Claude Code זמין גם בדפדפן בכתובת https://claude.ai/code, כאפליקציית שולחן עבודה, ב-VS Code ובסביבות JetBrains, ב-Slack, וב-CI/CD עם GitHub Actions ו-GitLab. רשימת כל הממשקים נמצאת בתיעוד הרשמי תחת all interfaces.

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

#שלב 1: התקנת Claude Code

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

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

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

#מלכודות בזיהוי המעטפת ובהתקנה

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

• השגיאה The token '&&' is not a valid statement separator מופיעה כשהפקודה של CMD רצה ב-PowerShell. השתמש בפקודת PowerShell:

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

• השגיאה 'irm' is not recognized as an internal or external command מופיעה כשהפקודה רצה ב-CMD. אפשר לפתוח PowerShell (חיפוש "PowerShell" בתפריט התחל) ולהריץ את פקודת PowerShell, או להישאר ב-CMD ולהריץ:

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

• 'bash' is not recognized as the name of a cmdlet או A parameter cannot be found that matches parameter name 'fsSL' אומרים שהרצת את פקודת macOS/Linux ב-Windows. ב-PowerShell, curl הוא כינוי ל-Invoke-WebRequest ודוחה את הדגלים -fsSL. השתמש בפקודת PowerShell.
• irm https://claude.ai/install.ps1 לבד מדפיס את הסקריפט. צריך לנתב אותו אל iex. ב-CMD, curl בלי -o מדפיס את סקריפט ה-batch. הרץ את הפקודה המלאה.
• אם פקודת ההתקנה נכשלת עם syntax error near unexpected token '<', עם שגיאת iex או ParserError שמצטטת תגי HTML או CSS, עם The term 'System.Xml.XmlDocument' is not recognized, עם < was unexpected at this time ב-CMD, עם 403, עם curl: (22), עם curl: (23), עם curl: (56), או עם שגיאת curl אחרת, התאם את ההודעה בטבלה שבסעיף פתרון התקלות.

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

Git for Windows מומלץ ב-Windows מקורי, כדי ש-Claude Code יוכל להשתמש בכלי ה-Bash. אם Git for Windows אינו מותקן, Claude Code משתמש בכלי ה-PowerShell במקום. סביבות WSL אינן זקוקות ל-Git for Windows. השגיאה Claude Code on Windows requires either Git for Windows (for bash) or PowerShell אומרת שאף מעטפת לא נמצאה. איך Claude Code מחפש את bash.exe, ואיך מגדירים CLAUDE_CODE_GIT_BASH_PATH, נמצא בפתרון התקלות.

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

#Homebrew

brew install --cask claude-code

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

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

השגיאה Cask 'claude-code' is unavailable: No Cask with this name exists אומרת שהאינדקס המקומי ישן. רענן והתקן שוב:

brew update
brew install --cask claude-code

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

brew install --cask claude-code@latest

אם brew upgrade --cask claude-code@latest מדפיס Error: Cask 'claude-code@latest' is not installed., ה-cask הזה אינו מה שמותקן. כדי לראות איזה cask יש:

brew list --cask | grep claude-code

שדרג את השם שמודפס. אם אין פלט, אף אחד משני ה-casks אינו מותקן.

ההבדל בין שני ה-casks מפורט בתיעוד הרשמי תחת Configure release channel.

#WinGet

winget install Anthropic.ClaudeCode

התקנות WinGet אינן מתעדכנות אוטומטית. הרץ מעת לעת:

winget upgrade Anthropic.ClaudeCode

הפקודה מביאה תכונות חדשות ותיקוני אבטחה.

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

כדי לוודא שההתקנה עבדה, הרץ:

claude --version

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

#שלב 2: פתיחת הסשן הראשון

פתח את הטרמינל בתיקיית פרויקט כלשהי והפעל את Claude Code:

cd /path/to/your/project
claude

החלף את /path/to/your/project בנתיב הפרויקט שעליו אתה עובד.

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

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

• מנוי Claude Pro, Max, Ultra, Team או Enterprise (מומלץ)
• חשבון Claude Console: גישת API עם יתרת תשלום מראש (pre-paid credits). בהתחברות הראשונה נוצרת אוטומטית סביבת עבודה בשם "Claude Code" ב-Console, למעקב עלויות מרוכז
• Amazon Bedrock, Google Cloud's Agent Platform, או Microsoft Foundry (ספקי ענן ארגוניים)
• שער יישומים עצמאי (Claude apps gateway), אם הארגון מפעיל אחד: מנהל המערכת מגדיר מראש את כתובת השער, ו-/login נפתח ישירות במסך Cloud gateway להתחברות עם SSO ארגוני

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

מופיע הפרומפט של Claude Code, ומעליו הגרסה, המודל הנוכחי ותיקיית העבודה. הקלד /help לפקודות הזמינות, או /resume כדי להמשיך שיחה קודמת. כדי להחליף חשבון בהמשך או לאמת מחדש, הקלד /login בתוך הסשן הפעיל:

/login

אם הדפדפן לא נפתח, לחץ c כדי להעתיק את כתובת ה-OAuth, והדבק אותה בדפדפן. זה עובד גם כשהכתובת נשברת על פני שורות בטרמינל צר או ב-SSH ואי אפשר ללחוץ עליה. ב-WSL2, ב-SSH או בקונטיינר, אם הדפדפן לא נפתח, או שנפתח ואז מציג שגיאת חיבור לכתובת localhost, אפשר לסיים בלי לתקן את זה: פתח בדפדפן המקומי את כתובת ההתחברות שהטרמינל מציג מעל שורת ההדבקה, והדבק את הקוד בשורה שמתחילה ב-Paste code here.

#שלב 3: השאלה הראשונה

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

what does this project do?

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

what technologies does this project use?

where is the main entry point?

explain the folder structure

אפשר גם לשאול את Claude על היכולות שלו:

what can Claude Code do?

how do I create custom skills in Claude Code?

can Claude Code work with Docker?

Claude Code קורא את קבצי הפרויקט לפי הצורך. אין חובה להוסיף הקשר ידנית.

#שלב 4: שינוי הקוד הראשון

עכשיו תן ל-Claude Code לכתוב קוד. נסה משימה פשוטה:

add a hello world function to the main file

Claude Code מוצא את הקובץ המתאים ומציג את השינוי. אם הוא מבקש אישור לפני השינוי, בחר Yes.

מצב ההרשאות של הסשן קובע אילו פעולות Claude יכול לבצע בלי לשאול קודם. בכל רגע אפשר ללחוץ Shift+Tab כדי להחליף את מצב ההרשאות של הסשן הנוכחי.

#שלב 5: עבודה עם Git

Claude Code הופך פעולות Git לשיחה:

what files have I changed?

commit my changes with a descriptive message

אפשר גם לבקש פעולות Git מורכבות יותר:

create a new branch called feature/quickstart

show me the last 5 commits

help me resolve merge conflicts

#שלב 6: תיקון באג או הוספת יכולת

תאר במילים רגילות מה שאתה רוצה:

add input validation to the user registration form

או תקן בעיה קיימת:

there's a bug where users can submit empty forms - fix it

#שלב 7: תהליכי עבודה נפוצים נוספים

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

שינוי מבנה קוד (refactor)

refactor the authentication module to use async/await instead of callbacks

כתיבת בדיקות

write unit tests for the calculator functions

עדכון תיעוד

update the README with installation instructions

סקירת קוד

review my changes and suggest improvements

דבר עם Claude כמו עם עמית לעבודה. תאר מה אתה רוצה להשיג, והוא יעזור להגיע לשם.

#פתרון תקלות התקנה והתחברות

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

אם מעדיפים לדלג על הטרמינל לגמרי, אפליקציית Claude Code Desktop מתקינה את 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 את כתובת הפרוקסי אם אינה ידועה, או בדוק בהגדרות הפרוקסי בדפדפן.

הגדרת המשתנים והרצת המתקין דרך הפרוקסי:

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

השגיאה Failed to fetch version from downloads.claude.ai אומרת שהמתקין לא הגיע לשרת ההורדה. בדרך כלל downloads.claude.ai חסום ברשת. השתמש בבדיקה שלמעלה.

#תיקון PATH

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

המתקין מזהה את המקרה ומדווח עליו תחת Setup notes: בפלט: Native installation exists but ~/.local/bin is not in your PATH. ב-macOS וב-Linux, או Native installation exists but C:\Users\you\.local\bin is not in your PATH. ב-Windows. הוא מדפיס את התיקון עם ההערה הזו, ואינו משנה את ה-PATH בעצמו.

הודעת השגיאה לפי פלטפורמה:

ב-Windows, אם השגיאה התחילה מיד אחרי ש-Claude Code התעדכן, ראה שחזור claude.exe מהגיבוי בהמשך. אחרת המשך בתיקון ה-PATH שלהלן.

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

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

macOS ו-Linux:

ודא שהמתקין הציב את התוכנית:

ls -la ~/.local/bin/claude

• No such file or directory: אין התקנה מקורית. אם לא התקנת את Claude Code בדרך אחרת, כמו npm, Homebrew או מנהל חבילות של Linux, התקן אותו. אם התקנת בדרך אחרת, עבור לבדיקת התקנות כפולות.
• מופיעה שורה של הקובץ: התוכנית שם. המשך לבדיקת ה-PATH.

בדוק אם תיקיית ההתקנה נמצאת ב-PATH באמצעות סינון הרשימה:

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

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

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

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

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

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

ל-Bash ב-macOS, הוסף את השורה אל ~/.bash_profile. טרמינל ב-macOS מפעיל את Bash כמעטפת login, שמתעלמת מ-~/.bashrc וקוראת רק את הראשון מבין ~/.bash_profile, ~/.bash_login או ~/.profile שקיים. אם כבר יש לך ~/.bash_login או ~/.profile ואין ~/.bash_profile, הוסף את השורה לקובץ הקיים במקום ליצור ~/.bash_profile:

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

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

אם פקודת ה-echo מדפיסה permission denied, ראה הרשאת כתיבה בהוספה ל-PATH.

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

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

claude --version

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

• הטרמינל קדם לשינוי: חלון שכבר היה פתוח שומר את ה-PATH הישן, וטרמינל בתוך עורך לוקח את ה-PATH מהעורך. פתח חלון חדש, או צא מהעורך ופתח אותו מחדש.
• השורה לא נשמרה: הרץ grep -n '.local/bin' ~/.zshrc, עם שם הקובץ של המעטפת שלך. כשהשורה קיימת, הפקודה מדפיסה אותה עם מספר השורה. אם אין פלט, הרץ שוב את שתי פקודות ה-PATH.
• השורה נכתבה לקובץ של מעטפת אחרת: הרץ echo $0 כדי לראות את המעטפת, ואז הרץ את שתי פקודות ה-PATH של אותה מעטפת.

Windows PowerShell:

ודא שהמתקין הציב את התוכנית:

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

• False: אין התקנה מקורית. אם לא התקנת את Claude Code בדרך אחרת, כמו npm או WinGet, התקן אותו. אם התקנת בדרך אחרת, עבור לבדיקת התקנות כפולות.
• True: התוכנית שם. המשך לבדיקת ה-PATH.

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

אם מודפס C:\Users\you\.local\bin, התיקייה כבר ב-PATH ואפשר לדלג לבדיקת התקנות כפולות. אם אין פלט, הוסף את תיקיית ההתקנה ל-User PATH:

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

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

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

claude --version

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

• הטרמינל רץ בתוך עורך: הוא לוקח את ה-PATH מהעורך, אז צא מהעורך ופתח אותו מחדש.
• השינוי לא נשמר: הרץ [Environment]::GetEnvironmentVariable('PATH', 'User') וחפש .local\bin ב-PATH שמודפס. אם הוא חסר, הרץ שוב את שתי הפקודות.

Windows CMD:

ודא שהמתקין הציב את התוכנית:

dir "%USERPROFILE%\.local\bin\claude.exe"

• File Not Found או The system cannot find the path specified.: אין התקנה מקורית. אם לא התקנת את Claude Code בדרך אחרת, כמו npm או WinGet, התקן אותו. אם התקנת בדרך אחרת, עבור לבדיקת התקנות כפולות.
• מופיעה שורה של claude.exe: התוכנית שם. המשך לבדיקת ה-PATH.

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

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

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

claude --version

אם claude עדיין לא נמצא בטרמינל חדש, טרמינל בתוך עורך לוקח את ה-PATH מהעורך: צא מהעורך ופתח אותו מחדש.

#הרשאת כתיבה בהוספה ל-PATH

אם פקודת ה-echo שמוסיפה את ~/.local/bin ל-PATH מדפיסה zsh: permission denied: /Users/you/.zshrc או bash: /home/you/.bashrc: Permission denied, המשתמש שלך אינו יכול לכתוב לקובץ הזה ודבר לא נשמר. בטרמינל, בדוק מי הבעלים של הקובץ. החלף את ~/.zshrc בשם הקובץ של המעטפת שלך:

ls -l ~/.zshrc

השדה השלישי בפלט הוא הבעלים.

• הבעלים הוא משתמש אחר, למשל root: קח בעלות עם sudo chown $(whoami) ~/.zshrc. הפקודה דורשת הרשאות מנהל.
• הבעלים הוא אתה: הקובץ לקריאה בלבד. הפוך אותו לניתן לכתיבה עם chmod u+w ~/.zshrc.

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

#התקנות כפולות

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

macOS ו-Linux:

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

which -a claude

אם הפקודה מדפיסה claude not found, שורה no claude in, או כלום, אין claude ב-PATH. הבדיקות הבאות מראות אם בכלל מותקן עותק.

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

ls -la ~/.local/bin/claude

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

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

ls -la ~/.claude/local/

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

אם ls -la ~/.local/bin/claude הדפיס No such file or directory, אין התקנה מקורית. אם לא התקנת את Claude Code בדרך אחרת, כמו npm, Homebrew או מנהל חבילות של Linux, התקן אותו. אם ~/.local/bin/claude קיים אבל which -a claude לא הציג אותו, התיקייה אינה ב-PATH: ראה תיקון PATH.

Windows PowerShell:

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

where.exe claude

אם מודפס INFO: Could not find files for the given pattern(s)., אין claude ב-PATH.

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

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

• True: ההתקנה המקורית שם. אם where.exe לא מצא כלום, התיקייה אינה ב-PATH: ראה תיקון PATH.
• False: אין התקנה מקורית. אם לא התקנת את Claude Code בדרך אחרת, כמו npm או WinGet, התקן אותו.

אם נמצאו התקנות מרובות, השאר רק אחת. ההתקנה המקורית ב-~/.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

#הרשאות תיקיות

התקנה שנכשלת על הרשאות מציינת את הנתיב שלא הצליחה ליצור או לכתוב אליו. ב-Windows ההתקנה כותבת תחת %USERPROFILE%, שניתן לכתיבה למשתמש כברירת מחדל, ולכן הסעיף הזה חל שם לעיתים נדירות.

ב-macOS וב-Linux ההתקנה כותבת למיקומים הבאים:

• ~/.claude/downloads/: המקום שבו פקודת ההתקנה שומרת את הבינארי שהורד
• ~/.local/bin/: ה-launcher של claude
• ~/.local/share/claude/: כל גרסה שמורדת
• ~/.local/state/claude/: קובצי נעילה (lock files)
• ~/.cache/claude/: הורדות בתהליך (staged downloads)
• ~/.claude.json: קובץ התצורה הגלובלי, שבו המתקין מתעד את שיטת ההתקנה

אם מוגדרים משתני הסביבה XDG_DATA_HOME, XDG_STATE_HOME או XDG_CACHE_HOME, ההתקנה משתמשת בהם במקום ב-~/.local/share, ~/.local/state ו-~/.cache. אם מוגדר CLAUDE_CONFIG_DIR, קובץ התצורה הגלובלי נשמר תחת תיקייה זו במקום בתיקיית הבית.

בדוק אם התיקיות ניתנות לכתיבה:

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

אם המתקין המקורי נכשל בשגיאות הרשאה, זו הבדיקה. אם הותקן בעבר דרך npm ונתקלת בשגיאות הרשאה ייחודיות ל-npm, עבור למתקין המקורי:

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

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

אם 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 או Zsh: השגיאה מצטטת את השורה הראשונה של הדף שהוחזר.

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 שומרת את אותו דף אינטרנט, ולכן אינה פותרת את הבעיה.

PowerShell, System.Xml.XmlDocument: השגיאה מציינת את הטיפוס הזה במקום לצטט את הדף.

System.Xml.XmlDocument : The term 'System.Xml.XmlDocument' is not recognized as the name of a cmdlet, function, script
file, or operable program.

כש-irm מצליח לנתח את התשובה כ-XML, הוא מחזיר אובייקט XML במקום טקסט, ו-iex מנסה להריץ את שם הטיפוס של האובייקט כפקודה. סקריפט ההתקנה הוא קוד PowerShell ואינו מתפרש כ-XML, ולכן גם השגיאה הזו אומרת שהתשובה אינה הסקריפט. הניסוח סביב שם הטיפוס משתנה לפי גרסת PowerShell ושפת המערכת, אבל System.Xml.XmlDocument עצמו נשאר זהה: התאם לפי שם הטיפוס.

CMD: מופיעה השגיאה הזו, ואחריה ה-HTML של הדף שהוחזר.

< was unexpected at this time.

C:\Users\you><!DOCTYPE html>...

השורה הראשונה מופיעה בשפת המערכת, אז חפש את ה-HTML שאחריה.

403 בלי דף: בהתאם לניתוב הבקשה, curl מדווח על סטטוס 403 בלי גוף HTML.

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

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

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

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

פתרונות:

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

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

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

brew install --cask claude-code

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

winget install Anthropic.ClaudeCode

לאחר מכן הרץ claude --version כדי לוודא: הפקודה מדפיסה מספר גרסה כמו 2.1.211 (Claude Code). אם המעטפת מדווחת ש-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 בבדיקת הרשת למעלה. אם הגעת לשרת, הכשל המקורי כנראה היה זמני: נסה שוב את פקודת ההתקנה. אפשר גם להשתמש במתקין חלופי.

#החיבור נקטע בזמן הורדת העדכון

החיבור לשרת ההורדה נסגר בזמן ש-claude install או claude update הורידו את הבינארי של Claude Code, והניסיונות החוזרים לא הצליחו. Claude Code מנסה שוב את ההורדה כשהחיבור נופל, כשההעברה נתקעת, או כשהקובץ שהורד נכשל בבדיקת checksum, עד שלושה ניסיונות בסך הכל. שגיאת HTTP שהושלמה, למשל 404, אינה מנוסה שוב, כי השרת כבר ענה. לפני גרסה v2.1.202, חיבור שנפל פעם אחת הכשיל את ההורדה מיד עם השגיאה החשופה aborted, בלי ניסיון חוזר.

The connection dropped while downloading the update (attempt 3/3: aborted). Check your network , proxies sometimes cut off large downloads.

הטקסט בסוגריים מציין איזה ניסיון נכשל ומה שגיאת הרשת שמתחתיו. claude update מקדים את ההודעה ב-Error: Failed to install native update על stderr.

הורדה שנשארת מחוברת אבל אינה מסתיימת בתוך 10 דקות נכשלת במקום זאת עם Download timed out: exceeded the total deadline. Claude Code אינו מנסה שוב הורדה שפג לה הזמן, כי חיבור איטי מדי כדי להסתיים בתוך המועד לא יסתיים גם בניסיון מיידי נוסף. הצעדים למטה חלים על שתי ההודעות.

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

מה לעשות:

• הרץ שוב את claude update. ברשת תקינה בדרך כלל, ההורדה מצליחה בהרצה הבאה. בהודעת הזמן שפג, הרץ שוב מרשת מהירה יותר או פחות מוגבלת.
• אם הרשת דורשת פרוקסי, הגדר HTTPS_PROXY לפני הרצת המתקין או claude update. ראה בדיקת רשת.
• אם פרוקסי ארגוני ממשיך לסגור את ההעברה, בקש מצוות הרשת לאפשר את ההורדה המלאה מ-downloads.claude.ai. ראה Network access requirements בתיעוד הרשמי.
• הרץ claude doctor מהמעטפת לאבחון ההתקנה.

#אימות המהדורה נכשל

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

Release verification failed for Claude Code <version> (<reason>). The update was not installed.

בחר את הצעד לפי הערך שבסוגריים בהודעה שלך:

• ערך שמתחיל ב-sidecar_fetch_: הרץ שוב את אותה פקודה מהמעטפת. claude update הצליח אם הוא מדפיס שורה שמתחילה ב-Successfully updated from, ו-claude install הצליח אם הוא מדפיס Claude Code successfully installed!.
• כל ערך אחר: נסה שוב את אותה פקודה מאוחר יותר.

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

#Auto-update failed · Run claude doctor בתחתית הסשן

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

השורה מפנה אל claude doctor, שהשורה Last update attempt: failed (install_failed) שלו נותנת תאריך בלי סיבה. כדי לסיים את העדכון או לראות למה הוא נכשל, הרץ claude update במעטפת. אם גם ההתקנה הזו נכשלת, התאם את השגיאה ש-claude update מדפיס לטבלה למעלה.

#TLS

שגיאות אלה מעידות שלחיצת היד של TLS נכשלה:

• curl: (35) TLS connect error
• schannel: next InitializeSecurityContext failed
• ב-PowerShell: Could not create SSL/TLS secure channel
• ב-PowerShell: Could not establish trust relationship for the SSL/TLS secure channel

עבור CRYPT_E_NO_REVOCATION_CHECK או CRYPT_E_REVOCATION_OFFLINE, עבור לשלב 4.

פתרונות:

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

ב-Ubuntu או Debian:

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

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

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

[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, עקוף חסימת בדיקות ביטול אישורים (revocation checks): השגיאות 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

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

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

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

#קובץ נעול בזמן התקנה ב-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

#claude.exe חסר אחרי עדכון ב-Windows

אם הטרמינל מדווח על 'claude' is not recognized מיד לאחר ש-Claude Code התעדכן ב-Windows, בדוק אם %USERPROFILE%\.local\bin עדיין מכיל את claude.exe. אם התיקייה אינה ב-PATH כלל, עיין בסעיף תיקון PATH. לצורך עדכון ב-Windows,‏ Claude Code משנה את שמו של claude.exe הקיים לגיבוי ומעביר את הגרסה החדשה למקומו. אם העברת הגרסה החדשה נכשלת ו-Claude Code אינו מצליח להחזיר גם את שם קובץ הגיבוי, התיקייה שומרת את הגיבוי אך נותרת ללא claude.exe.

קובץ הגיבוי נמצא באותה תיקייה ושמו מתחיל ב-claude.exe.old. ולאחריו חותמת זמן מספרית. הרץ את הפקודה הבאה ב-PowerShell כדי להחזיר את שם הגיבוי העדכני ביותר ל-claude.exe:

Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

לאחר מכן הרץ claude --version כדי לוודא את התיקון. קובץ claude.exe ששוחזר ידפיס מספר גרסה.

אם אין קובץ claude.exe.old.*, או שההרצה עדיין נכשלת לאחר שינוי השם, התקן מחדש:

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

לפני גרסה v2.1.281,‏ Claude Code היה עלול למחוק את הגיבוי בזמן ש-claude.exe עדיין חסר.

#התקנה שנהרגת מחוסר זיכרון ב-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.

#התקנה שנהרגה לפני שהסתיימה

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

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.

לכל אות קטלני אחר, ולקוד יציאה 137 ב-macOS, הסקריפט מדפיס Installation was killed before it could finish (exit code <N>) עם קוד היציאה בפועל, ומשמיט את הסבר חוסר הזיכרון. ההודעה מגיעה מסקריפט ההתקנה של macOS ו-Linux, שחלה גם על התקנות בתוך WSL. סקריפטי ההתקנה המקוריים של Windows אינם מדפיסים אותה. לפני גרסה v2.1.200, הסקריפט יצא רק עם שורת Killed החשופה של המעטפת.

מה לעשות:

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

#התקנה נתקעת ב-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, הגדל את מגבלת הזיכרון, והרץ שוב את הבנייה.

#Raw mode is not supported בזמן התקנה

כאשר ההגדרות המנוהלות על ידי שרת של הארגון כוללות שינויים הדורשים אישור אבטחה, גרסאות של Claude Code שלפני 2.1.246 מנסות להציג את דיאלוג האישור במהלך claude install. הדיאלוג דורש טרמינל על stdin. כאשר המתקין מריץ claude install מתוך צינור (pipe), כפי שנעשה ב-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, תיקייה באחד הנתיבים הללו גרמה לשתי הפקודות להיתקע והותירה את מקטע System diagnostics של /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 פותחת את אפליקציית שולחן העבודה.

עדכון Claude Desktop לגרסה האחרונה פותר את זה.

#מעטפת חסרה ב-Windows

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. נתיב שאינו קיים גורר את אותה התנהגות נסיגה ואותה אזהרה. לפני גרסה v2.1.219, Claude Code השתמש בכל קובץ קיים כמעטפת מבלי לבדוק את שמו, ויצא בהפעלה עם השגיאה Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path כאשר הנתיב לא היה קיים.

אם שם הקובץ תקין, ייתכן שתוכנת אבטחת נקודות קצה כגון AppLocker, מדיניות הגבלת תוכנה ב-Group Policy או סוכני EDR מפריעים להרצה. בקש מצוות ה-IT לאשר ברשימה הלבנה (allowlist) את 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, זו מהדורת Windows של 32 סיביות. Claude Code דורש מערכת הפעלה של 64 סיביות. ראה דרישות מערכת בתיעוד הרשמי.

#אי התאמה בין musl ל-glibc

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

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

הדבר עלול להתרחש במערכות מבוססות glibc שמותקנות בהן חבילות הידור צולב (cross-compilation) של 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. פתח דיווח ב-מאגר הבעיות עם הפלט של ldd --version ושל ls /lib/libc.musl*.

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

apk add libgcc libstdc++ ripgrep

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

#Illegal instruction

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

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

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

בשרת VPS או במכונה וירטואלית, הרץ:

grep -m1 -ow avx /proc/cpuinfo

תוצאה ריקה מעידה ש-AVX אינו זמין למכונה האורחת.

אין מעקף עבור הבינארי המקורי. עקוב אחר issue 50384 לבדיקת הסטטוס, וציין בדיווח את דגם המעבד שלך מתוך 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

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

#Bus error בזמן שסשן רץ

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

לפני הודעת המעטפת, סביבת הריצה של Claude Code יכולה להדפיס דוח קריסה שכולל panic(main thread): Bus error at address וגם oh no: Bun has crashed. This indicates a bug in Bun, not your code. כשקובץ ההרצה הפך לבלתי קריא, הקריסה נובעת מהקובץ הבלתי קריא, לא מבאג ב-Bun. הדוח יכול גם להיעדר, אם סביבת הריצה לא הצליחה לקרוא גם את הקוד שמדפיס אותו.

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

#Exec format error ב-WSL1

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

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

wsl --set-version <DistroName> 2

אם עליך להישאר ב-WSL1, הפעל את הבינארי דרך המקשר הדינמי (dynamic linker). הוסף פונקציה זו לקובץ ~/.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 12, התקן לפי הסעיף תיקון התקנת npm 12.

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

exec: node: not found בהרצת claude. סביבת ה-WSL שלך משתמשת כנראה בהתקנת Node.js של Windows. ודא זאת עם 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.

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

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

חבילת ה-npm‏ @anthropic-ai/claude-code מורידה את הבינארי המקורי כתלות אופציונלית לפי פלטפורמה, כדוגמת @anthropic-ai/claude-code-darwin-arm64. claude נשאר סקריפט מציין מקום (placeholder) עד ששלב ה-postinstall של החבילה רץ ומחליף את מציין המקום בבינארי הזה. אם שלב ההורדה או שלב ה-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 מדווחים שאינם יכולים להריץ את הקובץ במקום להציג הודעה זו.

בדוק את הגורמים הבאים:

• npm 12 מדלג על postinstall כברירת מחדל. כשמתקינים או מעדכנים את Claude Code עם npm 12, npm מסיים את ההתקנה בלי להריץ את השלב, אלא אם תצורת npm מאפשרת אותו. ראה תיקון התקנת npm 12.
• תלויות אופציונליות מנוטרלות. הסר את --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 נוסף בכל הפעלה. אם ה-wrapper מדפיס במקום זאת 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-* בנוסף לחבילת המטא.

#תיקון התקנת npm 12

אם claude מדפיס Error: claude native binary not installed. אחרי התקנת npm או עדכון, או שב-Windows המעטפת אינה מצליחה להריץ אותו, הרץ npm --version. גרסה שמתחילה ב-12 אומרת ש-npm דילג על שלב ה-postinstall של Claude Code, שמציב את הבינארי, אלא אם תצורת npm מאפשרת את השלב. בכל גרסה אחרת, בדוק את שאר הגורמים בסעיף בינארי מקורי חסר אחרי התקנת npm.

כדי לתקן התקנת npm 12, עבור למתקין המקורי או אשר את השלב:

• מעבר למתקין המקורי: התקן עם המתקין המקורי, ואז הסר את חבילת ה-npm. עדכונים אחר כך אינם עוברים דרך npm, והשגיאה אינה חוזרת.
• להישאר על npm: בהתקנת npm גלובלית, הוסף את Claude Code ל-allow-scripts בתצורת npm של המשתמש. npm מריץ אז את סקריפטי ההתקנה של Claude Code בכל התקנה ועדכון מאוחרים, וגם בהתקנות פרויקט ש-package.json שלהן אינו מגדיר allowScripts.

השתמש במתקין המקורי להתקנה מקומית ב-~/.claude/local. השתמש בו גם אם סקריפטים ב-package.json קוראים ל-npm install ואתה מריץ אותם עם pnpm 9, pnpm 10, Yarn 1 או כלי אחר שמעביר להם את ההגדרה הזו. ב-npm 12.1 ואילך, ההתקנות האלה עלולות להיכשל עם EALLOWSCRIPTS אחרי שההגדרה נשמרת.

1. אם npm --version הדפיס 12.0.x, עדכן את npm ל-12.1 או חדש יותר, למשל עם npm install -g npm@latest. ב-12.0.x, התקנות פרויקט שכלי npx או סקריפט npm run מתחיל עלולות להיכשל עם EALLOWSCRIPTS אחרי שההגדרה נשמרת.
2. הרץ npm config get allow-scripts ורשום את החבילות שמופיעות, כי הפקודה הבאה מחליפה את כל הערך. שמור את ההגדרה עם החבילות האלה בתוך המרכאות, כמו "allow-scripts=@anthropic-ai/claude-code,<package>":

npm config set "allow-scripts=@anthropic-ai/claude-code" --location=user

3. התקן מחדש:

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

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

4. אם claude --version אינו מדפיס מספר גרסה, בדוק את שאר הגורמים בסעיף בינארי מקורי חסר אחרי התקנת npm.

כדי לבטל, הגדר שוב את הרשימה בלי @anthropic-ai/claude-code, או מחק את כל הרשימה עם npm config delete allow-scripts --location=user. ב-npm 12 השגיאה חוזרת אחרי העדכון הבא.

#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 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 12, עקוב אחרי תיקון התקנת npm 12. אחרת הרץ:

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

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

#איפוס ההתחברות

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

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

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

#שגיאת OAuth: קוד לא חוקי

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

פתרונות:

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

#שגיאת 403 לאחר התחברות

אם מופיעה שגיאת API Error: 403 Request not allowed לאחר ההתחברות:

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

#אין הרשאת Claude Code לחשבון

אם דף ההתחברות מציג Authorization failed עם ההודעה Claude Code access has not been granted for this account. Contact your administrator. לאחר התחברות מתוך Claude Code, ארגון ה-Enterprise שלך הגדיר את תפקידך כ-Custom, ואף אחד מהתפקידים המותאמים אישית (custom roles) שהוקצו לקבוצות שלך אינו מעניק גישה ל-Claude Code. בתפקיד Custom, הגישה מתקבלת אך ורק מאותם תפקידים מותאמים, ולכן שום שינוי בתוך Claude Code אינו פותר שגיאה זו. פירוט על התפקידים המותאמים נמצא במאמר custom roles.

כדי לקבל גישה:

1. בקש מבעלי הארגון (Owner) להקצות לאחת הקבוצות שלך תפקיד מותאם אישית שמעניק גישה ל-Claude Code, או לשנות את תפקידך מ-Custom לתפקיד רגיל כגון User. בעלים מנהלים תפקידים בהגדרות התפקידים של הארגון בכתובת claude.ai/admin-settings/roles.
2. לאחר שהבעלים מבצע את השינוי, הרץ claude והתחבר שוב.

#ארגון מושבת למרות מנוי פעיל

אם מופיעה שגיאת API Error: 400 עם ההודעה This organization has been disabled למרות מנוי פעיל, משתנה הסביבה 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 כדי לוודא איזו שיטת אימות פעילה.

#התחברות ב-WSL2, ב-SSH או בקונטיינר

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

1. העתק את כתובת ההתחברות. בפרומפט האינטראקטיבי לחץ c כדי להעתיק, או סמן אותה בטרמינל. עם claude auth login, העתק את הכתובת שהפקודה מדפיסה.
2. פתח את הכתובת בדפדפן במכונה המקומית והתחבר. הדפדפן מציג קוד במקום לחזור אל localhost.
3. הדבק את הקוד בטרמינל בשורה שמתחילה ב-Paste code here.

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

claude auth login

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

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

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

#התחברות שפגה

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

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

סשנים מקבילים באותה מכונה חולקים התחברות שמורה ומתאמים את חידושה כך שרק תהליך אחד מרענן את האסימון בכל עת. פרטים על התנהגות שאר הסשנים לאחר התחברות מחודשת באחד מהם מופיעים בתיעוד הרשמי תחת Not logged in.

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

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

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

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

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

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

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

#ההתחברות נכשלת כשתיקיית הבית ברשת

כשבקשה נכשלת עם API Error: 401 ותיקיית התצורה נמצאת על מערכת קבצים ברשת, בדוק אם מערכת הקבצים הזו, או המכסה שלך עליה, מלאה. כשאין מקום פנוי, Claude Code אינו יכול לשמור התחברות חדשה או מחודשת לקובץ הטקסט הגלוי .credentials.json, ו-claude auth login עדיין יכול להדפיס Login successful.

1. פנה מקום במערכת הקבצים. מחק קבצים שאינך צריך עוד במערכת הקבצים שמחזיקה את ~/.claude, או בתיקייה שהגדרת ב-CLAUDE_CONFIG_DIR.
2. התחבר שוב. הרץ /login בפרומפט של Claude Code, או claude auth login במעטפת.

לפני גרסה v2.1.318, כש-Claude Code שמר את קובץ ההתחברות על מערכת קבצים ברשת שהייתה מלאה, הוא היה עלול להחליף התחברות שמורה שעדיין תקפה בקובץ ריק. פקודות מאוחרות יותר דיווחו אז Not logged in.

#פרטי ספק ענן לא נטענים

אם הגדרת את 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

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

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 (משתמשי Console: platform.claude.com), לחץ על ראשי התיבות שלך בפינה השמאלית התחתונה, ובחר Get help. ההליך המלא נמצא ב-How to get support.

#פקודות חיוניות

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

פקודות מעטפת

הרשימה המלאה של פקודות המעטפת נמצאת ב-CLI reference הרשמי.

פקודות סשן

הרשימה המלאה של פקודות הסשן נמצאת ב-commands reference הרשמי.

#טיפים למתחילים

להרחבה, ראה best practices ו-common workflows בתיעוד הרשמי.

#בקשות ממוקדות

בקשה ממוקדת מכוונת את Claude טוב יותר. הדוגמה הקצרה מהתיעוד היא fix the bug. נסה כך:

fix the login bug where users see a blank screen after entering wrong credentials

#הוראות צעד אחר צעד

פרק משימה מורכבת לשלבים בתוך ההנחיה:

1. create a new database table for user profiles
2. create an API endpoint to get and update user profiles
3. build a webpage that allows users to see and edit their information

#תן ל-Claude להכיר את הקוד קודם

לפני שינויים, תן ל-Claude להבין את הקוד:

analyze the database schema

build a dashboard showing products that are most frequently returned by our UK customers

#קיצורי דרך

• הקלד / כדי לראות את הפקודות וה-skills הזמינים לך
• Tab משלים פקודות
• חץ למעלה (↑) מציג היסטוריית פקודות
• Shift+Tab עובר בין מצבי הרשאות

#מה הלאה

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

• How Claude Code works: לולאת הסוכן, הכלים המובנים, ואיך Claude Code עובד מול הפרויקט
• Best practices: תוצאות טובות יותר בעזרת ניסוח יעיל והכנת הפרויקט
• Common workflows: מדריכים צעד אחר צעד למשימות נפוצות
• Extend Claude Code: התאמה עם CLAUDE.md, skills, hooks, MCP ועוד

אפשרויות התקנה, עדכון ידני או הוראות הסרה נמצאות ב-Advanced setup בתיעוד הרשמי.

#קבלת עזרה

• בתוך Claude Code: הקלד /help, או שאל שאלת "how do I"
• תיעוד: שאר המדריכים הרשמיים
• קורסים: Claude Code 101 וקורסים חינמיים נוספים בקצב אישי ב-Claude Academy
• קהילה: Discord של Anthropic, לטיפים ולתמיכה