התקנת קלוד קוד במק — צעד אחר צעד

מה צריך לפני שמתחילים?

שלושה דברים, ותכף מסבירים כל אחד:

• מק עם macOS 13 ומעלה: בלי דרישות חומרה מיוחדות — קלוד קוד רץ בטרמינל והעבודה הכבדה קורית בענן. גם שבב Apple (M1 ומעלה) וגם מעבד Intel ישן נתמכים
• חשבון קלוד בתשלום: מנוי Pro או Max (או חשבון API של Anthropic). זה החלק שעולה כסף — הכלי עצמו חינמי
• Command Line Tools של אפל (מגיע לבד): קלוד קוד נשען על git להרצת פקודות ולניהול גרסאות. ב-macOS git מגיע כחלק מ-Command Line Tools, ובפעם הראשונה שמריצים git המערכת מציעה להתקין אותם בלחיצה. אפשר גם להקדים ולהריץ ‎xcode-select —install

את הטרמינל פותחים דרך Spotlight (‎Cmd+רווח, מקלידים terminal). מי שכבר עובדים עם iTerm2 — הוא עובד בדיוק אותו דבר.

איך מתקינים — הדרך המהירה?

פותחים טרמינל ומדביקים:

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

הפקודה מורידה את המתקין הרשמי של Anthropic ומריצה אותו. הבינארי חתום על ידי Anthropic ומאושר על ידי אפל (notarized), אז Gatekeeper לא יקפוץ עם אזהרות מפחידות. בסיום מקבלים הודעת הצלחה — וזהו, מותקן, והוא גם יתעדכן לבד ברקע מכאן והלאה.

מי שכבר חיים בתוך Homebrew יעדיפו כנראה את זה:

brew install --cask claude-code

ומי שמגיעים מעולם ה-npm (דורש Node.js גרסה 22 ומעלה):

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

כל המסלולים מתקינים את אותו בינארי בדיוק. לא בטוחים? לכו על הראשון — הוא לא דורש כלום מראש ומתעדכן לבד.

מה עושים בהרצה הראשונה?

נכנסים לתיקייה של פרויקט כלשהו (או סתם תיקייה ריקה לניסוי) ומריצים:

cd ~/Projects/my-project
claude

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

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

תסביר לי מה יש בתיקייה הזאת ומה הפרויקט עושה

איך בודקים שהכול תקין?

שתי בדיקות של שנייה:

claude --version
claude doctor

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

ההתקנה נכשלה? התקלות הנפוצות

• ‏“command not found: claude”: הטרמינל נפתח לפני ההתקנה ולא מכיר את הנתיב החדש. סוגרים את כל החלונות, פותחים טרמינל חדש ומנסים שוב. אם זה נמשך — מוודאים שהתיקייה ‎~/.local/bin נמצאת ב-PATH של zsh (מוסיפים שורה ל-‎~/.zshrc אם צריך)
• המערכת מבקשת להתקין Command Line Tools: זה תקין — git עדיין לא מותקן. מאשרים את ההתקנה שהמק מציע, מחכים שתסתיים, ומריצים שוב
• שגיאות הרשאה ב-npm: לא מריצים ‎npm install עם sudo — זה גורם לבעיות הרשאה ואבטחה. אם npm דורש הרשאות, עדיף פשוט לעבור למתקין הרשמי
• גרסת Node ישנה (במסלול npm): אזהרת EBADENGINE אומרת שה-Node מיושן. ההתקנה בדרך כלל תושלם בכל זאת (הבינארי לא באמת רץ על Node), אבל אם משהו נשבר — מעדכנים ל-Node 22 ומעלה, או עוברים למתקין הרשמי
• גרסת Homebrew לא מתעדכנת: התקנת Homebrew לא מתעדכנת לבד. מריצים ‎brew upgrade claude-code מדי פעם, או פשוט מעדיפים מלכתחילה את המתקין הרשמי שמתעדכן ברקע

המתקין הרשמי או Homebrew — מה לבחור?

שאלה אמיתית שחוזרת אצל מפתחי מק, והתשובה תלויה בהרגלים:

• המתקין הרשמי מתעדכן לבד ברקע, ולא דורש כלום מותקן מראש. זו ברירת המחדל לרוב האנשים, ובמיוחד למי שלא רוצים לחשוב על עדכונים
• Homebrew שווה אם אתם כבר מנהלים דרכו את כל הכלים ורוצים את קלוד קוד באותו מקום. המחיר: העדכון ידני (‎brew upgrade), אז קל להישאר מאחור בלי לשים לב

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

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

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

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