מדריך קלוד קוד
המלא בעברית

מה זה Claude Code?

Claude Code הוא כלי AI לפיתוח תוכנה שפותח על ידי Anthropic ופועל ישירות בטרמינל (שורת הפקודה). בניגוד ל-Cursor או GitHub Copilot שהם תוספים ל-IDE, Claude Code הוא CLI עצמאי שיכול לפעול בכל סביבת עבודה.

Claude Code יכול לקרוא ולכתוב קבצים, להריץ פקודות, לנפות שגיאות, לנהל Git, לגלוש בתיעוד ולבצע משימות מורכבות מרובות שלבים, כולל יצירת סוכני AI עצמאיים (Agents) שעובדים במקביל.

ההבדל המהותי מכלי צ'אט רגיל הוא שהוא סוכן (agent), לא רק צ'אטבוט. כשמבקשים ממנו לתקן באג, הוא לא מחזיר לך פסקת קוד להעתיק, הוא קורא בעצמו את הקבצים הרלוונטיים בפרויקט, מזהה את המקור לבעיה, עורך את הקבצים ישירות, מריץ את הבדיקות כדי לוודא שהתיקון עובד, ואם משהו נשבר, מתקן שוב. הלולאה הזו של "קרא → תכנן → בצע → אמת" היא הלב של העבודה מולו.

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

מה Claude Code יכול לעשות?

• ✅ לקרוא, לכתוב ולשנות קבצי קוד
• ✅ להריץ פקודות Bash, npm, git ועוד
• ✅ לנפות שגיאות ולהציע תיקונים
• ✅ לבצע Refactoring מקיף על פרויקטים גדולים
• ✅ לחפש בתיעוד ובאינטרנט (עם MCP)
• ✅ לנהל סוכני AI מקבילים (Parallel Agents)
• ✅ לעבוד עם מסדי נתונים, APIs וכלים חיצוניים (MCP)

התקנה שלב-אחר-שלב

דרישות מקדימות

• Node.js גרסה 18 ומעלה (nodejs.org)
• חשבון Anthropic (console.anthropic.com)
• מנוי Claude Pro ($20/חודש) או קרדיט API

שלב 1: התקן Claude Code

שלב 2: כניסה לחשבון

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

שלב 3: אמת את ההתקנה

שלב 4: פתח פרויקט קיים

התקנה בווינדוס, WSL2

Claude Code רץ באופן טבעי על macOS ו-Linux. בווינדוס הדרך המומלצת היא להתקין אותו בתוך WSL2 (Windows Subsystem for Linux), שנותן סביבת Linux מלאה בתוך ווינדוס. אם עוד לא התקנת WSL, פותחים PowerShell כמנהל ומריצים:

לאחר אתחול המחשב, נכנסים ל-Ubuntu שהותקן, מתקינים שם Node.js 18+ ואז מריצים את פקודת ההתקנה של Claude Code כרגיל. חשוב לעבוד על קבצים שנמצאים בתוך מערכת הקבצים של Linux (למשל ~/projects) ולא על נתיבי /mnt/c/, כדי למנוע בעיות ביצועים והרשאות.

שגיאות התקנה נפוצות ואיך לפתור

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

הפתרון הנקי הוא להגדיר תיקיית npm גלובלית בתוך ספריית הבית שלך, כדי לא להריץ את npm עם sudo:

שגיאה שכיחה נוספת היא command not found: claude אחרי התקנה מוצלחת, סימן שתיקיית ה-bin של npm לא נמצאת ב-PATH. אמת עם npm bin -g היכן npm שם קבצים בינאריים, והוסף את הנתיב הזה ל-PATH בקובץ ה-profile של ה-shell.

CLAUDE.md, ההנחיות שמשנות הכל

CLAUDE.md הוא קובץ Markdown שיוצרים בשורש הפרויקט. Claude Code קורא אותו אוטומטית בתחילת כל שיחה ומשתמש בו כהקשר לכל הפעולות.

מה לשים ב-CLAUDE.md?

היררכיה של קבצי CLAUDE.md

אפשר להחזיק כמה קבצי CLAUDE.md ברמות שונות, ו-Claude Code מאחד אותם אוטומטית לפי סדר קדימות:

• ~/.claude/CLAUDE.md, הנחיות אישיות גלובליות שחלות על כל הפרויקטים (למשל "תמיד ענה בעברית").
• CLAUDE.md בשורש הפרויקט, הנחיות משותפות שנכנסות ל-Git ומשמשות את כל הצוות.
• CLAUDE.local.md, הנחיות אישיות לפרויקט הספציפי, שלא נכנסות ל-Git (מוסיפים ל-.gitignore).

טעות נפוצה, CLAUDE.md ארוך מדי

מפתה למלא את הקובץ בכל פרט אפשרי, אבל קובץ ענק דווקא מבזבז את חלון ההקשר ומטשטש את מה שחשוב. שמור אותו ממוקד: כללים שקריטי שלא יופרו, מבנה הפרויקט ברמת-על, ופקודות מרכזיות. אם צריך להסביר משהו לעומק, הפנה לקובץ תיעוד נפרד במקום להעתיק אותו פנימה. הטיפ הפרקטי: הוסף שורה כמו "לפני commit, הרץ npm run lint && npm test", Claude יזכור לעשות זאת בכל פעם.

פקודות עיקריות

פקודה	תיאור	דוגמה
/help	רשימת כל הפקודות הזמינות	/help
/clear	מנקה את ההיסטוריה של השיחה	/clear
/compact	מדחס את ההיסטוריה לחסכון בטוקנים	/compact
/model	בחירת מודל (Opus/Sonnet/Haiku)	/model claude-opus-4-7
/mcp	ניהול חיבורי MCP	/mcp list
@	הזכרת קובץ ספציפי בשיחה	@src/index.ts

MCP, חיבור לכלים חיצוניים

MCP (Model Context Protocol) הוא פרוטוקול שפיתחה Anthropic המאפשר ל-Claude Code לתקשר עם כלים חיצוניים. כל כלי שתרצה לחבר ל-Claude הוא "MCP Server". רוצה להעמיק? קרא את המדריך המלא ל-MCP בעברית, איך זה עובד, חיבור שלב-אחר-שלב ובניית שרת משלך.

דוגמאות לשרתי MCP פופולריים

• Filesystem MCP, גישה לקבצים ותיקיות מקומיים מהשיחה
• Playwright MCP, אוטומציה ובדיקות בדפדפן
• GitHub MCP, ניהול Issues, PRs ו-Repos
• Slack MCP, שליחת הודעות וקריאת ערוצים
• Context7 MCP, קריאת תיעוד של ספריות בזמן אמת

הגדרת MCP בקובץ settings.json

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

Agents, סוכני AI

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

מתי להשתמש ב-Agents?

• כשיש כמה משימות בלתי תלויות שאפשר לבצע במקביל
• כשמשימה ארוכה וניתן לפצל אותה לחלקים
• כשצריך לבדוק אותה קוד ממספר זוויות (security, performance, UX)

כל סוכן עובד בהקשר משלו ומחזיר סיכום בלבד, כך הסוכן הראשי לא מתמלא בפרטים ומרוויח מקום בחלון ההקשר. חשוב לזכור שסוכנים מקבילים לא רואים זה את השינויים של זה בזמן אמת, ולכן מומלץ שכל סוכן יעבוד על אזור נפרד בקוד כדי למנוע התנגשויות. לעבודה מקבילית אמיתית על אותו repo בלי דריכה הדדית, אפשר לשלב את זה עם Claude Code עם Git Worktrees, כל סוכן על branch ותיקייה משלו.

Claude Code vs Cursor vs GitHub Copilot

קריטריון	Claude Code	Cursor	GitHub Copilot
סוג	CLI (טרמינל)	IDE מלא	תוסף VS Code
מודל AI	Claude Opus 4.7	GPT-4o / Claude	GPT-4o / Codex
Agentic	✅ חזק מאוד	⚠️ מוגבל	❌ אין
MCP	✅ מלא	⚠️ חלקי	❌ אין
מחיר	Claude Pro $20/חודש	$20/חודש	$10-$19/חודש
עברית	✅ מצוין	✅ טוב	✅ טוב
גמישות	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐⭐

טיפים לשימוש יעיל

1. תאר את ה"למה", לא רק את ה"מה"

במקום: "שנה את הצבע של הכפתור ל-כחול", כתוב: "שנה את הצבע כי הבדיקות הראו שכחול מגדיל המרות ב-15%". ההקשר עוזר ל-Claude לקבל החלטות טובות יותר.

2. השתמש ב-@file להתייחסות ספציפית

3. /compact כל כמה שיחות

כשהשיחה ארוכה, הטוקנים מתרבים. /compact מסכם את ההיסטוריה ומוחק פרטים ישנים, כך Claude ממשיך בלי לאבד הקשר חשוב.

4. CLAUDE.md עם TODO list

הוסף סעיף "Current Focus" ל-CLAUDE.md עם המשימות הנוכחיות. Claude יוכל לזכור מה הורשם בסשן הקודם.

5. תן ל-Claude לכתוב בדיקות קודם

אחת השיטות היעילות ביותר היא לבקש מ-Claude לכתוב את הבדיקה לפני הקוד עצמו, ואז לממש עד שהיא עוברת. הבדיקה משמשת כ"חוזה" ברור, ו-Claude יודע בדיוק מתי הוא סיים. זו בדיוק גישת ה-TDD עם Claude Code, Red, Green, Refactor.

דוגמה מלאה, מהתקנה עד ה-commit הראשון

בואו נעבור על תרחיש אמיתי מקצה לקצה: יש לך פרויקט Node קטן, ואתה רוצה ש-Claude Code יוסיף פיצ'ר, יבדוק אותו, ויבצע commit, הכל בשיחה אחת. כך זה נראה בפועל.

שלב 1: פתיחת הפרויקט

נכנסים לתיקייה ומפעילים את Claude Code:

שלב 2: לתת לו להבין את הקוד

לפני שמבקשים שינוי, נותנים לו להתמצא. פרומפט טוב בעברית:

Claude יסרוק את הקבצים, יזהה למשל ש-routes/tasks.js מכיל את ה-endpoints, ויחזיר סיכום. עכשיו יש לו, וגם לך, תמונה משותפת.

שלב 3: לבקש את הפיצ'ר

Claude יכתוב את הבדיקה, יריץ אותה ויראה שהיא נכשלת (כי הקוד עוד לא קיים), יוסיף את ה-endpoint, ויריץ שוב עד שהבדיקה עוברת.

שלב 4: כשמופיעה שגיאה

נניח שהרצת הבדיקות מחזירה:

לא צריך לתקן בעצמך, פשוט כותבים "הבדיקה נכשלת עם השגיאה הזו, תקן". Claude קורא את שורה 42, מבין שהוא ניגש ל-req.params לפני ולידציה, מתקן, ומריץ שוב.

שלב 5: ה-commit

Claude מריץ npm test, מוודא שהכל עובר, מבצע git add ו-git commit, ומראה לך את ה-diff. סיימת פיצ'ר שלם בלי לכתוב שורת קוד אחת ידנית. אם אתה חדש לגמרי בטרמינל, כדאי להתחיל משיעור ההתקנה של Claude Code על המחשב ורק אז לחזור לכאן.

10 טעויות נפוצות ואיך להימנע מהן

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

הטעות	למה זה בעייתי	מה לעשות במקום
פרומפט מעורפל ("תקן את זה")	Claude מנחש מה התכוונת	תאר את הבעיה, הקובץ והתוצאה הרצויה
לא יוצרים CLAUDE.md	הקשר אובד בין שיחות	הגדר CLAUDE.md עם כללים וטכנולוגיות
שיחה אחת ארוכה מדי	ההקשר מתמלא ואיכות יורדת	הרץ /clear בין משימות שונות
לא בודקים את ה-diff	שינויים לא צפויים נכנסים בשקט	קרא את השינוי לפני שמאשרים commit
מבקשים הכל בבת אחת	הרבה שגיאות שקשה לבודד	פצל למשימות קטנות ובדיקות ביניים
מדלגים על בדיקות	אין דרך לדעת שהתיקון עובד	בקש בדיקה אוטומטית לכל פיצ'ר
לא מסבירים את ה"למה"	החלטות פחות טובות	ספק הקשר עסקי לכל בקשה
מריצים npm עם sudo	בעיות הרשאות עתידיות	הגדר תיקיית npm-global בבית
מתעלמים מ-Plan Mode	Claude קופץ למימוש בלי תוכנית	השתמש ב-Plan Mode למשימות גדולות
לא מנצלים MCP	עובדים ידנית מול כלים חיצוניים	חבר MCP למסד נתונים, GitHub ועוד

אם אתה רוצה להעמיק בבניית פרומפטים מדויקים שמונעים חצי מהטעויות האלה, כדאי לעבור על מדריך ה-Prompt Engineering בעברית, ולחבר את Claude Code לכלים חיצוניים לפי מדריך ה-MCP.

Plan Mode ו-Extended Thinking, עבודה מתקדמת

שני מנגנונים משנים לחלוטין את איכות התוצאה במשימות מורכבות: Plan Mode ו-Extended Thinking. שווה להכיר את שניהם.

Plan Mode, תכנון לפני ביצוע

ב-Plan Mode, Claude Code חוקר את הקוד ומציג תוכנית פעולה מפורטת, אילו קבצים ישתנו ומה הלוגיקה, בלי לגעת בקוד עד שאתה מאשר. זה קריטי במשימות גדולות (רפקטור רחב, פיצ'ר שנוגע בכמה מודולים) כי אתה תופס טעויות בשלב התכנון, כשהתיקון זול, ולא אחרי ש-20 קבצים כבר שונו. נכנסים למצב הזה בלחיצה על Shift+Tab שמחליפה בין מצבי העבודה, או בבקשה מפורשת: "תכנן קודם, אל תיגע בקוד עד שאאשר".

Extended Thinking, לתת ל-Claude לחשוב לעומק

למשימות שדורשות היגיון מורכב, דיבוג באג עמום, החלטת ארכיטקטורה, אלגוריתם מסובך, אפשר להפעיל חשיבה מורחבת. מוסיפים לפרומפט מילות טריגר כמו "think" או "think hard", ו-Claude מקדיש שלב חשיבה גלוי לפני שהוא עונה, שוקל חלופות ובודק את עצמו. זה עולה יותר טוקנים וזמן, אבל התוצאה לרוב מדויקת בהרבה. ההעמקה המלאה בנושא נמצאת בשיעור Extended Thinking, Claude חושב לפני שמשיב.

שאלות נפוצות

מה זה Claude Code?

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

כמה עולה Claude Code?

Claude Code עצמו חינמי להורדה. הוא משתמש בחשבון Claude Pro (כ-$20 לחודש) או ב-Anthropic API בתשלום לפי שימוש (tokens). הקורס בבית הספר של Claude שמלמד אותך להשתמש בו ביעילות הוא חינם לגמרי, כל 127 השיעורים ללא תשלום.

מה ההבדל בין Claude Code ל-Cursor?

Claude Code הוא CLI (ממשק שורת פקודה) שפועל בכל IDE. Cursor הוא IDE מבוסס VS Code עם AI מובנה. Claude Code גמיש יותר ומאפשר אוטומציה עמוקה יותר, בעוד Cursor יותר ידידותי למתחילים עם ממשק גרפי.

מה זה CLAUDE.md?

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

מה זה MCP ב-Claude Code?

MCP (Model Context Protocol) הוא פרוטוקול חיבור שמאפשר ל-Claude Code לתקשר עם כלים חיצוניים, מסדי נתונים, ממשקי API, קבצים, דפדפנים ועוד. זה כמו חיבור של Claude Code לאינטרנט של כלים.

מה דרישות המערכת של Claude Code?

Claude Code דורש Node.js גרסה 18 ומעלה, טרמינל (macOS, Linux, או Windows דרך WSL2 או PowerShell), חיבור אינטרנט וחשבון Anthropic פעיל. הוא רץ מצוין על macOS ו-Linux, ובווינדוס מומלץ להתקין אותו בתוך WSL2 לחוויה חלקה יותר. אין צורך במחשב חזק, כל העיבוד קורה בשרתי Anthropic.

האם צריך לדעת לתכנת כדי להשתמש ב-Claude Code?

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

מה ההבדל בין Claude Code ל-ChatGPT?

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

איך מעדכנים את Claude Code לגרסה החדשה?

מעדכנים דרך npm בעזרת הפקודה npm update -g @anthropic-ai/claude-code, או מתקינים מחדש עם npm install -g @anthropic-ai/claude-code@latest. אפשר לבדוק את הגרסה המותקנת עם claude --version. Claude Code גם מודיע לך בתוך הטרמינל כשיש גרסה חדשה זמינה.