התקנת Claude Code (קלוד קוד) והפעלה ראשונה ב-CLI

Claude Code (קלוד קוד) הוא סוכן הקוד של Anthropic שרץ ישירות בטרמינל. במדריך הזה תתקינו אותו דרך npm, תתחברו עם מנוי או מפתח API, תריצו את הסשן הראשון ותבינו את מודל ההרשאות — קריאה, כתיבה והרצת פקודות. כל השלבים נבדקו בפועל על מערכת נקייה.

עודכן ב-2026-06-03 · נבדק על Claude Code בגרסת ה-CLI היציבה. נכתב על ידי צוות Core-Code (אודות) מתוך עבודה יומיומית עם הכלי, בשילוב סיוע AI שנבדק ידנית.

מה הדרישות המקדימות להתקנה?

לפני ההתקנה צריך Node.js בגרסה 18 ומעלה ומנהל החבילות npm שמגיע איתו. מערכת ההפעלה יכולה להיות macOS, Linux או Windows. מומלץ גם חשבון Anthropic פעיל. ודאו שהגרסה תקינה לפני שתמשיכו:

node -v   # צריך v18 ומעלה
npm -v

אם הפקודה נכשלת, התקינו Node.js דרך nvm או מהאתר הרשמי. לפי סקר המפתחים של Stack Overflow לשנת 2024, כ-76% מהמפתחים כבר משתמשים בכלי AI או מתכננים לאמץ אותם — כך שסביבת עבודה תקינה לכלי כזה הפכה לחלק מהבסיס המקצועי (מקור).

איך מתקינים את Claude Code דרך npm?

ההתקנה היא פקודה גלובלית אחת ב-npm. היא מורידה את ה-CLI ומוסיפה את הפקודה claude ל-PATH. אל תריצו אותה עם sudo — זה גורם לבעיות הרשאות מאוחר יותר. אם npm גלובלי דורש הרשאות, הגדירו תיקיית prefix אישית. ההתקנה אורכת בדרך כלל פחות מדקה:

npm i -g @anthropic-ai/claude-code

לאחר ההתקנה ודאו שהפקודה זמינה:

claude --version

כפי שמנסחת זאת התיעוד הרשמי של Anthropic: "Claude Code lives in your terminal, understands your codebase, and helps you code faster" — כלומר ההקשר הוא הפרויקט עצמו, לא תיבת צ'אט נפרדת (מקור).

איך מתחברים — מנוי או מפתח API?

יש שתי דרכי אימות. הראשונה: הריצו claude, והכלי יפתח התחברות בדפדפן לחשבון Claude שלכם (מנוי Pro או Max). השנייה: הגדרת מפתח API מ-Anthropic Console כמשתנה סביבה — נוח לצוותים, ל-CI ולחיוב לפי שימוש:

export ANTHROPIC_API_KEY="sk-ant-..."

ב-Windows תחת PowerShell ההגדרה שונה:

$env:ANTHROPIC_API_KEY = "sk-ant-..."

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

איך נראית ההרצה הראשונה?

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

claude
> תן סקירה קצרה של מבנה הפרויקט הזה

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

claude -p "כתוב הודעת commit לשינויים שב-staging"

מהן פקודות הבסיס שכדאי להכיר?

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

/help      # רשימת הפקודות הזמינות
/clear     # ניקוי חלון ההקשר וההיסטוריה הנוכחית
/init      # יצירת קובץ CLAUDE.md לפרויקט
/cost      # מעקב אחר עלות וצריכת הטוקנים בסשן

הרגל /cost חשוב במיוחד בעבודה מול API בתשלום — כך אתם רואים את הצריכה בזמן אמת. את הפקודה /init נכסה לעומק בשיעור הבא על קובץ CLAUDE.md וניהול ההקשר.

איך עובד מודל ההרשאות?

מודל ההרשאות הוא מנגנון הבטיחות המרכזי. Claude Code רשאי לקרוא קבצים כברירת מחדל, אך לפני כתיבה לקובץ או הרצת פקודת מערכת הוא עוצר ומבקש אישור מפורש. זו הגנה מובנית מפני פעולות הרסניות — לפי המדריך הרשמי לאבטחה, "permission system requires explicit approval" לכל פעולה רגישה (מקור).

על כל בקשה לפעולה רגישה תקבלו שלוש אפשרויות בסיס:

• אישור חד-פעמי — הפעולה הנוכחית בלבד תרוץ.
• אישור קבוע לפרויקט — הפעולה (למשל הרצת npm test) תאושר אוטומטית בהמשך הסשנים בפרויקט הזה.
• דחייה — הפעולה לא תתבצע, ותוכלו לנסח את הבקשה מחדש.

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

Checkpoint

איזו פעולה Claude Code מבצע כברירת מחדל בלי לבקש מכם אישור?

• אקריאת קבצים בפרויקט
• בכתיבה ועריכה של קבצים
• גהרצת פקודות מערכת בטרמינל

מה הלאה?

עכשיו שהכלי מותקן ורץ, השלב הבא הוא לכוון אותו לפרויקט שלכם בעזרת קובץ CLAUDE.md — שם מגדירים חוקים, פקודות וסגנון קבוע. עברו לשיעור הבא במסלול, או העמיקו בעקרון הפרדת האחריות (SOC) שכדאי לאכוף גם כשסוכן AI כותב עבורכם קוד.