מדריך קלוד דסקטופ בעברית

פרק 2

התקנה, הגדרה ראשונית וחיבור

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

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

עמוד ההורדות הרשמי זמין בכתובת: claude.com/download.

באפליקציה קיימות שלוש לשוניות:

  • Chat: שיחה כללית ללא גישה לקבצים, בדומה ל-claude.ai.
  • Cowork: סוכן רקע אוטונומי שעובד על משימות במכונה וירטואלית מבודדת עם סביבה משלה, ורץ באופן עצמאי בזמן שאתם מבצעים עבודה אחרת. סשנים מקומיים מריצים את ה-VM במחשב שלכם, וסשנים מרוחקים רצים ב-VM המנוהל על ידי Anthropic.
  • Code: עוזר קידוד אינטראקטיבי עם גישה ישירה לקבצים המקומיים שלכם. בהתאם למצב ההרשאות, אתם מאשרים כל שינוי שקלוד מציע או בודקים את השינויים לאחר שקלוד מבצע אותם.

נושאי Chat ו-Cowork מכוסים במרכז העזרה של Claude, והתקנה ופריסה של אפליקציית שולחן העבודה מוסברות במאמרי התמיכה של Claude Desktop. פרק זה מתמקד בלשונית Code.

#התקנה ב-macOS

עבור משתמשי Mac, האפליקציה מופצת כקובץ תמונה אוניברסלי (Universal DMG) התומך במעבדי Apple Silicon (סדרת M1, M2, M3, M4) ובמעבדי Intel:

  1. היכנסו לעמוד ההורדות והורידו את חבילת ה-DMG למק.
  2. פתחו את הקובץ שהורד מתיקיית Downloads.
  3. בחלון שנפתח, גררו את האייקון של Claude ישירות אל תיקיית Applications.
  4. פתחו את ה-Finder, נווטו ל-Applications והפעילו את Claude.
  5. בעת ההפעלה הראשונה, מערכת macOS עשויה להציג דיאלוג אבטחה (Gatekeeper). לחצו על Open כדי לאשר את הרצת היישום.
  6. בחלון שייפתח, בצעו התחברות עם חשבון ה-Anthropic שלכם.

[!NOTE] תכונות מתקדמות במק כגון Quick Entry והכתבה קולית דורשות הרשאות מערכת נוספות (Accessibility, Screen Recording ו-Speech Recognition), אותן נגדיר בפרק המוקדש לכך.

#התקנה ב-Windows

מערכת Windows נתמכת בשתי ארכיטקטורות חומרה:

  1. עבור מעבדי x64 סטנדרטיים: הורידו את קובץ ההתקנה Setup.exe הסטנדרטי מאתר ההורדות.
  2. עבור מעבדי ARM64: הורידו את מתקין ה-ARM64 הייעודי מאתר ההורדות (עבור מחשבים ניידים ומחשבי Copilot+ מבוססי מעבדי Snapdragon).
  3. הריצו את קובץ ההתקנה. במידה ומופיעה התראת SmartScreen (Windows protected your PC), לחצו על More info ולאחר מכן על Run anyway (ודאו שהקובץ הורד מהדומיין הרשמי של claude.ai).
  4. עקבו אחר הוראות האשף וסיימו את ההתקנה. היישום יתווסף לתפריט Start.

#דרישת חובה ב-Windows: התקנת Git

כדי להריץ סשנים מקומיים (Local) בלשונית Code, יש לוודא שמותקן במערכת Git for Windows. ברוב מחשבי Mac מותקן Git כברירת מחדל. מנוע הקידוד נשען על פקודות Git לניהול שינויים ועבודה מבודדת ב-worktrees. אם Git אינו מותקן, סשנים מקומיים לא יוכלו לאתחל את סביבת העבודה. לאחר התקנת Git, מומלץ להפעיל מחדש את אפליקציית Claude.

[!NOTE] אם אתם עובדים ב-Windows עם WSL 2, ניתן להריץ סשנים ישירות מתוך הפצת WSL 2 דרך תפריט הסביבות בלשונית Code, כך ש-Claude Code, הכלים ו-Git ירוצו בצד של לינוקס עם נתיבים מקוריים.

#התקנה ב-Linux (גרסת בטא)

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

#דרישות מערכת

  • Ubuntu 22.04 ומעלה, או Debian 12 ומעלה
  • ארכיטקטורה x86_64 או arm64 (במונחי apt: amd64 או arm64)

הפצות אחרות מבוססות דביאן עשויות לעבוד, אך אינן נבדקות רשמית. ב-Fedora, ב-Arch וב-RHEL אין חבילת דסקטופ: הריצו שם את ה-CLI. המאגר לא מפרסם חבילות לארכיטקטורות אחרות.

#Cowork בלינוקס: QEMU ו-KVM

בלינוקס לשונית Cowork מריצה משימות מקומיות במכונה וירטואלית שהאפליקציה מארחת עם QEMU ו-KVM (סשנים מרוחקים של Cowork רצים ב-VM שמנוהל על ידי Anthropic). בלי הדרישות האלה הרצה מקומית תציג שגיאה ולא תעבוד.

דרישהמה צריך בפועל
וירטואליזציית חומרהמופעלת בהגדרות הקושחה. אחרת מופיע Cowork requires hardware virtualization (KVM)
QEMU וקושחת UEFIב-x86_64: qemu-system-x86, ovmf, virtiofsd. ב-arm64: qemu-system-arm, qemu-efi-aarch64, virtiofsd
גישה ל-/dev/kvm ול-/dev/vhost-vsockהוסיפו את המשתמש לקבוצת kvm, ואז התנתקו והתחברו מחדש

apt install claude-desktop מתקין את חבילות QEMU כחבילות מומלצות. אם התקנתם עם --no-install-recommends, או על תמונת מערכת מינימלית שמדלגת עליהן, הלשונית תדווח Cowork requires QEMU ותראה את פקודת apt install להשלמה.

[!NOTE] ב-Ubuntu 22.04 אין חבילת virtiofsd במאגר. האפליקציה משתמשת שם בעותק שמגיע איתה.

הוספה לקבוצה:

sudo usermod -aG kvm $USER

התנתקו והתחברו מחדש אחרי הפקודה. חלק מסביבות שולחן העבודה נותנות גישה ל-/dev/kvm בלי הקבוצה, אבל Cowork צריך גם את /dev/vhost-vsock, שרק חברי kvm יכולים לפתוח. הצטרפו לקבוצה גם אם /dev/kvm כבר עובד.

האפליקציה בודקת את הדרישות פעם אחת בעלייה: הפעילו אותה מחדש אחרי התקנת חבילות, והתנתקו והתחברו מחדש אחרי הצטרפות לקבוצה.

[!WARNING] אם /dev/vhost-vsock חסר ואין למערכת ספריית מודולים תחת /lib/modules, Cowork ידווח שהקרנל לא כולל את תמיכת הווירטואליזציה הנדרשת ושלא ניתן להוסיף אותה ידנית. זה נפוץ ב-ChromeOS ובסביבות לינוקס מבוססות קונטיינר.

#התקנה ממאגר apt

הדרך המומלצת: מאגר ה-apt של Anthropic, כדי שאימות החתימות והעדכונים יגיעו עם מערכת החבילות.

אם curl או gpg חסרים (נפוץ בהתקנת דביאן או אובונטו חדשה):

sudo apt install curl gnupg
  1. הורידו את מפתח החתימה:
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc

הפקודה לא מדפיסה כלום כשהיא מצליחה, ומדפיסה שגיאת curl: כשהיא נכשלת.

  1. ודאו שהקובץ הוא מפתח של Anthropic לפני שממשיכים. מפתח חסר או שגוי יכשיל אחר כך את apt update עם NO_PUBKEY BAA929FF1A7ECACE:
gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc

טביעת האצבע צריכה להיות 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. אם gpg מדווח שהקובץ לא נפתח או שאין בו נתוני OpenPGP תקינים, ההורדה נכשלה או החזירה תוכן שגוי: ודאו שיש גישה ל-downloads.claude.ai והריצו שוב את הורדת המפתח.

  1. רשמו את המאגר. שימו לב לדגל arch=amd64,arm64:
echo "deb [arch=amd64,arm64 signed-by=/usr/share/keyrings/claude-desktop-archive-keyring.asc] https://downloads.claude.ai/claude-desktop/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list
  1. עדכנו והתקינו:
sudo apt update && sudo apt install claude-desktop
  1. הפעילו את Claude ממסך היישומים, או הריצו claude-desktop מהטרמינל, והתחברו עם חשבון Anthropic.

[!IMPORTANT] בלינוקס האפליקציה לא מעדכנת את עצמה ברקע. עדכונים מגיעים עם עדכוני החבילות הרגילים של המערכת, כולל מנהל התוכנות הגרפי:

sudo apt update && sudo apt upgrade

#התקנה מקובץ .deb

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

curl -fLO "https://downloads.claude.ai/claude-desktop/apt/stable/$(curl -s "https://downloads.claude.ai/claude-desktop/apt/stable/dists/stable/main/binary-$(dpkg --print-architecture)/Packages" | grep '^Filename: pool/main/c/claude-desktop/claude-desktop_' | sort -V | tail -n 1 | cut -d' ' -f2)"

אם מופיע Remote file name has no length, האיתור לא החזיר נתיב חבילה. בדקו גישה ל-downloads.claude.ai, וודאו ש-dpkg --print-architecture מדפיס amd64 או arm64.

התקנה מהתיקייה שמכילה את הקובץ:

sudo apt install ./claude-desktop_*.deb

אם apt מדווח E: Unsupported file ./claude-desktop_*.deb given on commandline, התבנית לא מצאה קובץ .deb בתיקייה הנוכחית. ודאו שההורדה הושלמה והריצו שוב מאותה תיקייה.

התקנת ה-.deb גם רושמת את מאגר apt תחת /etc/apt/sources.list.d/claude-desktop.list, כך שעדכונים עתידיים יגיעו כרגיל. כדי להתקין בלי לרשום את המאגר, צרו קודם את /etc/default/claude-desktop עם השורה CLAUDE_DESKTOP_ADD_REPO="false". בלי המאגר, apt לא יביא גרסאות חדשות: כדי לעדכן יש להוריד ולהתקין שוב, או לרשום את המאגר אחר כך.

#הסרה

sudo apt remove claude-desktop

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

sudo rm /etc/apt/sources.list.d/claude-desktop.list

#מה עדיין חסר בבטא של לינוקס

תכונהמצב בלינוקס
Computer Useלא זמין
הכתבה קוליתלא זמינה באפליקציית הדסקטופ. אפשר להשתמש בהכתבה ב-CLI
קיצור Quick Entryעובד ב-X11. ב-Wayland מקורי נדרש פורטל GlobalShortcuts של סביבת שולחן העבודה
Fedora, RHEL ו-Archאין חבילת דסקטופ. להריץ את ה-CLI

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

#אימות והתחברות לחשבון

תהליך ההתקנה וההתחברות הראשונית כולל שני שלבים:

  1. התקנה והתחברות לחשבון: ב-macOS וב-Windows, הורידו את קובץ ההתקנה מהקישורים והריצו אותו. בלינוקס, עקבו אחר שלבי ההתקנה עבור לינוקס. הפעילו את Claude מתיקיית Applications ב-macOS, מתפריט Start ב-Windows, או ממפעיל היישומים בלינוקס, ולאחר מכן התחברו עם חשבון Anthropic שלכם.
  2. פתיחת לשונית Code: לחצו על לשונית Code במרכז החלק העליון של החלון. אם לחיצה על Code מבקשת שדרוג, עליכם להירשם תחילה לתוכנית בתשלום. אם מופיעה בקשה להתחבר ברשת, השלימו את ההתחברות והפעילו מחדש את האפליקציה. אם מופיעה שגיאת 403, עיינו בסעיף פתרון בעיות אימות בהמשך.

#סוגי מנויים ושדרוג

  • לשונית Chat: פתוחה לכל המשתמשים, כולל מנויים במסלול Free.
  • Claude Code (לשונית Code ולשונית Cowork): דורש מנוי פעיל בתשלום מבין המסלולים הבאים: Pro, Max, Team, או Enterprise.

[!IMPORTANT] אפליקציית הדסקטופ אינה מקבלת מפתח API של Claude Console. לצורך אימות עם מפתח API יש להשתמש ב-CLI. הריצה חייבת להתבצע כמשתמש רגיל: אם מריצים את claude-desktop כ-root, התהליך מופסק עם השגיאה Running as root without --no-sandbox is not supported.

#התחלת סשן ראשון בלשונית Code

כאשר לשונית Code פתוחה, בוחרים פרויקט ומגדירים משימה לקלוד לפי סדר השלבים הבא:

  1. בחירת סביבה ותיקייה: בחרו ב-Local כדי להריץ את Claude על המחשב שלכם תוך שימוש ישיר בקבצים שלכם. לחצו על Select folder ובחרו את תיקיית הפרויקט שלכם. מומלץ להתחיל בפרויקט קטן שאתם מכירים היטב, זו הדרך המהירה ביותר לראות מה Claude Code יודע לעשות. בנוסף ל-Local, ניתן לבחור בסביבות עבודה נוספות:
    • Cloud: הרצת סשנים בענן שממשיכים לפעול גם אם סוגרים את האפליקציה.
    • SSH: התחברות למכונה מרוחקת ב-SSH, כגון שרתים פרטיים, מכונות וירטואליות בענן, או dev containers. האפליקציה מתקינה את Claude Code במכונה המרוחקת באופן אוטומטי בהתחברות הראשונה.
    • WSL (ב-Windows): הרצת הסשן בתוך הפצת WSL 2, כאשר Claude Code, הכלים ו-Git רצים בצד של לינוקס עם נתיבים מקוריים.
  2. בחירת מודל: בחרו מודל מהתפריט הנפתח שליד כפתור השליחה. ניתן לשנות את המודל בהמשך מאותו תפריט נפתח.
  3. הגדרת המשימה לקלוד: הקלידו את מה שתרצו שקלוד יעשה:
    • Find a TODO comment and fix it
    • Add tests for the main function
    • Create a CLAUDE.md with instructions for this codebase סשן הוא שיחה עם קלוד אודות הקוד שלכם. כל סשן עוקב אחר ההקשר והשינויים שלו בנפרד.
  4. סקירה ואישור של שינויים: ההמשך תלוי במצב ההרשאות שנבחר בבורר שליד כפתור השליחה:
    • Auto או Accept edits: קלוד מחיל את שינויי הקבצים שלו, ומחוון כגון +12 -1 מופיע לצורך סקירה בתצוגת ה-diff.
    • Manual: קלוד מציע כל שינוי וממתין לאישורכם לפני החלתו. הקבצים אינם משתנים עד לאישור, ואם אתם דוחים שינוי, קלוד שואל כיצד תרצו להמשיך. במצב Manual מוצגים:
      1. תצוגת diff המציגה במדויק מה ישתנה בכל קובץ.
      2. כפתורי Accept ו-Reject לאישור או דחייה של כל שינוי.
      3. עדכונים בזמן אמת בזמן שקלוד מעבד את הבקשה.

#אפשרויות עבודה והמשך שימוש בסביבת העבודה

לאחר ביצוע העריכה הראשונה, עומדות לרשותכם יכולות נוספות:

  • עצירה והכוונה בזמן אמת: ניתן לכוון מחדש את קלוד בכל שלב. לחצו על כפתור העצירה כדי לקטוע פעולה מיד, או הקלידו תיקון ולחצו על Enter כדי לשלוח אותו מבלי לעצור את הפעולה שרצה. אינכם צריכים להמתין לסיום הפעולה או להתחיל מחדש.
  • הוספת הקשר: הקלידו @filename בתיבת ההנחיה כדי למשוך קובץ מסוים לשיחה, צרפו תמונות ומסמכי PDF דרך כפתור הקבצים המצורפים, או גררו ושחררו קבצים ישירות לתיבת ההנחיה. ככל שיש לקלוד יותר הקשר, כך התוצאות טובות יותר.
  • שימוש במיומנויות (Skills): הקלידו / או לחצו על + ולאחר מכן על Slash commands כדי לעיין בפקודות מובנות, במיומנויות מותאמות אישית ובמיומנויות של תוספים. מיומנויות הן הנחיות לשימוש חוזר שניתן להפעיל בכל עת, כגון רשימות תיוג לסקירת קוד או שלבי פריסה.
  • סקירת שינויים לפני ביצוע commit: לאחר עריכת קבצים מופיע מחוון כגון +12 -1. לחיצה עליו פותחת את תצוגת ה-diff, מאפשרת מעבר קובץ אחר קובץ והוספת הערות על שורות ספציפיות. קלוד קורא את ההערות ומתקן לפיהן. לחיצה על Review code מפעילה סקירה עצמית של קלוד שמשאירה הצעות בגוף הקוד.
  • הגדרת מצבי הרשאה: מצב ההרשאות קובע כמה קלוד יכול לעשות ללא בקשת אישור:
    • Auto: מסווג ברקע סוקר פעולות וחוסם פעולות מסוכנות במקום לבקש אישור ידני.
    • Manual: קלוד מבקש אישור לפני עריכת קבצים או הרצת פקודות.
    • Accept edits: קלוד מאשר אוטומטית שינויי קבצים לקצב עבודה מהיר יותר.
    • Plan: קלוד מציע גישת עבודה מבלי לערוך קבצים בפועל, שימושי לפני refactor נרחב.
  • הוספת תוספים (Plugins): לחצו על כפתור ה-+ ליד תיבת ההנחיה ובחרו ב-Plugins כדי להתקין מיומנויות, סוכנים, שרתי MCP והרחבות נוספות.
  • סידור סביבת העבודה: גררו את חלוניות הצ'אט, ה-diff, הטרמינל, הקבצים והדפדפן לכל פריסה רצויה. קיצור המקשים Ctrl+` פותח את הטרמינל לצד הסשן, ולחיצה על נתיב קובץ פותחת אותו בעורך הקבצים הפנימי.
  • תצוגה מקדימה של היישום: הרצת שרת הפיתוח שלכם באפליקציה פותחת את היישום בחלונית Browser, המסוגלת גם לפתוח אתרים חיצוניים. קלוד יכול לצפות ביישום הפעיל, לבדוק נקודות קצה (endpoints), לבחון יומני ריצה (logs) ולבצע שינויים בהתאם לממצאים.
  • מעקב אחר Pull Requests: לאחר פתיחת PR, המערכת עוקבת אחר תוצאות בדיקות ה-CI ויכולה לתקן שגיאות באופן אוטומטי או למזג את ה-PR כאשר כל הבדיקות עוברות בהצלחה.
  • משימות מתוזמנות: ניתן להגדיר משימות אוטומטיות החוזרות על עצמן, כגון סקירת קוד יומית בבוקר, בדיקת תלויות שבועית, או תדרוך המבוסס על הכלים המחוברים שלכם.
  • הרחבת סביבת העבודה: פתיחת סשנים מקבילים מסרגל הצד (ניתן לפתוח כל אחד בענף Git worktree נפרד), חלונית משימות (Tasks) לצפייה בתת-סוכנים ובפקודות רקע של הסשן, פתיחת שיחת צד (side chat) לשאלות נקודתיות מבלי לקטוע את התהליך המרכזי, העברת עבודות ארוכות לענן כך שימשיכו לרוץ גם אם תסגרו את האפליקציה, המשך סשן ברשת או ב-IDE אם משימה נמשכת זמן רב מהמצופה, וחיבור לכלים חיצוניים כגון GitHub, Slack ו-Linear.

#פתרון תקלות אימות, התקנה ועדכונים

#שגיאת 403 או כשל אימות בלשונית Code

אם לשונית Code מציגה שגיאת 403 Forbidden או מבקשת אימות מחדש בלולאה:

  1. בצעו יציאה מהחשבון באפליקציה דרך תפריט הפרופיל.
  2. פתחו את הדפדפן, היכנסו ל-claude.ai וודאו שהסשן פעיל והמנוי בתוקף.
  3. סגרו לחלוטין את אפליקציית Claude Desktop (במק: Cmd+Q, ב-Windows: סגירה מלאה מסרגל המשימות).
  4. הפעילו את האפליקציה מחדש והתחברו שוב.

#לינוקס: Unable to locate package claude-desktop

אם sudo apt install claude-desktop נכשל עם E: Unable to locate package claude-desktop, apt לא מצא את המאגר:

  • הריצו sudo apt update אחרי הוספת המאגר. apt install לבדו לא רואה מאגר שנוסף אחרי העדכון האחרון.
  • ודאו שהרשומה נכתבה: cat /etc/apt/sources.list.d/claude-desktop.list אמור להציג את שורת ה-deb. אם הקובץ ריק או חסר, חזרו על שלב הוספת המאגר.
  • ודאו שהארכיטקטורה נתמכת: dpkg --print-architecture צריך להדפיס amd64 או arm64.
  • הריצו שוב sudo apt update ובדקו אם מופיעות שגיאות שקשורות ל-downloads.claude.ai (רשת או מפתח).
  • אם המאגר במקום וזמין והחבילה עדיין לא נמצאת, ודאו שוב שפקודת sudo apt update הסתיימה בהצלחה ללא שגיאות.