TL;DR: התקנת Claude Code לוקחת בפועל כמה דקות, אבל רוב הבעיות של מפתחים ישראלים לא נובעות מ-Claude Code עצמו אלא מסביבת הריצה: גרסת Node ישנה, הרשאות npm שבורות, או ניסיון להריץ על Windows בלי WSL. המדריך הזה עובר צעד-אחר-צעד על התקנה תקינה ב-macOS, ב-Windows דרך WSL וב-Linux, מראה את הפקודות הראשונות שחשוב להכיר, מסביר איך לפתוח פרויקט ראשון נכון, מפנה לקובץ ה-CLAUDE.md שהוא ה"מוח" של הפרויקט, ומסיים בטבלת שגיאות נפוצות עם פתרון לכל אחת. כל הפקודות אמיתיות ומוכנות להעתקה.
מה זה Claude Code ולמה מתקינים אותו בטרמינל
Claude Code הוא סוכן קידוד (agentic coding tool) שרץ ישירות בטרמינל שלכם, קורא וכותב קבצים בפרויקט, מריץ פקודות shell ומבצע משימות פיתוח שלמות מול קוד אמיתי. בניגוד לתוסף עורך או לצ'אט בדפדפן, Claude Code חי בתוך תיקיית הפרויקט שלכם ופועל על מערכת הקבצים המקומית.
המשמעות המעשית: ההתקנה היא של כלי CLI (Command Line Interface), לא של אפליקציה גרפית. הוא מותקן כחבילת npm גלובלית, ולכן דורש סביבת Node.js תקינה. אם אתם מגיעים מרקע של Vibe Coding עם כלים כמו Cursor, Claude Code הוא הצעד המשלים: כלי טרמינל עצמאי שמתאים במיוחד למשימות ריפקטור, דיבוג ואוטומציה על בסיסי קוד קיימים.
עובדה חשובה לפני שמתחילים: Claude Code דורש Node.js בגרסה 18 ומעלה. זו הסיבה מספר אחת לכשלי התקנה, ולכן נתחיל דווקא משם.
שלב 0: לבדוק שיש Node.js תקין
לפני כל התקנה, ודאו שגרסת Node.js על המכונה היא 18 ומעלה, כי גרסאות ישנות יותר יגרמו לכשל שקשה לאבחן. הריצו:
node --version
npm --version
אם אתם רואים משהו כמו v20.11.0 אתם מסודרים. אם הגרסה נמוכה מ-18, או שהפקודה לא מזוהה בכלל, התקינו Node.js דרך מנהל גרסאות. הדרך המומלצת ל-macOS ו-Linux היא nvm:
# התקנת nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# פתחו טרמינל חדש, ואז:
nvm install 20
nvm use 20
node --version
היתרון בשימוש ב-nvm הוא שאתם מקבלים סביבת Node שאינה דורשת הרשאות root להתקנת חבילות גלובליות, וזה חוסך כמעט את כל שגיאות ה-permissions שנדבר עליהן בהמשך.
שלב 1: התקנה ב-macOS
ב-macOS ההתקנה הישירה ביותר היא כחבילת npm גלובלית, בהנחה ש-Node תקין. פתחו את הטרמינל (Terminal או iTerm) והריצו:
npm install -g @anthropic-ai/claude-code
אחרי שההתקנה מסתיימת, ודאו שהכלי זמין:
claude --version
אם אתם מקבלים command not found למרות שההתקנה הצליחה, סימן שתיקיית ה-bin הגלובלית של npm אינה ב-PATH. בדקו איפה npm שם קבצים גלובליים:
npm config get prefix
אם התוצאה היא למשל /Users/you/.npm-global, הוסיפו את תיקיית ה-bin ל-PATH בקובץ ה-shell שלכם (~/.zshrc ב-macOS מודרני):
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
המלצה: אל תריצו לעולם sudo npm install -g. זה פותר את התסמין אבל יוצר קבצים בבעלות root שישברו לכם התקנות עתידיות. אם אתם נתקלים בשגיאת הרשאות, עברו ל-nvm כמו שהוסבר בשלב 0.
שלב 2: התקנה ב-Windows דרך WSL
ב-Windows, הדרך הנכונה והיציבה להריץ Claude Code היא בתוך WSL (Windows Subsystem for Linux), לא ב-PowerShell או ב-CMD ישירות. Claude Code בנוי לסביבת Unix, ו-WSL נותן לכם בדיוק את זה בתוך Windows.
ראשית, התקינו WSL (אם עוד לא מותקן) מתוך PowerShell עם הרשאות אדמין:
wsl --install
הפקודה מתקינה כברירת מחדל את Ubuntu. לאחר ההתקנה תתבקשו לאתחל את המחשב וליצור שם משתמש וסיסמה ל-Linux. מרגע זה, כל העבודה עם Claude Code נעשית בתוך טרמינל ה-Ubuntu, לא ב-Windows רגיל.
בתוך WSL, התקינו Node דרך nvm (כמו בשלב 0) ואז את Claude Code:
# בתוך טרמינל WSL / Ubuntu
nvm install 20
npm install -g @anthropic-ai/claude-code
claude --version
נקודות חשובות ל-WSL:
- עבדו על קבצים שנמצאים בתוך מערכת הקבצים של Linux (למשל
~/projects/myapp) ולא על נתיבי Windows כמו/mnt/c/Users/.... עבודה על/mnt/cאיטית משמעותית ועלולה לגרום לבעיות הרשאות ו-file watching. - אם אתם משתמשים ב-VS Code, התקינו את התוסף WSL כדי לפתוח את הפרויקט ישירות מתוך סביבת ה-Linux (
code .מתוך WSL). - ודאו ש-git מותקן בתוך WSL עצמו (
sudo apt install git), לא רק ב-Windows.
שלב 3: התקנה ב-Linux
ב-Linux ההתקנה זהה בעקרון ל-macOS: חבילת npm גלובלית מעל Node.js תקין. הדרך הנקייה ביותר היא שוב nvm, כדי להימנע לחלוטין מהרשאות root:
# אם node כבר לא מותקן דרך מנהל חבילות המערכת
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 20
# התקנת Claude Code
npm install -g @anthropic-ai/claude-code
claude --version
אם התקנתם Node דרך מנהל החבילות של ההפצה (apt, dnf, pacman) והתקנת ה-npm הגלובלית נכשלת עם שגיאת EACCES, אל תפתרו את זה עם sudo. במקום זאת הגדירו prefix גלובלי בתיקיית הבית:
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code
שלב 4: הרצה ראשונה והתחברות
לאחר ההתקנה, ההרצה הראשונה של Claude Code תבקש מכם להתחבר לחשבון, וזה חד-פעמי לכל מכונה. נווטו לתיקיית פרויקט קיים (או צרו תיקייה חדשה) והריצו פשוט:
cd ~/projects/my-app
claude
בהרצה הראשונה הכלי יפתח תהליך התחברות בדפדפן. עקבו אחרי ההוראות בטרמינל, אשרו את ההרשאה, וחזרו לטרמינל. מרגע זה אתם בתוך סשן אינטראקטיבי של Claude Code, בתוך הקשר הפרויקט הנוכחי.
טיפ: הריצו את claude תמיד מתוך שורש הפרויקט (התיקייה שבה נמצא .git או package.json), כי משם הוא בונה את מפת הקבצים שלו ומבין את מבנה הפרויקט.
שלב 5: הפקודות הראשונות שחשוב להכיר
אחרי ההתקנה, שווה להכיר קומץ פקודות ומצבים בסיסיים שיחסכו לכם זמן מהרגע הראשון. בתוך סשן אינטראקטיבי, הפקודות הפנימיות מתחילות ב-slash:
/help הצגת כל הפקודות הזמינות
/clear ניקוי ההקשר הנוכחי והתחלת שיחה נקייה
/init יצירת קובץ CLAUDE.md אוטומטי לפרויקט
/model בחירה או החלפה של המודל בשימוש
/config פתיחת ההגדרות
מחוץ לסשן, מהטרמינל הרגיל, יש דגלים שימושיים:
# להריץ שאלה חד-פעמית ולקבל תשובה בלי סשן אינטראקטיבי
claude -p "explain what this repo does"
# להמשיך את הסשן האחרון באותה תיקייה
claude --continue
# לעדכן את Claude Code לגרסה האחרונה
claude update
הפקודה /clear חשובה במיוחד: כשמתחילים משימה חדשה שאינה קשורה לקודמת, ניקוי ההקשר משפר את איכות התשובות ומונע בלבול. זה חלק מהנדסת הקשר נכונה, וקשור ישירות למגבלת חלון ההקשר של המודל.
שלב 6: הפרויקט הראשון וקובץ CLAUDE.md
הצעד היחיד שהכי משפר את איכות העבודה עם Claude Code הוא יצירת קובץ CLAUDE.md בשורש הפרויקט. זהו קובץ Markdown שנטען אוטומטית לכל סשן ומשמש כזיכרון קבוע של הפרויקט: מוסכמות קוד, פקודות build ובדיקות, מבנה תיקיות והנחיות סגנון.
הדרך הפשוטה ליצור אותו היא הפקודה הפנימית:
/init
Claude יסרוק את הפרויקט וייצר טיוטת CLAUDE.md ראשונית שתוכלו לערוך. דוגמה למבנה טיפוסי:
# CLAUDE.md
## Project
אפליקציית React + TypeScript + Vite. RTL בעברית.
## Commands
- dev: `npm run dev`
- build: `npm run build`
- test: `npm run test`
## Conventions
- כל קומפוננטה בקובץ נפרד תחת src/components
- אין any ב-TypeScript
- הודעות commit באנגלית, בזמן הווה
הסבר מלא על איך לבנות קובץ אפקטיבי, מה כדאי לכלול ומה לא, נמצא במדריך קובץ CLAUDE.md. זו ההשקעה בעלת התשואה הגבוהה ביותר בכל התקנה חדשה.
שגיאות התקנה נפוצות ואיך לפתור אותן
רוב שגיאות ההתקנה נופלות לחמש קטגוריות, וכולן פתירות בלי sudo. הנה הטבלה המהירה:
| שגיאה / תסמין | סיבה | פתרון |
|---|---|---|
EACCES: permission denied | npm מנסה לכתוב לתיקייה בבעלות root | עברו ל-nvm, או הגדירו prefix בתיקיית הבית (שלב 3) |
claude: command not found | תיקיית ה-bin הגלובלית לא ב-PATH | הוסיפו את $(npm config get prefix)/bin ל-PATH (שלב 1) |
Unsupported engine / כשל שקט | גרסת Node נמוכה מ-18 | nvm install 20 && nvm use 20 |
| הכל תקוע ב-Windows PowerShell | Claude Code דורש סביבת Unix | התקינו והריצו בתוך WSL (שלב 2) |
| ביצועים איטיים מאוד ב-WSL | עבודה על נתיב /mnt/c/... | העבירו את הפרויקט ל-~/ בתוך Linux |
אם אחרי כל זה עדיין יש כשל, נסו התקנה נקייה: הסירו את החבילה, נקו את מטמון npm והתקינו מחדש:
npm uninstall -g @anthropic-ai/claude-code
npm cache clean --force
npm install -g @anthropic-ai/claude-code
עבור שגיאות ריצה שכבר מעבר לשלב ההתקנה (למשל בעיות MCP, timeouts או קונפיגורציה שבורה), ריכזנו מדריך נפרד: שגיאות נפוצות ב-Claude Code ותיקונים.
הצעד הבא: מעבר להתקנה בסיסית
אחרי שההתקנה עובדת ויש לכם CLAUDE.md, הכוח האמיתי של Claude Code נמצא בשכבת ההרחבה שלו. שווה להכיר את ארבעת אבני הבניין:
- Claude Code Hooks - פקודות shell שרצות אוטומטית באירועי מחזור חיים, למשל פורמט אוטומטי אחרי כל עריכה או חסימת פקודות מסוכנות.
- Claude Code Skills - חבילות הוראות רב-פעמיות שהסוכן מפעיל לבד כשמשימה מתאימה לתיאור שלהן.
- Slash Commands - פרומפטים מותאמים ורב-פעמיים שמופעלים עם /name ומשותפים לצוות דרך git.
- Claude Code Plugins - חבילות הפצה שיכולות לארוז יחד commands, subagents, skills, hooks ושרתי MCP בהתקנה אחת.
אם אתם רוצים להעמיק בהפעלת משימות מבודדות בהקשר נפרד, קראו על Subagents ב-Claude Code ועל שרתי MCP לחיבור כלים חיצוניים. למי שמעדיף מדריך יישומי מקיף, יש לנו את המדריך המלא ל-MCP ב-Claude Code ואת ההשוואה בין Cursor, Claude Code ו-Windsurf.
סיכום ו-CTA
התקנה תקינה של Claude Code היא 90% סביבת Node נקייה ו-10% הפקודה עצמה. אם תתחילו מ-nvm, תריצו על WSL ב-Windows, ותוסיפו CLAUDE.md מהיום הראשון, תחסכו לעצמכם את רוב הכאב.
הגעתם עד לכאן אבל הפרויקט עצמו מרגיש שברירי, מלא בקוד שנוצר במהירות ובלי בקרה? הצוות של VibeScale מתמחה בדיוק בזה: לקחת פרויקט Vibe Coding שהסתבך ולהפוך אותו ליציב ומוכן לפרודקשן. התחילו בהצלת פרויקט או הכירו את מסגרת ה-Audit שלנו שבודקת מוכנות לפרודקשן לעומק.
יש שאלה על ההתקנה או משהו לא עובד כמו שצריך? כתבו לנו ישירות בוואטסאפ ונשמח לעזור.
