קלוד קוד בעברית · המדריך המעשי לעסקים.

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

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

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

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

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

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

בהקלטה הותקנו Git, Node.js ו-Claude Desktop. לכל אחד תפקיד אחר: Git מנהל גרסאות מקומיות, Node.js מריץ פרויקטים וכלים שנבנו עבורו, ו-Desktop הוא ממשק העבודה שלכם. GitHub, שנפגוש בהמשך, הוא שירות נפרד לאחסון ושיתוף מאגרי קוד.

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

חשוב להפריד בין הכנת סביבת הסדנה לבין דרישת האפליקציה: Desktop כולל את Claude Code, ואין צורך בהתקנת CLI או Node.js נפרדת רק כדי לפתוח אותו. Node.js נדרש כשפרויקט או כלי מסוים משתמשים בו. ב-Windows בדקו גם את דרישת Git לעבודה מקומית בלשונית Code.

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

Manual מבקש אישורים לפעולות; Accept edits מאפשר עריכות קבצים בלי אישור לכל עריכה; Auto, כשזמין, בוחן פעולות אוטומטית. Bypass permissions מדלג על בדיקות הרשאה, ולכן אינו נדרש לתרגילי ההתחלה. זמינות המצבים תלויה בגרסה ובהגדרות החשבון.

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

במפגש 2 מחברים את Claude לשירותים כגון Gmail, Google Calendar ו-Google Drive. קונקטור נותן לסוכן יכולת לעבוד עם שירות חיצוני; MCP הוא תקן שבאמצעותו כלים יכולים להיחשף לסוכן. החיבור וההרשאות קובעים אילו פעולות זמינות.

נכנסים ל-Customize, בוחרים Connectors ומחפשים את השירות. בוחרים Connect, מתחברים לחשבון השירות הרצוי וקוראים את ההרשאות. למיון פניות התחלתי מספיק מידע לקריאה; אין צורך לתת הרשאת שליחה כדי לקבל המלצה על תשובה.

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

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

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

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

במפגש 3 מתחילים מהשאלה מה הסוכן צריך לדעת עליכם. CLAUDE.md הוא קובץ הוראות שקלוד יכול לטעון בעבודה על הפרויקט: מי העסק, מה המטרה, איך כותבים ומה חייבים לבדוק. הוראות כלליות יכולות לחול על כמה פרויקטים; הוראות בתיקיית לקוח צריכות להתייחס לאותו לקוח.

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

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

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

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

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

מנוי Claude שבו בונים את הסוכן אינו מכסה בהכרח את שימוש ה-API של הסוכן. גם ספק המודל, WhatsApp, חיבורי כלים ואירוח יכולים להיות מחויבים בנפרד. בדקו מחיר ומגבלות בכל חשבון; אין במדריך הבטחה למספר חינמי או למכסת הודעות קבועה.

קובץ .env הוא קובץ הגדרות, לא כספת מוצפנת. שומרים בו סודות בצד השרת, מגבילים גישה ומחריגים אותו מ-Git. אם קובץ כבר נכנס למאגר, הוספת .gitignore אינה מוחקת אותו מההיסטוריה. מפתח שנחשף מחליפים אצל הספק. בפרסום מגדירים את הסודות גם בסביבת האירוח.

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

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

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

לתרגול פתחו תיקייה נפרדת בשם flower-site. הוסיפו brief.md, לוגו ותמונות שמותר לכם להשתמש בהן. למדו מהדוגמה, אבל הזינו את פרטי העסק שלכם. אם אין עדיין פרטי עסק אמיתיים, סמנו את הפרויקט כדוגמה ואל תפרסמו אותו כעסק פעיל.

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

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

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

בסדנה הודגמו ספריות רכיבים כגון 21st.dev, Magic UI, React Bits ו-shadcn/ui. רכיב הוא חלק מהאתר: כרטיס מוצר, גלריה, לוח שנה או כפתור. בוחרים חלק מתאים, מצרפים את הוראות השימוש או הקוד ומסבירים לקלוד איפה לשלב אותו.

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

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

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

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

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

בסוף מפגש 4 הוזכר מפגש המשך על WordPress ודומיין. המדריך הנוכחי מבוסס על ארבע ההקלטות של דור ב׳; ההכרזה על ההמשך אינה מוצגת כאן כהדרכה שכבר נכללה בהן.

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

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

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