איך מתקינים את Claude Code: כל השיטות והפלטפורמות
מאת צוות מדיה דיל · 08.08.2026 · AI · 9 דק׳
מדריך מעשי להתקנת Claude Code בכל פלטפורמה: סקריפט ההתקנה הנייטיבי, Homebrew, WinGet, מנהלי חבילות בלינוקס, התחברות ראשונה והרצה בפרויקט - עם כל הפקודות המדויקות מהתיעוד הרשמי.
אם קראתם עליו, ראיתם דמו בעבודה או שמעתם ממישהו שהוא "חייב" את זה - השלב הבא הוא פשוט להתקין ולנסות. הבעיה היא שכשמחפשים איך מתקינים את Claude Code מגלים כמה שיטות שונות, כמה מערכות הפעלה, וכמה הבדלים קטנים בין אחת לשנייה שדווקא כן משנים בשימוש היומיומי - למשל, האם הכלי יעדכן את עצמו לבד או שתצטרכו לזכור לעשות את זה. במאמר הזה נעבור על כל שיטות ההתקנה הרשמיות של Claude Code: סקריפט ההתקנה הנייטיבי למק, לינוקס ו-WSL, ההתקנה בוינדוס דרך PowerShell או CMD, Homebrew, WinGet, ומנהלי החבילות של לינוקס - apt, dnf ו-apk. נסביר את ההבדלים בהתנהגות העדכונים האוטומטיים, נלווה אתכם דרך ההתחברות הראשונה ועד ההרצה הראשונה בתוך פרויקט אמיתי, ונענה על שאלות שעולות כמעט תמיד בשלב הזה. כל הפקודות במאמר לקוחות ישירות מהתיעוד הרשמי של Anthropic, כך שתוכלו להעתיק ולהדביק בביטחון מלא.
לפני שמתקינים: מה צריך במחשב
Claude Code הוא כלי טרמינל, ולכן לפני ההתקנה כדאי לוודא שהמערכת שלכם עומדת בדרישות הבסיסיות. מבחינת מערכת הפעלה נתמכים macOS מגרסה 13 ומעלה, Windows 10 גרסה 1809 ומעלה או Windows Server 2019 ומעלה, וכן הפצות לינוקס כמו Ubuntu מגרסה 20.04, Debian מגרסה 10 ו-Alpine Linux מגרסה 3.19 ומעלה. מבחינת חומרה מספיק 4GB זיכרון ומעבד x64 או ARM64, ומעבר לכך נדרש חיבור אינטרנט וסביבת שורת פקודה - Bash, Zsh, PowerShell או CMD. כלי בשם ripgrep, שמשמש לחיפוש בקבצים, מגיע בדרך כלל מובנה בתוך Claude Code עצמו, כך שברוב המקרים אין צורך להתקין אותו בנפרד.
שווה לציין שקיים גם אפליקציית Desktop גרפית של Claude Code למי שמעדיף לא לעבוד מהטרמינל, אבל המאמר הזה מתמקד בהתקנת כלי שורת הפקודה - שהוא עדיין הדרך הנפוצה והגמישה ביותר לעבוד איתו, ובמיוחד לשילוב בתהליכי פיתוח, אוטומציה ו-CI.
שיטה 1: התקנה נייטיבית - השיטה המומלצת
ההתקנה הנייטיבית היא השיטה שמומלצת רשמית על ידי Anthropic, בעיקר כי היא הכי פשוטה וגם מתעדכנת לבד ברקע. הרעיון הוא סקריפט אחד שמוריד את הבינארי המתאים למערכת שלכם ומגדיר אותו.
macOS, Linux ו-WSL
בטרמינל של מק, לינוקס או WSL (סביבת לינוקס בתוך וינדוס) מריצים את הפקודה הבאה:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell
מי שעובד בוינדוס באופן טבעי (לא דרך WSL) ופותח PowerShell - הפרומפט שלכם יראה כמו PS C:\ - מריץ:
irm https://claude.ai/install.ps1 | iex
Windows CMD
ומי שנמצא ב-CMD הרגיל של וינדוס, שבו הפרומפט מראה רק C:\ בלי האותיות PS, מריץ:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
יש כאן שתי הודעות שגיאה נפוצות שכדאי להכיר מראש: אם אתם מקבלים הודעה שהתו && אינו מפריד פקודות תקין, כנראה שאתם למעשה ב-PowerShell ולא ב-CMD. ואם אתם מקבלים הודעה שהפקודה irm אינה מוכרת, כנראה שאתם ב-CMD ולא ב-PowerShell. ההבדל בין השניים חשוב כי כל אחד דורש תחביר פקודות אחר לגמרי.
בוינדוס נייטיבי (לא WSL) מומלץ, אך לא חובה, להתקין גם את Git for Windows - זה מה שמאפשר ל-Claude Code להשתמש בכלי ה-Bash הפנימי שלו. בלי Git for Windows, הכלי פשוט ישתמש ב-PowerShell כדי להריץ פקודות שורת פקודה במקום. בסביבת WSL אין צורך ב-Git for Windows בכלל, כי כבר עובדים בסביבת לינוקס אמיתית.
נקודה חשובה מאוד להבנת ההבדלים בין שיטות ההתקנה: ההתקנה הנייטיבית היא היחידה שמתעדכנת אוטומטית ברקע כברירת מחדל, כדי לשמור עליכם תמיד בגרסה העדכנית. אפשר גם לבחור ערוץ עדכונים - latest, שהוא ברירת המחדל ומקבל פיצ'רים חדשים מיד עם השחרור, או stable, שהוא בדרך כלל בפיגור של כשבוע ומדלג על גרסאות עם רגרסיות משמעותיות. את זה אפשר להגדיר דרך הפקודה /config בתוך הכלי, תחת "Auto-update channel", או ידנית בקובץ settings.json.
שיטה 2: Homebrew (מק ולינוקס)
למי שכבר משתמש ב-Homebrew לניהול תוכנות במק, ההתקנה מתבצעת כך:
brew install --cask claude-code
Homebrew מציע שני casks שונים, וכדאי להכיר את ההבדל ביניהם: claude-code עוקב אחרי ערוץ ה-stable, כלומר גרסה שבדרך כלל בפיגור של כשבוע ומדלגת על רגרסיות גדולות, בעוד claude-code@latest עוקב אחרי ערוץ ה-latest ומקבל גרסאות חדשות מיד עם השחרור שלהן.
ההבדל המשמעותי ביותר מול ההתקנה הנייטיבית: התקנות Homebrew לא מתעדכנות אוטומטית. כדי לעדכן צריך להריץ ידנית brew upgrade claude-code או brew upgrade claude-code@latest, בהתאם לאיזה cask התקנתם. מי שרוצה שהעדכון יקרה בכל זאת באופן אוטומטי יכול להגדיר את משתנה הסביבה CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE לערך 1 - במקרה כזה Claude Code ירוץ בעצמו ברקע ויציע לכם לאתחל כשיש גרסה חדשה זמינה. שווה גם לזכור שהומברו משאיר גרסאות ישנות על הדיסק אחרי עדכונים, ולכן כדאי מדי פעם להריץ brew cleanup כדי לפנות מקום.
שיטה 3: WinGet (וינדוס)
למשתמשי וינדוס שמעדיפים את מנהל החבילות הרשמי של מיקרוסופט, ההתקנה היא:
winget install Anthropic.ClaudeCode
בדיוק כמו ב-Homebrew, גם כאן אין עדכון אוטומטי כברירת מחדל - צריך להריץ מדי פעם winget upgrade Anthropic.ClaudeCode כדי לעבור לגרסה החדשה. גם כאן אפשר להפעיל עדכון אוטומטי ברקע דרך אותו משתנה סביבה, CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1, אם כי בוינדוס יש לפעמים תקלה שבה העדכון נכשל כי המערכת נועלת את קובץ ההרצה בזמן שהתוכנה פעילה - במקרה כזה Claude Code פשוט יציג לכם את הפקודה הידנית במקום.
שיטה 4: מנהלי חבילות בלינוקס - apt, dnf ו-apk
Anthropic מפרסמת גם מאגרי חבילות חתומים דיגיטלית עבור לינוקס, כל אחד עם שני ערוצים - stable ו-latest. זו אופציה טובה למי שמנהל שרתים או תשתית לינוקס ורוצה שההתקנה תתנהל דרך מנגנוני ניהול החבילות הרגילים של המערכת.
Debian ו-Ubuntu (apt)
קודם מורידים ומאמתים את מפתח החתימה, ואז רושמים את המאגר ומתקינים:
- הורדת המפתח: sudo install -d -m 0755 /etc/apt/keyrings ואז sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc -o /etc/apt/keyrings/claude-code.asc
- רישום המאגר בערוץ stable: echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-code.list
- עדכון והתקנה: sudo apt update ואז sudo apt install claude-code
לעדכון בעתיד מריצים sudo apt update && sudo apt upgrade claude-code.
Fedora ו-RHEL (dnf)
יוצרים קובץ הגדרות מאגר תחת /etc/yum.repos.d/claude-code.repo עם הכתובת baseurl=https://downloads.claude.ai/claude-code/rpm/stable, ואז מריצים sudo dnf install claude-code. dnf יבקש לאשר את טביעת האצבע של המפתח בהתקנה הראשונה. לעדכון מריצים sudo dnf upgrade claude-code.
Alpine Linux (apk)
מורידים את מפתח החתימה, מוסיפים את כתובת המאגר לקובץ /etc/apk/repositories, ומריצים apk add claude-code. חשוב לדעת ש-Alpine לרוב לא כולל כברירת מחדל את bash ואת curl, שנדרשים כדי להריץ את פקודת ההתקנה - אם חסרים, מריצים קודם apk add bash curl libgcc libstdc++ ripgrep, ולעיתים גם צריך להוסיף את מאגר ה-community לרשימת המאגרים כדי ש-ripgrep יימצא. בנוסף, במערכות מבוססות musl כמו Alpine כדאי להגדיר בקובץ settings.json את המשתנה USE_BUILTIN_RIPGREP לערך 0, כדי שהכלי ישתמש בגרסת ripgrep שהותקנה במערכת במקום בגרסה המובנית.
נקודה משותפת חשובה לכל שלוש שיטות מנהלי החבילות בלינוקס: אף אחת מהן לא מתעדכנת אוטומטית דרך Claude Code עצמו. עדכונים מגיעים אך ורק דרך תהליך השדרוג הרגיל של המערכת - apt upgrade, dnf upgrade או apk upgrade.
אפשרות נוספת: התקנה עם npm
מי שכבר עובד בסביבת Node.js יכול גם להתקין את Claude Code כחבילת npm גלובלית, עם הפקודה npm install -g @anthropic-ai/claude-code. חשוב לדעת שהחל מגרסה 2.1.198 חבילת ה-npm דורשת Node.js 22 ומעלה. גם בגרסת Node ישנה יותר ההתקנה תושלם ו-Claude Code ירוץ בכל זאת, כי בפועל הפקודה מורידה בינארי נייטיבי ייעודי לפלטפורמה שלכם ולא באמת רצה על גבי Node בזמן אמת. שימו לב - לא מומלץ להריץ את ההתקנה עם sudo, כי זה עלול לגרום לבעיות הרשאות ולסיכוני אבטחה; אם נתקלים בשגיאות הרשאה, עדיף לתקן את הרשאות תיקיית ה-npm הגלובלית.
וידוא שההתקנה הצליחה
אחרי כל אחת מהשיטות, השלב הבא הוא לוודא שההתקנה אכן הצליחה. מריצים:
claude --version
אם ההתקנה תקינה, תקבלו מספר גרסה כמו 2.1.211 (Claude Code). אם מקבלים שגיאת command not found, כדאי לבדוק שהתקנה קודמת לא נשארה בדרך ולא מתנגשת עם החדשה. לבדיקה מעמיקה יותר של ההתקנה וההגדרות, כולל אימות קבצי settings ואזהרות רלוונטיות, אפשר להריץ claude doctor - פקודה שרק מציגה דיאגנוסטיקה ולא פותחת סשן בפועל.
התחברות ראשונה (Login)
Claude Code דורש חשבון Pro, Max, Team, Enterprise או Console - תוכנית Claude.ai החינמית לא כוללת גישה לכלי. אפשר גם לחבר אותו לספק API צד שלישי כמו Amazon Bedrock, Google Cloud או Microsoft Foundry, למי שעובד כבר בתשתית כזו בארגון.
אחרי ההתקנה, פותחים טרמינל בפרויקט הרצוי ומריצים פשוט:
claude
בפעם הראשונה הכלי יבקש להתחבר - יפתח דפדפן ויוביל אתכם דרך תהליך אישור החשבון בדפדפן. אם המשתנה ANTHROPIC_API_KEY כבר מוגדר אצלכם בסביבה, Claude Code יתנהג אחרת: הוא לא יפתח דפדפן בכלל, אלא יבקש מכם פעם אחת לאשר את השימוש במפתח ה-API הזה, וזהו. זה שימושי מאוד בסביבות שרת או CI שבהן אין דפדפן זמין, או בארגונים שמנהלים גישה מרוכזת דרך מפתחות API.
הרצה ראשונה בתוך פרויקט
ברגע שההתחברות הושלמה, פתיחת סשן אינטראקטיבי היא עניין של פקודה אחת, מתוך תיקיית הפרויקט שאתם רוצים לעבוד עליו:
claude
הכלי ייפתח כסשן אינטראקטיבי ישירות בטרמינל, ומכאן אפשר לתת לו הוראות בשפה חופשית - לבקש שיסביר קובץ, יתקן באג, יריץ טסטים, יבצע ריפקטור, או פשוט לשאול אותו שאלות על הקוד בפרויקט. מי שרוצה להבין את מלוא היכולות של הכלי אחרי ההתקנה - כולל ניהול קבצים, כלי Bash, הרשאות ועוד - מוזמן להעמיק במדריך המלא שלנו: מדריך Claude Code מלא. ומי שעובד בעיקר מתוך VS Code ורוצה לשלב את הכלי בסביבת העריכה ישירות, כדאי להסתכל על מדריך Claude Code ב-VS Code.
עדכון ידני ובעיות עדכון נפוצות
גם בהתקנה נייטיבית שמתעדכנת אוטומטית ברקע, אפשר לכפות עדכון מיידי בלי לחכות לבדיקה הבאה, פשוט עם:
claude update
אם יש עדכון זמין, תקבלו הודעה כמו Successfully updated from גרסה ישנה to version גרסה חדשה. אם אתם כבר בגרסה העדכנית, ההודעה תהיה Claude Code is up to date. שימו לב שבהתקנות שמנוהלות דרך Homebrew, WinGet או apk ההודעה תהיה מנוסחת מעט אחרת - Claude is up to date!.
מי שרוצה לעצור לגמרי את בדיקת העדכונים האוטומטית (רק בהתקנה הנייטיבית, כי בשיטות האחרות ממילא אין עדכון אוטומטי) יכול להגדיר בקובץ settings.json את המשתנה DISABLE_AUTOUPDATER לערך 1. שימו לב שההגדרה הזו רק עוצרת את הבדיקה ברקע - הפקודות claude update ו-claude install עדיין יעבדו באופן ידני. מי שצריך לחסום גם עדכונים ידניים לגמרי, למשל בסביבה ארגונית עם גרסה קבועה שמופצת פנימית, צריך להשתמש במשתנה נפרד בשם DISABLE_UPDATES.
טיפים לפתרון בעיות התקנה נפוצות
כמה תקלות חוזרות שכדאי להכיר מראש כדי לחסוך זמן:
- בלבול בין PowerShell ל-CMD בוינדוס: אם קיבלתם שגיאה על && שאינו מפריד פקודות תקין, אתם ב-PowerShell ולא ב-CMD. אם קיבלתם שגיאה שהפקודה irm אינה מוכרת, אתם ב-CMD ולא ב-PowerShell. הפרומפט עצמו מגלה לכם איפה אתם - PS C:\ מול C:\ בלבד.
- Alpine Linux ומערכות מבוססות musl: אם פקודת ההתקנה נכשלת עם שגיאת not found, כנראה ש-bash ו-curl פשוט לא מותקנים כברירת מחדל. יש להתקין אותם ידנית לפני ההתקנה עם apk add bash curl libgcc libstdc++ ripgrep.
- קובץ הרצה מותאם אישית: אם החלפתם את קובץ ההרצה ~/.local/bin/claude בסקריפט או קישור סימבולי משלכם, Claude Code ישמור אותו במקומו ולא ידרוס אותו בעדכונים, אבל גם ישמור על הדיסק את כל הגרסאות שהתקינו אי פעם כי אין לו דרך לדעת איזו גרסה קובץ ההרצה שלכם צריך. אם אתם רוצים שהכלי ינהל את קובץ ההרצה בעצמו שוב, פשוט מוחקים אותו ומריצים claude update.
- התקנת npm שלא מצליחה להתעדכן: אם תיקיית ה-npm הגלובלית לא ניתנת לכתיבה, תקבלו הודעה חד-פעמית בהפעלה, ו-claude doctor יציג לכם את הפתרונות האפשריים.
תרחיש התקנה מהחיים: onboarding של מפתח חדש בצוות
נניח שמצטרף מפתח חדש לצוות פיתוח, והוא עובד על מק עם Homebrew כבר מותקן. הוא ירוץ brew install --cask claude-code, יקבל את גרסת ה-stable, יפתח טרמינל בתוך ריפו הפרויקט, ירוץ claude, ויעבור אישור בדפדפן מול חשבון ה-Claude הארגוני. תוך פחות מדקה הוא כבר יכול לבקש מהכלי "תסביר לי את מבנה הפרויקט" ולקבל תשובה שמבוססת על קריאה אמיתית של הקוד.
לעומת זאת, בצוות DevOps שמריץ שרתי בנייה על Ubuntu, סביר יותר להתקין דרך apt כדי שההתקנה תתנהל דרך אותו תהליך ניהול חבילות שמנהל את שאר התוכנות בשרת, כולל בקרת גרסאות ואבטחה מרכזית. במקרה הזה גם ANTHROPIC_API_KEY מוגדר מראש כמשתנה סביבה בשרת, כך שההתחברות בפעם הראשונה לא דורשת דפדפן בכלל - רק אישור חד פעמי של המפתח.
ומפתח שלישי, שעובד בעיקר בוינדוס אבל מריץ את כל כלי הפיתוח שלו בתוך WSL, פותח את חלון ה-WSL ומריץ את אותה פקודת curl כמו במק ולינוקס - כי מבחינת Claude Code, WSL הוא פשוט סביבת לינוקס לכל דבר. שלוש דרכי עבודה שונות, שלוש שיטות התקנה שונות, אותה תוצאה סופית.
שאלות נפוצות
מה ההבדל המרכזי בין ההתקנה הנייטיבית ל-Homebrew או WinGet?
ההבדל המשמעותי ביותר הוא עדכונים אוטומטיים. ההתקנה הנייטיבית בודקת עדכונים בכל הפעלה ומורידה אותם ברקע באופן שקוף, כך שאתם כמעט תמיד על הגרסה העדכנית בלי לעשות כלום. Homebrew ו-WinGet, לעומת זאת, לא מתעדכנים לבד כברירת מחדל - צריך להריץ ידנית brew upgrade או winget upgrade, או להפעיל עדכון אוטומטי דרך משתנה הסביבה CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE.
איזה חשבון צריך כדי להשתמש ב-Claude Code?
נדרש חשבון בתשלום - Pro, Max, Team, Enterprise או Console. תוכנית ה-Claude.ai החינמית אינה כוללת גישה לכלי. חלופה נוספת היא חיבור דרך ספק API צד שלישי כמו Amazon Bedrock, Google Cloud או Microsoft Foundry.
איך עובד ANTHROPIC_API_KEY בהתחברות הראשונה?
אם המשתנה מוגדר בסביבה שלכם עוד לפני ההרצה הראשונה של claude, הכלי לא יפתח דפדפן להתחברות רגילה, אלא יבקש אישור חד-פעמי לשימוש במפתח הזה. זה שימושי בעיקר בסביבות שרת, CI/CD, או ניהול ארגוני מרוכז של גישה.
האם אפשר להתקין גרסה ספציפית של Claude Code ולא את העדכנית ביותר?
כן, בהתקנה הנייטיבית. למשל curl -fsSL https://claude.ai/install.sh | bash -s stable מתקין את ערוץ ה-stable, וניתן גם להעביר מספר גרסה מדויק, כמו bash -s 2.1.89, כדי לנעול על גרסה ספציפית.
מה קורה אם אני עובד ב-Alpine Linux וההתקנה נכשלת?
זו תקלה נפוצה כי Alpine לרוב לא כולל כברירת מחדל bash או curl, שנדרשים כדי להריץ את פקודת ההתקנה עצמה. פותרים את זה עם apk add bash curl libgcc libstdc++ ripgrep, ולפעמים גם צריך להוסיף את מאגר ה-community כדי ש-ripgrep יימצא. בנוסף, כדאי להגדיר USE_BUILTIN_RIPGREP לערך 0 בקובץ settings.json.
איך מסירים לגמרי את Claude Code מהמחשב?
זה תלוי בשיטת ההתקנה. בהתקנה נייטיבית מוחקים את ~/.local/bin/claude ואת תיקיית ~/.local/share/claude. ב-Homebrew מריצים brew uninstall --cask claude-code (או claude-code@latest, בהתאם למה שהתקנתם). ב-WinGet מריצים winget uninstall Anthropic.ClaudeCode, וב-apt/dnf/apk מסירים את החבילה ואת קובצי הגדרת המאגר. מי שרוצה למחוק גם הגדרות, הרשאות ותצורות MCP שנשמרו, יכול למחוק גם את תיקיית ~/.claude וקובץ ~/.claude.json, בזהירות - הפעולה הזו מוחקת את כל ההיסטוריה וההגדרות לצמיתות.
ההתקנה עצמה היא רק ההתחלה - ההבדל האמיתי מורגש כשמתחילים לעבוד עם הכלי בפרויקט אמיתי, יום־יום. אם אתם מתלבטים איזו שיטת התקנה הכי מתאימה לצוות שלכם, איך לשלב את זה בתשתית CI קיימת, או פשוט רוצים ליווי בהטמעה של Claude Code בארגון - נשמח לעזור. אפשר לדבר איתנו ישירות בוואטסאפ.
תגיות: Claude Code · התקנת Claude Code · Homebrew · WinGet · כלי AI לפיתוח · Anthropic · התקנה בלינוקס