איך להתקין את Claude Code מהאתר הרשמי

מהו Claude Code, ולמה הוא פועל במסוף?#

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

כך Anthropic מתארת את המוצר.

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

אם אתם ממש לא רוצים להשתמש במסוף, ל-Anthropic יש אפליקציית שולחן עבודה עם חלון רגיל וגם גרסת אינטרנט בכתובת claude.ai/code, שפועלת ישירות בדפדפן. אבל האפשרות החזקה והגמישה ביותר היא גרסת המסוף, ובה עוסק המאמר כולו.

איפה נמצא האתר הרשמי של Claude Code, ומה צריך להוריד?#

הבלבול הראשון של מתחילים הוא היכן נמצא האתר הרשמי של Claude Code ועל מה צריך ללחוץ כדי להוריד אותו. הנה טבלה עם כל הכתובות הרשמיות של Anthropic, כדי שלא תצטרכו לנחש.

לא מורידים מתקין מהאתר כמו בתוכנה רגילה, בניגוד לציפיות של רבים. מתקינים באמצעות פקודת מסוף, שמורידה את הגרסה המתאימה למערכת שלכם. במאמר הזה מופיעות הפקודות המדויקות ל-Mac, ל-Windows ול-Linux.

מלכודת נפוצה אחת היא שם המוצר: אנשים מאייתים אותו לעיתים קרובות בטעות כ-clode code,‏ clade code,‏ слод код או clode design. שם המוצר הוא Claude Code, עם au. זכרו זאת כשאתם מחפשים את האתר הרשמי: דומיינים באיות דומה שייכים למישהו אחר.

כדאי לדעת גם מהו השם המדויק של חבילת npm. שם החבילה הקנוני הוא @anthropic-ai/claude-code, עם הקידומת @anthropic-ai/. Anthropic עצמה מחזיקה בשם הקצר claude-code ללא הקידומת — זהו המצביע הרשמי שלה לאותה חבילה. הכלל הפשוט: המפרסם צריך להיות Anthropic, והשם להתקנה כולל את הקידומת.

מה צריך להתקנה: דרישות המחשב#

דרישות Claude Code צנועות: השרתים של Anthropic מבצעים את העבודה הכבדה; המחשב שלכם רק שולח בקשות ומקבל תשובות.

הערה נפרדת על Node.js, כי סביבו יש הכי הרבה מיתוסים. המתקין המקורי — זה ש-Anthropic עצמה ממליצה עליו — אינו זקוק ל-Node.js כלל: הוא מתקין את התוכנה כקובץ עצמאי יחיד. Node.js נדרש רק אם מתקינים את Claude Code דרך npm, ובמקרה כזה צריך גרסה 22 ומעלה. במאמרים ישנים נכתב „Node 18 ומעלה” — המידע הזה כבר לא עדכני; הסתמכו על 22 ומעלה.

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

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

איך מתקינים את Claude Code ב-macOS?#

פתחו את Terminal (הוא מגיע עם כל Mac: לחצו על Cmd+Space ב-Spotlight והקלידו “Terminal”) והדביקו את השורה הזאת:

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

הפקודה מורידה את המתקין מהכתובת הרשמית של Anthropic ומתקינה את Claude Code. אין צורך ב-Node.js. השיטה המקורית נוחה גם בגלל אופן העדכון שלה.

אם אתם כבר משתמשים ב-Homebrew, יש אפשרות נוספת:

brew install --cask claude-code

ההבדל ביניהן הוא באופן העדכון: המתקין המקורי מתעדכן בעצמו, ואילו Homebrew לא — תצטרכו לעדכן אותו ידנית באמצעות הפקודה brew upgrade claude-code. התוכנה עצמה זהה, אז בחרו בשיטה שאתם רגילים אליה. אם אינכם בטוחים, השתמשו בראשונה.

איך מתקינים את Claude Code ב-Windows?#

תחילה בררו באיזה מסוף אתם נמצאים. ל-Windows יש שתי מעטפות, ולכל אחת פקודה משלה. פתחו חלון והביטו בתחילת שורת הפקודה: PS C:\> פירושו PowerShell, ואילו C:\> ללא PS פירושו שורת הפקודה (CMD).

עבור PowerShell (הדרך הקלה ביותר לפתוח אותו היא ללחוץ לחיצה ימנית על כפתור Start ולבחור ב-“Terminal”):

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

עבור שורת הפקודה (CMD):

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

יש גם אפשרות שלישית, להשתמש במנהל החבילות המובנה WinGet:

winget install Anthropic.ClaudeCode

אם כבר יש לכם סביבת WSL תקינה (Linux בתוך Windows), התקינו את Claude Code ישירות ב-WSL באמצעות אותה פקודה כמו ב-Linux. יש עניין נפרד ב-WSL שקשור ל-Node, ואעסוק בו בהמשך, בסעיף על שגיאות נפוצות.

איך מתקינים את Claude Code ב-Linux?#

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

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

אין צורך ב-Node.js; התוכנה מגיעה כקובץ יחיד ומאותו רגע מתעדכנת בעצמה.

אם אתם רגילים להתקין תוכנות רק דרך מנהל החבילות של המערכת, תוכלו להוסיף את המאגרים הרשמיים של Anthropic:‏ apt ל-Debian ול-Ubuntu,‏ dnf ל-Fedora ול-RHEL, ו-apk ל-Alpine. הם חתומים באמצעות מפתח ויש בהם ערוצי יציב ועדכני. למתחילים זו טרחה מיותרת, לכן אני משאיר את הפרטים לתיעוד שבסעיף המקורות וממליץ כברירת מחדל על הפקודה שלמעלה.

עלולה לצוץ בעיה אחת בשרתים זולים. אם יש למחשב מעט מאוד זיכרון פנוי, ההתקנה עשויה להיעצר עם המילה Killed (קוד 137) — המערכת הפסיקה את התהליך כי נגמר לה הזיכרון. הפתרון הוא להוסיף קובץ swap: ל-Claude Code דרושים כ-512 MB של זיכרון פנוי להתקנה.

איך מפעילים את Claude Code בפעם הראשונה?#

ההפעלה הראשונה נמשכת כמה דקות. כך התהליך מתנהל.

1. עברו לתיקיית הפרויקט

   במסוף, השתמשו בפקודה cd path-to-project כדי לעבור לתיקייה שתרצו לעבוד בה, ואז הקלידו claude.

2. היכנסו לחשבון

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

3. המתינו לאישור

   לאחר שתיכנסו, במסוף תופיע ההודעה Login successful והוא יבקש מכם ללחוץ על Enter.

4. שאלו את השאלה הראשונה

   שאלו משהו פשוט על הפרויקט, למשל „מה הפרויקט הזה עושה?” Claude יקרא את הקבצים ויענה.

5. אשרו את השינוי הראשון

   כשתבקשו ממנו לשנות משהו, Claude יציג את השינויים המוצעים ויבקש אישור. אפשר להחליף מצבי גישה באמצעות Shift+Tab.

כדאי ללמוד מיד כמה פקודות בסיסיות בתוך ההפעלה: /help מציגה את הפקודות, /clear מנקה את היסטוריית השיחה, ו-/exit יוצאת (גם Ctrl+D פעמיים עושה זאת). Claude יציג לכם את כל המידע הזה אם תקלידו /help.

להתחבר באמצעות מנוי או מפתח API: במה כדאי לבחור?#

זאת השאלה הראשונה שעולה בעת ההתחברות.

יש שתי דרכים להתחבר, והן נבדלות באופן התשלום.

כדי להתחבר באמצעות מנוי, פשוט השתמשו בחשבון Claude.ai שלכם. כדי להתחבר באמצעות מפתח API, קבלו מפתח מ-Claude Console (platform.claude.com); החיובים יורדים מהיתרה ששילמתם מראש בזמן העבודה. הגדירו את המפתח במשתנה הסביבה ANTHROPIC_API_KEY, ו-Claude Code לא יפתח את הדפדפן בכל פעם.

אפשר לעבור בין חשבונות במהלך ההפעלה באמצעות /login ולהתנתק באמצעות /logout.

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

איך בודקים שההתקנה הושלמה כראוי?#

יש שלוש פקודות שכדאי להכיר מההתחלה.

הראשונה בודקת את הגרסה:

claude --version

התקנה תקינה משיבה מספר בתבנית X.Y.Z (Claude Code). הספרות המדויקות משתנות מגרסה לגרסה; העיקר שהפקודה מחזירה מספר גרסה כלשהו. תגובה של “command not found” מצביעה על בעיה אחרת — עליה אדבר בסעיף הבא.

השנייה היא פקודת אבחון, אם משהו משתבש.

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

למה פקודת claude לא נמצאת אחרי ההתקנה?#

זאת התלונה הנפוצה ביותר של מתחילים, והיא נשמעת מפחידה יותר מכפי שהיא באמת. המסוף לא מחפש פקודות בכל המחשב; הוא בודק רק את התיקיות שב-PATH. Claude Code מתקין את עצמו ב-~/.local/bin/claude (ב-Mac וב-Linux) או ב-%USERPROFILE%\\.local\\bin\\claude.exe (ב-Windows), ואם התיקייה הזאת לא נמצאת ב-PATH, המסוף פשוט לא מצליח למצוא את התוכנה.

ב-Mac וב-Linux, הוסיפו את התיקייה לרשימה. פתחו את קובץ ההגדרות של המעטפת שלכם (~/.zshrc עבור Zsh,‏ ~/.bashrc עבור Bash) והוסיפו את השורה הזאת בסוף:

export PATH="$HOME/.local/bin:$PATH"

לאחר מכן סגרו ופתחו מחדש את המסוף (או הריצו source ~/.zshrc). אחרי זה, הפקודה claude תימצא.

שגיאות נפוצות בהתקנה ובהפעלה הראשונה#

נעבור עליהם לפי הסדר; כולם מופיעים במדריך הרשמי של Anthropic לפתרון בעיות.

1. Node ישן בהתקנה דרך npm. החבילה @anthropic-ai/claude-code דורשת Node.js 22 ומעלה. ב-Windows, npm עלול להיכשל עם הודעה על כך שסקריפטים מושבתים — המדיניות של PowerShell מונעת מהם לפעול. ב-WSL, שגיאה נפוצה היא exec: node: not found: WSL משתמש ב-Node של Windows במקום ב-Node של Linux. אם npm גורם לכם לבעיות, עברו למתקין המקורי; הוא אינו זקוק ל-Node.
2. מתקין לא מתאים למעטפת. 'irm' is not recognized פירושו שהדבקתם פקודת PowerShell בשורת הפקודה. The token '&&' is not a valid statement separator פירושו שעשיתם את ההפך והרצתם פקודת CMD ב-PowerShell. A parameter cannot be found that matches parameter name 'fsSL' פירושו שהרצתם את פקודת Mac/Linux ב-PowerShell. בדקו את תחילת שורת הפקודה: PS C:\ הוא PowerShell, ואילו C:\ הוא CMD.
3. מפתח API ישן גובר על המנוי. אם המנוי פעיל אבל מפתח ישן עדיין מוגדר בסביבה, תופיע השגיאה API Error: 400 ... This organization has been disabled. המפתח מקבל עדיפות על פני התחברות למנוי. הסירו אותו באמצעות unset ANTHROPIC_API_KEY (ב-PowerShell השתמשו ב-Remove-Item Env:ANTHROPIC_API_KEY), בדקו את ~/.zshrc ואת ~/.bashrc, ואז הקלידו /status.
4. אין מספיק זיכרון בשרת חלש. ההתקנה נעצרת עם המילה Killed והקוד 137 — כלומר אין מספיק RAM. דרושים כ-512 MB פנויים; הוספת swap פותרת את הבעיה.
5. המתקין החזיר תוכן אחר. השגיאה syntax error near unexpected token '<' או אזכור של <!DOCTYPE html> פירושם שכתובת ההתקנה החזירה דף אינטרנט במקום את סקריפט ההתקנה — בדרך כלל בגלל האזור שלכם, חומת אש ארגונית או השבתה זמנית. נסו שיטה אחרת (Homebrew,‏ WinGet) או נסו שוב בעוד כמה דקות.

בכל אחת מהשגיאות האלה, הצעד הראשון זהה: הריצו claude doctor. הוא יראה מה לא תקין ויציע היכן לבדוק.

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

מה לעשות אחרי ההתקנה: צעדים ראשונים#

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

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

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

על מה עוד אנשים שואלים?#

מסגרת התכנות המלאה באמצעות הנחיות: שיבוט AI + מוח שני + הנדסת הקשר.