מדריך עומק · חלק מקלוד קוד לאדריכלים · כל המדריכים

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

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

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

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

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

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

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

למי המדריך הזה

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


1. מה זה בעצם להתקין את קלוד קוד

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

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

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

2. חמשת הכלים ומה כל אחד עושה

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

הכלימה זה, בשפה של בני אדםלמה צריך אותו
VSCodeעורך חינמי של מיקרוסופט. החלון שבתוכו קלוד עובד.זה שולחן העבודה. בלעדיו אין איפה לשבת.
תוסף Claude Codeהכפתור וחלון השיחה של קלוד בתוך העורך.זה הממשק. דרכו אתם כותבים לו ורואים מה הוא עושה.
Nodeמנוע שמריץ תוכניות. קלוד עצמו רץ עליו.בלעדיו הכלי פשוט לא נדלק.
Pythonמנוע נוסף, שקלוד כותב אליו סקריפטים קצרים בעצמו.זה מה שמאפשר לו לפתוח ולעבד את הקבצים שלכם.
Gitשומר גרסאות. ביטול אינסופי לכל הפרויקט.זה מה שנותן לכם להעז לנסות דברים.

למה דווקא פייתון

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

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

למה Git הוא הכלי שהכי כדאי לכם שיהיה

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

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

השכבה שלא מופיעה ברשימת התוכנות

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

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

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

3. מה צריך להיות מוכן לפני שמתחילים

ארבעה דברים, וכולם קלים:

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

4. ההתקנה עצמה, שלב אחרי שלב

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

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

מורידים ולוחצים פעמיים

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

עוברים את מסך האזהרה של וינדוס

לפעמים יקפוץ מסך כחול שכתוב עליו Windows protected your PC. זה נראה מפחיד וזה לא. וינדוס מציגה אותו לכל קובץ הרצה שאין לו חתימה מסחרית יקרה, וזה כולל כמעט כל כלי קטן. לוחצים על More info ואז על Run anyway. אם אתם לא יודעים מאיפה הקובץ הגיע, אל תעשו את זה. אם אתם יודעים, זה בסדר גמור.

מאשרים הרשאת מנהל מערכת

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

מחכים

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

5. למה מבקשים ממכם הרשאת מנהל מערכת

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

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

איך אני מנסח את זה לעצמי

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

6. הדפדפן שנפתח בסוף, וההתחברות

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

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

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

7. הפעם הראשונה: לפתוח תיקייה

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

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

איפה לפתוח את התיקייה, וזה חשוב

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

8. שלושת המושגים שחייבים להבין

אם תבינו את שלושת אלה, לא תיתקעו. אם לא, כל שאר הכלי ירגיש לכם שרירותי.

פרויקט הוא תיקייה. זהו.

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

סשן הוא שיחה אחת, וסשנים לא מכירים זה את זה

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

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

הראיון הראשון, שקורה פעם אחת

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

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

9. מה קלוד יוצר לעצמו בתוך הפרויקט

אחרי העבודה הראשונה תראו שהופיעה בתיקייה תיקייה בשם .claude. אל תיבהלו וגם אל תמחקו אותה.

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

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

10. המלכודות

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

מלכודת הנתיב: עברית באמצע הכתובת

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

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

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

מלכודת הקידוד: אותו קובץ, שתי דרישות הפוכות

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

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

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

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

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

החלק שהופך את זה למלכודת אמיתית

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

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

מלכודת קטנה אחרונה

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

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


שאלות ותשובות

כמה זמן לוקחת ההתקנה?

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

למה צריך להתקין כל כך הרבה דברים? אני רק רוצה צ'אט

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

ההתקנה מבקשת הרשאת מנהל מערכת. זה בטוח?

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

זה עובד גם על מק?

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

איפה כדאי לפתוח את תיקיית הפרויקטים?

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

מה זה סשן, ולמה קלוד לא זוכר מה עשינו אתמול?

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

מה זו התיקייה בשם .claude שהופיעה לי בפרויקט?

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

שמרתי קובץ סקריפט עם עברית ועכשיו הטקסט יצא ג'יבריש. מה קרה?

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

משהו נכשל באמצע ההתקנה. מה עושים?

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

אני לא יודע לתכנת. באמת אצליח להתקין את זה?

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

למה צריך גם פייתון וגם Node? הם לא אותו דבר?

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

מה ההבדל בין להתקין את קלוד קוד לבד לבין קובץ ההתקנה שבנית?

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

התקנתי את קלוד קוד והוא עובד הרבה פחות טוב ממה שראיתי בהדגמות. למה?

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

האם חבילת ההתקנה המוכנה זמינה לכולם?

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

להעמיק הלאה

על הכותב

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

מעדיפים שנעשה את זה ביחד?

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

לסילבוס המלא של הקורס

4 מפגשים מוקלטים · גישה מיידית · בלי רקע בתכנות · שאלה? בוואטסאפ