נקודות מרכזיות
- נייטיב לטרמינל (Terminal-native), לא צ'אטבוט: Claude Code רץ ישירות על הקבצים המקומיים שלך, מבצע אינדוקס לכל מבנה הפרויקט, ופועל דרך מערכת הרשאות שבה אתה מאשר כל שינוי בקובץ וכל הרצת פקודה.
- Plan Mode למשימות מורכבות: אמור ל-Claude לתכנן את הגישה שלו לפני ביצוע שינויים -- הוא מנתח את הבעיה, מפרט את הצעדים, מציג את אופן החשיבה, ומחכה לאישור שלך לפני הביצוע.
- Sonnet עבור 80%, Opus עבור 20%: השתמש ב-Sonnet 4.6 למשימות יומיומיות (מהיר, חסכוני); עבור ל-Opus 4.6 עבור refactoring מורכב של מספר קבצים, החלטות ארכיטקטוניות, או Agent Teams.
- CLAUDE.md מגביר עקביות: צור קובץ CLAUDE.md ספציפי לפרויקט עם מוסכמות קידוד, העדפות של ה-tech stack, ודרישות בדיקה ש-Claude קורא אוטומטית בכל session.
מדריך Claude Code למתחילים: המדריך המלא לתחילת העבודה
Claude Code הוא עוזר הקידוד מבוסס AI שחי בטרמינל שלך.
נבנה על ידי Anthropic, הוא מתחבר ישירות ל-codebase שלך, מבין את מבנה הפרויקט, וכותב קוד אמיתי על המכונה שלך — הכל דרך שיחה בשפה טבעית. מאז שהושק לציבור הרחב במאי 2025, Claude Code צמח להיות אחד מכלי הפיתוח מבוססי ה-AI הנפוצים ביותר, ותורם לכך ש-Anthropic הגיעה להכנסות שנתיות של מעל 1 מיליארד דולר בנובמבר 2025.
המדריך הזה ייקח אתכם מאפס ליצרנות (productive). אין צורך בניסיון קודם בכלי AI.
תוכן עניינים
- מה זה Claude Code?
- דרישות קדם והתקנה
- ה-session הראשון שלך
- רשימת פקודות חיוניות
- Plan Mode: חשוב לפני שאתה מקודד
- הגדרת CLAUDE.md
- דוגמאות לתהליכי עבודה מהעולם האמיתי
- בחירה בין Sonnet 4.6 ל-Opus 4.6
- טיפים להפקת המירב מ-Claude Code
מה זה Claude Code?
Claude Code הוא עוזר הקידוד מבוסס ה-AI הנייטיב לטרמינל של Anthropic. בניגוד לצ'אטבוטים מבוססי דפדפן או תוספי IDE, הוא רץ ישירות בתוך הטרמינל שלך ופועל על הקבצים המקומיים שלך.
הנה מה שהופך אותו לשונה:
- מודעות עמוקה ל-codebase — Claude מאנדקס את כל הפרויקט ומבין איך קבצים קשורים אחד לשני
- חשיבה אינטראקטיבית — הוא מציג את תהליך החשיבה שלו ומבקש את הקלט שלך בנקודות החלטה
- ביצוע מקומי — עורך קבצים ומריץ פקודות על המכונה שלך, לא ב-sandbox מרוחק
- מערכת הרשאות — כל שינוי בקובץ והרצת פקודה דורשים את האישור שלך
Claude Code מופעל על ידי Claude Opus 4.6 ו-Claude Sonnet 4.6, המודלים המתקדמים ביותר של Anthropic. הוא תומך ב-context window סטנדרטי של 200K, עם גרסת בטא של 1M tokens הזמינה ב-Opus 4.6.
"Claude Code הוא לא צ'אטבוט. הוא סוכן קידוד (coding agent) שבמקרה מתקשר דרך שיחה."
דרישות קדם והתקנה
מה שאתה צריך
לפני ההתקנה, וודא שיש לך:
- מנוי Claude — לפחות Claude Pro ($20 לחודש)
- אפליקציית טרמינל — Terminal.app (macOS), הטרמינל המועדף עליך בלינוקס, או Windows Terminal
- מערכת הפעלה נתמכת — macOS, Linux, או Windows 11
- Node.js — נדרש עבור שיטת ההתקנה דרך npm
שלב 1: התקנת Claude Code
פתח את הטרמינל והרץ:
npm install -g @anthropic-ai/claude-code
לחלופין, ניתן להתקין דרך הסקריפט הרשמי:
curl -fsSL https://claude.ai/install.sh | sh
שלב 2: אימות ההתקנה
claude --version
אתה אמור לראות את מספר הגרסה הנוכחית מודפס. אם אתה מקבל שגיאת "command not found", וודא שספריית ה-bin של Node.js נמצאת ב-PATH שלך.
שלב 3: ניווט לפרויקט שלך
Claude Code עובד הכי טוב כשהוא מופעל משורש הפרויקט (root):
cd ~/projects/my-app
claude
זהו זה. Claude יסרוק את הפרויקט שלך ואתה מוכן לצאת לדרך.
ה-session הראשון שלך
כשאתה מפעיל את claude בפעם הראשונה בתוך פרויקט, הנה מה שקורה:
- Claude מאנדקס את קבצי הפרויקט ואת המבנה שלו
- הוא פותח שורת פקודה אינטראקטיבית שבה אתה מקליד בשפה טבעית
- אתה שואל שאלות או נותן הוראות, ו-Claude מגיב עם קוד, עריכות או הסברים
אינטראקציה ראשונה פשוטה
נסה להתחיל עם משהו כזה:
> מה הפרויקט הזה עושה? סכם את ה-tech stack ואת מבנה התיקיות.
Claude יסרוק את הקבצים שלך ויתן לך פירוט מובנה של הפרויקט — ה-frameworks, נקודות הכניסה (entry points), והמודולים המרכזיים.
המשך עם משימה אמיתית:
> הוסף וולידציה (validation) לטופס ההרשמה. יש לאמת את האימייל והסיסמה צריכה להיות באורך של 8 תווים לפחות.
Claude יבצע:
- ימצא את רכיב הטופס הרלוונטי
- יראה לך את התוכנית שלו לשינויים
- יבקש את רשותך לפני שינוי קבצים כלשהם
- יחיל את העריכות ויאשר מה השתנה
אתה נשאר בשליטה לאורך כל הדרך. שום דבר לא קורה ללא אישורך.
רשימת פקודות חיוניות
אלו הפקודות שתשתמש בהן בתדירות הגבוהה ביותר בתוך session של Claude Code:
| פקודה | מה היא עושה |
|---|---|
claude | התחלת session חדש של Claude Code |
/help | הצגת כל הפקודות הזמינות |
/plan | כניסה ל-Plan Mode — Claude מתכנן לפני הביצוע |
/clear | ניקוי ה-context של השיחה והתחלה מחדש |
/cost | הצגת השימוש ב-tokens ועלויות מוערכות עבור ה-session |
/compact | דחיסת השיחה כדי לחסוך מקום ב-context window |
אינך צריך לשנן פקודות סלאש (slash commands) כדי להיות פרודוקטיבי. ברוב הזמן, פשוט תקליד את הבקשה שלך בשפה טבעית ו-Claude יבין את השאר.
Plan Mode: חשוב לפני שאתה מקודד
Plan Mode הוא אחד התכונות החשובות ביותר של Claude Code, במיוחד למתחילים.
כשאתה נכנס ל-Plan Mode עם /plan, Claude משנה את התנהגותו:
- הוא מנתח את הבעיה — קורא קבצים רלוונטיים, עוקב אחר תלותיות (dependencies), מזהה אזורים מושפעים
- הוא משרטט תוכנית צעד-אחר-צעד — מה הוא ישנה, באיזה סדר, ולמה
- הוא מציג את אופן החשיבה שלו — אתה רואה איך Claude חושב על הבעיה
- הוא מחכה לאישור שלך — שום דבר לא מתבצע עד שאתה אומר "סע"
מתי להשתמש ב-Plan Mode
- Refactoring מורכב — שינוי שם של מודול המיובא בעשרות קבצים
- פיצ'רים מרובי קבצים — הוספת API endpoint חדש שנוגע ב-routes, controllers, models, ובבדיקות
- Codebases לא מוכרים — כשאתה רוצה להבין את ההשפעה לפני ביצוע שינויים
- למידה — קריאת החשיבה של Claude עוזרת לך להבין את ה-codebase שלך טוב יותר
דוגמה: Plan Mode בפעולה
> /plan
> בצע refactor למודול האימות (authentication) כך שישתמש ב-JWT tokens במקום ב-session cookies.
Claude יגיב עם משהו כזה:
הנה התוכנית שלי:
- עדכון
auth/middleware.jsלאימות JWT tokens במקום בדיקה ב-session store- שינוי
auth/login.jsליצירה והחזרה של JWT בכניסה מוצלחת- עדכון
auth/logout.jsלטיפול בביטול תוקף הטוקן- התאמת ה-API client ב-
frontend/src/api.jsלשליחת טוקנים ב-header של Authorization- עדכון 3 קבצי בדיקה לשימוש ב-fixtures של אימות מבוסס JWT
האם להמשיך?
אתה בודק, שואל שאלות, מתאים את התוכנית במידת הצורך, ואז מאשר.
הגדרת CLAUDE.md
CLAUDE.md הוא קובץ מיוחד ש-Claude קורא אוטומטית בתחילת כל session. חשוב עליו כקובץ הגדרות לאיך Claude צריך להתנהג בפרויקט שלך.
צור את ה-CLAUDE.md שלך
מקם אותו בשורש הפרויקט שלך:
# Project: My SaaS App
## Tech Stack
- Next.js 14 with App Router
- TypeScript (strict mode)
- Tailwind CSS
- PostgreSQL with Prisma ORM
## Coding Conventions
- Use functional components with hooks (no class components)
- All functions must have TypeScript return types
- Use named exports, not default exports
- Write tests for all new utility functions
## Testing
- Run tests with: npm run test
- Use Vitest for unit tests
- Test files go in __tests__ directories next to source files
## Git
- Conventional commits: feat(), fix(), refactor()
- Always create a new branch for features
למה CLAUDE.md חשוב
ללא CLAUDE.md, Claude מנחש הערכות סבירות לגבי המוסכמות שלך. איתו, Claude פועל לפי הסטנדרטים המדויקים שלך מהפרומפט הראשון. זה בעל ערך מיוחד בצוותים שבהם העקביות חשובה.
דוגמאות לתהליכי עבודה מהעולם האמיתי
ניפוי שגיאות בבעיית ייצור
> משתמשים מדווחים שה-dashboard לוקח 15 שניות להיטען.
> בדוק את קריאות ה-API בדף ה-dashboard וזהה צווארי בקבוק בביצועים.
Claude ינתח את ה-dashboard, ימצא קריאות API, יבדוק N+1 queries או אינדקסים חסרים, ויציע תיקונים ספציפיים.
הוספת פיצ'ר חדש
> הוסף כפתור מעבר ל-dark mode לאפליקציה. זה צריך לשמור את העדפת המשתמש
> ב-localStorage ולהחיל אותה בטעינת הדף ללא קפיצה של תוכן לא מעוצב (flash of unstyled content).
Claude יזהה איפה להוסיף את הרכיב, יגדיר theme context, יוסיף לוגיקה ל-localStorage, ויטפל ברינדור הראשוני בצורה נכונה.
Refactoring של קוד ישן
> /plan
> הקובץ הזה משתמש בתבניות async מבוססות callback. בצע לו refactoring לשימוש ב-async/await
> תוך שמירה על אותו API חיצוני.
Claude מתכנן את ה-refactoring, מראה אילו פונקציות משתנות, ומאשר ששום דבר לא נשבר חיצונית לפני שהוא ממשיך.
אינטגרציה עם Git
Claude Code עובד ישירות עם Git. אתה יכול לבקש ממנו:
> צור branch חדש בשם feat/dark-mode, בצע commit לשינויים שעשינו עכשיו,
> ופתח pull request עם תיאור של מה שהשתנה.
Claude ייצור את ה-branch, יוסיף את הקבצים (stage), יכתוב הודעת commit, וישתמש ב-GitHub CLI כדי לפתוח PR — הכל מתוך ה-session בטרמינל.
בחירה בין Sonnet 4.6 ל-Opus 4.6
Claude Code נותן לך גישה לשני מודלים. בחירת המודל הנכון תחסוך לך זמן וכסף.
| Sonnet 4.6 | Opus 4.6 | |
|---|---|---|
| מהירות | Fast | Slower |
| עלות (API) | $3 / $15 לכל 1M tokens | $15 / $75 לכל 1M tokens |
| הכי טוב עבור | רוב משימות הקידוד היומיומיות | ארכיטקטורה מורכבת, refactoring של מספר קבצים |
| Context window | 200K tokens | 200K standard, 1M beta |
| Agent Teams | לא זמין | זמין (Opus בלבד) |
חוק ה-80/20
השתמש ב-Sonnet 4.6 עבור כ-80% מהעבודה שלך: כתיבת פונקציות, תיקון באגים, הוספת פיצ'רים, כתיבת בדיקות, הסברת קוד. הוא מהיר, זול ובעל יכולות מעבר למספקות.
עבור ל-Opus 4.6 עבור ה-20% הקשים ביותר: refactoring בקנה מידה גדול על פני קבצים רבים, החלטות ארכיטקטוניות מורכבות, Agent Teams לעבודה מקבילה, או כשאתה זקוק ל-context window של 1M tokens לניתוח codebase גדול.
טיפים להפקת המירב מ-Claude Code
1. התחל כל פרויקט עם context. לפני צלילה למשימות, בקש מ-Claude לסכם מה הפרויקט עושה. זה עוזר ל-Claude לבנות מודל מנטלי מדויק ומביא לקוד טוב יותר כבר מהפרומפט הראשון.
> מה הפרויקט הזה עושה? הסבר לי את הארכיטקטורה.
2. השתמש ב-Plan Mode לכל דבר מורכב.
אם משימה נוגעת ביותר משני קבצים, השתמש ב-/plan. העלות המוקדמת של התכנון חוסכת ממך שינויים שגויים שקשה יותר לבטל.
3. היה ספציפי בבקשות שלך.
במקום "הפוך את הקוד לטוב יותר", נסה "בצע refactor לפונקציית processPayment כדי שתטפל בחיובים שנכשלו ב-Stripe ותנסה שוב עד 3 פעמים עם exponential backoff."
4. השתמש ב-/compact כשאתה מגיע למגבלות ה-context.
sessions ארוכים צוברים context. כש-Claude מתחיל לאבד מעקב אחר שיחות מוקדמות יותר, הרץ /compact כדי לדחוס את ההיסטוריה ולפנות מקום.
5. צור ותחזק את ה-CLAUDE.md שלך.
זה הדבר בעל ההשפעה הגבוהה ביותר שאתה יכול לעשות. CLAUDE.md טוב מונע תיקונים חוזרים ושומר על Claude מסונכרן עם הסטנדרטים של הצוות שלך.
6. בדוק את ה-diffs לפני האישור. מערכת ההרשאות של Claude קיימת מסיבה כלשהי. קרא את השינויים המוצעים, במיוחד ב-codebases לא מוכרים. Claude חזק אבל לא חסין מטעויות.
7. השתמש באינטגרציה עם Git לתהליכי עבודה נקיים. תן ל-Claude לטפל בחלקים המכניים של Git — יצירת branch, ביצוע commit, כתיבת תיאורי PR — כדי שתוכל להתמקד בבדיקת שינויי הקוד בפועל.
8. שרשר משימות ב-session יחיד. Claude זוכר את ה-context בתוך session. אחרי בניית פיצ'ר, המשך מיד עם "עכשיו כתוב בדיקות למה שהרגע הוספנו" — Claude כבר מכיר את הקוד.
מה הלאה?
כעת יש לך כל מה שצריך כדי להתחיל להשתמש ב-Claude Code בצורה פרודוקטיבית. עקומת הלמידה קצרה: רוב המפתחים מוצאים את הקצב שלהם בתוך ה-sessions הראשונים.
ככל שתרגיש בנוח יותר, חקור את היכולות המתקדמות הללו:
- Agent Teams — הפעל מספר מופעים של Claude לעבודה מקבילה בפרויקטים גדולים (Opus 4.6 בלבד)
- Context window של 1M tokens — נתח codebases עצומים ב-session יחיד (Opus 4.6 בטא)
- פקודות סלאש מותאמות אישית — הפוך תהליכי עבודה חוזרים לאוטומטיים עם פקודות ספציפיות לפרויקט
- אינטגרציה עם CI/CD — הרץ את Claude Code כחלק מצינור הבנייה והביקורת שלך
