קלוד קוד (Claude Code): המדריך המלא בעברית

מה זה Claude Code (קלוד קוד)?

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

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

איפה הוא רץ

• טרמינל (CLI): הגרסה המלאה, וממנה מתחיל המדריך הזה
• VS Code ו-Cursor: תוסף עם דיף בתוך העורך
• JetBrains: פלאגין ל-IntelliJ, PyCharm, WebStorm ועוד
• אפליקציית דסקטופ: כמה סשנים במקביל ודיף ויזואלי
• דפדפן: claude.ai/code, בלי התקנה, למשימות ארוכות שרצות בענן

כל הממשקים משתמשים באותו מנוע, כך שקובץ ה-CLAUDE.md, ההגדרות ושרתי ה-MCP של הפרויקט עובדים בכולם.

ומה עם וייב קודינג?

"וייב קודינג" (vibe coding) פירושו לתת ל-AI לכתוב קוד כמעט בלי להסתכל עליו. זה כיף לאב-טיפוס של סוף שבוע, אבל לא לקוד שמשרת לקוחות. במדריך הזה אני מראה את הגרסה המקצועית: אותה מהירות, עם תכנון, טסטים וריוויו, כך שהקוד באמת מגיע לפרודקשן.

התקנה והתחברות

כדי לעבוד עם Claude Code צריך חשבון בתשלום: מנוי Pro, Max, Team או Enterprise, או חשבון Console (API שמחויב לפי שימוש). התוכנית החינמית של claude.ai לא כוללת את Claude Code. ארגונים יכולים לעבוד גם דרך Amazon Bedrock, Google Cloud או Microsoft Foundry.

macOS, Linux ו-WSL

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

Windows (PowerShell)

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

Homebrew

brew install --cask claude-code

ההתקנה הרגילה (native) מתעדכנת לבד ברקע. התקנה דרך Homebrew או WinGet לא מתעדכנת אוטומטית, וצריך להריץ upgrade מדי פעם. יש גם חבילת npm, שדורשת Node.js 22 ומעלה.

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

claude --version
claude doctor

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

ב-Windows מומלץ להתקין Git for Windows, כדי ש-Claude Code יוכל להשתמש ב-Bash. בלעדיו הוא עובד עם PowerShell.

כל אפשרויות ההתקנה נמצאות במדריך ההתקנה הרשמי.

הסשן הראשון בפרויקט אמיתי

היכנסו לתיקיית הפרויקט והפעילו:

cd /path/to/your/project
claude

לא צריך להדביק קבצים או להסביר את המבנה. Claude Code קורא בעצמו את הקבצים שהוא צריך. התחילו בשאלות, לא בשינויים:

what does this project do?
explain the folder structure
where is the main entry point?

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

כשהוא מכיר את הפרויקט, תנו לו משימה קטנה ומוגדרת. Claude Code יראה לכם את השינוי, ולפי מצב ההרשאות יבקש אישור לפני שהוא עורך קבצים (על זה בהמשך). אחר כך אפשר להעביר אליו גם את עבודת ה-git:

add input validation to the user registration form
what files have I changed?
commit my changes with a descriptive message

פקודות שכדאי להכיר מהיום הראשון

• claude -c: ממשיך את השיחה האחרונה בתיקייה
• claude -r או /resume: בוחרים שיחה קודמת מרשימה
• /clear: מתחילים נקי כשעוברים למשימה אחרת
• /compact: מסכם את השיחה כדי לפנות מקום בהקשר
• /model: מחליפים מודל באמצע סשן
• /usage: כמה צרכתם
• Esc: עוצר אותו באמצע. /rewind (או Esc פעמיים) מחזיר לנקודה קודמת
• /help: כל השאר

CLAUDE.md: הזיכרון של הפרויקט

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

הדרך המהירה להתחיל היא להריץ /init בתוך הסשן. Claude סורק את הקוד ויוצר CLAUDE.md עם פקודות build, הוראות טסט ומוסכמות שמצא. אם כבר יש קובץ, הוא מציע שיפורים במקום לדרוס אותו.

/init

איפה הקבצים נמצאים

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

אם בריפו כבר יש AGENTS.md של כלי סוכנים אחר, Claude Code יודע לקרוא גם אותו. בנוסף יש auto memory: Claude שומר לעצמו הערות מהתיקונים וההעדפות שלכם, בלי שתכתבו דבר.

איך כותבים CLAUDE.md טוב

• קצר: עד 200 שורות בערך. קובץ ארוך תופס מקום בהקשר, ו-Claude מקפיד פחות על ההוראות
• ספציפי: "הרץ npm test לפני כל קומיט" עדיף על "תכתוב קוד איכותי"
• בלי סתירות: כששתי הוראות סותרות זו את זו, הוא עלול לבחור אחת באקראי
• ממוקד: הוראות שרלוונטיות רק לחלק מהקוד עוברות ל-.claude/rules/ או ל-Skill

CLAUDE.md הוא הקשר, לא חוק. אם משהו חייב לקרות תמיד, או לעולם לא, השתמשו ב-Hook. עליהם בהמשך.

עוד על זה בתיעוד הזיכרון.

שגרת עבודה שעובדת: תכנון, צעדים קטנים, טסטים, ריוויו

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

1. תכנון. משימה לא טריוויאלית מתחילה ב-Plan Mode: Claude קורא את הקוד ומציע תוכנית, ואתם מתקנים אותה לפני שנכתבה שורת קוד אחת.
2. צעדים קטנים. משימה ברורה אחת בכל פעם. "תוסיף ולידציה לפונקציית ההתחברות ב-auth.ts" עדיף בהרבה על "תשפר את הקוד".
3. טסטים. תנו לו דרך לבדוק את עצמו: טסטים, פלט צפוי, צילום מסך של הבאג. כשהוא יכול להריץ ולבדוק, הוא תופס טעויות לפני שאתם רואים אותן.
4. ריוויו. קראו את הדיף כמו PR של עמית. מה שלא הייתם מאשרים לאדם, אל תאשרו לסוכן.
5. קומיט ו-/clear. סגרתם משימה? קומיט, /clear, והמשימה הבאה מתחילה בהקשר נקי.

שני טריקים שחוסכים הרבה זמן. הראשון: הפניה לקבצים עם @, למשל @src/utils/auth.js, כדי שהוא יקבל אותם מיד. השני: עבודה במקביל עם git worktrees. כל סשן עובד על ענף משלו, והשינויים לא מתנגשים:

claude --worktree feature-auth

אם הוא הולך לכיוון לא נכון, אל תחכו שיסיים. Esc עוצר מיד, ו-/rewind מחזיר את השיחה והקוד לנקודה קודמת.

מצבי הרשאות ו-Plan Mode

מצב ההרשאות קובע מה Claude Code עושה בלי לשאול אתכם. מחליפים מצב באמצע סשן עם Shift+Tab, או בהפעלה עם --permission-mode.

• Manual (default): קורא בלי לשאול, וכל עריכה או פקודה דורשת אישור. לעבודה רגישה ולקוד שאתם לא מכירים
• acceptEdits: עורך קבצים ומריץ פקודות קבצים בסיסיות בלי לשאול. כשאתם עוקבים אחרי השינויים
• plan: חוקר ומציע תוכנית, ולא עורך קוד עד שתאשרו
• auto: מודל נוסף בודק כל פעולה ברקע במקומכם. טוב למשימות ארוכות, בלי "עייפות אישורים". בגרסאות עדכניות זה מצב ההתחלה שנבחר כברירת מחדל
• dontAsk: רק כלים שאושרו מראש, וכל השאר נחסם. ל-CI ולסקריפטים
• bypassPermissions: הכול בלי בדיקות. רק בתוך container או VM מבודדים, אף פעם לא על המחשב שלכם

Plan Mode בפועל

claude --permission-mode plan

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

מעל המצבים אפשר להוסיף כללי allow ו-deny בקובץ ההגדרות. כלל deny חוסם בכל מצב, כולל bypassPermissions, ולכן זה המקום לחסום למשל git push או גישה לקבצי סודות. הפרטים בתיעוד מצבי ההרשאות.

סוכני משנה, Skills, Hooks ו-MCP במילים פשוטות

ארבעה מנגנונים הופכים את Claude Code מכלי אישי לסביבת עבודה של צוות:

סוכני משנה (Subagents)

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

use a subagent to investigate how our auth system handles token refresh

סוכנים קבועים מגדירים כקובצי Markdown עם frontmatter, בתיקייה .claude/agents/ לפרויקט או ~/.claude/agents/ לכל הפרויקטים: שם, תיאור, כלים מותרים והנחיות.

Skills

Skill הוא תהליך שחוזר על עצמו, ארוז בקובץ SKILL.md תחת .claude/skills/<name>/. מפעילים אותו עם /name, או ש-Claude טוען אותו לבד כשהוא רלוונטי. Skill נטען רק כשמשתמשים בו, ולכן זה המקום להוראות ארוכות שלא צריכות לשבת ב-CLAUDE.md. פקודות מותאמות שכבר יש לכם ב-.claude/commands/ ממשיכות לעבוד: הן אוחדו עם Skills.

Hooks

Hook הוא פקודת shell שרצה אוטומטית בנקודה קבועה: לפני שימוש בכלי (PreToolUse), אחריו (PostToolUse), כש-Claude מסיים (Stop) ועוד. בניגוד ל-CLAUDE.md, זה דטרמיניסטי: זה קורה תמיד. דוגמה קלאסית היא להריץ Prettier על כל קובץ ש-Claude ערך. מגדירים ב-settings.json ובודקים עם /hooks.

MCP

MCP (Model Context Protocol) הוא סטנדרט פתוח לחיבור כלים חיצוניים: Jira, Slack, Google Drive, מסד הנתונים שלכם או כלי פנימי. מוסיפים שרת בפקודה אחת:

claude mcp add --transport http notion https://mcp.notion.com/mcp

עם --scope project ההגדרה נשמרת ב-.mcp.json ומשותפת לצוות, ו-/mcp מציג את מצב השרתים. חברו רק שרתים שאתם סומכים עליהם: שרת שמביא תוכן חיצוני יכול לחשוף אתכם ל-prompt injection.

Claude Code בסקריפטים וב-CI

Claude Code הוא גם כלי שורת פקודה רגיל. עם -p הוא מריץ משימה אחת ויוצא, והוא קורא stdin, כך שאפשר לשלב אותו בסקריפטים, ב-pre-commit וב-CI:

claude -p "What does the auth module do?"

git log --oneline -20 | claude -p "summarize these recent commits"

git diff main --name-only | claude -p "review these changed files for security issues"

כשאף אחד לא יושב מול המסך, חשוב להגביל מה מותר לו. --allowedTools מאשר מראש רק את הכלים שצריך, ו---output-format json מחזיר תוצאה מובנית:

claude -p "Run the test suite and fix any failures" --allowedTools "Bash,Read,Edit"

claude -p "Summarize this project" --output-format json

ב-CI מומלץ להוסיף --bare: הוא מדלג על hooks, Skills, שרתי MCP ו-CLAUDE.md שמוגדרים במכונה, כך שכל ריצה מתנהגת אותו דבר. במצב הזה הוא עובד עם ANTHROPIC_API_KEY ולא עם ההתחברות של המנוי.

GitHub Actions

הדרך המהירה היא להריץ /install-github-app בתוך Claude Code. הוא מתקין את ה-GitHub App, שומר את המפתח כ-secret ומכין PR עם ה-workflow. אחרי המיזוג, מי שיש לו הרשאת כתיבה לריפו יכול לכתוב @claude ב-issue או ב-PR, ו-Claude עונה, מתקן או פותח PR. יש גם תמיכה ב-GitLab CI/CD.

לעולם אל תכניסו מפתחות API לריפו. רק כ-secrets של GitHub.

הפרטים בתיעוד ההרצה מסקריפטים ובתיעוד GitHub Actions.

איך מכניסים את Claude Code לצוות פיתוח

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

1. CLAUDE.md משותף בריפו: פקודות, מוסכמות ו"מה לא לעשות". מתחזקים אותו כמו קוד, דרך PR.
2. הגדרות והרשאות משותפות: .claude/settings.json בריפו עם כללי allow ו-deny ברורים. ארגונים יכולים גם לאכוף הגדרות דרך managed settings.
3. Skills ו-MCP משותפים: .claude/skills/ ו-.mcp.json בריפו, כך שכל אחד מקבל את אותם כלים ותהליכים.
4. הריוויו לא משתנה: קוד שנכתב עם Claude עובר את אותו PR ואותה בדיקה כמו כל קוד. מי שפתח את ה-PR אחראי עליו.
5. עלויות: ב-Team וב-Enterprise השימוש נכלל במושב של כל חבר צוות, ואפשר להגדיר מגבלות הוצאה. ב-Console מגדירים מגבלות הוצאה ל-workspace. התחילו בקבוצת פיילוט קטנה ומדדו לפני שמרחיבים.
6. אבטחה ופרטיות: בתנאים המסחריים (Team, Enterprise ו-API) Anthropic לא מאמנת מודלים על הקוד והפרומפטים שלכם, אלא אם הארגון בחר לשתף. ודאו שכולם עובדים מחשבון של הארגון ולא ממנוי פרטי.

ולמי שמחפש "קורס קלוד קוד": ל-Anthropic יש קורסים חינמיים באנגלית ב-Claude Academy, כמו Claude Code 101. הם מצוינים להתחלה. מה שהם לא נותנים: התאמה לקוד, לתהליכים ולצוות שלכם.

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

• פרומפטים מעורפלים. "תתקן את הבאג" גורם לו לסרוק חצי פרויקט. תארו את הסימפטום, את הקובץ ואיך משחזרים.
• סשן אחד לכל היום. הקשר ארוך עולה יותר ומבלבל אותו. הריצו /clear בין משימות שלא קשורות זו לזו.
• CLAUDE.md מנופח. מאות שורות של הוראות הן הוראות שנבלעות. קצרו, והעבירו פרטים ל-Skills ול-rules.
• לדלג על תכנון. במשימה גדולה, כמה דקות ב-Plan Mode חוסכות שעה של קוד בכיוון הלא נכון.
• בלי דרך לבדוק. בלי טסטים או פלט צפוי, הוא לא יודע מתי באמת סיים, וגם אתם לא.
• bypassPermissions על המחשב שלכם. רק ב-container או ב-VM מבודדים.
• לאשר בלי לקרוא. הדיף באחריותכם. סוכן מהיר לא פוטר מריוויו.

איך אני עובד עם Claude Code

Claude Code הוא חלק מהעבודה היומיומית שלי, יחד עם Cursor ו-Codex: כ-CTO ושותף מייסד ב-Matchi ובכל פרויקט שאני בונה.

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

• 566 קומיטים, כולם של סוכני Claude Code
• סוכן אוטונומי שעבד לבד כל 5 שעות
• יותר מ-10 מיליון בדיקות אוטומטיות

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

היום יש לזה גם כלים מובנים: Routines שרצות בענן לפי לוח זמנים, משימות מתוזמנות באפליקציית הדסקטופ ו-claude -p בתוך CI. רוצים סוכן שעובד על הריפו גם כשאתם ישנים? מכאן מתחילים.