מדריך Claude Code בעברית: התקנה ועבודה ראשונה

מה זה Claude Code ובמה הוא שונה מצ'אט

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

התקנה

צריך מנוי בתשלום של Claude (Pro או Max) או חשבון API של Anthropic. ב-Mac או Linux, פותחים טרמינל ומריצים:

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

ב-Windows, ב-PowerShell:

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

אחרי ההתקנה נכנסים לתיקיית פרויקט ומפעילים:

cd my-project
claude

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

משימה ראשונה

התחילו ממשהו קטן שקל לבדוק. למשל, בתיקייה ריקה:

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

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

שלושה הרגלים שעושים הבדל גדול:

• תארו את התוצאה, לא את הקוד. "כשלוחצים על הכפתור, הטופס נשלח ומופיעה הודעת תודה" עדיף על "תוסיף event listener".
• בקשו תוכנית קודם. במשימה גדולה כתבו "לפני שאתה כותב קוד, תציע תוכנית". יש גם מצב תכנון ייעודי (Plan mode), שמתחלפים אליו ב-Shift+Tab.
• תנו לו לבדוק את עצמו. "תריץ את השרת ותוודא שאין שגיאות בקונסול" חוסך לכם סבב.

קובץ CLAUDE.md: הזיכרון של הפרויקט

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

# CLAUDE.md
- האתר בעברית, RTL. כל טקסט חדש בעברית.
- להריץ מקומית: python3 -m http.server בתוך public_html
- לא לגעת בקבצים בתיקייה legacy/

לעבוד בבטחה

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

טיפים מהעבודה היומיומית

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