התקנת קלוד קוד ב-Windows היא תהליך של כ-10 דקות, וברוב המקרים הוא עובר חלק. אבל בדיוק בגלל שמדובר בכלי טרמינל, יש שתיים-שלוש שגיאות נפוצות שתופסות אנשים בפעם הראשונה, בעיקר סביב PATH ו-PowerShell. במדריך הזה נעבור על ההתקנה של Claude Code צעד אחר צעד, ואז נפתור את כל השגיאות שאתה עלול לפגוש, עם הפקודות המדויקות.
הנחת הפתיחה: אתה על Windows 10 או Windows 11, ויש לך הרשאת admin על המחשב. זה הכל מה שצריך.
שלב 1: התקנת Node.js
Claude Code מותקן דרך npm, מנהל החבילות של Node.js. לכן הצעד הראשון הוא להתקין Node.js:
- היכנס לאתר הרשמי
nodejs.org. - הורד את גרסת ה-LTS (התומכת לטווח ארוך), לא את גרסת ה-Current הניסיונית.
- הרץ את קובץ ה-installer ולחץ Next עד הסוף. חשוב: השאר מסומן את האפשרות "Add to PATH".
אחרי ההתקנה, פתח PowerShell (חפש "PowerShell" בתפריט התחל) וּודא שהכל תקין:
node --version
npm --versionאתה אמור לראות מספרי גרסה, למשל v20.11.0 ו-10.2.4. אם רואים מספרים, מצוין, אפשר להמשיך.
שלב 2: התקנת Claude Code דרך npm
עכשיו מתקינים את קלוד קוד עצמו. באותו חלון PowerShell, הרץ:
npm install -g @anthropic-ai/claude-codeה--g מתקין את הכלי באופן גלובלי, כך שתוכל להריץ claude מכל תיקייה. ההתקנה לוקחת דקה-שתיים. אם היא הסתיימה בלי שגיאות אדומות, עברת את החלק הקשה.
טיפ: אל תריץ את הפקודה עם sudo (זה בכלל לא קיים ב-Windows) ואל תנסה להתקין מתוך תיקייה עם הרשאות מוגבלות. אם אתה נתקל בשגיאת EACCES או הרשאות, פתח את PowerShell במצב "Run as administrator" ונסה שוב.
שלב 3: כניסה והרצה ראשונה
עבור לתיקיית פרויקט כלשהי (אפילו תיקייה ריקה לבדיקה) והפעל את Claude Code:
cd C:\Users\שם-המשתמש\my-project
claudeבהפעלה הראשונה, Claude Code יפתח דפדפן ויבקש ממך להתחבר לחשבון Anthropic שלך. אם אין לך חשבון, תיצור אחד בחינם. אחרי האישור, חזור לטרמינל, תראה שאתה מחובר, ותופיע שורת קלט להקלדת בקשות.
נסה בקשה ראשונה פשוטה בעברית: "צור קובץ README קצר לפרויקט הזה". Claude יראה לך את מה שהוא עומד לכתוב, אתה מאשר, והקובץ נוצר. זהו, ההתקנה עבדה.
פתרון שגיאות נפוצות ב-Windows
אלה שלוש התקלות שתופסות כמעט כל מי שמתקין את קלוד קוד ב-Windows בפעם הראשונה, והפתרון המדויק לכל אחת:
שגיאה 1: "claude is not recognized"
ההודעה המלאה נראית כך:
claude : The term 'claude' is not recognized as
the name of a cmdlet, function, script file...המשמעות: התקנת ה-npm הצליחה, אבל התיקייה שבה npm שם את הפקודות הגלובליות לא נמצאת ב-PATH. הפתרון ב-90% מהמקרים: סגור לגמרי את PowerShell ופתח חלון חדש, משתני הסביבה נטענים מחדש רק בפתיחת טרמינל חדש. אם זה עדיין לא עובד, בדוק לאן npm מתקין:
npm config get prefixקח את הנתיב שחזר (למשל C:\Users\שם\AppData\Roaming\npm) וּודא שהוא מופיע במשתנה PATH: חפש "Edit environment variables" בתפריט התחל, ערוך את Path, והוסף את הנתיב אם הוא חסר.
שגיאה 2: PowerShell Execution Policy חוסם
לפעמים PowerShell מסרב להריץ סקריפטים ומחזיר "running scripts is disabled on this system". זה קורה כי מדיניות ההרצה של Windows מוגדרת ל-Restricted כברירת מחדל. הפתרון, הרץ פעם אחת (ב-PowerShell כ-administrator):
Set-ExecutionPolicy -Scope CurrentUser RemoteSignedזה מאפשר הרצת סקריפטים חתומים עבור המשתמש שלך בלבד, בלי לפגוע באבטחת המערכת. אשר עם Y כשמבקשים.
שגיאה 3: גרסת Node ישנה מדי
אם קיבלת שגיאה שמזכירה גרסת Node לא נתמכת, כנראה שהיתה התקנה ישנה על המחשב. הסר את Node הישן דרך "Add or remove programs", התקן מחדש גרסת LTS עדכנית, ואז חזור על שלב 2.
| שגיאה | סיבה | פתרון מהיר |
|---|---|---|
| claude not recognized | PATH לא רוענן | סגור ופתח PowerShell מחדש |
| scripts is disabled | Execution Policy מגביל | Set-ExecutionPolicy RemoteSigned |
| EACCES / הרשאות | אין הרשאת admin | Run as administrator |
| Node not supported | גרסת Node ישנה | התקן מחדש Node LTS |
מה עושים אחרי ההתקנה?
עכשיו שקלוד קוד עובד, כדאי ללמוד להשתמש בו נכון. למדריך מלא עם כל הפקודות וה-workflows, קראו את מדריך ההתקנה וההפעלה המורחב שלנו. ובקורס החינמי יש שיעורים שיקחו אותך הלאה:
- שיעור 0b, Claude Code על המחשב (אופציונלי למתקדמים), הרחבה על ההתקנה והשילוב עם VS Code.
- Claude Code ו-MCP, שליטה מלאה על כלים חיצוניים, לחבר את Claude Code לכלים חיצוניים.
- Claude Code עם Git Worktrees, להריץ כמה sessions במקביל ולעבוד יעיל יותר.
שאלות נפוצות
איך מתקינים את Claude Code ב-Windows?
קודם מתקינים Node.js בגרסת LTS מהאתר הרשמי nodejs.org. אחר כך פותחים PowerShell ומריצים את הפקודה npm install -g @anthropic-ai/claude-code. בסיום, מריצים claude בתוך תיקיית פרויקט, ומתחברים לחשבון Anthropic דרך הדפדפן שנפתח. כל התהליך לוקח כ-10 דקות.
מה עושים כשמופיעה שגיאה ש-claude לא מזוהה כפקודה ב-Windows?
השגיאה 'claude is not recognized' פירושה שתיקיית ה-npm הגלובלית לא נמצאת ב-PATH. סגור ופתח מחדש את PowerShell כדי לרענן את משתני הסביבה. אם זה לא עוזר, הרץ npm config get prefix כדי לראות את נתיב ההתקנה, ווודא שהתיקייה הזו מופיעה במשתנה PATH של המערכת. לרוב אתחול הטרמינל פותר את הבעיה.
האם צריך את WSL כדי להריץ Claude Code ב-Windows?
לא חובה. Claude Code רץ ישירות על Windows דרך PowerShell או Command Prompt לאחר התקנת Node.js. עם זאת, מפתחים רבים מעדיפים להשתמש ב-WSL (Windows Subsystem for Linux) כי חלק מכלי הפיתוח ופקודות ה-git עובדים חלק יותר בסביבת Linux. אם אתה רק מתחיל, PowerShell מספיק לחלוטין.
