תיעוד 10

תהליכי עבודה נפוצים

מדריכים צעד אחר צעד לחקירת מאגרי קוד, תיקון באגים, שכתוב קוד (refactoring), בדיקות ומשימות יומיומיות נוספות עם Claude Code.

דף זה מרכז מתכונים קצרים לפיתוח יומיומי. להנחיות ברמה גבוהה יותר בנושא ניסוח הנחיות (prompting) וניהול הקשר (context), ראה Best practices.

דף זה מכסה:

מתכוני הנחיות לחקירת קוד, תיקון באגים, שכתוב, בדיקות, בקשות משיכה (PRs) ותיעוד
המשך שיחות קודמות כדי שמשימה תוכל להתפרס על פני מספר ישיבות
הרצת הפעלות מקבילות עם עצי עבודה (worktrees) כדי שעריכות מקבילות לא יתנגשו
תכנון לפני עריכה כדי לבדוק שינויים לפני שהם נוגעים בדיסק
האצלת מחקר לסוכני משנה (subagents) כדי לשמור על ההקשר הראשי שלך נקי
הזנת Claude לתוך סקריפטים (pipe) עבור CI ועיבוד באצ'ים

#מתכוני הנחיות

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

#הבנת מאגרי קוד חדשים

להגדרת Claude Code במאגר מונו-רפו (monorepo) או במאגר קוד גדול, ראה Monorepos and large repos.

#קבלת סקירה מהירה של מאגר הקוד

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

נווט אל ספריית השורש של הפרויקט:
```
cd /path/to/project 
```
החלף את /path/to/project בנתיב לפרויקט שלך.
הפעל את Claude Code:
```
claude 
```
בקש סקירה ברמה גבוהה:
```
give me an overview of this codebase
```

צלול עמוק יותר לרכיבים ספציפיים:

explain the main architecture patterns used here

what are the key data models?

how is authentication handled?

טיפים:

התחל בשאלות רחבות, ולאחר מכן צמצם לתחומים ספציפיים.

שאל לגבי מוסכמות כתיבת קוד ותבניות המשמשות בפרויקט.

בקש מילון מונחים של מונחים ייחודיים לפרויקט.

#מציאת קוד רלוונטי

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

בקש מ-Claude למצוא קבצים רלוונטיים:
```
find the files that handle user authentication
```
קבל הקשר על האופן שבו רכיבים מתקשרים זה עם זה:
```
how do these authentication files work together?
```

הבן את זרימת הביצוע:

trace the login process from front-end to database

טיפים:

היה ספציפי לגבי מה שאתה מחפש.

השתמש במונחי תחום התוכן מתוך הפרויקט.

התקן תוסף בינה לקוד (code intelligence) עבור השפה שלך כדי לתת ל-Claude יכולת ניווט מדויקת של "מעבר להגדרה" ו"חיפוש הפניות".

#תיקון באגים ביעילות

נניח שנתקלת בהודעת שגיאה ואתה צריך למצוא ולתקן את המקור שלה.

שתף את השגיאה עם Claude:
```
I'm seeing an error when I run npm test
```

בקש המלצות לתיקון:

suggest a few ways to fix the @ts-ignore in user.ts

החל את התיקון:

update user.ts to add the null check you suggested

טיפים:

מסור ל-Claude את הפקודה לשחזור הבעיה וקבלת קריאת מחסנית (stack trace).

ציין שלבים כלשהם לשחזור השגיאה.

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

#שכתוב קוד

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

להעברת מאגר קוד שלם לשפה חדשה, ראה כיצד Anthropic מריצה הגירות קוד בהיקף גדול עם Claude Code בבלוג.

זהה קוד ישן לצורך שכתוב:
```
find deprecated API usage in our codebase
```

קבל המלצות לשכתוב:

suggest how to refactor utils.js to use modern JavaScript features

החל את השינויים בבטחה:

refactor utils.js to use ES2024 features while maintaining the same behavior

אמת את השכתוב:
```
run tests for the refactored code
```

טיפים:

בקש מ-Claude להסביר את היתרונות של הגישה המודרנית.

בקש שהשינויים ישמרו על תאימות לאחור בעת הצורך.

בצע שכתוב במנות קטנות שניתנות לבדיקה.

#עבודה עם בדיקות

נניח שאתה צריך להוסיף בדיקות עבור קוד ללא כיסוי.

זהה קוד שאינו נבדק:

find functions in NotificationsService.swift that are not covered by tests

צור שלד בדיקות:
```
add tests for the notification service
```

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

add test cases for edge conditions in the notification service

הרץ ואמת בדיקות:
```
run the new tests and fix any failures
```

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

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

#יצירת בקשות משיכה

באפשרותך ליצור בקשות משיכה (pull requests) על ידי פנייה ישירה אל Claude ("create a pr for my changes"), או להנחות את Claude לאורך התהליך צעד אחר צעד:

סכם את השינויים שלך:

summarize the changes I've made to the authentication module

צור בקשת משיכה:
```
create a pr
```

בדוק ושפר:

enhance the PR description with more context about the security improvements

כדי למצוא את ההפעלה מאוחר יותר, הרץ claude --from-pr 1234 עם מספר ה-PR שלך, פעולה שפותחת את בורר ההפעלות כשהוא מסונן להפעלות שמקושרות לאותו PR, או הדבק את כתובת ה-URL של ה-PR בחיפוש של בורר /resume. Claude Code מקשר את ההפעלה ל-PR כאשר Claude יוצר אותו בעזרת gh pr create או glab mr create, וכאשר Claude עובד על PR קיים.

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

#טיפול בתיעוד

נניח שאתה צריך להוסיף או לעדכן תיעוד עבור הקוד שלך.

זהה קוד ללא תיעוד:

find functions without proper JSDoc comments in the auth module

צור תיעוד:

add JSDoc comments to the undocumented functions in auth.js

בדוק ושפר:

improve the generated documentation with more context and examples

אמת תיעוד:

check if the documentation follows our project standards

טיפים:

ציין את סגנון התיעוד הרצוי לך (JSDoc, docstrings וכו').

בקש דוגמאות בתוך התיעוד.

בקש תיעוד עבור ממשקי API ציבוריים, ממשקים ולוגיקה מורכבת.

#עבודה בהערות ובתיקיות שאינן קוד

Claude Code עובד בכל ספרייה. הרץ אותו בתוך מאגר הערות (notes vault), תיקיית תיעוד או כל אוסף של קובצי markdown כדי לחפש, לערוך ולארגן מחדש תוכן באותו אופן שבו היית עובד עם קוד.

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

#עבודה עם תמונות

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

הוסף תמונה לשיחה: באפשרותך להשתמש בכל אחת מהשיטות הבאות:
1. גרור ושחרר תמונה לתוך חלון Claude Code.
2. העתק תמונה והדבק אותה ב-CLI עם Ctrl+V, או עם Alt+V ב-Windows וב-WSL.
3. ספק נתיב תמונה ל-Claude. לדוגמה: "Analyze this image: /path/to/your/image.png".

בקש מ-Claude לנתח את התמונה:

What does this image show?

Describe the UI elements in this screenshot

Are there any problematic elements in this diagram?

השתמש בתמונות לצורך הקשר:

Here's a screenshot of the error. What's causing it?

This is our current database schema. How should we modify it for the new feature?

קבל הצעות קוד מתוכן חזותי:

Generate CSS to match this design mockup

What HTML structure would recreate this component?

טיפים:

השתמש בתמונות כאשר תיאורים מילוליים אינם ברורים או מסורבלים.

כלול צילומי מסך של שגיאות, עיצובי ממשק משתמש (UI) או דיאגרמות לצורך הקשר טוב יותר.

באפשרותך לעבוד עם מספר תמונות בשיחה אחת.

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

כאשר Claude מתייחס לתמונות (למשל, [Image #1]), לחץ Cmd+Click (ב-Mac) או Ctrl+Click (ב-Windows/Linux) על הקישור כדי לפתוח את התמונה במציג ברירת המחדל שלך.

#התייחסות לקבצים ולספריות

השתמש ב-@ כדי לכלול במהירות קבצים או ספריות מבלי לחכות ש-Claude יקרא אותם.

התייחס לקובץ יחיד:
```
Explain the logic in @src/utils/auth.js
```
פעולה זו כוללת את תוכן הקובץ המלא בשיחה.

התייחס לספרייה:

What's the structure of @src/components?

התייחס למשאבי MCP:
```
Show me the data from @github:repos/owner/repo/issues
```
פעולה זו מושכת נתונים משרתי MCP מחוברים בעזרת המבנה @server:resource. לפרטים, ראה משאבי MCP.

טיפים:

נתיבי קבצים יכולים להיות יחסיים או מוחלטים.

הקלד @ כדי לפתוח תפריט הצעות נתיב, לאחר מכן לחץ Enter או Tab כדי לקבל את הנתיב המסומן ולחץ Enter שוב כדי לשלוח את ההודעה.

אזכורי קבצים עם @ מוסיפים להקשר את CLAUDE.md בספריית הקובץ ובספריות האב שלה.

אזכורי ספריות מציגים רשימות קבצים, לא את תוכנם.

באפשרותך להתייחס למספר קבצים בהודעה יחידה (לדוגמה, "@file1.js and @file2.js").

#הפעלת Claude לפי לוח זמנים

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

בחר אפשרות תזמון בהתאם למקום שבו תרצה שהמשימה תרוץ:

אפשרות	היכן היא רצה	מתאימה ביותר עבור
Routines	ענן, מנוהל כברירת מחדל על ידי Anthropic	משימות שאמורות לרוץ גם כשהמחשב שלך כבוי. יכולות לפעול גם בעקבות קריאות API או אירועי GitHub בנוסף ללוח זמנים. הגדרה בכתובת claude.ai/code/routines.
Desktop scheduled tasks	המכונה שלך, דרך אפליקציית שולחן העבודה	משימות הזקוקות לגישה ישירה לקבצים מקומיים, כלים או שינויים שטרם נשמרו ב-commit.
GitHub Actions	צינור ה-CI שלך	משימות הקשורות לאירועי מאגר כמו בקשות משיכה שנפתחו, או לוחות זמנים של cron שאמורים לשבת לצד הגדרות תהליך העבודה שלך.
`/loop`	הפעלת ה-CLI הנוכחית	דגימה מהירה (polling) בזמן שהפעלה פתוחה. הדגלים `--resume` ו-`--continue` משחזרים לולאות במרווחים קבועים שטרם פג תוקפן.

טיפ: בעת כתיבת הנחיות למשימות מתוזמנות, הגדר במפורש כיצד נראית הצלחה ומה לעשות עם התוצאות. המשימה רצה באופן אוטונומי, ולכן אינה יכולה לשאול שאלות הבהרה. לדוגמה: "Review open PRs labeled needs-review, leave inline comments on any issues, and post a summary in the #eng-reviews Slack channel."

#שאל את Claude לגבי היכולות שלו

ל-Claude יש גישה מובנית לתיעוד שלו והוא יכול לענות על שאלות לגבי התכונות והמגבלות של עצמו.

#שאלות לדוגמה

can Claude Code create pull requests?

how does Claude Code handle permissions?

what skills are available?

how do I use MCP with Claude Code?

how do I configure Claude Code for Amazon Bedrock?

what are the limitations of Claude Code?

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

טיפים:

ל-Claude יש תמיד גישה לתיעוד העדכני ביותר של Claude Code, ללא קשר לגרסה שבה אתה משתמש.

שאל שאלות ספציפיות כדי לקבל תשובות מפורטות.

Claude יכול להסביר תכונות מורכבות כמו שילוב MCP, הגדרות ארגוניות ותהליכי עבודה מתקדמים.

#המשך שיחות קודמות

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

claude --continue

פקודה זו ממשיכה את ההפעלה האחרונה בספרייה הנוכחית. אם עדיין אין כזו, היא מדפיסה No conversation found to continue ויוצאת. השתמש ב-claude --resume כדי לבחור מתוך רשימה, או ב-/resume מתוך הפעלה שרצה. ראה Manage sessions לגבי מתן שמות, פיצול ענפים ומדריך הבורר המלא.

#הרצת הפעלות מקבילות עם עצי עבודה (worktrees)

עבוד על תכונה בטרמינל אחד בזמן ש-Claude מתקן באג בטרמינל אחר, מבלי שהעריכות יתנגשו. כל git worktree הוא עותק עבודה (checkout) נפרד בענף משלו, שנוצר מ-commit קיים, ולכן המאגר זקוק ל-commit אחד לפחות תחילה.

claude --worktree feature-auth

הרץ את אותה פקודה עם שם אחר בטרמינל שני כדי להתחיל הפעלה מקבילה ומבודדת. במאגר ללא שום commit, הפקודה נכשלת עם Failed to resolve base branch "HEAD": git rev-parse failed. ראה Worktrees לגבי ניקוי, הקובץ .worktreeinclude ותמיכה במערכות בקרת גרסאות שאינן git. כדי לעקוב אחר הפעלות מקבילות ממסך אחד במקום מטרמינלים נפרדים, ראה background agents.

#תכנון לפני עריכה

עבור שינויים שברצונך לבדוק לפני שהם נוגעים בדיסק, עבור למצב תכנון (plan mode). Claude קורא קבצים ומציע תוכנית, אך אינו מבצע עריכות עד שאתה מאשר. שורת המצב מציגה ⏸ plan mode on בזמן שמצב תכנון פעיל.

claude --permission-mode plan

באפשרותך גם ללחוץ על Shift+Tab במהלך ההפעלה עד ששורת המצב תציג ⏸ plan mode on. ראה Plan mode עבור תהליך האישור ועריכת התוכנית בעורך הטקסט שלך.

#האצלת מחקר לסוכני משנה (subagents)

חקירת מאגר קוד גדול ממלאת את ההקשר שלך בקריאות קבצים. האצל את החקירה כדי שרק הממצאים יחזרו.

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

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

#הזנת Claude לתוך סקריפטים (pipe)

הפעל את Claude באופן לא אינטראקטיבי עבור CI, עבור הוקים לפני שמירה (pre-commit hooks) או עבור עיבוד באצ'ים. קלט רגיל (stdin) ופלט רגיל (stdout) פועלים כמו בכל כלי Unix.

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

ראה Non-interactive mode לפורמטים של פלט, דגלי הרשאות ותבניות פיזור (fan-out).

#השלבים הבאים

Best practices: תבניות להפקת המרב מ-Claude Code
Manage sessions: המשך, מתן שמות ופיצול שיחות לענפים
Worktrees: הרצת הפעלות מקבילות מבודדות
Extend Claude Code: הוספת כישורים (skills), הוקים (hooks), שרתי MCP, סוכני משנה ותוספים