הסוכנת הראשונה שלך
בונים אותה ב-Claude Code

מה תבני במדריך הזה

בסוף המדריך יהיו לך שתי סוכנות עובדות, שאת בנית בעצמך:

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

שלוש דרכים לעבוד עם Claude Code

זה אותו Claude בשלושתן. ההבדל הוא רק איך המסך נראה

מה צריך להכין לפני שמתחילים

• מחשב עם Windows 10 או Windows 11, וחיבור לאינטרנט.
• מנוי בתשלום של Claude: Pro, Max, Team או Enterprise. בחשבון החינמי זה לא יעבוד. אין צורך במפתח API (ההסבר למה, בסוף המדריך).
• בערך שעה וחצי פנויה לסוכנת הראשונה, ועוד כשעה לשנייה.
• לסוכנת השנייה בלבד: חשבון Google עם Gmail.

ℹ️ המדריך נבדק מול התיעוד הרשמי באוקטובר 2026. הכלים מתעדכנים לעיתים קרובות, ולכן שמות של כפתורים ותפריטים עשויים להשתנות מעט.

מפת הדרך

לחיצה על שלב מעבירה אליו

1. מתקינים את VS Code10 דק׳
2. מתקינים בתוכה את התוסף Claude Code5 דק׳
3. יוצרים תיקיית עבודה ופותחים אותה10 דק׳
4. מתחברים ומנהלים שיחה ראשונה10 דק׳
5. מסדרים את התיקייה ומוסיפים הוראות קבועות15 דק׳
6. שמירת גרסאות ב-GitHub (רשות)20 דק׳
7. סוכנת 1: ניתוח משובים30 דק׳
8. סוכנת 2: פניות לקוחות עם Gmail45 דק׳

1. נכנסים לאתר https://code.visualstudio.com ולוחצים על כפתור ההורדה ל-Windows.

1. פותחים את הקובץ שירד (בדרך כלל בתיקייה Downloads).
2. מאשרים את תנאי השימוש ולוחצים Next.
3. במסך האפשרויות הנוספות מסמנים את שתי השורות שמכילות את הביטוי Open with Code. כך תוכלי אחר כך לפתוח כל תיקייה ב-VS Code בקליק ימני.
4. לוחצים Install, ובסיום Finish. התוכנה תיפתח.

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

1. בתוך VS Code לוחצים על סמל ההרחבות בסרגל הצד (ארבעה ריבועים), או על המקשים Ctrl+Shift+X.

1. בשורת החיפוש מקלידים: Claude
2. בוחרים את התוסף Claude Code for VS Code שהמפרסם שלו Anthropic, עם סימן אימות כחול. יש תוספים עם שמות דומים מחברות אחרות, ואותם לא מתקינים.

1. לוחצים Install וממתינים כמה שניות.
2. אם מופיעה ההודעה All extensions require a restart, לוחצים על הכפתור הכחול Restart Extensions.

⚠️ התוסף לא מופיע אחרי ההתקנה? לוחצים Ctrl+Shift+P, מקלידים Reload Window ובוחרים Developer: Reload Window. החלון ייטען מחדש. התוסף דורש גרסה 1.94 של VS Code ומעלה. בודקים בתפריט Help ואז About.

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

אפשרות א: תיקייה חדשה

1. פותחים את סייר הקבצים של Windows (סמל התיקייה הצהובה בשורת המשימות, או המקשים Win+E).
2. בצד לוחצים על This PC ("מחשב זה") ובוחרים כונן, בדרך כלל Local Disk (C:).
3. נכנסים למיקום הרצוי. הכי פשוט: התיקייה Documents.
4. קליק ימני על מקום ריק, בוחרים New ואז Folder. אפשר גם בקיצור Ctrl+Shift+N.
5. קוראים לתיקייה My-AI-Agent ולוחצים Enter. עדיף שם באנגלית ובלי רווחים.

אפשרות ב: תיקייה שכבר קיימת

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

פותחים את התיקייה ב-VS Code

1. בתוך VS Code לוחצים במסך הפתיחה על Open Folder. אפשר גם דרך התפריט File ואז Open Folder.

1. מנווטים לתיקייה My-AI-Agent, לוחצים עליה פעם אחת ואז Select Folder.
2. תופיע שאלה: Do you trust the authors of the files in this folder? בוחרים Yes, I trust the authors. זו התיקייה שלך, ולכן זה בטוח.
3. בודקים שבצד, באזור Explorer, מופיע השם MY-AI-AGENT.

⚠️ למה האישור הזה חשוב: אם בוחרים No, התיקייה נפתחת ב"מצב מוגבל" (Restricted Mode), והתוסף לא עובד בו. מאשרים רק תיקיות שלך או של מקור שאת סומכת עליו.

💡 קיצור דרך לפעמים הבאות: אם סימנת בהתקנה את Open with Code, עושים קליק ימני על התיקייה בסייר הקבצים ובוחרים Open with Code. ב-Windows 11 זה נמצא תחת Show more options.

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

פותחים את חלון השיחה

יש כמה דרכים, ומספיקה אחת:

• בשורת המצב הכחולה בתחתית החלון, בצד ימין, לוחצים על ✻ Claude Code. זה עובד גם כשאין קובץ פתוח.
• בסמל ה-Spark (כוכבית כתומה) בפינה העליונה של אזור העריכה. הוא מופיע רק כשקובץ כלשהו פתוח.
• בסרגל הצד: סמל ה-Spark מופיע גם בסרגל הסמלים שבצד, תמיד. לחיצה עליו פותחת את רשימת השיחות, ומשם פותחים שיחה חדשה.
• בחלון הפקודות: לוחצים Ctrl+Shift+P, מקלידים Claude Code ובוחרים Open in New Tab.

מתחברים לחשבון

1. בפעם הראשונה יופיע מסך התחברות. לוחצים Sign in.
2. ייפתח דפדפן. מתחברות עם אותו חשבון של המנוי ב-Claude ומאשרות.
3. חוזרים ל-VS Code. אם מופיעה רשימת הדרכה בשם Learn Claude Code, אפשר לעבור עליה או לסגור ב-X.

⚠️ כתוב Not logged in? לוחצים Ctrl+Shift+P, בוחרים Developer: Reload Window ומנסים שוב. אם עדיין לא עובד, בודקים שהמנוי בתשלום פעיל.

שיחה ראשונה, בלי לשנות כלום

בפינה למטה, ליד כפתור השליחה, רואים את מצב ההרשאות. בצילום כתוב Auto, ואצלך אמור להיות Manual.

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

💡 להפנות את Claude לקובץ מסוים: מקלידים @ ואחריו חלק משם הקובץ, ובוחרים מהרשימה. למשל: סכם לי את @feedback. כך Claude יודע בדיוק על איזה קובץ מדובר.

נבקש מ-Claude ליצור שלוש תיקיות משנה:

• התיקייה input: קבצי המקור שהסוכנת קוראת.
• התיקייה output: התוצרים שהסוכנת כותבת.
• התיקייה instructions: מסמכי הנחיות שלך, כמו סגנון כתיבה או מחירון.

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

כיוון שבחרת Manual, Claude יבקש אישור. מאשרים, ובודקים שהתיקיות הופיעו באזור Explorer.

הוראות קבועות: הקובץ CLAUDE.md

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

צור בתיקייה הראשית קובץ CLAUDE.md עם ההוראות הבאות:
1. תמיד לענות בעברית ובלשון נקבה.
2. לא למחוק ולא לדרוס קבצים בתיקייה input.
3. לשמור כל תוצר חדש בתיקייה output.
4. אם חסר מידע, לשאול אותי במקום לנחש.
5. בסוף כל משימה, לפרט אילו קבצים נוצרו או שונו.

💡 לערוך את ההוראות בעצמך: פותחים את הקובץ CLAUDE.md מאזור Explorer, משנים, ושומרים עם Ctrl+S. ההוראות החדשות ייכנסו לתוקף בשיחה הבאה שתפתחי.

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

1. מוודאים ש-Git for Windows מותקן (ראי שלב 2).
2. פותחים חשבון חינמי באתר https://github.com
3. באתר לוחצים New repository, קוראים לו my-ai-agent ומסמנים Private. לא מסמנים Add a README, כדי לא ליצור התנגשות.
4. ב-VS Code לוחצים על סמל Source Control בסרגל הצד (שלושה עיגולים מחוברים) ואז Initialize Repository.
5. כותבים הודעה קצרה, למשל "גרסה ראשונה", ולוחצים Commit. אם VS Code שואל אם לכלול את כל הקבצים, עונים Yes.
6. לוחצים Publish Branch, בוחרים Private ומתחברים ל-GitHub כשמתבקשים.

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

⚠️ מה אסור להעלות, גם למאגר פרטי: סיסמאות, מפתחות API, קבצי לקוחות, פרטי אשראי ומסמכים חסויים. מאגר פרטי זה לא כספת.

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

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

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

איפה היא נשמרת

בתוך התיקייה של הפרויקט, בתיקייה .claude/agents/, בקובץ ששמו כשם הסוכנת עם הסיומת .md. התיקייה מתחילה בנקודה, וזה תקין.

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

סוכנת מקומית לעומת סוכנת מחוברת

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

מבנה תיקיית העבודה בסוף המדריך

צעד 1: קובץ משובים לתרגול

נתרגל על נתוני דוגמה ולא על לקוחות אמיתיות

צור בתיקייה input קובץ בשם feedback.txt, עם שמונת המשובים הבאים, כל משוב בשורה נפרדת:
לקוחה 1: השירות מצוין אבל התשובה לוקחת יומיים.
לקוחה 2: תהליך ההזמנה באתר מסובך, התייאשתי באמצע.
לקוחה 3: חסרות הוראות שימוש במוצר.
לקוחה 4: היחס אישי וחם, אבל זמן המענה ארוך.
לקוחה 5: המוצר איכותי, אשמח לאפשרות לשלם בביט.
לקוחה 6: לא הבנתי איך בוחרים מידה באתר.
לקוחה 7: שירות מעולה, ממליצה לכולן.
לקוחה 8: חיכיתי שלושה ימים לתשובה במייל.

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

צעד 2: מבקשים מ-Claude לבנות את הסוכנת

צור סוכנת משנה ברמת הפרויקט, בקובץ .claude/agents/feedback-analyst.md, בשם feedback-analyst.
תפקידה: לנתח קבצי משובי לקוחות מהתיקייה input ולכתוב דוח בעברית לתיקייה output.
כלים מותרים: Read, Write, Glob, Grep בלבד.
ההוראות שלה, בעברית:
1. לקרוא את כל הקבצים ב-input ולספור כמה משובים יש.
2. לזהות מחמאות חוזרות, תלונות חוזרות ובקשות.
3. לכל ממצא, לציין על אילו משובים הוא נשען.
4. להפריד בין מה שכתוב במשובים לבין המלצות.
5. לא להמציא משובים, מספרים או ציטוטים, ולא לשנות קבצי מקור.
6. אם המידע לא מספיק למסקנה, לכתוב זאת במפורש.
אחרי שתיצור את הקובץ, הראה לי את התוכן שלו.

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

💡 מה לבדוק בקובץ

• השורה הראשונה היא בדיוק שלושה מקפים קצרים (---). אם יש לפניה שורה ריקה, הסוכנת לא תיטען.
• יש שורת name ושורת description. שתיהן חובה. בלי אחת מהן, הקובץ פשוט לא נטען, בלי הודעת שגיאה.
• ברשימת tools אין כלים מיותרים. כאן אין Edit ואין הרצת פקודות, וזה מכוון.

צעד 3: שיחה חדשה כדי שהסוכנת תיטען

אם התיקייה .claude/agents/ לא הייתה קיימת כשפתחת את השיחה, השיחה הנוכחית לא "תראה" את הסוכנת החדשה. פותחים שיחה חדשה: Ctrl+Shift+P ואז Claude Code: Open in New Tab, או Developer: Reload Window.

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

צעד 4: מפעילים

בתיבת הכתיבה מקלידים @ ובוחרים מהרשימה את feedback-analyst (agent). כך מובטח שדווקא היא תעבוד. אחר כך כותבים את המשימה:

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

צעד 5: בודקים, לא מאמינים

• פותחים את הקובץ customer-feedback-report.md בתיקייה output.
• האם כתוב 8 משובים? אם לא, משהו השתבש.
• בעיית זמן המענה אמורה לעלות ראשונה, כי היא חוזרת בשלושה משובים (1, 4, 8).
• כל ציטוט בדוח קיים באמת בקובץ המקור?

💡 קריאה נוחה של הדוח: קבצי md הם טקסט עם סימני עיצוב. כדי לראות אותם מעוצבים: קליק ימני על הקובץ ב-Explorer ואז Open Preview, או Ctrl+Shift+V.

צעד 6: משפרים

לא אהבת את המבנה? לא צריך לבנות מחדש. אומרים ל-Claude מה לשנות בהוראות של הסוכנת, למשל:

מאשרים, ומריצים שוב.

מה הסוכנת השנייה עושה, שלב אחר שלב

⚠️ תנאי חשוב לפני שמתחילים: החיבורים (Connectors) עוברים ל-Claude Code רק כשמחוברים עם חשבון המנוי של Claude, ולא עם מפתח API. אם התחברת בשלב 4 דרך Sign in עם החשבון שלך, זה בסדר. בחשבונות Team ו-Enterprise רק מנהלת החשבון יכולה להוסיף חיבורים חדשים.

צעד 1: מחברים את Gmail

1. בדפדפן נכנסים ל-https://claude.ai/customize/connectors (או בהגדרות של Claude, בחלק Connectors).
2. מוצאים את Gmail ולוחצים Connect.
3. מתחברים לחשבון Google ומאשרים את ההרשאות. כדאי לקרוא מה מאשרים.

📌 למה לא מחברים את Gmail מתוך VS Code: החיבור ל-Gmail מתנהל על ידי Anthropic, ו-Google מאפשרת אותו רק דרך האתר של Claude. ניסיון לחבר אותו ישירות מ-Claude Code ייכשל. מחברים פעם אחת באתר, והוא מופיע אוטומטית גם ב-VS Code.

צעד 2: טבלת המעקב

יש שתי דרכים. אם זו הפעם הראשונה, מומלץ להתחיל בדרך ב, כי היא לא דורשת חיבור נוסף.

צעד 3: מוודאים שהחיבורים מופיעים

פותחים תיקייה חדשה בשם Customer-Service-Agent (בדיוק כמו בשלב 3), פותחים שיחה, ומקלידים:

ברשימה אמורים להופיע חיבורים שמתחילים ב-claude.ai, למשל claude.ai Gmail. חיבורים שעוד לא השתמשת בהם עשויים להיות מוסתרים תחת Show unused connectors.

⚠️ החיבור לא מופיע? מקלידים /status ובודקים שההתחברות היא עם חשבון Claude ולא עם מפתח API. סוגרים ופותחים מחדש את VS Code. אם הרשימה עדיין חסרה, מחברים מחדש באתר.

צעד 4: מבקשים מ-Claude לבנות את הסוכנת

צור סוכנת משנה ברמת הפרויקט בשם customer-service-agent.
לפני שאתה כותב את הקובץ, בדוק אילו כלים בדיוק זמינים בחיבור ל-Gmail ובחיבור ל-Google Sheets, והצג לי את השמות שלהם.
ברשימת הכלים של הסוכנת כלול רק: חיפוש וקריאה של מיילים, יצירת טיוטה, והוספת שורה לגיליון. אל תכלול כלים של שליחה, העברה, מחיקה או סימון כספאם.
ההוראות שלה, בעברית:
1. לקרוא את הפנייה ממקור שאישרתי.
2. לזהות נושא ודחיפות (גבוהה, רגילה, נמוכה).
3. להוסיף שורה לטבלת המעקב, בלי ליצור כפילויות.
4. להכין טיוטת תשובה אדיבה, בעברית ובלשון נקבה.
5. לא לשלוח, לא למחוק, לא להבטיח הנחות או מועדים, ולא להמציא פרטים.
6. לסיים בדוח: מה בוצע ומה לא הצליח.

📌 בחרת בדרך ב? מחליפים את המשפט על הגיליון ב"הוספת שורה לקובץ output/inquiries.csv", וברשימת הכלים מבקשים Read, Write ו-Edit במקום הכלי של הגיליון.

צעד 5: ניסוי מבוקר

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

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

צעד 6: בודקים במקור

• ב-Gmail, בתיקיית הטיוטות: יש טיוטה חדשה? הטון מתאים?
• בטבלת המעקב: נוספה שורה אחת, עם תאריך, נושא ודחיפות?
• ההודעה "סיימתי" של הסוכנת היא לא הוכחה. ההוכחה היא מה שרואים בפועל ב-Gmail ובטבלה.

סוכנת שיצרת לא עובדת ברקע מעצמה. היא מחכה שמישהו יפעיל אותה. יש שלוש רמות:

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

מילון קצר