חיצים לניווט · Enter לפתיחה · Esc לסגירה

קורס Claude Code בעברית, בחינם · שיעור 2 מתוך 8 · 16 דק׳

🛠️ שיעור 2: התקנת Claude Code ו-⁠CLAUDE.md, צעד אחר צעד

התקנת Claude Code ב-⁠Windows, Mac ולינוקס לפי התיעוד העדכני, התחברות, בדיקת התקנה, כתיבת CLAUDE.md טוב ובחירת מצב הרשאות, כולל תרגיל מעשי מלא.

🎯 בסוף השיעור תדעו להתקין ולהתחבר ל-⁠Claude Code, ליצור קובץ CLAUDE.md טוב ולבחור מצב הרשאות.

→ השיעור הקודם: מה זה Claude Code
בקצרה
  • התקנת Claude Code היא פקודה אחת לפי מערכת ההפעלה, ואחריה claude --version ו-⁠claude doctor.
  • CLAUDE.md הוא קובץ הוראות שנטען בכל סשן. יוצרים אותו עם /init ומקצרים אותו ידנית.
  • מצב ההרשאות קובע מה Claude עושה בלי לשאול. מחליפים אותו עם Shift+Tab.

איך מתקינים Claude Code?

התקנת Claude Code (קלוד קוד) היא פקודה אחת. לפי התיעוד הרשמי, ההתקנה המומלצת היא Native Install. דרישות המערכת: macOS 13 ומעלה, Windows 10 גרסה 1809 ומעלה, Ubuntu 20.04, Debian 10 או Alpine 3.19, לפחות 4GB זיכרון, וחיבור לאינטרנט.

macOS, לינוקס ו-⁠WSL:

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

Windows PowerShell:

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

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

חלופות שהתיעוד מציג: brew install --cask claude-code ב-⁠Mac, ו-⁠winget install Anthropic.ClaudeCode ב-⁠Windows. שימו לב: Native מתעדכן לבד ברקע, ואילו Homebrew ו-⁠WinGet לא. בהן צריך לשדרג ידנית.

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

איך מתקינים claude code windows?

התקנה ב-⁠Windows היא בעיקר שאלה של איזה חלון פתחתם.

  • אם בשורת הפקודה כתוב PS C:\, אתם ב-⁠PowerShell. השתמשו בפקודת irm.
  • אם אין PS, אתם ב-⁠CMD. השתמשו בפקודת curl.
  • שגיאה The token '&&' is not a valid statement separator אומרת שהרצתם את פקודת ה-⁠CMD ב-⁠PowerShell.
  • שגיאה 'irm' is not recognized אומרת שהרצתם את פקודת ה-⁠PowerShell ב-⁠CMD.

התיעוד ממליץ גם על Git for Windows, כדי שהכלי יוכל להשתמש ב-⁠Bash. בלעדיו הוא משתמש ב-⁠PowerShell. ב-⁠WSL לא צריך את זה.

מדריך מורחב עם פתרון תקלות יש במאמר התקנת קלוד קוד ב-⁠Windows וב-⁠Mac.

איך מתחברים ובודקים שזה עובד?

  1. פותחים טרמינל חדש. חלון ישן עלול לא להכיר את הפקודה.
  2. מריצים claude --version. אמור להופיע מספר גרסה.
  3. לבדיקה מפורטת מריצים claude doctor. הוא מדפיס אבחון של ההתקנה וההגדרות בלי להפעיל סשן.
  4. נכנסים לתיקיית פרויקט ומריצים claude. בהפעלה הראשונה נפתח דפדפן להתחברות.

לפי התיעוד נדרש חשבון Pro, Max, Ultra, Team, Enterprise או Console. התוכנית החינמית של claude.ai לא כוללת גישה. להחלפת חשבון מקלידים /login בתוך הסשן. פירוט עלויות ומנויים ב-⁠מדריך המחירים.

אם הפקודה לא נמצאה, תיקיית ההתקנה לא ב-⁠PATH. התיעוד מפנה לפרק “Fix your PATH” בדף Troubleshoot installation.

מה זה CLAUDE.md ולמה צריך אותו?

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

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

הקשר, לא חוק

התיעוד אומר ש-⁠Claude מתייחס ל-⁠CLAUDE.md כהקשר ולא כהגדרה נאכפת. כדי לחסום פעולה בוודאות משתמשים ב-⁠hook, ועל כך בשיעור 7.

איפה CLAUDE.md יושב?

יש כמה היקפים:

היקףמיקוםלמי
מדיניות ארגוניתב-⁠Windows: C:\Program Files\ClaudeCode\CLAUDE.mdכל משתמשי הארגון
אישי~/.claude/CLAUDE.mdרק אתם, בכל הפרויקטים
פרויקט./CLAUDE.md או ./.claude/CLAUDE.mdהצוות, דרך גיט
מקומי./CLAUDE.local.mdרק אתם בפרויקט הזה, מוסיפים ל-.gitignore

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

איך יוצרים CLAUDE.md טוב?

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

אחרי כן מקצרים ומחדדים. כללי התיעוד:

  • הוראות קונקרטיות: “הרץ npm test לפני קומיט” ולא “בדוק את הקוד”.
  • עד כ-200 שורות לקובץ. ארוך מזה מוריד את רמת ההיענות.
  • כותרות ורשימות, בלי פסקאות צפופות.
  • בלי סתירות בין הוראות.
  • מה שרלוונטי רק לחלק מהקוד עובר ל-⁠.claude/rules/ או ל-⁠Skills.

דוגמה לקובץ קצר (המספרים והפקודות הם דוגמה, התאימו לפרויקט שלכם):

# פרויקט: אתר חדשות

## פקודות
- בנייה: `npm run build`
- בדיקות: `npm test`

## כללים
- הקוד ב-TypeScript, הזחה של 2 רווחים
- טקסטים באתר בעברית, RTL
- לפני קומיט: הרץ בדיקות ותקן כשלים

## מבנה
- תוכן ב-`src/content/`
- קומפוננטות ב-`src/components/`

## אסור
- לא לגעת ב-`.env`
- לא להוסיף ספריות בלי לשאול

אפשר לייבא קובץ אחר עם @ ‏(למשל @README) כדי לארגן קובץ ארוך. ייבוא לא מקטין את צריכת ההקשר. לבדיקת קבצי ההוראות קיימת הפקודה /doctor prompt-audit, שמחפשת סתירות והפניות לקבצים שלא קיימים.

מה הם מצבי ההרשאות?

מצב הרשאות קובע מה Claude עושה בלי לשאול. התיעוד מונה שישה:

מצבמה רץ בלי אישורמתאים ל
default (Manual)קריאה בלבדעבודה רגישה
acceptEditsקריאה ועריכת קבציםאיטרציה על קוד שאתם בודקים
planקריאה בלבד, תכנוןחקירה לפני שינוי
autoהכול, עם בדיקות בטיחות ברקעמשימות ארוכות
dontAskרק מה שאושר מראשCI ו-סקריפטים
bypassPermissionsהכולרק קונטיינרים ו-⁠VM מבודדים

ב-⁠CLI לוחצים Shift+Tab כדי להתקדם בין המצבים. שורת הסטטוס מראה מה פעיל. להתחלה במצב מסוים: claude --permission-mode plan. לפי התיעוד, בגרסאות חדשות הסשן מתחיל במצב auto כברירת מחדל, אז בדקו מה כתוב בשורת הסטטוס.

להתחלה מומלץ plan ו-⁠default. את bypassPermissions משאירים לסביבה מבודדת בלבד.

תרגיל מעשי

המשימה: התקינו, התחברו ובנו CLAUDE.md לפרויקט אמיתי.

  1. התקינו לפי המערכת שלכם והריצו claude --version ואז claude doctor.
  2. היכנסו לתיקיית פרויקט קטן שלכם, הריצו claude והתחברו.
  3. הקלידו /init ואשרו את הקובץ.
  4. הריצו /context all וודאו שהקובץ ברשימת Memory files.
  5. הקלידו Shift+Tab ועברו ל-⁠plan. בקשו את הפרומפט הבא.
ביקורת על CLAUDE.md
קרא את CLAUDE.md של הפרויקט. סמן: 1. הוראות מעורפלות שאי אפשר לאמת. 2. הוראות שחוזרות על עצמן או סותרות. 3. פקודות או נתיבים שלא קיימים בפרויקט. אל תשנה כלום. תן רשימה קצרה ואחריה הצעת נוסח לכל סעיף.

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

טעויות נפוצות

  • לכתוב CLAUDE.md של 600 שורות. מקצרים ומעבירים פרטים ל-⁠rules.
  • להשאיר את הקובץ שיצר /init בלי עריכה.
  • לכתוב הוראות כלליות כמו “תהיה מדויק”.
  • להפעיל bypassPermissions על המחשב הרגיל.
  • לשים סודות, כמו מפתחות API, בקובץ שמשותף בגיט.
סיימתי את השיעור אם...0%

השיעור הבא: עבודה יומיומית עם Claude Code →

16 דק׳ קריאה

חשבון גיקזילה