תיעוד 3

קלוד דסקטופ בלינוקס (בטא)

התקנה ועדכון של אפליקציית הדסקטופ של Claude ב-Ubuntu וב-Debian

תמיכת לינוקס באפליקציית הדסקטופ של Claude נמצאת בבטא.

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

#דרישות

Ubuntu 22.04 ואילך, או Debian 12 ואילך
x86_64 או arm64

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

#דרישות Cowork

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

וירטואליזציית חומרה: מופעלת בהגדרות ה-firmware. בלעדיה, לשונית Cowork מדווחת Cowork requires hardware virtualization (KVM).
QEMU ו-firmware של UEFI: qemu-system-x86, ovmf ו-virtiofsd ב-x86_64, או qemu-system-arm, qemu-efi-aarch64 ו-virtiofsd ב-arm64. apt install claude-desktop מתקין אותם כברירת מחדל כחבילות מומלצות. אם התקנתם עם --no-install-recommends, או שהמערכת שלכם היא תמונה מינימלית שמדלגת על חבילות מומלצות, לשונית Cowork מדווחת Cowork requires QEMU ומציגה את פקודת apt install שיש להריץ. ב-Ubuntu 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 כדי שהעדכונים יגיעו דרך עדכוני החבילות הרגילים של המערכת. פתחו טרמינל והריצו את הפקודות בכל שלב.

#הוספת מאגר apt של Anthropic

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

#התקנת החבילה

sudo apt update && sudo apt install claude-desktop

#הפעלה והתחברות

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

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

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

אם אי אפשר להתקין דרך מאגר apt, הורידו את חבילת .deb ישירות מ-package pool של המאגר. הפקודה הזו מחפשת את החבילה החדשה ביותר לארכיטקטורה שלכם באינדקס המאגר, ואז מורידה אותה לספרייה הנוכחית:

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

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

#תלויות שלא מולאו

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

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

#Running as root without --no-sandbox is not supported

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

#Cowork לא זמין

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

Cowork requires QEMU: התקינו את חבילות QEMU ו-firmware של UEFI שההודעה מציגה.
Cowork requires hardware virtualization (KVM): הפעילו וירטואליזציית חומרה בהגדרות ה-firmware.
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: קלט קולי לא זמין באפליקציית הדסקטופ ללינוקס. השתמשו בהכתבה קולית ב-CLI במקום זאת.
קיצור מקשים גלובלי של Quick Entry: עובד ב-X11. ב-Wayland מקורי הוא דורש את פורטל GlobalShortcuts של סביבת שולחן העבודה.
Fedora ו-RHEL: כיום נתמכות רק הפצות מבוססות Debian. תמיכה בהפצות נוספות תגיע בעתיד.

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