Claude Code בעברית
ההתקדמות שלכם בקורס0 מתוך 14 פרקים

פרק 12

סוכנים חכמים (Agents & Sub-agents) ותכנון מתקדם

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

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

מה זה סוכן?

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

סוכן משנה (Sub-agent) הוא עוזר ש-Claude מפעיל לטובת משימה מוגדרת. מה שמייחד אותו:

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

צלילה לעומק: טוקנים, חלון הקשר ו-Prompt Caching

מה זה טוקן?

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

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

חלון ההקשר: הזיכרון לטווח קצר

חלון ההקשר (Context Window) הוא כל מה ש-Claude "רואה" ברגע נתון. הוא גדול, מאות אלפי טוקנים, ובחלק מהמודלים אפילו מיליון, אבל הוא מתמלא מהר. מה נמצא בו?

מהמתי נכנס
הוראות המערכת והכלים של Claude Codeבתחילת השיחה
CLAUDE.md, זיכרון אוטומטי וכללים בלי pathsבתחילת השיחה
שמות ותיאורים של Skills ושל כלי MCPבתחילת השיחה (רק השמות, לא התוכן)
כל הודעה שלכם וכל תשובה של Claudeלאורך השיחה
כל קובץ ש-Claude קוראברגע הקריאה, ונשאר
כל פלט של פקודהברגע ההרצה, ונשאר
כללים עם paths ו-CLAUDE.md של תת-תיקייהכשנוגעים בקבצים מתאימים

/context מראה בכל רגע מה תופס מקום בחלון, לפי קטגוריות.

Prompt Caching: למה ההודעה השנייה זולה מהראשונה

עובדה מפתיעה: המודל לא זוכר כלום בין הודעה להודעה. בכל פעם שאתם שולחים הודעה, Claude Code שולח מחדש את כל השיחה: ההוראות, CLAUDE.md, כל הקבצים שנקראו, וכל ההודעות. נשמע בזבזני? כאן נכנס Prompt Caching (זיכרון מטמון).

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

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

שכבהמה יש בהמשתנה כש
1. הוראות מערכתהוראות בסיס והגדרות הכליםקבוצת הכלים משתנה
2. הקשר הפרויקטCLAUDE.md, זיכרון, כלליםשיחה חדשה, /clear או /compact
3. השיחהההודעות, התשובות ופלטי הכליםבכל הודעה (רק בסוף)

מה שובר את המטמון (התור הבא איטי ויקר יותר, פעם אחת):

  • החלפת מודל עם /model: לכל מודל מטמון משלו.
  • סיכום עם /compact: השיחה מוחלפת בסיכום חדש. זה בסדר בנקודת עצירה טבעית, פחות באמצע משימה.
  • חיבור או ניתוק של שרת MCP, ושינויים בתוספים שמוסיפים כלים, בחלק מהמקרים.
  • שדרוג של Claude Code, בשיחה הראשונה אחריו.

מה לא שובר את המטמון:

  • עריכת קבצים בפרויקט, גם קבצים ש-Claude כבר קרא.
  • החלפת מצב הרשאות עם Shift + Tab.
  • הפעלת Skills: התוכן שלהם נוסף בסוף השיחה.
  • /rewind: חוזרים לנקודה שכבר נמצאת במטמון.
  • הפעלת סוכן משנה: הוא בונה מטמון משלו, ומשאיר את של השיחה הראשית כמו שהוא.

כדי לבדוק איך המטמון עובד אצלכם, הריצו /usage. בשורה Prompt cache תראו כמה מהקלט הגיע מהמטמון.

ואיך כל זה קשור לסוכנים?

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

הסוכנים המובנים

Claude Code מגיע עם סוכני משנה מוכנים, ומשתמש בהם לבד כשזה מתאים:

סוכןמה הוא עושהכלים
Exploreחיפוש וניתוח מהירים בקודקריאה בלבד
Planמחקר על הקוד בזמן מצב תכנוןקריאה בלבד
General-purposeמשימות מורכבות שדורשות גם חקירה וגם פעולהכל הכלים
claude-code-guideעונה על שאלות על Claude Code עצמוקריאת תיעוד

כשביקשתם בפרק 4 "תכנן לפני שאתה כותב קוד", או בפרק 7 "תשתמש בסוכני משנה כדי לחקור", אלה הסוכנים שעבדו מאחורי הקלעים.

סוכן מוביל, סוכנים במקביל וסוכנים ברקע

במקביל: כמה יועצים בבת אחת

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

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

מוביל או ברקע?

בחזית (Foreground)ברקע (Background)
השיחה הראשיתמחכה שהסוכן יסייםממשיכה. אפשר להמשיך לעבוד
בקשות אישורמגיעות אליכם כרגילמופיעות בשיחה הראשית, עם שם הסוכן
מתי מתאיםכשצריך את התוצאה כדי להמשיךמשימה ארוכה ועצמאית: סקירה, בדיקות, תיעוד

סוכן שכבר רץ בחזית אפשר להעביר לרקע עם Ctrl + B. אפשר גם לבקש מראש:

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

לבנות סוכנים משלכם

איפה הם גרים

מיקוםלמי
.claude/agents/<name>.mdלפרויקט, לכל מי שעובד עליו (נשמר ב-Git)
~/.claude/agents/<name>.mdלכם, בכל הפרויקטים

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

השדות החשובים

שדהמה הוא עושה
nameחובה. השם של הסוכן
descriptionחובה. מתי Claude צריך להעביר אליו משימה. "use proactively" מעודד אותו לעשות את זה לבד
toolsרשימת הכלים המותרים. בלי השדה הזה, הסוכן מקבל את כל הכלים
disallowedToolsכלים שנחסמים
modelsonnet, opus, haiku, או inherit (כמו השיחה הראשית)
permissionModeמצב הרשאות לסוכן: למשל plan לקריאה בלבד
maxTurnsכמה צעדים לכל היותר לפני שהסוכן עוצר
skillsSkills שנטענים לסוכן מראש (פרק 11)
memoryזיכרון קבוע לסוכן, שנשמר בין שיחות: project, user או local
backgroundtrue = תמיד רץ ברקע
isolationworktree = עובד על עותק נפרד של הפרויקט, ב-Git worktree זמני
colorצבע לזיהוי בטרמינל

סוכן 1: סוקר קוד

.claude/agents/code-reviewer.md
---
name: code-reviewer
description: Reviews code changes for bugs, accessibility and RTL issues. Use proactively after any significant code change and before opening a PR.
tools: Read, Glob, Grep, Bash
model: sonnet
color: blue
---
 
You are a meticulous senior reviewer for a Hebrew, RTL, Next.js family website
whose main users are older adults.
 
When invoked:
1. Run `git diff main...HEAD` to see what changed.
2. Read every changed file in full, not just the diff lines.
3. Check: correctness, edge cases, RTL layout, text size (min 18px),
   buttons with text labels, no secrets, no swallowed errors.
4. Report in Hebrew, grouped by severity, each item with file:line
   and a concrete suggested fix.
 
Never edit files. You report; the main conversation decides.

שימו לב: אין לסוכן כלים לעריכה (Edit, Write). גם אם ירצה "לתקן משהו קטן", הוא לא יכול. סוקר שמתקן בעצמו כבר לא סוקר.

סוכן 2: צייד באגים

.claude/agents/bug-hunter.md
---
name: bug-hunter
description: Investigates errors, stack traces and failing builds to find the root cause. Use when the user reports a bug, pastes an error, or a build fails.
tools: Read, Glob, Grep, Bash
model: inherit
memory: project
---
 
You are a debugging specialist. Your job is to find ROOT CAUSES, not to
make errors disappear.
 
1. Reproduce: find the exact command or steps that trigger the error.
2. Trace the data flow across files until you find where it goes wrong.
3. Rank up to three hypotheses and verify each without changing code.
4. Return: the root cause, the evidence, and a proposed minimal fix.
5. Check your memory for similar past bugs in this project, and record
   this one (symptom → cause) when you are done.
 
Never suggest try/catch that swallows errors, ts-ignore, or disabling checks.

שימו לב ל-memory: project: הסוכן מקבל תיקיית זיכרון משלו (.claude/agent-memory/bug-hunter/), ששורדת בין שיחות. עם הזמן הוא "זוכר" אילו באגים כבר קרו בפרויקט ומה גרם להם.

סוכן 3: כותב תיעוד, ויצירה אוטומטית של README

.claude/agents/docs-writer.md
---
name: docs-writer
description: Writes and updates project documentation (README.md, setup guides, code comments) based on the actual code. Use when docs are missing or out of date.
tools: Read, Glob, Grep, Bash, Write, Edit
model: sonnet
---
 
You write clear documentation for a Hebrew-speaking audience.
 
Rules:
- Base every statement on the actual code and package.json. Never invent
  features, commands or URLs. If unsure, leave a TODO and say so.
- README.md structure: title, one-paragraph description, live URL
  (placeholder if unknown), requirements, install & run steps
  (git clone → npm install → npm run dev), available scripts,
  project structure, how to contribute, credits.
- Hebrew prose, wrapped in <div dir="rtl"> so it renders RTL on GitHub.
  Keep code blocks outside the RTL div.
- Only edit documentation files. Never touch source code.

ועכשיו, README שנוצר ומתעדכן אוטומטית:

תשתמש בסוכן docs-writer כדי לעדכן את README.md לפי המצב הנוכחי של הקוד: הפקודות ב-package.json, מבנה התיקיות והפרקים שקיימים ב-lib/syllabus.ts. לפני שהוא כותב, שיציג לי רשימה של מה שהשתנה לעומת ה-README הקיים

איך מפעילים סוכן

דרךאיך
אוטומטיתClaude קורא את ה-description ומעביר משימות מתאימות לבד
בבקשה"תשתמש בסוכן code-reviewer כדי לבדוק את השינויים שלי"
באזכורמקלידים @ ובוחרים את הסוכן מהרשימה
כל השיחהclaude --agent code-reviewer מפעיל שיחה שלמה כשהסוכן הוא הראשי

זרימת עבודה מלאה עם סוכנים

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

שלבמי עושהאיך
1. חקירה2-3 סוכני Explore במקביל"תחקור במקביל את X, Y ו-Z"
2. תכנוןClaude הראשי, במצב תכנוןShift + Tab עד plan mode on
3. סקירת התוכניתסוכן משנה חדש, "בעיניים רעננות""תשתמש בסוכן משנה כדי למצוא חורים בתוכנית"
4. ביצועClaude הראשי, בענף חדשאחרי אישור התוכנית
5. אימותcode-reviewer ו-bug-hunterסקירה ובדיקה לפני PR
6. תיעודdocs-writerעדכון README

בקשה חלשה

תוסיף לאתר מערכת התחברות

בקשה חזקה

אנחנו מוסיפים התחברות. שלב 1: תפעיל במקביל שני סוכני Explore, אחד לניתוב ולדפים ואחד לשמירת הנתונים, כל אחד עם דוח קצר. שלב 2: על סמך הדוחות, תכין תוכנית במצב תכנון. שלב 3: לפני שאני מאשר, תשתמש בסוכן משנה נפרד שינסה למצוא בתוכנית חורים ומקרי קצה. אל תכתוב קוד עד שאאשר.

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

סוכנים מהקהילה

  • aitmpl.com/agents: קטלוג של מאות סוכנים מוכנים, בתחומים כמו פיתוח, אבטחה ו-DevOps, מבוסס על הפרויקט הפתוח claude-code-templates. התקנה של סוכן ספציפי:
בטרמינל
npx claude-code-templates@latest --agent development-tools/code-reviewer --yes
  • alirezarezvani/claude-skills: מעבר ל-Skills, יש במאגר גם עשרות "פרסונות" של סוכנים, והסבר איך לשלב אותם עם Skills.

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

סוכנים הם כלי חזק, אבל לא לכל דבר:

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

תרגיל: הצוות שלכם

  1. צרו את שלושת הסוכנים מהפרק ב-.claude/agents/.
  2. בקשו מ-Claude שלוש חקירות במקביל על הפרויקט, וראו שכל אחת חוזרת כדוח קצר.
  3. עשו שינוי קטן בקוד, וכתבו "סיימתי את השינוי". code-reviewer הופעל לבד, בזכות "use proactively"?
  4. הדביקו שגיאה כלשהי (אפשר מתרגיל ציד הבאגים בפרק 7) ובקשו מ-bug-hunter לחקור.
  5. הפעילו סוכן ברקע, והמשיכו לעבוד בזמן שהוא רץ.
  6. צרו את ה-Skill update-readme והריצו /update-readme.
  7. הריצו /context לפני ואחרי חקירה גדולה עם סוכן, וראו כמה מקום נחסך.

סיימתם את התרגיל?

0 מתוך 8

סיכום

  • סוכן פועל בלולאה: קורא, מחליט, עושה ובודק. סוכן משנה הוא עוזר עם חלון הקשר, הוראות וכלים משלו, שמחזיר רק סיכום.
  • טוקנים הם יחידת המדידה של הכול. חלון ההקשר מתמלא מכל קובץ ופלט, והביצועים יורדים כשהוא מלא.
  • Prompt Caching חוסך עיבוד חוזר של תחילת השיחה. לא מחליפים מודל באמצע משימה, ומסכמים בהפסקות טבעיות.
  • במקביל לחקירות עצמאיות, ברקע למשימות ארוכות (Ctrl + B), ובחזית כשצריך את התוצאה כדי להמשיך.
  • סוכנים משלכם ב-.claude/agents/: תיאור טוב, tools מינימליים, מודל מתאים, ולפעמים memory.
  • Skill עם context: fork מריץ סוכן בפקודה אחת, למשל /update-readme.

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

בדקו את עצמכם

1. מה היתרון העיקרי של סוכן משנה?

2. מה שובר את ה-Prompt Caching?

פתרון כל שאלות החידון מסמן את הפרק כהושלם אוטומטית.