מדריך מתחילים ל-Claude Code: בנו סוכן AI תוך שעה

עד לפני כמה שנים, בניית סוכן AI שפועל באופן עצמאי — קורא קבצים, מריץ קוד, מקבל החלטות — דרשה ידע מעמיק בפיתוח תוכנה, הבנה של APIs מורכבים, ושבועות של עבודה. היום, עם Claude Code של Anthropic, אפשר לעשות את זה תוך שעה — גם עם ניסיון טכני מוגבל.

המדריך הזה יקח אתכם מ“מה זה בכלל Claude Code?” ועד סוכן AI עובד ראשון שמבצע משימות אמיתיות. כל שלב מוסבר, שום דבר לא מדלג.

מה זה Claude Code ולמה הוא שונה מ-ChatGPT?

ChatGPT ומוצרים דומים הם ממשקי צ'אט: שואלים, מקבלים תשובה, שואלים שוב. Claude Code הוא שונה מהותית. זהו CLI — Command Line Interface — שמאפשר ל-Claude לפעול ישירות בסביבת המחשב שלכם.

מה זה אומר בפועל? Claude Code יכול:

• לקרוא ולכתוב קבצים ישירות על הדיסק שלכם
• להריץ פקודות טרמינל ולראות את הפלט שלהן
• לכתוב קוד, לבדוק שהוא עובד, ולתקן שגיאות — בלולאה אוטונומית
• לבצע פעולות מורכבות עם כלים חיצוניים (APIs, דאטאבייסים, ממשקי אינטרנט)

ההבדל המעשי: אם תבקשו מ-ChatGPT לבנות לכם אתר, הוא יתן לכם קוד שתצטרכו להעתיק ולהדביק בעצמכם. Claude Code יכתוב את הקבצים, יריץ שרת, ויאמר לכם “האתר רץ בפורט 3000.”

דרישות מוקדמות

לפני שמתחילים, בדקו שיש לכם:

• Python 3.8 ומעלה מותקן על המחשב (כדאי לבדוק עם python --version בטרמינל)
• חשבון Anthropic — נדרש מפתח API. ניתן להירשם בחינם ב-console.anthropic.com
• Node.js 18 ומעלה — Claude Code מותקן דרך npm

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

התקנה: 5 דקות מהתחלה לסיום

פתחו טרמינל (Terminal ב-Mac/Linux, PowerShell ב-Windows) והקלידו:

npm install -g @anthropic-ai/claude-code

לאחר ההתקנה, הגדירו את מפתח ה-API שלכם. הדרך הקלה ביותר היא דרך משתנה סביבה:

export ANTHROPIC_API_KEY="your-api-key-here"

ב-Windows PowerShell:

$env:ANTHROPIC_API_KEY = "your-api-key-here"

עכשיו אפשר לבדוק שהכל עובד:

claude --version

אם מופיעה גרסה — אתם מוכנים.

הפגישה הראשונה עם Claude Code

ניווטו לתיקייה שאתם רוצים לעבוד בה:

mkdir my-first-agent
cd my-first-agent
claude

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

> צור קובץ hello.py שמדפיס שלום עולם, ואחר כך הרץ אותו

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

פקודות בסיסיות שחשוב להכיר

Claude Code פועל בשני מצבים עיקריים:

מצב אינטראקטיבי

הפעלה רגילה עם claude פותחת שיחה מתמשכת שבה Claude זוכר את ההקשר. מתאים לעבודה על פרויקט לאורך זמן.

מצב פקודה אחת (Single-shot)

להרצת משימה בודדת מבלי להיכנס לשיחה:

claude -p "צור סקריפט Python שמוריד נתוני מזג אוויר עבור תל אביב"

זה שימושי לאוטומציה — אפשר להכניס פקודות כאלה לסקריפטים ולתהליכי CI/CD.

מצב אוטונומי

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

claude --dangerously-skip-permissions

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

פרויקט ראשון: סוכן שמסכם קבצי טקסט

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

שלב 1: הכינו קבצי טקסט לדוגמה

claude -p "צור 3 קבצי טקסט בתיקייה הנוכחית: article1.txt, article2.txt, article3.txt. כל קובץ יכיל טקסט של כ-200 מילים על נושא שונה: טכנולוגיה, ספורט, ואוכל."

שלב 2: כתבו את הסוכן

claude -p "כתוב סקריפט Python בשם summarizer.py שעושה את הדברים הבאים:
1. מוצא את כל קבצי .txt בתיקייה הנוכחית
2. לכל קובץ, שולח את תוכנו ל-Anthropic API ומבקש סיכום של 3 משפטים
3. שומר את הסיכומים לקובץ summaries.txt
4. מדפיס הודעת הצלחה בסיום
השתמש בספרייה anthropic ל-Python. מפתח ה-API יגיע ממשתנה סביבה ANTHROPIC_API_KEY"

שלב 3: הרצה

python summarizer.py

אם יש שגיאות, פשוט חזרו ל-Claude Code:

claude -p "קיבלתי את השגיאה הבאה בהרצת summarizer.py: [הדביקו את השגיאה]. תקן אותה."

Claude יקרא את הקוד, יבין את השגיאה, ויתקן אותה.

הרחבה: סוכן עם לולאה עצמאית

הסוכן שבנינו עד עכשיו הוא “חד-כיווני” — הוא רץ ומסיים. סוכנים אמיתיים לרוב פועלים בלולאה: מנתחים מצב, מחליטים על פעולה, מבצעים, ומנתחים שוב. נבנה גרסה כזו.

claude
> בנה לי סוכן Python שפועל בלולאה כל 60 שניות. בכל איטרציה, הסוכן:
1. קורא קובץ tasks.txt (אם קיים)
2. בוחר את המשימה הראשונה שלא הושלמה
3. "מבצע" אותה (בשלב זה רק מדפיס שהשלים)
4. מסמן אותה כהשלמה ב-tasks.txt
5. מדפיס סיכום מה עשה
אם אין משימות, ממתין ומנסה שוב בסיבוב הבא.

לאחר שהקוד נכתב, צרו קובץ tasks.txt:

[ ] שלח אימייל לצוות
[ ] עדכן את ה-README
[ ] הרץ בדיקות
[ ] עדכן גרסה לפרודקשן

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

CLAUDE.md: איך לתת לסוכן הנחיות קבועות

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

צרו קובץ CLAUDE.md בתיקיית הפרויקט:

# הנחיות לסוכן

## שפה
תמיד כתוב קוד עם הערות בעברית. הפלט למשתמש תמיד בעברית.

## סגנון קוד
- השתמש ב-type hints ב-Python
- כל פונקציה חייבת docstring
- שגיאות תמיד ב-try/except עם לוג ברור

## מגבלות
- לעולם אל תמחק קבצים ישנים מבלי לגבות אותם קודם
- לפני כל שינוי בבסיס נתונים, הצג תחילה מה השינוי הצפוי

## סביבה
- מפתחות API נמצאים ב-.env ולעולם לא נכתבים ישירות בקוד
- Deploy תמיד דרך Git ולא בהעלאה ישירה של קבצים

עכשיו בכל פעם שתפתחו Claude Code בתיקייה הזו, הוא יפעל לפי ההנחיות האלה אוטומטית. זה שקול לשימוש ב-system prompt בממשקי צ'אט, רק הרבה יותר שימושי כי הוא שמור בפרויקט עצמו.

חיבור לכלים חיצוניים: MCP

Claude Code תומך ב-MCP (Model Context Protocol) — פרוטוקול שמאפשר לחבר את הסוכן לכלים חיצוניים. מה שזה אומר בפועל: אפשר לתת לסוכן גישה לדאטאבייס, לממשקי API חיצוניים, לקבצי Google Drive, ועוד — ולגרום לו לעבוד עם כולם בשפה טבעית.

דוגמה קלה: חיבור ל-SQLite דרך MCP server מובנה:

claude mcp add sqlite /path/to/database.db

לאחר החיבור, אפשר לשאול:

> כמה משתמשים נרשמו החודש לפי הדאטאבייס?

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

טיפים לשימוש יעיל

היו ספציפיים ב“מה”, גמישים ב“איך”

תארו בבהירות מה התוצאה שאתם רוצים, אבל תנו לסוכן חופש לבחור איך להגיע לשם. “צור API שמחזיר נתוני מזג אוויר” עדיף על “כתוב Flask endpoint שמשתמש ב-requests library לשליחת GET request ל-OpenWeatherMap.”

עבדו בגדלים קטנים

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

השתמשו ב-Git ובגיבויים

לפני שמתחילים עבודה עם Claude Code על פרויקט קיים, ודאו שכל הקבצים ב-Git. כך אם משהו משתבש — git diff יראה מה השתנה ו-git restore יחזיר הכל.

בקשו הסברים

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

מה לא לעשות: אזהרות חשובות

אל תעבדו על קבצי מערכת קריטיים: Claude Code יכול לבצע שינויים אמיתיים בקבצים. הרצה בתיקיית הבית שלכם (~/) או בתיקיות מערכת עלולה לגרום לנזק.

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

בדקו מה הסוכן עשה: לאחר כל משימה, עיינו בקצרה בשינויים שנעשו. git diff הוא חברכם הכי טוב כאן.

אל תאמינו לשגיאות “עדינות”: לפעמים קוד שנכתב ע“י AI ירוץ ללא שגיאה אבל לא יעשה מה שציפיתם. תמיד בדקו שהפלט הוא מה שרציתם.

סיכום: מה בניתם בשעה אחת

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

• Claude Code מותקן ומוגדר
• סוכן שמסכם קבצים אוטומטית
• סוכן שפועל בלולאה ומנהל משימות
• הבנה של CLAUDE.md והגדרת הנחיות קבועות
• בסיס לחיבור כלים חיצוניים דרך MCP

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

ב-Claude Code, הגבול הוא לא הטכנולוגיה — הוא הדמיון שלכם.