⌨️ פרק 3

הפעלת קלוד קוד והכנת סביבת העבודה

הודעת ההתקנה האוטומטית מיועדת להרצה מתוך כלי סוכן בעל גישה למערכת הקבצים ולטרמינל. קלוד קוד (Claude Code) מנהל את כל שלבי ההקמה: יצירת הקבצים, בניית קונטיינר ה-Docker, הגדרת שרת ה-FastMCP וחיבור כלי ה-MCP.

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

#שלב 1: פתיחת מסוף הפקודות (Terminal)

לפי מערכת ההפעלה שלכם:

• macOS: לחצו על Cmd + Space לפתיחת ה-Spotlight, הקלידו Terminal או iTerm ולחצו על Enter.
• Windows: לחצו על מקש Windows, הקלידו PowerShell או Windows Terminal, ולחצו על Enter.
• Linux: לחצו על קיצור המקלדת Ctrl + Alt + T או פתחו את יישום ה-Terminal מתפריט היישומים.

בחלון שייפתח יופיע סמן מהבהב המוכן לקבלת פקודות.

#שלב 2: יצירת תיקיית עבודה ייעודית

מומלץ מאוד לרכז את כל קובצי המערכת (קובץ ה-Docker Compose, מסד הנתונים של ה-Session, ושרת ה-FastMCP) בתוך תיקייה נפרדת ומסודרת, ולא ישירות בתיקיית הבית או ההורדות.

העתיקו והריצו את הפקודה המתאימה למערכת שלכם:

ב-macOS וב-Linux:

mkdir -p ~/gowa-ai
cd ~/gowa-ai

ב-Windows (PowerShell):

New-Item -ItemType Directory -Force -Path "$HOME\gowa-ai"
Set-Location "$HOME\gowa-ai"

פעולה זו מייצרת תיקייה בשם gowa-ai ומעבירה את המסוף לתוכה.

#שלב 3: הפעלת קלוד קוד

מתוך תיקיית הפרויקט, הפעילו את פקודת הסוכן:

claude

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

אם קלוד שואל האם אתם נותנים אמון בתיקייה הנוכחית (Trust this folder), אשרו את הבקשה. כיוון שזוהי תיקייה חדשה וייעודית שיצרתם עבור הפרויקט, בטוח לאשר אותה.

╭──────────────────────────────────────────────────╮
│ Claude Code                                      │
│ Connected to /Users/username/gowa-ai             │
╰──────────────────────────────────────────────────╯

> _

#שלב 4: הדבקת הפרומפט המלא

בתחתית חלון קלוד קוד מופיעה שורת הקלט (המסומנת ב->).

1. היכנסו לפרק הבא במדריך והעתיקו את בלוק הטקסט המלא מתוך תיבת הקוד (החל מהשורה הראשונה ועד השורה האחרונה).
2. חזרו לחלון הטרמינל והדביקו את הטקסט (Cmd + V ב-macOS או Ctrl + V ב-Windows/Linux).
3. לחצו על Enter לשליחת ההודעה לקלוד.

[!TIP] במידה והטרמינל מציג חלון אישור על הדבקת טקסט מרובה שורות (Multi-line Paste), אשרו את ההדבקה (Paste anyway / Confirm).

#שלב 5: אישור פקודות בצורה מושכלת

במהלך ביצוע ההתקנה, קלוד יציג בפניכם פקודות מערכת הדורשות אישור להרצה (פקודות docker, יצירת סביבת פייתון וירטואלית python -m venv, והתקנת ספריות באמצעות pip).

• מה מאשרים: פקודות הקשורות ישירות להתקנה בתיקיית gowa-ai, הרצת קונטיינר ה-Docker, יצירת קובצי קונפיגורציה ובדיקות curl מקומיות.
• מה לא מאשרים: פקודות למחיקת ספריות מחוץ לתיקיית הפרויקט, ניסיונות לחשוף פורטים לכתובת חיצונית (0.0.0.0), או שליחת הודעות וואטסאפ ללא הצגת טקסט ונמען ברורים.

#מה עושים אם התהליך מופסק באמצע

אם חלון הטרמינל נסגר או שאתם נאלצים לעצור את העבודה:

1. פתחו שוב את הטרמינל ועברו לתיקייה: cd ~/gowa-ai
2. הפעילו את קלוד: claude
3. כתבו לסוכן: "אנחנו באמצע התקנת GOWA ושרת ה-MCP. תבדוק מה קיים ואיפה עצרנו, ותמשיך משם."

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

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