Claude Desktop di Linux (beta)

Instal dan perbarui aplikasi desktop Claude di Ubuntu dan Debian

Aplikasi desktop di Linux memberikan Anda pengalaman Chat, Cowork, dan Claude Code yang sama seperti di macOS dan Windows: sesi paralel, tinjauan diff visual, terminal dan editor terintegrasi, dan pratinjau aplikasi langsung. Lihat Gunakan Claude Code Desktop untuk referensi fitur.

Persyaratan

• Distribusi berbasis Debian: Ubuntu 22.04 atau lebih baru, atau Debian 12 atau lebih baru
• x86_64 atau arm64

Distribusi berbasis Debian lainnya yang memenuhi persyaratan ini mungkin berfungsi tetapi tidak diuji secara resmi. Pada distribusi yang bukan berbasis Debian, seperti Fedora atau Arch, jalankan CLI sebagai gantinya. Jika Anda bekerja di Windows dengan WSL 2, instal aplikasi desktop Windows dan jalankan sesi di dalam distribusi Anda; lihat Claude Code Desktop di WSL.

Persyaratan Cowork

Cowork adalah tab desktop untuk Dispatch dan pekerjaan agentic yang lebih lama. Di Linux, Cowork menjalankan tugas-tugas tersebut di mesin virtual yang dihosting oleh aplikasi desktop dengan QEMU dan KVM. Untuk menggunakan Cowork, mesin Anda memerlukan:

• Virtualisasi hardware: diaktifkan dalam pengaturan firmware Anda. Tanpa itu, tab Cowork melaporkan "Cowork requires hardware virtualization (KVM)".
• QEMU dan firmware UEFI: qemu-system-x86, ovmf, dan virtiofsd pada x86_64, atau qemu-system-arm, qemu-efi-aarch64, dan virtiofsd pada arm64. apt install claude-desktop menginstalnya secara default sebagai paket yang direkomendasikan. Jika Anda menginstal dengan --no-install-recommends, atau sistem Anda adalah gambar minimal yang melewatkan paket yang direkomendasikan, tab Cowork melaporkan "Cowork requires QEMU" dan menampilkan perintah apt install untuk dijalankan. Ubuntu 22.04 tidak memiliki paket virtiofsd; aplikasi menggunakan salinan bundel di sana.
• Akses ke /dev/kvm: tambahkan pengguna Anda ke grup kvm dengan sudo usermod -aG kvm $USER, kemudian keluar dan masuk kembali. Beberapa lingkungan desktop memberikan akses pengguna yang masuk ke /dev/kvm tanpa grup, tetapi Cowork juga memerlukan /dev/vhost-vsock, yang hanya dapat dibuka oleh anggota grup kvm. Bergabunglah dengan grup bahkan jika /dev/kvm sudah berfungsi untuk Anda.

Aplikasi memeriksa persyaratan ini sekali saat peluncuran: mulai ulang setelah menginstal paket, dan keluar serta masuk kembali setelah bergabung dengan grup. Jika /dev/vhost-vsock hilang dan kernel yang sedang berjalan tidak memiliki direktori modul di bawah /lib/modules, tab Cowork melaporkan bahwa kernel tidak menyertakan dukungan virtualisasi yang Cowork butuhkan dan bahwa itu tidak dapat ditambahkan secara manual. Kombinasi ini umum di ChromeOS dan di lingkungan Linux berbasis kontainer.

Instal

Instal dari repositori apt Anthropic sehingga pembaruan tiba melalui pembaruan paket reguler sistem Anda. Buka terminal dan jalankan perintah di setiap langkah.

sudo apt install curl gnupg

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

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

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

Instal dari file yang diunduh

Jika Anda tidak dapat menginstal melalui repositori apt, unduh paket .deb secara langsung dari kumpulan paket repositori. Perintah ini mencari paket terbaru untuk arsitektur Anda di indeks repositori, kemudian mengunduhnya ke direktori saat ini:

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)"

Jika perintah gagal dengan Remote file name has no length, pencarian mengembalikan tidak ada jalur paket. Ini dapat berarti indeks repositori tidak dapat diambil, misalnya ketika jaringan Anda memblokir downloads.claude.ai, atau bahwa tidak ada paket yang ada untuk arsitektur Anda. Konfirmasi bahwa jaringan Anda dapat menjangkau downloads.claude.ai dan bahwa dpkg --print-architecture mencetak amd64 atau arm64; repositori tidak menerbitkan paket untuk arsitektur lain.

Untuk menginstal tanpa mendaftarkan repositori apt Anthropic, pertama buat /etc/default/claude-desktop dengan baris CLAUDE_DESKTOP_ADD_REPO="false". Tanpa repositori, apt tidak mengirimkan versi baru; untuk memperbarui, jalankan kembali perintah unduh dan instal ulang, atau daftarkan repositori nanti.

Kemudian buka file yang diunduh dengan penginstal perangkat lunak Anda, seperti GNOME Software, atau instal dengan apt dari direktori yang berisi file yang diunduh:

sudo apt install ./claude-desktop_*.deb

Jika apt melaporkan E: Unsupported file ./claude-desktop_*.deb given on commandline, pola tidak cocok dengan file .deb di direktori saat ini. Konfirmasi bahwa unduhan selesai, kemudian jalankan perintah lagi dari direktori yang berisi file tersebut.

Menginstal .deb juga mendaftarkan repositori apt Anthropic di /etc/apt/sources.list.d/claude-desktop.list, jadi pembaruan di masa depan tiba dengan pembaruan paket reguler sistem Anda.

Perbarui

Aplikasi desktop tidak memperbarui dirinya sendiri di Linux. Pembaruan tiba dengan pembaruan paket reguler sistem Anda:

sudo apt update && sudo apt upgrade

Pembarui perangkat lunak grafis distribusi Anda juga akan mengambil versi baru.

Copot

sudo apt remove claude-desktop

Mencopot paket juga menghapus entri repositori dan kunci penandatanganan yang didaftarkannya. Jika Anda menambahkan entri repositori sendiri dengan langkah Tambahkan repositori apt Anthropic, hapus juga:

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

Troubleshooting

Tidak dapat menemukan paket claude-desktop

Jika sudo apt install claude-desktop gagal dengan E: Unable to locate package claude-desktop, apt tidak menemukan repositori yang Anda tambahkan. Periksa hal berikut:

• Jalankan sudo apt update setelah menambahkan repositori. apt install sendiri tidak melihat repositori yang Anda tambahkan setelah terakhir kali Anda menjalankan apt update.
• Konfirmasi entri repositori telah ditulis. cat /etc/apt/sources.list.d/claude-desktop.list harus menampilkan baris deb dari langkah Add Anthropic's apt repository. Jika file kosong atau hilang, jalankan langkah itu lagi.
• Konfirmasi arsitektur Anda didukung. dpkg --print-architecture harus mencetak amd64 atau arm64. Repositori tidak menerbitkan paket untuk arsitektur lain.
• Jalankan sudo apt update lagi dan periksa outputnya untuk kesalahan yang terkait dengan downloads.claude.ai. Kesalahan jaringan atau kunci di sana berarti repositori ditambahkan tetapi tidak dapat dijangkau atau diverifikasi.

Jika repositori sudah ada dan dapat dijangkau dan paket masih tidak ditemukan, install dari file yang diunduh sebagai gantinya.

Dependensi yang tidak terpenuhi

Jika apt berhenti dengan The following packages have unmet dependencies atau Unsatisfied dependencies, baca dependensi mana yang dinamainya:

• libc6 (>= 2.34): distribusi Anda lebih lama daripada yang didukung paket. Ubuntu 20.04 mengirimkan libc6 2.31. Tingkatkan ke Ubuntu 22.04 atau lebih baru, atau Debian 12 atau lebih baru.
• Semua dependensi yang hilang menampilkan not installable dengan akhiran :amd64 atau :arm64: Anda mengunduh .deb untuk arsitektur yang berbeda dari mesin Anda. Jalankan dpkg --print-architecture dan unduh .deb yang cocok, atau install dari repositori apt, yang memilih paket untuk arsitektur Anda.

Menjalankan sebagai root tanpa --no-sandbox tidak didukung

Jika claude-desktop keluar dengan pesan ini, Anda meluncurkannya sebagai root. Masuk sebagai pengguna biasa dan luncurkan dari sana.

Cowork tidak tersedia

Jika tab Cowork menampilkan salah satu pesan ini, perbaiki persyaratan yang dinamainya, kemudian mulai ulang aplikasi:

• Cowork memerlukan QEMU: instal paket QEMU dan UEFI firmware yang tercantum dalam pesan.
• Cowork memerlukan virtualisasi hardware (KVM): aktifkan virtualisasi hardware di pengaturan firmware Anda.
• Claude tidak memiliki izin untuk menggunakan virtualisasi (/dev/kvm): tambahkan pengguna Anda ke grup kvm, kemudian keluar dan masuk kembali.
• Cowork memerlukan modul kernel vhost_vsock: jalankan sudo modprobe vhost_vsock, kemudian mulai ulang aplikasi. Itu memuat modul hanya untuk boot saat ini. Untuk memuatnya di setiap boot, jalankan echo vhost_vsock | sudo tee /etc/modules-load.d/vhost_vsock.conf.

Apa yang belum ada di beta Linux

• Computer Use: kontrol aplikasi dan layar tidak tersedia di Linux.
• Dictation: input suara tidak tersedia di aplikasi desktop Linux. Gunakan dictation suara di CLI sebagai gantinya.
• Quick Entry global hotkey: berfungsi di X11. Di Wayland asli, ini memerlukan portal GlobalShortcuts lingkungan desktop Anda.
• Fedora dan RHEL: hanya distribusi berbasis Debian yang didukung hari ini. Dukungan untuk distribusi tambahan akan datang di masa depan.

Untuk apa pun yang belum tersedia di aplikasi desktop, CLI menjalankan mesin Claude Code yang sama dan mendukung berbagai distribusi Linux yang lebih luas; lihat persyaratan sistem.