📦 פרק 2

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

אפליקציית שולחן העבודה נותנת את Claude Code בממשק גרפי, כדי שתוכלו לבקש מקלוד לעבוד על הקוד בתיקייה במחשב, ולסקור את השינויים בלי לפתוח טרמינל. Claude Code נמצא בלשונית Code בראש סרגל הצד של האפליקציה. הפרק הזה עובר על התקנת האפליקציה ועל הסשן הראשון שם. ל-Claude Code נדרש מנוי Pro, Max, Ultra, Team או Enterprise.

עבור Windows ARM64, מורידים את קובץ ההתקנה ל-ARM64. בלינוקס, מתקינים באמצעות apt, ראו Claude Desktop on Linux.

[!NOTE] המקרים האלה מכוסים בעמודים אחרים:

• האפליקציה כבר מוגדרת: ראו Use Claude Code Desktop לכל מה שלשונית Code יודעת לעשות.
• רוצים את הפקודה claude בטרמינל: מתקינים את ה-CLI בנפרד.
• משתמשים ב-Chat או ב-Cowork: ראו את מרכז העזרה של Claude.
• צריך עוד על התקנה או פריסה של אפליקציית שולחן העבודה: ראו את מאמרי התמיכה של Claude Desktop.

#התקנה

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

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

#לינוקס (בטא)

לפי Claude Desktop on Linux. למדריך היכולות ראו Use Claude Code Desktop. פותחים טרמינל ומריצים את הפקודות בכל שלב.

#דרישות

• הפצה מבוססת דביאן: אובונטו 22.04 ומעלה, או דביאן 12 ומעלה.
• x86_64 או arm64.

הפצות אחרות מבוססות דביאן שעומדות בדרישות האלה עשויות לעבוד, אבל הן לא נבדקו רשמית. בהפצות שאינן מבוססות דביאן, כמו Fedora או Arch, מריצים את ה-CLI. ב-Windows עם WSL 2 מתקינים את אפליקציית Windows ומריצים סשנים בתוך ההפצה. ראו Claude Code Desktop in WSL.

#דרישות Cowork

Cowork הוא הלשונית ל-Dispatch ולעבודה אגנטית ארוכה. בלינוקס המשימות רצות במכונה וירטואלית שהאפליקציה מארחת עם QEMU ו-KVM. כדי להשתמש ב-Cowork המחשב צריך:

• וירטואליזציית חומרה: מופעלת בהגדרות הקושחה. אם היא כבויה, לשונית Cowork מדווחת: Cowork requires hardware virtualization (KVM).
• QEMU וקושחת UEFI: ב-x86_64 החבילות qemu-system-x86, ovmf ו-virtiofsd. ב-arm64 החבילות qemu-system-arm, qemu-efi-aarch64 ו-virtiofsd. הפקודה apt install claude-desktop מתקינה אותן כברירת מחדל כחבילות מומלצות. אם התקנתם עם --no-install-recommends, או שהמערכת היא תמונה מינימלית שמדלגת על חבילות מומלצות, לשונית Cowork מדווחת Cowork requires QEMU ומציגה את פקודת apt install להרצה. באובונטו 22.04 אין חבילת virtiofsd, והאפליקציה משתמשת שם בעותק שמגיע איתה.
• גישה אל /dev/kvm: מוסיפים את המשתמש לקבוצה kvm:

sudo usermod -aG kvm $USER

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

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

#התקנה

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

1. הוספת מאגר ה-apt של Anthropic: השלב מוריד את מפתח החתימה עם curl ומאמת אותו עם gpg. התקנות טריות של דביאן ואובונטו עשויות שלא לכלול את שתי הפקודות. אם אחת מהן מדווחת command not found, מתקינים את שתיהן קודם:

sudo apt install curl gnupg

מורידים את מפתח החתימה של Anthropic:

sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc

הפקודה לא מדפיסה כלום כשהיא מצליחה, ומדפיסה שגיאת curl: כשהיא נכשלת. מפתח חסר או שגוי גורם ל-apt update להיכשל אחר כך עם NO_PUBKEY BAA929FF1A7ECACE. לפני שממשיכים מוודאים שהמפתח ירד ושייך ל-Anthropic:

gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc

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

רושמים את המאגר:

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

2. התקנת החבילה:

sudo apt update && sudo apt install claude-desktop

3. הפעלה והתחברות: מפעילים את Claude ממפעיל היישומים, או מריצים claude-desktop מטרמינל, ומתחברים עם חשבון Anthropic.

האפליקציה בלינוקס מתחברת כמו ב-macOS וב-Windows: עם מנוי claude.ai, או דרך ה-SSO של הארגון. לאימות באמצעות מפתח API משתמשים ב-CLI. כדי להשתמש ב-Desktop עם Amazon Bedrock, עם Agent Platform של Google Cloud, עם Microsoft Foundry, או עם שער LLM, ראו Claude Desktop on 3P. לשרתי proxy ולרשויות אישורים מותאמות בפריסות האלה, ראו network configuration.

#התקנה מקובץ שהורד

אם אי אפשר להתקין דרך מאגר ה-apt, מורידים את חבילת ה-.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, או כשאין חבילה לארכיטקטורה שלכם. מוודאים שהרשת מגיעה אל downloads.claude.ai, וש-dpkg --print-architecture מדפיס amd64 או arm64. המאגר לא מפרסם חבילות לארכיטקטורות אחרות.

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

אחר כך פותחים את הקובץ שירד במתקין התוכנות, למשל GNOME Software, או מתקינים אותו עם apt מתוך התיקייה שמכילה את הקובץ:

sudo apt install ./claude-desktop_*.deb

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

קובץ ה-.deb מכיל את מפתח החתימה של Anthropic ומתקין אותו בנתיב /usr/share/keyrings/claude-desktop-archive-keyring.asc, כך שאין צורך להוריד את המפתח ידנית. אלא אם כיביתם את הרישום באמצעות CLAUDE_DESKTOP_ADD_REPO, החבילה גם רושמת את מאגר ה-apt ב-/etc/apt/sources.list.d/claude-desktop.list, כך שעדכונים עתידיים מגיעים עם עדכוני החבילות הרגילים.

#עדכון

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

sudo apt update && sudo apt upgrade

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

#הסרה

sudo apt remove claude-desktop

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

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

#פתרון תקלות

#Unable to locate package claude-desktop

אם sudo apt install claude-desktop נכשל עם E: Unable to locate package claude-desktop, apt לא מצא את המאגר שהוספתם. בודקים את אלה:

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

אם המאגר במקום, נגיש, והחבילה עדיין לא נמצאת, מתקינים מקובץ שהורד.

#תלויות חסרות

אם apt נעצר עם The following packages have unmet dependencies או Unsatisfied dependencies, קוראים איזו תלות הוא מציין:

• libc6 (>= 2.34): ההפצה ישנה יותר ממה שהחבילה תומכת בו. אובונטו 20.04 מגיעה עם libc6 2.31. משדרגים לאובונטו 22.04 ומעלה, או לדביאן 12 ומעלה.
• כל התלויות החסרות מופיעות כ-not installable עם סיומת :amd64 או :arm64: הורדתם .deb לארכיטקטורה שונה מזו של המחשב. מריצים dpkg --print-architecture ומורידים את ה-.deb המתאים, או מתקינים ממאגר ה-apt, שבוחר את החבילה לארכיטקטורה שלכם.

#הרצה כ-root בלי --no-sandbox אינה נתמכת

אם claude-desktop יוצא עם ההודעה הזאת, הפעלתם אותו כ-root. נכנסים כמשתמש רגיל ומפעילים משם.

#פרטי ההתחברות לא יישמרו במכשיר זה

Claude Desktop שומר את פרטי ההתחברות ב-keyring של שולחן העבודה, כגון GNOME Keyring או KDE Wallet. אם אין גישה ל-keyring פתוח, פרטי ההתחברות אינם נשמרים ותצטרכו להתחבר מחדש בכל הפעלה של האפליקציה. בוחרים את המקרה המתאים למערכת שלכם:

• אין keyring מותקן, בשולחן עבודה שאינו KDE Plasma: אם התקנתם עם --no-install-recommends, או על תמונה מינימלית שמדלגת על חבילות מומלצות, apt לא התקין keyring. מתקינים את GNOME Keyring באמצעות sudo apt install gnome-keyring.
• KDE Plasma שבו מותקן גם GNOME Keyring: היישום KDE Wallet מגיע יחד עם שולחן העבודה של Plasma. שני ה-keyrings מתנגשים, ו-Claude Desktop עשוי להציג את ההודעה הזו אף על פי ש-KDE Wallet עובד. מסירים את המיותר באמצעות sudo apt remove gnome-keyring, ואז מפעילים מחדש את המחשב.
• Keyring מותקן אך נעול: פותחים את הנעילה שלו.

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

#Cowork אינו זמין

אם לשונית Cowork מציגה אחת מההודעות האלה, מתקנים את הדרישה שהיא מציינת, ואז מפעילים מחדש את האפליקציה:

• Cowork requires QEMU: מתקינים את חבילות ה-QEMU וקושחת ה-UEFI שההודעה מפרטת.
• Cowork requires hardware virtualization (KVM): מפעילים וירטואליזציית חומרה בהגדרות הקושחה.
• Claude doesn't have permission to use virtualization (/dev/kvm): מוסיפים את המשתמש לקבוצה kvm, ואז יוצאים מהחשבון ונכנסים מחדש.
• Cowork requires the vhost_vsock kernel module: מריצים sudo modprobe vhost_vsock, ואז מפעילים מחדש את האפליקציה. זה טוען את המודול רק לאתחול הנוכחי. כדי לטעון אותו בכל אתחול:

echo vhost_vsock | sudo tee /etc/modules-load.d/vhost_vsock.conf

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

• Computer Use: שליטה ביישום ובמסך אינה זמינה בלינוקס.
• Dictation: קלט קולי אינו זמין באפליקציית שולחן העבודה בלינוקס. משתמשים ב-voice dictation ב-CLI.
• קיצור המקשים הגלובלי Quick Entry: עובד ב-X11. ב-Wayland מקורי הוא דורש את פורטל GlobalShortcuts של סביבת שולחן העבודה.
• Fedora ו-RHEL: כרגע נתמכות רק הפצות מבוססות דביאן. תמיכה בהפצות נוספות צפויה בהמשך.

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

#התחלת הסשן הראשון

כשלשונית Code פתוחה, בוחרים פרויקט ונותנים לקלוד משימה.

1. בחירת סביבה ותיקייה: בשורה שמתחת לתיבת ההנחיה, לוחצים על הפקד הראשון, בורר הסביבה, ובוחרים את הרשומה העליונה בקבוצה Local. אחר כך לוחצים על פקד תיקיית הפרויקט שליד בורר הסביבה, בוחרים Open folder…, ובוחרים את תיקיית הפרויקט.

   אם סשן חדש אינו מציג סביבה מתחת לתיבת ההנחיה, זו הפריסה הקודמת. ראו Check which layout you have.

   [!TIP] כדאי להתחיל בפרויקט קטן שאתם מכירים היטב. זו הדרך המהירה ביותר לראות מה Claude Code יודע לעשות.

   אפשר לבחור גם:

   • Cloud: הרצת סשנים בענן שממשיכים גם אם סוגרים את האפליקציה. ראו Use Claude Code in the cloud לאופן שבו סשנים בענן עובדים.
   • SSH: חיבור למכונה מרוחקת דרך SSH, כגון שרתים משלכם, מכונות וירטואליות בענן, או dev containers. קודם מוסיפים חיבור. אפליקציית שולחן העבודה מתקינה את Claude Code במכונה המרוחקת באופן אוטומטי בהתחברות הראשונה. משימה שרצה יכולה להמשיך לפעול בזמן ש-Desktop מנותק, אבל עם חשבון Claude היא יכולה להיעצר כשתוקף ההתחברות פג.
   • WSL (ב-Windows): הרצת הסשן בתוך הפצת WSL 2. Claude Code, הכלים ו-git רצים בצד של לינוקס עם נתיבים מקוריים.

2. בחירת מודל: בוחרים מודל מבורר המודלים לקראת הקצה הימני של השורה שמתחת לתיבת ההנחיה. ראו models להשוואה בין המודלים הזמינים. אפשר להחליף מודל מאוחר יותר מאותו בורר מודלים.

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. כפתורים לאישור או לדחייה של כל שינוי.
   3. עדכונים בזמן אמת בזמן שקלוד עובד על הבקשה שלכם.

#ומה עכשיו

ביצעתם את העריכה הראשונה. למדריך המלא על כל מה ש-Desktop יודע לעשות, ראו Use Claude Code Desktop. הנה כמה דברים שכדאי לנסות בהמשך.

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

הוספת הקשר לקלוד. מקלידים @filename בתיבת ההנחיה כדי למשוך קובץ מסוים לשיחה. ככל שיש לקלוד יותר הקשר, כך התוצאות טובות יותר. ראו Add files and context.

שימוש במיומנויות למשימות שחוזרות על עצמן. מקלידים / או לוחצים על + ולאחר מכן על Slash commands כדי לעיין בפקודות מובנות, במיומנויות מותאמות אישית ובמיומנויות של תוספים. מיומנויות הן הנחיות לשימוש חוזר שאפשר להפעיל מתי שצריך, כמו רשימות תיוג לסקירת קוד או שלבי פריסה.

סקירת שינויים לפני commit. אחרי שקלוד עורך קבצים, מופיע מחוון +12 -1. לוחצים עליו כדי לפתוח את תצוגת ה-diff, לסקור שינויים קובץ אחר קובץ ולהשאיר הערות על שורות ספציפיות. קלוד קורא את ההערות ומתקן. כדי שקלוד יסקור את השינויים בעצמו, מקלידים /code-review בתיבת ההנחיה.

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

• Auto: מסווג סוקר פעולות ברקע וחוסם פעולות מסוכנות במקום לשאול אתכם.
• Manual: קלוד שואל לפני עריכת קבצים או הרצת פקודות.
• Accept edits: קלוד מאשר אוטומטית עריכות קבצים לסבבי עבודה מהירים יותר.
• Plan: קלוד מציע גישה בלי לערוך קבצים בכלל, מה ששימושי לפני refactor גדול.

הוספת תוספים ליכולות נוספות. מתקינים תוספים שמוסיפים מיומנויות, סוכנים, שרתי MCP ועוד.

סידור סביבת העבודה. גוררים את חלוניות הצ'אט, ה-diff, הטרמינל, הקבצים והדפדפן לכל פריסה שרוצים. פותחים את הטרמינל באמצעות Ctrl+` כדי להריץ פקודות לצד הסשן, או לוחצים על נתיב קובץ כדי לפתוח אותו בחלונית הקבצים. ראו Arrange your workspace.

תצוגה מקדימה של היישום. כשמריצים את שרת הפיתוח בתוך אפליקציית שולחן העבודה, היישום נפתח בחלונית הדפדפן, שיכולה גם לפתוח אתרים חיצוניים. קלוד יכול לצפות ביישום שרץ, לבדוק נקודות קצה (endpoints), לבחון יומנים (logs), ולבצע תיקונים לפי מה שהוא רואה. ראו Preview your app.

מעקב אחרי ה-Pull Request. אחרי פתיחת PR, Claude Code עוקב אחרי תוצאות בדיקות ה-CI ויכול לתקן אוטומטית כשלים. ראו Monitor pull request status.

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

התרחבות כשמוכנים. פותחים סשנים במקביל מסרגל הצד כדי לעבוד על כמה משימות בבת אחת, לפי בחירה כל אחד ב-Git worktree נפרד, ופותחים את חלונית המשימות כדי לעקוב אחרי סוכני משנה ופקודות רקע שהסשן מריץ. פותחים שיחת צד כדי לשאול שאלה בלי להסיט את השרשור הראשי. שולחים משימות ארוכות לענן כך שימשיכו לפעול גם אם סוגרים את האפליקציה, או מעבירים סשן שכבר התחלתם לענן אם משימה נמשכת זמן רב מהמצופה. מחברים כלים חיצוניים כמו GitHub, Slack ו-Linear כדי לאחד את סביבת העבודה.

#מה הלאה

• Use Claude Code Desktop: מצבי הרשאה, סשנים במקביל, תצוגת diff, חיבורים, והגדרה ארגונית.
• Coming from the CLI?: הרצת Desktop וה-CLI על אותו פרויקט, והשוואה של יכולות, מקבילות לדגלים, ומה שאינו זמין ב-Desktop.
• Troubleshooting: פתרונות לשגיאות נפוצות ולבעיות התקנה.
• Best practices: טיפים לכתיבת הנחיות יעילות ולהפקת המרב מ-Claude Code.
• Common workflows: מדריכים לניפוי שגיאות, refactor, בדיקות ועוד.