⚡ פרק 2

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

התקנת קלוד קוד מתבצעת בכמה צעדים פשוטים באמצעות סקריפט התקנה מקורי (Native Installer) או מנהלי חבילות מוכרים. הכלי פועל כתוכנה עצמאית המותקנת במערכת ההפעלה שלך ומתחברת ישירות לחשבון Anthropic או לספקי ענן ארגוניים. למי שמעדיף ממשק גרפי ללא שימוש בטרמינל, קיימת גם אפליקציית שולחן עבודה (Claude Code Desktop) הזמינה להורדה ישירה עבור macOS ו-Windows, ובאמצעות apt עבור Linux.

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

• מערכות הפעלה נתמכות:
  • macOS: גרסה 13.0 (Ventura) ומעלה, עם תמיכה מלאה במעבדי Apple Silicon ובמעבדי Intel. גרסאות ישנות יותר אינן נתמכות על ידי הקובץ הבינארי.
  • Linux: הפצות מודרניות מבוססות glibc 2.28 ומעלה, דוגמת Ubuntu 20.04+, Debian 11+, Fedora 36+, או הפצות מבוססות musl דוגמת Alpine Linux (הדורשת התקנת חבילות עזר).
  • Windows: גרסאות Windows 10 ו-Windows 11 ב-64 סיביות בלבד. השימוש דרך WSL2 מומלץ במיוחד, לצד תמיכה מקורית ב-PowerShell וב-CMD. גרסת WSL1 סובלת מרגרסיה במבנה הקובץ הבינארי ואינה נתמכת ישירות כברירת מחדל.
  • מערכות שאינן נתמכות: FreeBSD מדווחת כמערכת שאינה נתמכת (בגרסאות ישנות מ-2.1.205 זוהתה בטעות כלינוקס והורד קובץ שלא פעל).
• ארכיטקטורת מעבד וחומרה:
  • מעבדי 64 סיביות בלבד (x64 ו-ARM64). מערכות הפעלה או מעבדים של 32 סיביות אינם נתמכים.
  • קובצי ההרצה הבינאריים הרשמיים זמינים עבור שמונה פלטפורמות: darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64, win32-arm64.
  • תמיכה בסט פקודות AVX: המעבד חייב לתמוך ב-AVX (קיים במרבית המעבדים שיוצרו משנת 2013 ואילך). במכונות וירטואליות יש לוודא שה-Hypervisor מעביר את הוראות ה-AVX למערכת האורחת.
• זיכרון (RAM):
  • נדרשים לפחות 4GB של זיכרון RAM להרצת הכלי בפועל.
  • תהליך ההתקנה דורש כ-512MB של זיכרון פנוי. בשרתים מוגבלים או במכונות ענן קטנות, יש להגדיר קובץ swap כדי למנוע את עצירת המתקין על ידי מנגנון ה-OOM של לינוקס.
• מעטפת פקודה (Shell) ב-Windows:
  • קלוד קוד ב-Windows דורש מעטפת PowerShell או את Git for Windows (עבור Bash).
  • התקנת Git for Windows היא רשות ולא חובה: בהיעדרה, קלוד קוד מפעיל כברירת מחדל את כלי ה-PowerShell המובנה שלו. אם נדרש שימוש בסקריפטים של Bash, יש להתקין את Git for Windows ולוודא שהנתיב שלו מוגדר במערכת.

#התקנה מקורית (Native Installer)

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

#macOS, Linux ו-WSL

פתח את חלון הטרמינל והרץ את הפקודה הבאה:

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

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

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

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

#Windows PowerShell

פתח את Windows PowerShell (ודא שאינך מפעיל את גרסת ה-x86) והרץ:

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

אם מוגדר פרוקסי ארגוני:

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

#Windows CMD

בשורת הפקודה הקלאסית (Command Prompt):

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

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

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

#התקנה בסביבת Docker

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

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

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

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

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

#Homebrew (macOS)

ל-Homebrew קיימים שני ערוצי הפצה (Casks):

# ערוץ יציב (עוקב אחרי ערוץ ה-Stable ומפגר בכשבוע אחרי שחרור גרסה)
brew install --cask claude-code

# ערוץ Latest (מתעדכן מיידית עם שחרור כל גרסה חדשה)
brew install --cask claude-code@latest

[!NOTE] התקנות דרך Homebrew אינן מתעדכנות אוטומטית ברקע. אם ההתקנה מדווחת שהחבילה אינה קיימת או מורידה גרסה ישנה, יש לרענן את האינדקס המקומי באמצעות brew update לפני ההתקנה. כדי לעדכן גרסה באופן ידני, הרץ brew upgrade claude-code או brew upgrade claude-code@latest.

#WinGet (Windows)

התקנה:

winget install Anthropic.ClaudeCode

עדכון ידני:

winget upgrade Anthropic.ClaudeCode

הסרה:

winget uninstall Anthropic.ClaudeCode

#מנהלי חבילות בלינוקס והפצות מבוססות musl

• Alpine Linux: מערכות מבוססות musl דורשות התקנת ספריות תאימות לפני הרצת המתקין:

  העתק

  apk add libgcc libstdc++ ripgrep

• התקנת אפליקציית Desktop בלינוקס: הפצות מבוססות Debian ו-Ubuntu נתמכות באמצעות apt לפי ההנחיות הרשמיות של אפליקציית שולחן העבודה.

#התקנה באמצעות npm (אינה מומלצת)

ניתן להתקין גלובלית באמצעות npm install -g @anthropic-ai/claude-code. שיטה זו מורידה את הקובץ הבינארי כתלות אופציונלית של החבילה. חבילה זו רגישה לחסימות סקריפטים ב-PowerShell, לשגיאות ENOTEMPTY בעת שדרוג, ולהיעדר הקובץ הבינארי אם הופעל הדגל --omit=optional או אם בוטלו סקריפטים עם --ignore-scripts. לכן Anthropic ממליצה להשתמש במתקין המקורי.

אם התקנת דרך npm והקובץ הבינארי לא הונח במקומו עקב דילוג על סקריפט ה-postinstall, ניתן להריץ ידנית:

node node_modules/@anthropic-ai/claude-code/install.cjs

או להשתמש במעטפת ההפעלה:

node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs

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

לאחר סיום ההתקנה, נווט לתיקיית פרויקט קיים והפעל את קלוד קוד:

cd /path/to/your-project
claude

בשימוש הראשון, קלוד קוד יזהה שאינך מחובר ויציג תהליך התחברות:

Welcome to Claude Code!
Please log in to continue:
> 1. Log in with your Claude account (Browser OAuth)
  2. Enter Anthropic API Key

#1. התחברות באמצעות דפדפן (OAuth)

זוהי הדרך הנוחה ביותר למנויי Claude Pro, Team ו-Enterprise. לחיצה על Enter תפתח חלון דפדפן לאישור הגישה, ובסיום הסשן בטרמינל יתחבר אוטומטית.

מלכודות ופתרונות בהתחברות דפדפן:

• סביבות מרוחקות, SSH, מכולות ו-WSL2: כאשר קלוד קוד רץ במכונה מרוחקת או בתוך מכולה, הדפדפן אינו יכול לבצע הפניה אוטומטית חזרה לשרת המקומי של קלוד קוד. במצב זה הדפדפן יציג קוד אימות: העתק אותו והדבק בטרמינל בשורת הפקודה Paste code here if prompted.
• העתקת קישור ידנית: אם הדפדפן אינו נפתח כלל, לחץ על המקש c בטרמינל כדי להעתיק את כתובת ה-OAuth המלאה ללוח, והדבק אותה ידנית בדפדפן המקומי שלך. זה מועיל גם כאשר הכתובת נשברת על פני שורות מרובות בטרמינל צר.
• התחברות חלופית דרך הקלט הסטנדרטי: אם הדבקת הקוד בממשק האינטראקטיבי נכשלת עקב הגדרות הטרמינל (למשל קיצורי מקשים שאינם מועברים), נסה להדביק באמצעות לחצן ימני או Shift+Insert, או הרץ ישירות את הפקודה claude auth login, הקוראת את הקוד ישירות מ-stdin.
• פתיחת דפדפן ב-WSL2: ניתן לכוון את משתנה הסביבה של הדפדפן ישירות לבינארי של Windows:

  העתק

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

• שגיאת OAuth error: Invalid code: שגיאה זו מופיעה אם קוד האימות פג תוקף או נקטע במהלך ההעתקה. לחץ Enter כדי לנסות שוב ולהשלים את ההתחברות מיד לאחר פתיחת הדפדפן, או הקש c להעתקת הקישור המלא. בסשן מרוחק ודא שאתה פותח את הקישור בדפדפן המקומי שלך ולא במכונה המרוחקת.
• שגיאת 403 Forbidden לאחר התחברות: ודא שהמנוי שלך פעיל בכתובת claude.ai/settings. למשתמשי Anthropic Console, ודא שלחשבונך מוקצה תפקיד "Claude Code" או "Developer" (מוגדר ב-Console תחת Settings > Members). אם אתה מאחורי פרוקסי ארגוני, בדוק את תצורת הרשת.

#2. התחברות באמצעות API Key

למפתחים העובדים עם חשבון Anthropic Console, ניתן לייצא את המפתח כמשתנה סביבה:

# ב-Linux / macOS / WSL
export ANTHROPIC_API_KEY="sk-ant-api03-..."

# ב-Windows PowerShell
$env:ANTHROPIC_API_KEY="sk-ant-api03-..."

[!WARNING] קדימות אימות: משתנה הסביבה ANTHROPIC_API_KEY מקבל עדיפות עליונה ועוקף את מנוי ה-OAuth שלך (ובמצב לא אינטראקטיבי עם דגל -p הוא נבחר תמיד כשיש ערך). אם מוגדר בפרופיל המעטפת מפתח API ישן של ארגון שנמחק או הושבת, תופיע שגיאת API Error: 400 ... "This organization has been disabled". כדי להשתמש במנוי הרגיל, בטל את המשתנה והסר אותו מקובצי התצורה של המעטפת:

העתק

#ב-Linux / macOS / WSL

unset ANTHROPIC_API_KEY claude

#ב-Windows PowerShell

Remove-Item Env:ANTHROPIC_API_KEY claude

העתק

הסר שורות ייצוא של המשתנה מקובצי `~/.zshrc`, `~/.bashrc` או `~/.profile`, או ממשתני הסביבה של המשתמש ופרופיל `$PROFILE` ב-Windows. הרץ `/status` בתוך קלוד קוד כדי לאמת איזו שיטת אימות פעילה.

#3. איפוס התחברות ותפוגת טוקן

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

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

אם קלוד קוד מבקש ממך להתחבר שוב ושוב לאחר סשן, ייתכן שתוקף הטוקן פג. הרץ /login כדי להתחבר מחדש. אם זה קורה לעיתים קרובות, ודא ששעון המערכת שלך מדויק, שכן אימות הטוקן תלוי בחותמות זמן מדויקות. סשנים מקבילים במכונה אחת חולקים התחברות שמורה ומתאמים חידוש כך שרק תהליך אחד מחדש בכל עת (בגרסאות ישנות מ-2.1.211 חזרה של המכונה ממצב שינה יכלה לגרום לשני סשנים לחדש עם אותו טוקן ולבטל את ההתחברות).

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

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

1. בדוק גישה ל-Keychain: הרץ 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, בחר ב-keychain בשם login, ובחר Edit > Change Password for Keychain "login" כדי לסנכרן אותו עם סיסמת החשבון שלך. לאחר מכן הרץ שוב claude doctor. עבור לשלב הבא ברגע שהדוח אינו כולל עוד את אזהרת ה-Keychain.
4. התנתק והתחבר מחדש: ברגע שה-Keychain נגיש שוב לכתיבה, קלוד קוד יעביר את פרטי ההזדהות בפעם הבאה שהוא יכתוב פרטי הזדהות. כדי לכפות זאת כעת, הרץ /logout ולאחר מכן /login. התנתקות מסירה את כל פרטי ההזדהות השמורים, כולל תוכן קובץ הטקסט הפשוט, התחברויות שמורות לשרתי MCP וערכים רגישים של תוספים, לכן צפה לאשר מחדש שרתי MCP ולהזין מחדש סודות של תוספים לאחר מכן. התחברות מחדש שומרת את פרטי ההתחברות שלך ב-Keychain.

#תמיכה בספקי ענן חיצוניים

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

#Amazon Bedrock

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION="us-east-1"

אימות תקינות פרטי ההזדהות בטרמינל:

aws sts get-caller-identity

אם פרטי ההזדהות אינם מוגדרים כראוי בסביבה הנוכחית, תופיע השגיאה Could not load credentials from any providers.

#Google Cloud Vertex AI (Google Cloud's Agent Platform)

export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION="us-central1"
export ANTHROPIC_VERTEX_PROJECT_ID="your-gcp-project-id"

אימות תקינות הגישה דרך Application Default Credentials:

gcloud auth application-default login

אם פרטי ההזדהות חסרים במעטפת הנוכחית, תופיע השגיאה Could not load the default credentials.

#Microsoft Foundry

export ANTHROPIC_FOUNDRY_API_KEY="your-key"

לחלופין, ניתן להתחבר דרך Azure CLI כדי לאפשר זיהוי אוטומטי של שרשרת ההרשאות:

az login

אם שרשרת ההזדהות נכשלת, תופיע השגיאה ChainedTokenCredential authentication failed או CredentialUnavailableError.

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

#אימות תקינות ההתקנה ובדיקות אבחון

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

# בדיקת גרסת הכלי
claude --version

# אבחון מקיף של הסביבה, ההרשאות והכלים
claude doctor

פקודת claude doctor בודקת את תקינות הקובץ הבינארי, גישה ל-Git, הרשאות כתיבה ל-Keychain, חיבור לרשת ושרתי MCP מוגדרים.

#בדיקות אבחון ידניות

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

#1. בדיקת חיבור רשת לשרת ההורדות

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

ב-macOS וב-Linux:

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

ב-Windows PowerShell (יש להפעיל במפורש את curl.exe שאינו מתנגש עם ה-Alias המובנה):

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

אם השורה הראשונה מציגה סטטוס 200 (HTTP/2 200 ב-macOS ולינוקס, או HTTP/1.1 200 OK ב-Windows), החיבור תקין. סטטוס 403 מצביע בדרך כלל על חסימת פרוקסי או סינון רשת, או על כך שקלוד קוד אינו זמין באזור הגאוגרפי שלך. סטטוס 5xx מצביע על תקלה זמנית בשירות (יש להמתין מספר דקות ולנסות שוב). אם מופיעה הודעת Could not resolve host או שהחיבור מתנתק ב-timeout, חומת אש או שרת פרוקסי חוסמים את החיבור.

#2. בדיקת משתנה הסביבה PATH

המתקין המקורי שומר את קובץ ההרצה בנתיב ~/.local/bin/claude ב-macOS ו-Linux או בנתיב %USERPROFILE%\.local\bin\claude.exe ב-Windows.

[!NOTE] הרחבת VS Code כוללת עותק פנימי פרטי של קלוד קוד עבור חלונית השיחה שלה, ואינה מוסיפה את הפקודה ל-PATH. אם התקנת רק את ההרחבה ל-VS Code, הקובץ בנתיב ~/.local/bin/claude לא יהיה קיים. יש להריץ את ההתקנה העצמאית כדי להשתמש ב-claude מהטרמינל.

בדיקה ב-macOS ו-Linux:

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

אם הנתיב אינו מופיע בפלט, הוסף אותו לקובץ הגדרות המעטפת:

• ב-Zsh (ברירת מחדל ב-macOS):

  העתק

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

• ב-Bash (ברירת מחדל בלינוקס):

  העתק

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

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

בדיקה ב-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"

אם אין פלט, פתח את הגדרות המערכת, עבור למשתני סביבה, והוסף את %USERPROFILE%\.local\bin למשתנה ה-PATH של המשתמש. פתח מחדש את הטרמינל ובדוק בעזרת claude --version.

#3. איתור התקנות כפולות וסותרות

התקנות מרובות עלולות לגרום לאי-התאמת גרסאות. בדוק אילו קובצי הרצה קיימים במערכת:

ב-macOS וב-Linux:

which -a claude

בדוק את שלושת המיקומים האפשריים:

# בדיקת התקנה מקורית (מציגה קישור סימבולי לספריית הגרסאות)
ls -la ~/.local/bin/claude

# בדיקת התקנת npm מקומית ישנה של גרסאות קודמות
ls -la ~/.claude/local/

# בדיקת התקנת npm גלובלית
npm -g ls @anthropic-ai/claude-code 2>/dev/null

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

ב-Windows PowerShell:

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

אם נמצאו התקנות כפולות, שמור רק אחת (ההתקנה המקורית ב-~/.local/bin/claude או ב-%USERPROFILE%\.local\bin\claude.exe היא המומלצת). הסר את ההתקנות העודפות:

# הסרת התקנת npm גלובלית
npm uninstall -g @anthropic-ai/claude-code

# מחיקת התקנת npm מקומית ישנה ב-macOS ולינוקס
rm -rf ~/.claude/local

ב-Windows PowerShell למחיקת התקנת npm מקומית ישנה:

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

הסרת התקנת Homebrew ב-macOS:

brew uninstall --cask claude-code

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

winget uninstall Anthropic.ClaudeCode

#4. בדיקת הרשאות תיקיות

המתקין המקורי ב-macOS וב-Linux זקוק להרשאות כתיבה בספריות ~/.local/bin/ ו-~/.claude/ (ב-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

#5. בדיקת תקינות הקובץ הבינארי

אם claude --version מדפיס מספר גרסה אך הרצת claude גורמת לקריסה או לתקיעה בהפעלה, בצע את הבדיקות הבאות:

ודא שהקובץ הבינארי קיים ובעל הרשאות הרצה: ב-macOS וב-Linux:

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

ב-Windows PowerShell:

Get-Command claude | Select-Object Source

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

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

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

claude --version

#עדכון והסרה

• עדכון ידני: בהתקנות מקוריות ניתן להריץ בכל עת:

  העתק

  claude update

  [!NOTE] מלכודת תקיעה בעדכון: בגרסאות קודמות ל-2.1.214, אם קיים נתיב שהוא תיקייה במקום קובץ באחד מקובצי התצורה של המעטפת (דוגמת ~/.zshrc, ~/.bashrc, ~/.config/fish/config.fish, או קובצי פרופיל ב-macOS), הפקודות claude update ו-claude doctor עלולות להיתקע ללא פלט. הפתרון הוא להריץ מחדש את סקריפט ההתקנה המקורי, אשר יעדכן את הכלי ישירות לגרסה העדכנית.

• הסרת התקנה מקורית:
  • ב-macOS וב-Linux: מחק את קובץ ההרצה מ-~/.local/bin/claude, מחק את ספריית הגרסאות ~/.local/share/claude/versions/ ומחק את ספריית ההגדרות ~/.claude.
  • ב-Windows: מחק את קובץ ההרצה מ-%USERPROFILE%\.local\bin\claude.exe ומחק את ספריית ההגדרות %USERPROFILE%\.claude.
• הסרת התקנות ממנהלי חבילות:
  • ב-Homebrew: הרץ brew uninstall --cask claude-code.
  • ב-WinGet: הרץ winget uninstall Anthropic.ClaudeCode.

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

#פירוט פתרונות לתקלות נפוצות

#סקריפט ההתקנה מחזיר דף HTML או שגיאת 403

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

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

ב-PowerShell, התקלה מתבטאת בשגיאות ניתוח של iex המנסה להריץ תגיות HTML ו-CSS כפקודות PowerShell (למשל Missing argument in parameter list, Missing expression after unary operator '--', או ParserError עם ParseException). הורדה עם -OutFile install.ps1 תשמור את אותו דף אינטרנט. לחלופין תיתכן שגיאת 403 ללא תוכן דף: curl: (22) The requested URL returned error: 403.

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

פתרונות לפי התיעוד הרשמי:

1. השתמש בשיטת התקנה חלופית: ב-macOS התקן דרך Homebrew (brew install --cask claude-code), וב-Windows התקן דרך WinGet (winget install Anthropic.ClaudeCode). לאחר מכן הרץ claude --version כדי לוודא תקינות. אם המעטפת מדווחת ש-claude לא נמצא, פתח חלון טרמינל חדש.
2. נסה שוב לאחר כמה דקות: לעיתים קרובות מדובר בבעיה זמנית, המתן ונסה שוב את הפקודה המקורית.

#כשל בהורדה וכתיבה לצינור: curl (56) או curl (23)

הפקודה מזרימה את הסקריפט מ-curl ישירות ל-bash. קוד יציאה 56 מעיד שההורדה נקטעה, וקוד יציאה 23 מעיד ש-curl לא הצליח לכתוב את המידע שקיבל לתוך הצינור, לרוב עקב סגירה מוקדמת של מעטפת Bash.

בדוק חיבור לשרת downloads.claude.ai. אם השרת זמין, מדובר בתקלה זמנית: הרץ שוב את פקודת ההתקנה או נסה שיטת התקנה חלופית.

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

שגיאות דוגמת curl: (35) TLS connect error, schannel: next InitializeSecurityContext failed, או Could not establish trust relationship for the SSL/TLS secure channel ב-PowerShell מצביעות על כשל בלחיצת יד של 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): בשלב ההתקנה ב-macOS ו-Linux, הגדר ל-curl לבטוח בתעודת ה-CA של הפרוקסי:

   העתק

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

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

   העתק

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

   עבור קלוד קוד לאחר ההתקנה, הגדר את NODE_EXTRA_CA_CERTS: ב-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'

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 (irm https://claude.ai/install.ps1 | iex), או התקנה באמצעות winget install Anthropic.ClaudeCode.

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

אם קיבלת שגיאה על כך ש-irm אינו מוכר, אתה נמצא ב-CMD ולא ב-PowerShell. פתח PowerShell והרץ את הפקודה, או השתמש בפקודת ה-curl הייעודית ל-CMD.

אם קיבלת שגיאה ש-&& אינו חוקי, הרצת את פקודת ה-CMD בתוך PowerShell. השתמש בפקודת PowerShell המתאימה.

אם קיבלת שגיאה שפרמטר fsSL אינו מוכר, הרצת את פקודת ה-curl של לינוקס ב-PowerShell (שם curl הוא כינוי לפקודה פנימית). השתמש בפקודת PowerShell.

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

#שגיאת הרצת סקריפטים ב-PowerShell בעת שימוש ב-npm

הודעת השגיאה running scripts is disabled on this system או PSSecurityException נובעת ממדיניות האבטחה (ExecutionPolicy) של PowerShell, החוסמת הרצת סקריפטים מסוג .ps1 שנוצרו על ידי npm עבור פקודותיו ועבור claude.ps1. מדיניות זו חלה על קובצי סקריפט ואינה משפיעה על מתקין ה-PowerShell המקורי (irm ... | iex) המריץ טקסט ישירות מהזיכרון.

פתרונות לפי התיעוד הרשמי:

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

   העתק

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

2. הפעל את קובץ ה-.cmd במקום זאת: npm.cmd ו-claude.cmd מבצעים את אותה פעולה ואינם כפופים למדיניות ה-ExecutionPolicy.
3. השתמש במתקין ה-PowerShell במקום ב-npm: המתקין מתקין קובץ בינארי ולא סקריפט .ps1.

#הקובץ בשימוש תהליך אחר במהלך התקנה ב-Windows

אם מתקין ה-PowerShell נכשל בהודעה 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

#עצירת התקנה מחוסר זיכרון (OOM Killed) בשרתי לינוקס

הודעת Killed או שגיאה Installation was killed before it could finish (exit code 137) מעידה שמנגנון ה-OOM של לינוקס עצר את שלב claude install מחוסר זיכרון פנוי. תהליך ההתקנה זקוק לכ-512MB של זיכרון פנוי, והרצת הכלי דורשת זיכרון רב יותר.

פתרונות לפי התיעוד הרשמי:

1. הוסף שטח swap אם לשרת יש זיכרון RAM מוגבל:

   העתק

   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. השתמש במכונה גדולה יותר במידת האפשר. קלוד קוד דורש לפחות 4GB של זיכרון RAM.

#התקנה נתקעת במכולת Docker

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

פתרונות לפי התיעוד הרשמי:

1. הגדר ספריית עבודה לפני הרצת המתקין:

   העתק

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

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

#שגיאת Raw mode is not supported במהלך ההתקנה

כאשר ההגדרות הארגוניות כוללות שינויים הדורשים אישור אבטחה, גרסאות ישנות מ-2.1.246 ניסו להציג את חלונית האישור במהלך שלב claude install. החלונית דורשת מסוף (terminal) על ה-stdin, אך בעת התקנה דרך צינור (curl ... | bash) הקלט הוא הצינור ולא מסוף, ולכן ההתקנה נכשלה עם הודעת Raw mode is not supported.

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

#תקיעה בפקודות claude update או claude doctor

הפקודות סורקות את קובצי הגדרות המעטפת לאיתור כינויי claude ישנים: ~/.zshrc, ~/.bashrc, ~/.config/fish/config.fish, וב-macOS את הראשון שקיים מבין ~/.bash_profile, ~/.bash_login, או ~/.profile (או $ZDOTDIR/.zshrc). בגרסאות קודמות ל-2.1.214, אם אחד הנתיבים הללו היה תיקייה במקום קובץ, הפקודות נתקעו ללא פלט וסעיף אבחון המערכת ב-/status נותר ריק.

בדוק האם קיים נתיב שהוא תיקייה:

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

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

#אפליקציית Claude Desktop עוקפת את פקודת ה-CLI ב-Windows

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

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

#דרישת מעטפת Git Bash או PowerShell ב-Windows

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

אם PowerShell חסר ב-PATH, הנתיב הרגיל שלו הוא C:\Windows\System32\WindowsPowerShell\v1.0\. הוסף אותו ל-PATH או התקן את PowerShell 7.

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

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

1. נתיבי ברירת המחדל C:\Program Files\Git ו-C:\Program Files (x86)\Git.
2. ה-git המופיע ב-PATH שלך, תוך שימוש ב-bin\bash.exe של אותה התקנה. (בשלב זה קלוד קוד מדלג על git שנמצא בתיקייה שממנה הפעלת את הכלי או מתחתיה בנתיב המכיל node_modules או תיקיות סביבה וירטואלית כגון .venv או env).

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

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

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

#היעדר תמיכה ב-Windows בגרסת 32 סיביות

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

בדוק בחלון שבו הופיעה השגיאה:

[Environment]::Is64BitOperatingSystem

אם הפלט הוא True, מערכת ההפעלה תקינה: סגור את החלון, פתח את Windows PowerShell הרגיל (ללא סיומת x86) והרץ שוב את ההתקנה. אם הפלט הוא False, מערכת ההפעלה היא ב-32 סיביות ואינה נתמכת.

#אי-התאמה בין ספריות musl ו-glibc בלינוקס

אם מופיעות שגיאות על ספריות משותפות חסרות (כגון libstdc++.so.6 או libgcc_s.so.1), ייתכן שהמתקין הוריד קובץ בינארי שגוי. הדבר עלול לקרות במערכות glibc שמותקנות בהן חבילות הידור של 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

#שגיאת Illegal instruction ודרישת AVX

השגיאה Illegal instruction מעידה שהקובץ הבינארי עושה שימוש בהוראות מעבד שאינן נתמכות. קיימות שתי סיבות אפשריות:

• אי-התאמת ארכיטקטורה: המתקין הוריד קובץ שגוי (למשל x86 בשרת ARM). בדוק בעזרת uname -m בלינוקס/macOS או $env:PROCESSOR_ARCHITECTURE ב-PowerShell. אם יש אי-התאמה, פתח דיווח ב-GitHub.
• היעדר סט פקודות AVX: המעבד ישן מדי (מיוצר לפני שנת 2013 לערך), או שמכונה וירטואלית אינה מעבירה את הוראות ה-AVX מהמארח למערכת האורחת. במכונה וירטואלית הרץ grep -m1 -ow avx /proc/cpuinfo; תוצאה ריקה פירושה ש-AVX אינו זמין. אין מעקף בקובץ הבינארי המקורי עבור מעבדים ללא AVX (ניתן לעקוב אחר issue #50384).

#שגיאות טעינה dyld ב-macOS

שגיאות מסוג dyld: Symbol not found: _ubrk_clone (המצביעות על libicucore) או dyld: cannot load ו-Abort trap: 6 מעידות שגרסת ה-macOS ישנה מהגרסה הנתמכת.

פתרונות לפי התיעוד הרשמי:

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

#שגיאת Exec format error ב-WSL1

השגיאה cannot execute binary file: Exec format error בהרצת claude ב-WSL מעידה על שימוש ב-WSL1 ופגיעה ברגרסיה במבנה הקובץ הבינארי (מנוהל תחת issue #38788).

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

#תקלות התקנת npm בתוך WSL

אם התקנת את קלוד קוד באמצעות 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: סביבת ה-WSL משתמשת בהתקנת ה-Node של Windows. ודא באמצעות which npm ו-which node: נתיב המתחיל ב-/mnt/c/ הוא בינארי של Windows, בעוד נתיב לינוקס מתחיל ב-/usr/. התקן את Node דרך מנהל החבילות של לינוקס או דרך nvm.
• התנגשויות גרסאות ב-nvm: אם nvm מותקן גם ב-Windows וגם ב-WSL, הנתיב של Windows עלול לקבל עדיפות. ודא שטוען ה-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"

  או הצב במפורש את נתיב ה-Node של לינוקס בראש ה-PATH:

  העתק

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

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

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

חבילת ה-npm של קלוד קוד מורידה את הקובץ הבינארי כתלות אופציונלית לכל פלטפורמה, ומריצה סקריפט postinstall שמעתיק את הקובץ למקומו כפקודת claude. אם ההורדה או הרצת הסקריפט נכשלו, מופיעה השגיאה:

Error: claude native binary not installed.

ב-Windows, הקובץ bin/claude.exe נשאר סקריפט מעטפת במקום קובץ הפעלה אמיתי ואינו מסוגל לרוץ.

גורמים ופתרונות:

• תלויות אופציונליות מבוטלות: אם השתמשת ב---omit=optional ב-npm, ב---no-optional ב-pnpm, ב---ignore-optional ב-yarn, או שהוגדר optional=false בקובץ .npmrc, הקובץ הבינארי כלל לא ירד. הסר את הדגל והתקן מחדש.
• סקריפטי התקנה מבוטלים: אם הופעל הדגל --ignore-scripts, הרץ ידנית את סקריפט ההתקנה: node node_modules/@anthropic-ai/claude-code/install.cjs. לחלופין ניתן להפעיל את הכלי באמצעות המעטפת: node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs.
• פלטפורמה שאינה נתמכת: קובצי הרצה רשמיים קיימים עבור 8 פלטפורמות בלבד. מערכות כמו FreeBSD אינן נתמכות.
• מאגר npm ארגוני: ודא שהמאגר הפנימי משקף את כל שמונה חבילות הפלטפורמה (@anthropic-ai/claude-code-*) לצד חבילת העל.

#שגיאת npm ENOTEMPTY בעת שדרוג או התקנה מחדש

שגיאת npm error code ENOTEMPTY ו-directory not empty, rename מתרחשת כאשר npm מנסה להזיז את ספריית החבילה הישנה הצידה ונכשל עקב קבצים שנשארו בתיקייה או תיקיות זמניות מהרצות קודמות שנקטעו.

פתרונות לפי התיעוד הרשמי: מחק את תיקיית החבילה ואת תיקיות .claude-code-* הזמניות:

ב-macOS וב-Linux:

rm -rf "$(npm root -g)/@anthropic-ai/claude-code"
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.

#צעדים נוספים אם הבעיה לא נפתרה

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

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