📘 תיעוד 10

זרימות עבודה נפוצות

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

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

הדף הזה מכסה:

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

#מתכוני פרומפט

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

#הבנת בסיסי קוד חדשים

להגדרת Claude Code במונורפו או בבסיס קוד גדול, ראו מונורפו ומאגרים גדולים.

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

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

1. נווטו לתיקיית השורש של הפרויקט

cd /path/to/project 

החליפו את /path/to/project בנתיב לפרויקט שלכם.

2. הפעילו את Claude Code

claude 

3. בקשו סקירה ברמה גבוהה

give me an overview of this codebase

4. העמיקו ברכיבים ספציפיים

explain the main architecture patterns used here

what are the key data models?

how is authentication handled?

[!TIP]

טיפים:

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

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

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

1. בקשו מ-Claude למצוא קבצים רלוונטיים

find the files that handle user authentication

2. קבלו הקשר על האופן שבו רכיבים פועלים יחד

how do these authentication files work together?

3. הבינו את זרימת הביצוע

trace the login process from front-end to database

[!TIP]

טיפים:

• היו ספציפיים לגבי מה שאתם מחפשים
• השתמשו בשפת התחום של הפרויקט
• התקינו תוסף מודיעין קוד עבור השפה שלכם כדי לתת ל-Claude ניווט מדויק של "go to definition" ו-"find references"

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

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

1. שתפו את השגיאה עם Claude

I'm seeing an error when I run npm test

2. בקשו המלצות לתיקון

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

3. החילו את התיקון

update user.ts to add the null check you suggested

[!TIP]

טיפים:

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

#רפקטור של קוד

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

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

1. זהו קוד ישן לרפקטור

find deprecated API usage in our codebase

2. קבלו המלצות רפקטור

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

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

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

4. אמתו את הרפקטור

run tests for the refactored code

[!TIP]

טיפים:

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

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

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

1. זהו קוד שלא נבדק

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

2. צרו שלד בדיקות

add tests for the notification service

3. הוסיפו מקרי בדיקה משמעותיים

add test cases for edge conditions in the notification service

4. הריצו ואמתו בדיקות

run the new tests and fix any failures

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

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

#יצירת pull requests

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

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

summarize the changes I've made to the authentication module

2. צרו pull request

create a pr

3. סקרו ושפרו

enhance the PR description with more context about the security improvements

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

[!TIP]

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

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

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

1. זהו קוד בלי תיעוד

find functions without proper JSDoc comments in the auth module

2. צרו תיעוד

add JSDoc comments to the undocumented functions in auth.js

3. סקרו ושפרו

improve the generated documentation with more context and examples

4. אמתו את התיעוד

check if the documentation follows our project standards

[!TIP]

טיפים:

• ציינו את סגנון התיעוד שאתם רוצים (JSDoc, docstrings וכן הלאה)
• בקשו דוגמאות בתוך התיעוד
• בקשו תיעוד ל-API ציבוריים, לממשקים וללוגיקה מורכבת

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

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

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

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

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

1. הוסיפו תמונה לשיחה

אפשר להשתמש בכל אחת מהשיטות האלה:

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

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

What does this image show?

Describe the UI elements in this screenshot

Are there any problematic elements in this diagram?

3. השתמשו בתמונות להקשר

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?

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

Generate CSS to match this design mockup

What HTML structure would recreate this component?

[!TIP]

טיפים:

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

#הפניה לקבצים ולתיקיות

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

1. הפניה לקובץ יחיד

Explain the logic in @src/utils/auth.js

זה כולל את תוכן הקובץ בשיחה כשהוא נכנס למגבלת הטוקנים של כלי Read, 25,000 טוקנים כברירת מחדל. קובץ טקסט גדול מ-256KB לא נכלל.

2. הפניה לתיקייה

What's the structure of @src/components?

3. הפניה למשאבי MCP

Show me the data from @github:repos/owner/repo/issues

זה מביא נתונים משרתי MCP מחוברים באמצעות הפורמט @server:resource. ראו משאבי MCP לפרטים.

[!TIP]

טיפים:

• נתיבי קבצים יכולים להיות יחסיים או מוחלטים
• הקלידו @ כדי לפתוח תפריט הצעות נתיב, ואז לחצו Enter או Tab כדי לקבל את הנתיב המודגש ו-Enter שוב כדי לשלוח את ההודעה
• הפניות @ לקובץ מוסיפות את CLAUDE.md בתיקייה של הקובץ ובתיקיות האב להקשר
• הפניות לתיקייה מציגות רשימות קבצים, לא תוכן
• אפשר להפנות לכמה קבצים בהודעה אחת (לדוגמה, "@file1.js and @file2.js")

כדי לעצור הפניות @ מלהכליל תוכן קבצים ורשימות תיקיות, הגדירו את CLAUDE_CODE_DISABLE_FILE_MENTIONS ל-1 במעטפת שלכם או בבלוק env של הגדרות המשתמש או הגדרות מנוהלות. Claude מקבל אז את הנתיבים שהפניתם אליהם עם הערה לקרוא אותם באמצעות כלי הקבצים שלו. המשתנה דורש Claude Code מגרסה v2.1.299 ואילך, ו-Claude Code מתעלם ממנו בהגדרות פרויקט ובהגדרות מקומיות.

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

• חסימת נתיבים ספציפיים: הוסיפו עבורם כלל דחייה של Read. Claude Code לא כולל קובץ שהכלל תואם לו.
• עצירת הפניות @ מלהכליל קבצים: הגדירו CLAUDE_CODE_DISABLE_FILE_MENTIONS=1, מה שעוצר הפניות @ לקבצים ולתיקיות בהודעות שלכם מלהכליל תוכן, גם עבור נתיבים שההוקים שלכם לא בודקים. ההוקים התואמים רצים אז לפני ש-Claude פותח נתיב שהופנה אליו עם כלי כגון Read.

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

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

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

[!TIP]

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

#שאלות ל-Claude על היכולות שלו

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

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

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?

[!NOTE]

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

[!TIP]

טיפים:

• שאלו שאלות ספציפיות כדי לקבל תשובות מפורטות
• Claude יכול להסביר יכולות מורכבות כמו שילוב MCP, הגדרות ארגוניות וזרימות עבודה מתקדמות

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

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

claude --continue

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

#הרצת סשנים מקבילים עם worktrees

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

claude --worktree feature-auth

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

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

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

claude --permission-mode plan

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

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

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

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

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

#הזרמת Claude לתוך סקריפטים

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

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

ראו מצב לא אינטראקטיבי לפורמטי פלט, דגלי הרשאות, ודפוסי fan-out.

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

• שיטות עבודה מומלצות: דפוסים להפקת המרב מ-Claude Code

• ניהול סשנים: חידוש שיחות, מתן שם לשיחות ויצירת ענפים לשיחות

• Worktrees: הרצת סשנים מבודדים במקביל

• הרחבת Claude Code: הוספת skills, hooks, MCP, subagents ו-plugins