תיעוד 3

Claude Desktop בלינוקס (בטא)

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

[!NOTE]

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

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

#דרישות

הפצה מבוססת Debian: Ubuntu 22.04 ומעלה, או Debian 12 ומעלה
x86_64 או arm64

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

#דרישות Cowork

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

וירטואליזציית חומרה: מופעלת בהגדרות הקושחה. בלעדיה, Cowork מדווח "Cowork requires hardware virtualization (KVM)".
QEMU וקושחת 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 כדי שעדכונים יגיעו דרך עדכוני החבילות הרגילים של המערכת. פתחו טרמינל והריצו את הפקודות בכל שלב.

1. הוספת מאגר 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

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. עבור שרתי פרוקסי ורשויות אישורים מותאמות בפריסות האלה, ראו network configuration.

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

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

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

#Unmet dependencies

אם 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. התחברו כמשתמש רגיל והפעילו אותו משם.

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

אין מחזיק מפתחות מותקן, בשולחן עבודה שאינו KDE Plasma: אם התקנתם עם --no-install-recommends, או בתמונה מינימלית שמדלגת על חבילות מומלצות, apt לא התקין מחזיק מפתחות. התקינו את GNOME Keyring עם sudo apt install gnome-keyring.
KDE Plasma עם GNOME Keyring מותקן גם הוא: KDE Wallet מגיע עם שולחן העבודה Plasma. שני מחזיקי המפתחות מתנגשים, ו-Claude Desktop יכול להציג את ההודעה הזו אף על פי ש-KDE Wallet עובד. הסירו את המיותר עם sudo apt remove gnome-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 global hotkey: עובד ב-X11. ב-Wayland מקורי נדרש פורטל GlobalShortcuts של סביבת שולחן העבודה.
Fedora ו-RHEL: רק הפצות מבוססות Debian נתמכות כיום. תמיכה בהפצות נוספות תגיע בעתיד.

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