לוגו ״הסייבורג״: ראש שחציו אנושי וחציו רובוטיהסייבורג

פרק 1 מתוך 12

המדריך להקמת סביבת העבודה

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

לפני שמתחילים, דבר אחד חשוב. קלוד קוד דורש מנוי בתשלום של Claude (תוכנית Pro או Max), חשבון חינמי לא כולל אותו. אם עוד אין מנוי כזה, זה הצעד הראשון: נכנסים ל-claude.ai ומשדרגים לתוכנית בתשלום.

התקנת Git

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

ב-Mac

Git מגיע יחד עם חבילת כלים של אפל. פותחים את התוכנה Terminal, חלון פשוט שבו מקלידים פקודות למחשב במקום ללחוץ על כפתורים. מוצאים אותה דרך החיפוש של ה-Mac (סמל הזכוכית המגדלת בפינה העליונה של המסך, או Cmd+רווח). מעתיקים את השורה הבאה ומדביקים אותה בחלון:

xcode-select --install

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

ב-Windows

נכנסים לכתובת git-scm.com/download/win, מורידים את הגרסה שמוצעת, ומריצים את הקובץ שהתקבל. אפשר ללחוץ Next על כל המסכים, ברירות המחדל מתאימות.

לבדיקה שההתקנה הצליחה, מקלידים בחלון הפקודות (Terminal ב-Mac, PowerShell ב-Windows) את השורה:

git --version

אם הכול תקין, יופיע מספר גרסה.

התקנת Node.js

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

בשתי המערכות מורידים את אותו דבר: נכנסים ל-nodejs.org ובוחרים את גרסת ה-LTS, שהיא הגרסה היציבה והמומלצת. פותחים את הקובץ שהתקבל ועוברים על שלבי ההתקנה הרגילים.

ב-Windows, שימו לב לתיבה אחת בדרך: חשוב שהתיבה Add to PATH תישאר מסומנת. היא מה שמאפשר להפעיל את הכלי מכל מקום במחשב. ברירת המחדל כבר מסמנת אותה, רק לא להוריד את הסימון.

לבדיקה שההתקנה הצליחה, מקלידים בחלון הפקודות:

node --version

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

npm --version

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

התקנת VS Code

VS Code הוא חלון העבודה שבתוכו קלוד קוד יחיה. הוא חינמי לגמרי. נכנסים ל-code.visualstudio.com, והכפתור הגדול באמצע כבר מזהה לבד את סוג המחשב שלך ומציע את הקובץ הנכון.

ב-Mac

  1. לוחצים על כפתור ההורדה. מתקבל קובץ מכווץ בתיקיית ההורדות.
  2. לוחצים עליו פעמיים, ומתקבלת תוכנה בשם Visual Studio Code.
  3. גוררים אותה לתיקייה Applications, תיקיית התוכנות של ה-Mac. זה חשוב: תוכנה שנשארת בתיקיית ההורדות מתנהגת בצורה לא צפויה.
  4. פותחים אותה. בפתיחה הראשונה ה-Mac שואל אם להריץ תוכנה שהורדה מהאינטרנט, מאשרים.

ב-Windows

  1. לוחצים על כפתור ההורדה ומריצים את הקובץ שהתקבל.
  2. אם מופיעה תיבה בשם Add to PATH, משאירים אותה מסומנת, ולוחצים Next על שאר המסכים.
  3. בסיום פותחים את VS Code מתפריט התחל.

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

התקנת התוסף Claude Code, והתחברות

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

  1. פותחים את VS Code ולוחצים על סמל התוספים בסרגל הצדדי. אפשר גם עם Cmd+Shift+X ב-Mac, או Ctrl+Shift+X ב-Windows.
  2. בשורת החיפוש מקלידים Claude Code. בוחרים את התוסף שהמפרסם שלו הוא Anthropic, ולוחצים Install.
  3. אחרי ההתקנה מופיע סמל של קלוד בסרגל הצדדי. לוחצים עליו, ונפתח חלון שיחה.

האישורים שיקפצו בדרך

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

  • VS Code שואל אם אתה סומך על התיקייה ("Do you trust the authors of the files in this folder?"). בוחרים Yes, I trust the authors. בלי זה קלוד קוד לא יוכל לקרוא ולכתוב קבצים בתיקייה.
  • נפתח הדפדפן לצורך התחברות. מתחברים עם חשבון ה-Claude שיש לו מנוי בתשלום, ומאשרים את הבקשה שמופיעה בעמוד.
  • הדפדפן שואל אם לחזור ל-VS Code ("Open Visual Studio Code?"). מאשרים, והחלון חוזר לעצמו.
  • ב-Mac תקפוץ בקשת הרשאה לתיקיות (מסמכים, שולחן עבודה). מאשרים, אחרת קלוד קוד לא יראה את הקבצים שלך.

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

להתחברות מחדש בעתיד אפשר תמיד להקליד /login בתוך חלון השיחה.

הגדרת מצב ההרשאות

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

א. לפתוח את מסך ההגדרות

  1. פותחים את ההגדרות של VS Code: Cmd+, ב-Mac, או Ctrl+, ב-Windows.
  2. בשורת החיפוש שלמעלה מקלידים claude code, וכל הגדרות התוסף מופיעות יחד.

ב. לסמן את Allow Dangerously Skip Permissions

מחפשים את השורה Claude Code: Allow Dangerously Skip Permissions ומסמנים את התיבה שלה. זו הגדרת מפתח שפותחת את האפשרות הבאה: בלעדיה, מצב ההרשאות החופשי לא זמין לבחירה בכלל.

ג. למצוא את Initial Permission Mode ולשנות אותו

באותו מסך מחפשים את השורה Claude Code: Initial Permission Mode. זו תיבת בחירה שקובעת באיזה מצב כל שיחה חדשה נפתחת, וכברירת מחדל היא עומדת על Default, כלומר לשאול אישור על כל דבר. פותחים את התיבה ובוחרים bypassPermissions.

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

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

רוצים דרך אמצע? acceptEdits באותה תיבת בחירה מאשר לקלוד לערוך קבצים בלי לשאול, אבל עדיין עוצר ושואל לפני שהוא מריץ פקודה במחשב. זה מוריד את רוב הלחיצות ומשאיר את הבלם במקום שבו הוא באמת חשוב.

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

התקנת כל הסקילים של הסייבורג

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

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

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

## איך לעבוד
זהה קודם את מערכת ההפעלה שלי, והשתמש בפקודות שמתאימות לה.
ב-Mac המעטפת היא zsh, וב-Windows PowerShell.
לבדיקה אם כלי קיים, הראשונה ל-Mac והשנייה ל-Windows:
command -v <tool>
Get-Command <tool> -ErrorAction SilentlyContinue
נתיב שיש בו רווח או עברית תמיד בתוך מירכאות כפולות.
אל תתקין שום דבר שלא מופיע ברשימה למטה.

## 1. הכלים שצריכים להיות
שלושה כלים: git, node בגרסה 18 ומעלה, ו-npm.
בדוק אותם עם:
git --version
node --version
npm --version

אם git חסר:
ב-Mac, הרץ את הפקודה הבאה. היא פותחת חלון התקנה של אפל, ואז אמור לי לאשר אותו
ולחזור אליך כשהוא מסתיים. אל תמשיך לפני שאישרתי.
xcode-select --install
ב-Windows, אל תתקין לבד. אמור לי להוריד את Git מהכתובת git-scm.com/download/win,
להריץ את ההתקנה, ואז לחזור אליך.

אם node או npm חסרים, אמור לי להוריד את גרסת ה-LTS מ-nodejs.org. אל תתקין לבד.

## 2. הסקילים של הסייבורג
הם יושבים במאגר הציבורי github.com/elad-the-cyborg/cyborg-skills,
כל סקיל בתוך תיקיית קטגוריה, בנתיב מהצורה skills/<category>/<name>/

קודם בדוק מה כבר מותקן אצלי בתיקייה ~/.claude/skills/
כדי להתקין את מה שחסר:
1. שכפל את המאגר לתיקייה זמנית:
git clone --depth 1 https://github.com/elad-the-cyborg/cyborg-skills.git <temp-dir>
2. העתק כל תיקיית סקיל אל ~/.claude/skills/<name>/
שים לב: שם היעד הוא שם הסקיל בלבד, בלי תיקיית הקטגוריה מעליו.
3. אל תדרוס סקיל קיים בלי לשאול אותי קודם.
4. מחק את התיקייה הזמנית בסיום.
ודא שבכל סקיל שהותקן יש קובץ SKILL.md, ודווח לי כמה סקילים מותקנים בסך הכול.

## 3. התוספים בעורך
עבור על כל עורך שקיים אצלי מבין code ו-cursor.
לכל אחד שקיים הרץ את הפקודה הבאה, והחלף את editor בשם העורך:
editor --list-extensions
ודא ששני המזהים האלה מופיעים ברשימה:
anthropic.claude-code
yechielby.claude-code-rtl
מה שחסר, התקן עם:
editor --install-extension <extension-id>
אם פקודת code לא זמינה בטרמינל, אל תנסה לעקוף. אמור לי להתקין את החסר ידנית
מחלונית התוספים לפי המזהה, או להוסיף קודם את הפקודה לנתיב.

## מה להחזיר לי
רשימה מסודרת עם ✓ לכל דבר תקין ו-✗ לכל דבר חסר.
לכל דבר שהיה חסר: אם השלמת אותו, או מה בדיוק עליי לעשות, עם פקודה מדויקת
למערכת ההפעלה שלי.
אם הכול תקין, סיים במשפט: הסביבה מוכנה, אפשר להתחיל לעבוד.
אל תזכיר מפתחות API או טוקנים בשום שלב, הם לא חלק מהבדיקה הזו.

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

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

עברית מימין לשמאל: תוסף ה-RTL

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

השם המדויק שלו, שאפשר להעתיק לחיפוש, הוא yechielby.claude-code-rtl. יש שתי דרכים להתקין אותו, ואפשר לבחור את הנוחה יותר.

הדרך הראשונה: שורת פקודה

פותחים חלון פקודות (Terminal ב-Mac, PowerShell ב-Windows, או החלון המובנה בתוך VS Code עם Cmd+` או Ctrl+`) ומריצים:

code --install-extension yechielby.claude-code-rtl

ב-Mac הפקודה הזו לרוב לא תעבוד בהתחלה, ותתקבל הודעה שהפקודה לא נמצאה. זה תקין ויש לזה תיקון חד פעמי: בתוך VS Code לוחצים Cmd+Shift+P, מקלידים Shell Command: Install 'code' command in PATH ובוחרים בשורה שמופיעה. אחר כך פותחים חלון פקודות חדש ומריצים את השורה שוב.

ב-Windows הפקודה הזו עובדת לבד אם התיבה Add to PATH הייתה מסומנת בזמן התקנת VS Code. אם מתקבלת הודעה שהפקודה לא נמצאה, סוגרים ופותחים מחדש את PowerShell, וזה בדרך כלל פותר.

הדרך השנייה: מתוך VS Code

  1. פותחים את חלונית התוספים (Cmd+Shift+X או Ctrl+Shift+X).
  2. מדביקים בשורת החיפוש את השם yechielby.claude-code-rtl, ולוחצים Install.
  3. טוענים מחדש את חלון VS Code: Cmd+Shift+P ואז Reload Window. העברית מסתדרת.

העברית התהפכה שוב פתאום? זה קורה אחרי עדכון של תוסף קלוד קוד, שמוחק את התיקון. טוענים מחדש את חלון VS Code (Reload Window) והתוסף מחזיר אותו לבד.

הצעד האחרון: לספר לקלוד מי אתה

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

הסקיל brand-voice-setup, שכבר הותקן בצעד 6, בונה את הקובץ הזה בשיחה קצרה של כמה שאלות. מקלידים בחלון השיחה:

/brand-voice-setup

שתי פקודות שימושיות בהמשך: /memory מציגה ועורכת את ה-CLAUDE.md שלך, ו-/context מראה מה קלוד טען לשיחה הנוכחית. אם משהו לא נטען, כדאי לוודא שהקובץ יושב בתיקיית העבודה עצמה ולא בתוך תת תיקייה.

רשות: קלוד קוד גם בחלון פקודות

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

ב-Mac

curl -fsSL https://claude.ai/install.sh | bash

ב-Windows

irm https://claude.ai/install.ps1 | iex

לבדיקה, מקלידים:

claude --version

קלוד קוד כבר רץ בחלון הפקודות ו-VS Code פתוח בצד? הפקודה /ide מחברת ביניהם.

נתקעים? פתרונות מהירים

פקודה כלשהי מחזירה הודעה שהיא לא נמצאה

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

הפקודה code לא נמצאת

ב-Mac צריך להוסיף אותה פעם אחת: בתוך VS Code לוחצים Cmd+Shift+P, מקלידים Shell Command: Install 'code' command in PATH ובוחרים בשורה. ב-Windows זה בדרך כלל סימן שהתיבה Add to PATH לא סומנה בהתקנה, ואפשר פשוט להתקין את התוספים מתוך חלונית התוספים לפי השם שלהם.

אין אפשרות לבחור bypassPermissions בתיבת הבחירה

זה סימן שהתיבה Allow Dangerously Skip Permissions עוד לא מסומנת, והיא התנאי לאפשרות הזו. חוזרים להגדרות, מסמנים אותה, ואז פותחים שוב את Initial Permission Mode.

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

צריך את תוסף ה-RTL מצעד 7. אם הוא כבר מותקן והבעיה חזרה, כנראה התעדכן תוסף קלוד קוד ומחק את התיקון. טוענים מחדש את חלון VS Code (Reload Window) והתוסף מחזיר את עצמו.

הסקילים לא מופיעים כשמקלידים לוכסן

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

לא מצליח להתחבר לחשבון

כדאי לוודא שיש מנוי בתשלום של Claude, חשבון חינמי לא מספיק, ולנסות שוב עם /login בתוך חלון השיחה.

עכשיו אפשר להתחיל

הסביבה עומדת, קלוד קוד מחובר, והסקילים במקום. הצעד הבא הוא לבחור סקיל ולהוציא ממנו תוצר אמיתי לעסק, בעברית, תוך דקות.

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

לספריית הסקילים, לבחור סקיל ראשון