🧭 מהות הכלי

מה זה קלוד קוד

קלוד קוד (Claude Code) הוא כלי תכנות סוכני (agentic coding tool) המופעל על ידי בינה מלאכותית, אשר קורא את בסיס הקוד שלך, עורך קבצים, מריץ פקודות ומתחבר לכלי הפיתוח שלך. הוא זמין בטרמינל, בהרחבות לסביבות פיתוח (IDE), באפליקציית שולחן עבודה (Desktop app) ובדפדפן (Web).

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

#התחלת עבודה

קלוד קוד פועל במספר ממשקים: הטרמינל, הרחבות IDE, אפליקציית שולחן עבודה ודפדפן. מרבית הממשקים דורשים מנוי ב-Claude או חשבון ב-Anthropic Console. ממשק ה-CLI בטרמינל, הרחבת VS Code ותוסף JetBrains תומכים גם בספקי צד שלישי (third-party providers).

#מסוף (Terminal)

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

להתקנת קלוד קוד, ניתן להשתמש באחת השיטות הבאות:

#התקנה מקורית (מומלץ)

עבור macOS, Linux ו-WSL:

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

עבור Windows PowerShell:

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

עבור Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

מלכודות נפוצות בהתקנה ב-Windows:

• אם מופיעה הודעת השגיאה The token '&&' is not a valid statement separator, אתה נמצא ב-PowerShell ולא ב-CMD.
• אם מופיעה הודעת השגיאה 'irm' is not recognized as an internal or external command, אתה נמצא ב-CMD ולא ב-PowerShell.
• שורת הפקודה מציגה PS C:\ כאשר אתה ב-PowerShell, ומציגה C:\ ללא הקידומת PS כאשר אתה ב-CMD.
• אם פקודת ההתקנה נכשלת עם שגיאה כגון syntax error near unexpected token '<', שגיאת 403 או שגיאת curl אחרת, יש לעיין בתיעוד פתרון בעיות ההתקנה לצורך התאמת השגיאה לפתרון ולבחינת שיטות התקנה חלופיות.
• בסביבת Windows מקורית מומלץ להתקין את Git for Windows כדי שקלוד קוד יוכל להשתמש בכלי Bash. אם Git for Windows אינו מותקן, קלוד קוד משתמש ב-PowerShell ככלי המעטפת במקום זאת. התקנות ב-WSL אינן דורשות את Git for Windows.
• התקנות מקוריות מתעדכנות באופן אוטומטי ברקע כדי לשמור על הגרסה העדכנית ביותר.

#Homebrew

brew install --cask claude-code

ב-Homebrew מוצעים שני מסלולים (casks):

• claude-code: עוקב אחר ערוץ הגרסאות היציב, שבדרך כלל מפגר בכשבוע ומדלג על גרסאות עם נסיגות משמעותיות (regressions).
• claude-code@latest: עוקב אחר הערוץ העדכני ביותר ומקבל גרסאות חדשות מיד עם שחרורן.

מלכודת עדכונים: התקנות Homebrew אינן מתעדכנות אוטומטית. יש להריץ brew upgrade claude-code או brew upgrade claude-code@latest, בהתאם למסלול שהותקן, כדי לקבל תכונות חדשות ותיקוני אבטחה.

#WinGet

winget install Anthropic.ClaudeCode

מלכודת עדכונים: התקנות WinGet אינן מתעדכנות אוטומטית. יש להריץ מעת לעת winget upgrade Anthropic.ClaudeCode כדי לקבל תכונות חדשות ותיקוני אבטחה.

ניתן להתקין גם באמצעות מנהלי החבילות apt, dnf או apk בהפצות Debian, Fedora, RHEL ו-Alpine.

#הפעלת קלוד קוד בפרויקט

ההליך להפעלת קלוד קוד בפרויקט מתבצע לפי השלבים הבאים:

1. מעבר לתיקיית הפרויקט במחשב והרצת הפקודה claude (יש להחליף את your-project בנתיב לתיקיית הפרויקט):

cd your-project
claude

2. התחברות לחשבון: בשימוש ראשון תוצג בקשת התחברות. אם הוגדר משתנה הסביבה ANTHROPIC_API_KEY, קלוד קוד מדלג על בקשת ההתחברות ומבקש לאשר את המפתח במקום זאת.

#סביבת פיתוח VS Code

הרחבת VS Code מספקת תצוגת שינויי קוד ישירות בעורך (inline diffs), תיוגי @, סקירת תוכניות (plan review) והיסטוריית שיחה ישירות בסביבת הפיתוח.

נתמכת ב-VS Code וב-Cursor.

הליך ההתקנה וההפעלה:

1. חיפוש "Claude Code" בתצוגת ההרחבות (Cmd+Shift+X ב-Mac, או Ctrl+Shift+X ב-Windows וב-Linux) והתקנת ההרחבה.
2. פתיחת לוח הפקודות (Cmd+Shift+P ב-Mac, או Ctrl+Shift+P ב-Windows וב-Linux), הקלדת "Claude Code" ובחירה באפשרות Open in New Tab.

#אפליקציית מחשב (Desktop app)

אפליקציה עצמאית להרצת קלוד קוד מחוץ ל-IDE או לטרמינל. מאפשרת סקירה חזותית של שינויי קוד, הרצת מספר סשנים במקביל זה לצד זה, תזמון משימות חוזרות והפעלת סשנים בענן.

האפליקציה זמינה להורדה ולהתקנה עבור:

• macOS (מעבדי Intel ו-Apple Silicon).
• Windows בגרסת x64.
• Windows בגרסת ARM64.
• Ubuntu ו-Debian, שבהן האפליקציה נמצאת בגרסת בטא ומותקנת באמצעות apt.

הליך ההפעלה:

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

האפליקציה כוללת את קלוד קוד באופן מובנה, כך שאין צורך בהתקנה נפרדת של ה-CLI. נדרש מנוי בתשלום.

#דפדפן (Web)

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

זמין בדפדפנים במחשב ובאפליקציית Claude לנייד ב-iOS וב-Android.

מתחילים לעבוד בכתובת claude.ai/code.

#סביבות פיתוח JetBrains

תוסף עבור IntelliJ IDEA, PyCharm, WebStorm וסביבות פיתוח נוספות של JetBrains, המציע צפייה אינטראקטיבית בשינויים ושיתוף הקשר מקטעי קוד נבחרים.

הליך ההתקנה:

1. התקנת התוסף Claude Code מתוך JetBrains Marketplace.
2. הפעלה מחדש של סביבת הפיתוח.

מלכודת: התוסף דורש התקנה נפרדת של כלי ה-CLI של קלוד קוד.

#מה אפשר לעשות

#אוטומציה של משימות שדוחים

קלוד קוד מטפל במשימות מייגעות שגוזלות זמן עבודה: כתיבת בדיקות לקוד ללא כיסוי, תיקון שגיאות lint בכל רחבי הפרויקט, פתרון קונפליקטים במיזוג (merge conflicts), עדכון תלויות וכתיבת הערות שחרור (release notes).

claude "write tests for the auth module, run them, and fix any failures"

#בניית תכונות ותיקון באגים

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

במקרה של באגים, מדביקים הודעת שגיאה או מתארים את התופעה: קלוד קוד מתחקה אחר התקלה בבסיס הקוד, מאתר את שורש הבעיה ומיישם תיקון.

#יצירת commits ו-pull requests

קלוד קוד עובד ישירות מול git: הוא מעביר שינויים ל-stage, כותב הודעות commit, יוצר ענפים ופותח pull requests.

claude "commit my changes with a descriptive message"

בתהליכי CI, ניתן לבצע אוטומציה של סקירת קוד ומיון בעיות באמצעות GitHub Actions או GitLab CI/CD.

#חיבור כלים באמצעות MCP

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

#התאמה אישית עם הנחיות, כישורים ו-hooks

• CLAUDE.md: קובץ Markdown שמוסיפים לשורש הפרויקט ונקרא בתחילת כל סשן. משמש להגדרת תקני קידוד, החלטות ארכיטקטורה, ספריות מועדפות ורשימות בדיקה לסקירה.
• AGENTS.md: אם במאגר כבר קיים קובץ AGENTS.md עבור סוכני קידוד אחרים, קלוד קוד יכול לקרוא אותו באופן עצמאי או לצד CLAUDE.md.
• זיכרון אוטומטי (auto memory): קלוד שומר לקחים ותובנות תוך כדי עבודה על פני סשנים שונים, ללא צורך בכתיבה ידנית.
• כישורים (skills): מאפשרים לארוז תהליכי עבודה שניתן לשתף בצוות, כגון /review-pr או /deploy-staging.
• פקודות יזומות (hooks): מאפשרות להריץ פקודות מעטפת לפני או אחרי פעולות של קלוד קוד, כגון עיצוב קוד אוטומטי לאחר כל עריכת קובץ או הרצת lint לפני commit.

#הרצת סוכנים במקביל ובניית סוכנים מותאמים אישית

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

להרצת מספר סשנים מלאים במקביל ומעקב אחריהם ממסך יחיד, ניתן להשתמש בסוכני רקע (agent-view). עבור תהליכי עבודה מותאמים אישית לחלוטין, ערכת Agent SDK מאפשרת לבנות סוכנים המבוססים על הכלים והיכולות של קלוד קוד, עם שליטה מלאה בתזמור, בגישה לכלים ובהרשאות.

#צינורות, סקריפטים ואוטומציה עם ה-CLI

קלוד קוד ניתן להרכבה ופועל לפי פילוסופיית Unix. ניתן להזרים אליו קובצי יומן בצינור (pipe), להריץ אותו בסביבות CI, או לשרשר אותו לכלים אחרים:

# Analyze recent log output
tail -200 app.log | claude -p "Slack me if you see any anomalies"

# Automate translations in CI
claude -p "translate new strings into French and raise a PR for review"

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

#תזמון משימות חוזרות

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

• שגרות ענן (Routines): רצות בענן וממשיכות לפעול גם כאשר המחשב כבוי. הן יכולות לפעול גם בעקבות קריאות API או אירועי GitHub. יצירתן מתבצעת מהדפדפן, מאפליקציית Desktop, או באמצעות הרצת /schedule ב-CLI.
• משימות מתוזמנות ב-Desktop (Desktop scheduled tasks): רצות במחשב שלך עם גישה ישירה לקבצים ולכלים המקומיים.
• הפקודה /loop: חוזרת על הנחיה בתוך סשן CLI לצורך דגימה מהירה חוזרת (polling).

#עבודה מכל מקום

סשנים אינם כבולים לממשק יחיד, וניתן להעביר עבודה ביניהם בהתאם לשינוי סביבת העבודה:

• עזיבת עמדת העבודה והמשך הפעילות מהטלפון או מכל דפדפן באמצעות שליטה מרחוק (Remote Control).
• שליחת משימה בהודעה ל-Dispatch מהטלפון, ופתיחת סשן ה-Desktop שנוצר בעקבותיה.
• התחלת משימה ארוכה בדפדפן או באפליקציית Claude לנייד, ומשיכתה לטרמינל באמצעות הפקודה claude --teleport (דורש מנוי ב-claude.ai).
• הרצת הפקודה /desktop להמשך סשן הטרמינל הנוכחי באפליקציית ה-Desktop לצורך סקירה חזותית של שינויי קוד (העברה זו דורשת מנוי ב-claude.ai, וזמינה ב-macOS וב-Windows x64).
• ניתוב משימות מצ'אט הצוות: תיוג @Claude ב-Slack עם דיווח על באג, וקבלת pull request בחזרה.

#איך קלוד קוד עובד

הארכיטקטורה של קלוד קוד מבוססת על שילוב בין מודל שפה שמבצע הסקה וחשיבה, לבין כלי ביצוע המאפשרים לו לפעול בתוך סביבת העבודה שלך. קלוד קוד משמש כמעטפת סוכנית (agentic harness) המספקת למודל את הכלים, ניהול ההקשר וסביבת ההרצה.

#הלולאה הסוכנית (Agentic loop)

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

• איסוף הקשר (gather context).
• ביצוע פעולה (take action).
• אימות תוצאות (verify results).

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

#מודלים וכלים מובנים

קלוד קוד משתמש במודלים שונים לצורך חשיבה והבנת הקוד:

• Sonnet: מודל ברירת המחדל המתאים למרבית משימות התכנות.
• Opus: מספק יכולת חשיבה מעמיקה יותר עבור החלטות ארכיטקטורה מורכבות.

ניתן להחליף מודל במהלך סשן פעיל באמצעות הפקודה /model, או להגדיר מראש בהפעלת ה-CLI באמצעות claude --model <name>.

הכלים המובנים של קלוד קוד מתחלקים לחמש קטגוריות עיקריות:

כדוגמה להפעלת הלולאה הסוכנית, בעת בקשה לתקן בדיקות שנכשלו, קלוד מבצע את ההליך הבא:

1. הרצת חבילת הבדיקות כדי לראות מה נכשל.
2. קריאת פלט השגיאה.
3. חיפוש קובצי המקור הרלוונטיים.
4. קריאת הקבצים להבנת הקוד.
5. עריכת הקבצים לתיקון התקלה.
6. הרצת הבדיקות שוב לאימות.

#למה קלוד יכול לגשת

בהרצת claude בתיקייה, לקלוד קוד יש גישה למשאבים הבאים:

• הפרויקט שלך: קבצים בתיקייה הנוכחית ובתת-התיקיות, וכן קבצים במיקומים אחרים לאחר קבלת אישור.
• הטרמינל שלך: כל פקודה שהמשתמש יכול להריץ: כלי בנייה, git, מנהלי חבילות וסקריפטים.
• מצב ה-git: הענף הנוכחי, שינויים שטרם נשמרו ב-commit והיסטוריית commits אחרונה.
• הנחיות הפרויקט: קובץ CLAUDE.md, וכן קובץ AGENTS.md (אם קיים במאגר).
• זיכרון אוטומטי (auto memory): לקחים שנשמרים בקובץ MEMORY.md. 200 השורות הראשונות או 25KB (המוקדם מביניהם) נטענים בתחילת כל סשן.
• הרחבות מוגדרות: שרתי MCP, כישורים (skills), סוכני משנה (subagents), וחיבור לדפדפן דרך Chrome.

#סביבות ריצה

קלוד קוד תומך בשלוש סביבות ריצה עבור ביצוע הקוד:

#עבודה עם סשנים וחלון ההקשר

שיחות קלוד קוד נשמרות מקומית כקובצי JSONL תחת הנתיב ~/.claude/projects/.

• עצמאות סשנים: כל סשן מתחיל עם חלון הקשר נקי ללא היסטוריית שיחות קודמות.
• מעבר בין ענפים: סשן קשור לתיקייה שבה הוא נפתח. הרצת /resume מציגה כברירת מחדל סשנים מ-worktree הנוכחי. שינוי ענף ב-git מציג לקלוד את הקבצים החדשים אך משמר את היסטוריית השיחה. לצורך סשנים מקבילים על ענפים שונים, מומלץ להשתמש ב-git worktrees.
• חידוש לעומת פיצול: הפקודות claude --continue או claude --resume פותחות מחדש את השיחה תחת אותו מזהה סשן. פיצול באמצעות --fork-session או הפקודה /branch מעתיק את ההיסטוריה למזהה סשן חדש מבלי לשנות את המקור.
• דחיסת הקשר אוטומטית: כשההקשר מתמלא, קלוד מנקה תחילה פלטי כלים ישנים ולאחר מכן מסכם את השיחה. הנחיות קבועות יש לשמור ב-CLAUDE.md כדי שלא יאבדו בסיכום. ניתן לכוון את הדחיסה באמצעות /compact (למשל /compact focus on the API changes), או על ידי הוספת סעיף "Compact Instructions" ב-CLAUDE.md.
• בדיקת ניצול שטח: הפקודה /context מציגה את הרכיבים שתופסים מקום בחלון ההקשר.
• מלכודת דשדוש בדחיסה (thrashing): אם קובץ יחיד או פלט של כלי גדול מדי כך שההקשר מתמלא שוב מיד לאחר הסיכום, קלוד קוד עוצר את הדחיסה האוטומטית לאחר מספר ניסיונות ומציג הודעת שגיאה.
• חיסכון בהקשר באמצעות הרחבות: הגדרות כלי MCP נטענות לפי דרישה דרך חיפוש כלים (tool search), כך שרק שמות הכלים והוראות השרת תופסים מקום בהתחלה. כישורים נטענים רק בעת שימוש (ניתן להגדיר disable-model-invocation: true או להשתמש ב-skillOverrides בהגדרות). סוכני משנה מופעלים בחלון הקשר נפרד ואינם מעמיסים על ההקשר הראשי.

#בטיחות: נקודות ביקורת והרשאות

• נקודות ביקורת (Checkpoints): לפני שקלוד עורך קובץ, נשמר תצלום מצב שלו. ניתן לחזור אחורה בכל שלב על ידי לחיצה כפולה על Esc או בקשת undo. נקודות הביקורת נפרדות מ-git ונשמרות גם לאחר חידוש סשן.
• מלכודת שחזור: שחזור נקודות ביקורת מדלג על קבצים עם קישורים סימבוליים (symlinks) או קישורים קשיחים (hard links). פעולות מול מערכות מרוחקות כגון בסיסי נתונים, פריסות ענן או קריאות API אינן מכוסות על ידי נקודות ביקורת.
• מצבי הרשאה: מעבר בין מצבי ההרשאה מתבצע באמצעות Shift+Tab:
  • Auto: מסווג סוקר את מרבית הפעולות ברקע וחוסם פעולות מסוכנות במקום לבקש אישור. זהו מצב ברירת המחדל בסשנים אינטראקטיביים בטרמינל וב-VS Code במסלולי Pro, Max ו-Team.
  • Manual: קלוד מבקש אישור לפני כל עריכת קובץ והרצת פקודת מעטפת.
  • Accept edits: קלוד עורך קבצים ומריץ פקודות מערכת קבצים נפוצות (כגון mkdir ו-mv) ללא אישור, אך ממשיך לבקש אישור לפקודות אחרות.
  • Plan: קלוד חוקר ומציע תוכנית פעולה ללא ביצוע עריכות בפועל בקובצי המקור.
• אישור פקודות קבוע: ניתן להגדיר פקודות מורשות בקובץ .claude/settings.json (כגון npm test או git status) כדי למנוע בקשות אישור חוזרות.

#עבודה יעילה והתערבות בזמן אמת

• פקודות עזרה והגדרה:
  • /init: יצירת קובץ CLAUDE.md התחלתי לפרויקט.
  • /doctor: בדיקת תקינות מקיפה של ההתקנה וההגדרות ותיקון תקלות.
• התערבות במהלך עבודה:
  • לחיצה על Esc: עוצרת את פעולת קלוד מיד ומבטלת את קריאת הכלי שרצה באותו רגע.
  • הקלדת תיקון ולחיצה על Enter: שולחת תיקון או הנחיה חדשה מבלי לעצור את הכלי הרץ. קלוד יקרא את ההודעה מיד עם סיום הפעולה הנוכחית ויתאים את המשך התוכנית.
• האצלת סמכויות: מומלץ לתאר את התוצאה המבוקשת וההקשר הרלוונטי, ולא להכתיב במפורש שמות קבצים לקריאה או פקודות מדויקות להרצה.

#שימוש בקלוד קוד בכל מקום

כל ממשק מתחבר לאותו מנוע קלוד קוד בסיסי, כך שקובצי CLAUDE.md, הגדרות ושרתי MCP במאגר שלך פועלים באופן אחיד בכולם.

מעבר לממשקי הטרמינל, VS Code, JetBrains, Desktop והרשת, קלוד קוד משתלב בתהליכי CI/CD, צ'אט ודפדפן:

#הצעדים הבאים

לאחר התקנת קלוד קוד, המדריכים הבאים מאפשרים להעמיק:

• התחלה מהירה (Quickstart): ליווי צעד אחר צעד במשימה אמיתית ראשונה, מחקר בסיס הקוד ועד לביצוע commit לתיקון.
• שמירת הנחיות וזיכרונות (Store instructions and memories): מתן הנחיות קבועות לקלוד באמצעות קובצי CLAUDE.md וזיכרון אוטומטי (auto memory).
• תהליכי עבודה נפוצים ושיטות עבודה מומלצות (Common workflows and best practices): דפוסים להפקת המרב מקלוד קוד.
• מעטפת לכל משימה (A harness for every task): כיצד צוות קלוד קוד משתמש בתהליכי עבודה דינמיים (dynamic workflows) לתזמור סוכני משנה רבים במקביל.
• הגדרות (Settings): התאמת קלוד קוד לתהליך העבודה שלך.
• פתרון בעיות (Troubleshooting): פתרונות לבעיות נפוצות.
• code.claude.com: הדגמות, מחירים ופרטי המוצר.