פרק 1 - היסודות - Agents 101_×

Agents 101פרק 1

היסודות: מה זה Claude Code, ולמה זה לא רק למתכנתים

מה זה Claude Code, Chatbot מול Agent, ששת החלקים של סוכן, מפת המוצרים (Chat/Cowork/Code/Codex), הסשן הראשון, מצבי הרשאה, מה זה סשן ואיך סשנים מדברים, / ו-@

אביתר יצחק8 דקות קריאה

ארגז כלים אדום פתוח ובו שורת כלים מסודרים, כמו תפריט: מפתח ברגים, מברג, מברשת, פטיש, סרט מדידה ופלייר

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

1.1 מתשובה לתוצאה

עד היום ביקשנו מ-AI תשובה. "תסביר לי את המאמר". "תכתוב לי פוסט". והתשובה נעלמה בהיסטוריית הצ'אט.

עכשיו אנחנו מבקשים תוצאה. "צור טבלה מכל המאמרים בתיקייה, שמור אותה כ-CSV, ותכתוב לי מה חסר." ובסוף יש קובץ. אמיתי. בתיקייה. שאפשר לפתוח מחר.

זה כל ההבדל בין Chatbot ל-Agent:

  • Chatbot: מהיר, נוח, לא צריך כלום. מצוין לשאלה אחת.
  • Agent: מקבל יעד, מסתכל מה יש, בוחר כלים, עושה כמה צעדים, בודק שיצא תוצר. עובד גם כשהמשימה נמשכת שלושה ימים ועוברת בין 40 קבצים.

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

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

1.2 ממה בנוי Agent (הציור שנחזור אליו כל המדריך)

מטרה  ->  הקשר  ->  תכנית  ->  כלים  ->  הרשאות  ->  תוצר
Goal      Context    Plan       Tools     Permissions  Output
חלקהשאלה שהוא עונה עליהדוגמה
Goalמה צריך להיות נכון בסוף?"טבלה עם עמודות: מקור, שיטה, ממצא, מגבלה" (ולא "עזור לי בסקירה")
Contextמה הסוכן יודע ורואה עכשיו?הקבצים שפתח, ה-CLAUDE.md, ההודעות. "אם הסוכן לא פתח את הקובץ, מבחינתו הוא לא על השולחן"
Planמה הוא עומד לעשות לפני שהוא נוגע ב-20 קבצים?"אקרא X, אשנה Y, אעצור ב-Z"
Toolsבמה הוא יכול להשתמש?קריאת קבצים, טרמינל, דפדפן, יומן גוגל
Permissionsמה מותר לו לעשות בלי לשאול?לקרוא - כן. למחוק - לשאול
Outputמה נשאר בסוף שאפשר לפתוח ולבדוק?קובץ, log, diff. "אם אין קובץ שאפשר לפתוח, המשימה עוד לא הסתיימה"

למה זה חשוב: אם Agent לא עובד טוב, בדרך כלל אחד מששת החלקים לא ברור. במקום לכתוב פרומפט ארוך יותר - בודקים שישה חלקים.

1.3 מפת המוצרים: איפה אני נמצא בכלל?

אנתרופיק בנתה כמה "חדרים" לאותה צורת עבודה. אפליקציית Claude לדסקטופ (מק/ווינדוס) מכילה שלושה טאבים:

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

ובנוסף:

  • Claude Code CLI - אותו מנוע, בטרמינל. מה שהיה קודם. יש כמה דברים שרק שם (agent teams, --print לסקריפטים).
  • Claude Code on the web (claude.ai/code) - סשנים בענן.
  • אפליקציית המובייל - לראות סשני ענן, Remote Control, Dispatch.
  • Codex - הגרסה של OpenAI. מצב עבודה אייג'נטי בתוך אפליקציית ChatGPT (הם איחדו את אפליקציית Codex לתוך ChatGPT ביולי), וגם CLI ו-IDE. אותם עקרונות: תיקייה, הוראות, סקילים, כלים, הרשאות, תוצר. (פרק 6)

"צריך שליטה ישירה בקבצים ופקודות? Code. צריך תוצר ידע ארוך בלי טרמינל? Cowork." אין מנצח.

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

1.4 הסשן הראשון (5 דקות)

  1. פותחים את אפליקציית Claude ← טאב Code.
  2. Environment: Local (המחשב שלכם). יש גם Cloud ו-SSH, לא עכשיו.
  3. Project folder: בוחרים תיקייה. ספציפית, לא את כל Downloads. "זה הגבול הראשון של המשימה: תיקייה, לא המחשב." (בפרויקט גיט כל סשן חדש מקבל אוטומטית עותק מבודד - worktree - כדי ששני סשנים לא ידרכו אחד על השני.)
  4. Model: מהתפריט ליד כפתור השליחה. Sonnet ליומיום, Opus או Fable 5 לחשיבה כבדה. אפשר להחליף באמצע.
  5. Permission mode: מתחילים ב-Plan או Manual.
  6. כותבים את הבקשה הראשונה. ההמלצה שלי לבקשה ראשונה, תמיד:
תסתכל על התיקייה. אל תשנה כלום.
תסביר לי במילים פשוטות מה יש כאן, איזה קבצים נראים חשובים,
ומה היית מציע לעשות קודם.

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

  1. אחרי שהוא ענה - /init. קלוד כותב CLAUDE.md ראשוני לתיקייה. מעכשיו יש לפרויקט "דף על המסך" (פרק 2).

1.5 מצבי הרשאה - הרשאה היא החלטה, לא חלון שסוגרים מהר

זה הדבר שהכי חשוב לי שתצאו איתו מהפרק. כשקלוד שואל "מותר לי להריץ את הפקודה הזאת?" - זו לא הפרעה. זו החלטה.

מצבמה קורהמתי
Planקורא, חוקר, מציע תוכנית. לא משנה כלום.תחילת כל משימה לא טריוויאלית. הכי זול, הכי בטוח
Manual (ברירת מחדל)שואל לפני כל עריכה ופקודהכשלומדים, או בתיקייה עם דברים אמיתיים
Accept editsעריכות קבצים - אוטומטי. פקודות אחרות - שואלאחרי שאישרתם כיוון ויש גיבוי (git)
Autoקלוד שני בודק כל פעולה ומאשר מה שנראה בטוחPro/Max. משימות הפיכות
Bypass permissionsלא שואל כלוםרק סביבה מבודדת, עם גיבוי, בלי מידע רגיש. לא תרגיל חובה

מחליפים: בורר המצב בפינה (באפליקציה) או Shift+Tab (בטרמינל).

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

כלל הזהב: "פעולה אוטומטית טובה משאירה אחריה ראיות" - קובץ, log, diff, ציטוט. לא בודקים אם התשובה "נשמעת חכם". בודקים: יש קובץ? יש מקור? מסומנת אי-ודאות? נשמר log?

1.6 מה זה סשן, ואיך גורמים לסשנים לדבר

סשן = שיחה שמורה, קשורה לתיקייה, עם ההיסטוריה שלה, נקודות שמירה (checkpoints) של קבצים, והמודל שנבחר. נשמר במחשב שלכם (~/.claude/projects/..., כ-30 יום כברירת מחדל).

מה חשוב להבין: כל סשן מתחיל עם שולחן ריק. הידע לא עובר בין סשנים דרך השיחה. הוא עובר דרך קבצים (CLAUDE.md, זיכרון, KICKOFF) - פרק 2.

פעולות על סשנים

  • להמשיך: /resume (בוחרים מהרשימה), או בסרגל הצד באפליקציה. בטרמינל claude --continue = הסשן האחרון בתיקייה.
  • שם: /rename הצעה-לשרון. שם = ידית לחזור אליה. סשן בלי שם מקבל כותרת אוטומטית.
  • לפצל: /branch - עותק של השיחה לסשן חדש, המקור נשאר. "רוצה לנסות כיוון אחר בלי להרוס".
  • לחזור אחורה: /rewind - גם הקוד וגם השיחה חוזרים לנקודת שמירה.
  • לפנות שולחן: /clear (הישן נשמר), /compact (מסכם).
  • שאלת צד: /btw או Cmd+; - שאלה שמשתמשת בקונטקסט של הסשן אבל לא נכנסת אליו.

איך סשנים מדברים אחד עם השני (כדי לא להסביר הכל מההתחלה)

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

  1. קובץ משותף. הכי פשוט, הכי אמין. סשן א' כותב HANDOFF.md ("מה עשיתי, מה נשאר, איפה הקבצים"), סשן ב' קורא. אצלי: KICKOFF*.md בכל פרויקט + TASKS.md + AGENT_LOG.md (שורה לכל פעולה, כדי שהסשן הבא - וגם קודקס - יידע מה קרה).
  2. CLAUDE.md + זיכרון. דברים קבועים ← CLAUDE.md. דברים שקלוד למד ← הזיכרון האוטומטי. שני סשנים מאותה תיקייה חולקים את שניהם.
  3. סשנים מדברים ישירות (אפליקציית הדסקטופ). אפשר לבקש בשפה חופשית: "איזה סשן נגע בהצעת המחיר?", "מה סיכם הסשן של האתר?", "תגיד לסשן של האנליטיקס שהסכמה השתנתה". קלוד רואה את 20 הסשנים האחרונים באפליקציה, קורא מה עשו, ושולח הודעה (שמופיעה שם ככרטיס עם קישור חזרה). לפני שהוא מארכב סשן - שואל אתכם. גם בטרמינל אפשר @ על שם סשן (2.1.232+).
  4. סאב-אייג'נטים ו-workflows. בתוך סשן אחד, קלוד שולח עוזרים לחדרים אחרים ומקבל תוצאות. (פרק 4)

מה שאני עושה בפועל: סשן Hub אחד ב-Downloads (ניהול, יומן, משימות קטנות). סשן נפרד לכל פרויקט עמוק, שנפתח מתיקיית הפרויקט כדי שה-KICKOFF ייטען. וכל סשן משמעותי מסתיים בשורה ב-AGENT_LOG.md. ככה גם קלוד וגם קודקס וגם אני-של-מחר יודעים מה קרה.

1.7 שני התווים שצריך להכיר: `/` ו-`@`

/ = מגירת הכלים. מקלידים לוכסן בתחילת השורה ורואים מה אפשר להפעיל: פקודות מובנות (/init, /clear, /model, /compact, /context, /resume, /plan, /loop, /schedule), סקילים שלכם (/ey-ai-proposal), סקילים מפלאגינים (/telegram:configure). "המטרה אינה לזכור פקודות אלא להרגיש איפה הן נמצאות."

@ = על מה בדיוק. במקום "המסמך ההוא", מקלידים @ ובוחרים קובץ או תיקייה. @MEETING_SUMMARY.md מכניס את הקובץ לשולחן. @תיקייה/ מראה מה יש בה. @ על שם סאב-אייג'נט מפעיל אותו. @ על שם סשן אחר. גם גרירה של קובץ לחלון, או הדבקת צילום מסך (Cmd+V) עובדים.

האם @ נותן הרשאה חדשה? לא. הוא רק מפנה לקובץ שכבר בתחום הגישה של הסשן.

רשימת הפקודות שבאמת משתמשים בהן ביומיום

פקודהלמה
/initלייצר CLAUDE.md לתיקייה חדשה
/planלעבור למצב תכנון
/modelלהחליף מודל
/effortרמת מאמץ (low/medium/high/xhigh/max)
/clear /compact /contextניהול השולחן
/resume /rename /branch /rewindניהול סשנים
/memoryלפתוח את קבצי הזיכרון וה-CLAUDE.md
/usageכמה נשאר מהמכסה
/mcp /plugin /skills /agentsניהול תוספים
/loop /scheduleלולאות ותזמונים
/code-review /security-review /simplifyביקורת על שינויים
/exportלשמור את השיחה לקובץ טקסט
/doctorכשמשהו לא עובד
/btwשאלת צד

1.8 מה זה נותן לי? (הסיכום שלי לפרק)

  • אתם לא לומדים "כלי למתכנתים". אתם לומדים לתת ל-AI תיקייה, כללים וכלים, ולקבל תוצרים במקום תשובות.
  • ששת החלקים (מטרה, הקשר, תכנית, כלים, הרשאות, תוצר) הם רשימת הבדיקה כשמשהו לא עובד.
  • Plan קודם. Manual בהתחלה. הרשאה = החלטה.
  • הצ'אט זמני. הקבצים זוכרים.
  • / מה להפעיל, @ על מה.

כל הפרקים

  1. היסודות: מה זה Claude Code, ולמה זה לא רק למתכנתיםמה זה Claude Code, Chatbot מול Agent, ששת החלקים של סוכן, מפת המוצרים (Chat/Cowork/Code/Codex), הסשן הראשון, מצבי הרשאה, מה זה סשן ואיך סשנים מדברים, / ו-@8 דקות קריאה
  2. זיכרון, קונטקסט ומגבלות שימושחלון הקונטקסט (השולחן), מגבלות שימוש וטריקים, CLAUDE.md, הזיכרון האוטומטי - זיכרון אחד או לכל פרויקט10 דקות קריאה
  3. סקילים: המתכונים במגירהמה זה סקיל, SKILL.md אמיתי, הסקילים שלי, הרשמיים של אנתרופיק, מהקהילה, איך מורידים בבטחה, איך בונים8 דקות קריאה
  4. סוכנים, סאב-אייג'נטים, פלאגינים והוקיםסאב-אייג'נטים, workflows, worktrees, פלאגינים ו-marketplaces, הוקים, הרשאות מפורטות6 דקות קריאה
  5. חיבורים: MCP, קונקטורים, API, ארטיפקטים ותוסף הכרוםMCP, קונקטורים, API ו-Agent SDK, ארטיפקטים, Claude in Chrome6 דקות קריאה
  6. קלוד וקודקס ביחד על אותו פרויקט (Handoff)קודקס 2026, CLAUDE.md מול AGENTS.md, סקילים וזיכרון משותפים, Handoff, AGENT_LOG, git כחוזה6 דקות קריאה
  7. מוח שני: קבצי md, תיקיות, Obsidian, ומקומי מול דרייבמה זה md ואיך פותחים, מוח שני (איפה/איך/למה), Obsidian, שלד תיקייה לכל פרויקט, מקומי מול דרייב8 דקות קריאה
  8. קלוד בענן, בטלפון ובטלגרםCloud sessions, Remote Control, Dispatch, טלגרם (התקנה צעד-צעד), Channels, Routines7 דקות קריאה
  9. טיפים וטריקים עדכניים (יולי-אוגוסט 2026)40 טיפים עדכניים + מה הקהילה מדברת עליו. מסומן בתאריכים כי זה מתיישן5 דקות קריאה
  10. שימושים: יומיומיים ומתקדמים (מתכונים)20 מתכונים (10 יומיומיים, 10 מתקדמים), בדיקת הצלחה, תוכנית לשבוע הראשון5 דקות קריאה

להורדת הפרק הזה (Markdown)המדריך המלא להורדה

יש לכם שאלה על משהו כאן, או שאתם רוצים ללמוד לעשות את זה בעצמכם?

לכל המדריכים