Claude di Linux: Aplikasi Desktop dan CLI

Bagian mana dari Claude yang saat ini berjalan secara native di Linux

Claude di Linux berjalan melalui empat antarmuka terpisah, dan per Agustus 2026 semuanya dapat digunakan pada mesin Ubuntu atau Debian biasa. Aplikasi desktop diinstal dari repositori apt milik Anthropic dan masih dalam tahap beta. Claude Code CLI (antarmuka baris perintah) adalah binary terkompilasi dan dapat berjalan pada lebih banyak distribusi daripada aplikasi desktop. Aplikasi web di claude.ai hanya memerlukan browser, sedangkan API adalah endpoint HTTPS yang Anda panggil dari kode Anda sendiri.

Dua fitur yang tersedia di macOS dan Windows belum tersedia dalam versi beta desktop Linux: Computer Use, yang memungkinkan Claude mengendalikan aplikasi pada layar Anda, dan dikte suara. Anthropic mendokumentasikan bahwa keduanya belum tersedia di Linux. CLI memiliki fitur dikte suara sendiri, sehingga keterbatasan ini terdapat pada aplikasi desktop, bukan pada Claude secara keseluruhan.

Ketersediaan dapat berubah. Karena itu, anggap halaman ini sebagai penjelasan tentang berbagai antarmuka, lalu periksa status terbaru sebelum menjadikannya dasar perencanaan. Bagian terakhir mencantumkan halaman yang perlu diperiksa.

Instal aplikasi desktop Claude pada Ubuntu atau Debian

Persyaratan yang didokumentasikan adalah Ubuntu 22.04 atau yang lebih baru, atau Debian 12 atau yang lebih baru, pada x86_64 (yang oleh dpkg disebut amd64) atau arm64. Distribusi berbasis Debian lainnya mungkin dapat digunakan, tetapi belum diuji. Fedora dan RHEL belum memiliki paket, jadi pada sistem tersebut gunakan CLI atau browser.

Instal dari repositori apt, bukan dari file .deb yang diunduh. Aplikasi Linux tidak memiliki updater sendiri, sehingga versi baru hanya tersedia melalui package manager. Mendaftarkan repositori membuat apt upgrade dapat menemukannya.

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

gpg --show-keys seharusnya menampilkan fingerprint 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Bandingkan fingerprint tersebut sebelum mendaftarkan repositori, karena signing key yang belum Anda periksa berarti Anda mempercayainya tanpa verifikasi. Jika gpg melaporkan bahwa file tersebut tidak berisi data OpenPGP yang valid, pengunduhan gagal. Akibatnya, apt update akan gagal kemudian dengan NO_PUBKEY BAA929FF1A7ECACE.

Mendaftarkan repositori berarti menulis satu baris deb ke /etc/apt/sources.list.d/claude-desktop.list. Salin baris tersebut dari halaman instalasi Linux Anthropic, code.claude.com/docs/en/desktop-linux, persis seperti yang tercantum di sana. Alamat repositori adalah bagian dari prosedur ini yang paling mungkin berubah. Baris yang diketik berdasarkan ingatan dapat membuat Anda melihat E: Unable to locate package claude-desktop setelahnya. Baca baris tersebut sebelum menempelkannya: arch=amd64,arm64 adalah alasan apt pada arsitektur lain tidak menemukan apa pun, sedangkan signed-by= menunjuk ke file keyring yang baru saja Anda periksa. Pengaturan ini membatasi key tersebut hanya untuk repositori ini, bukan mempercayainya untuk semua hal lain yang dibaca apt.

sudo apt update && sudo apt install claude-desktop

Jalankan aplikasi dari application launcher, atau jalankan claude-desktop di terminal. Masuk dengan akun claude.ai Anda, atau melalui SSO (single sign-on) organisasi jika perusahaan Anda telah menyiapkannya. Aplikasi desktop tidak menerima Claude Console API key. Autentikasi berbasis key adalah fitur CLI.

E: Unable to locate package claude-desktop berarti apt tidak pernah membaca repositori tersebut. cat /etc/apt/sources.list.d/claude-desktop.list seharusnya menampilkan baris deb yang Anda tulis, sedangkan dpkg --print-architecture seharusnya mencetak amd64 atau arm64, karena tidak ada paket yang dipublikasikan untuk arsitektur lain. Pembaruan kemudian tersedia bersama pembaruan sistem lainnya, dari sudo apt update && sudo apt upgrade.

Yang hanya tersedia di browser

claude.ai berfungsi di browser apa pun yang masih didukung pada distribusi apa pun. Karena itu, claude.ai menjadi pilihan untuk Fedora, RHEL, Arch, openSUSE, dan distribusi lain yang tidak memiliki paket. Browser juga menyediakan Claude Code di web. Sesi berjalan di cloud Anthropic, bukan di komputer Anda. Sesi tersebut selalu menggunakan kredensial langganan Anda.

Batasan browser adalah hal penting yang perlu dipahami. Sesi cloud tidak dapat membaca file di server Anda atau menjalankan perintah di server tersebut. Semua tindakan yang mengakses komputer Anda memerlukan software pada komputer itu. Artinya, Anda harus menggunakan CLI atau aplikasi desktop.

Hal yang disediakan CLI, tetapi tidak disediakan aplikasi web

Jalankan claude dalam sebuah direktori, dan CLI akan bekerja pada direktori tersebut. Itulah perbedaannya, dan hal-hal lainnya mengikuti dari sana.

• CLI membaca dan mengedit file dalam direktori kerja Anda, lalu menampilkan setiap perubahan sebelum menerapkannya.
• CLI menjalankan perintah shell yang Anda setujui. Dengan demikian, CLI dapat membangun proyek, menjalankan rangkaian pengujian, membaca log, atau memeriksa service langsung pada server.
• CLI dapat berjalan tanpa sesi interaktif: claude -p "read the nginx error log and summarise it" menampilkan satu jawaban lalu keluar. Inilah yang digunakan dari cron job atau pipeline.
• CLI menghubungkan server MCP (model context protocol) dengan claude mcp add. Dengan demikian, model memperoleh tool di luar filesystem.
• CLI dapat berjalan tanpa desktop grafis sama sekali. Kondisi ini berlaku untuk setiap VPS (virtual private server) yang Anda sewa.

Poin terakhir itulah alasan panduan server membahas CLI. Server sewaan menyediakan SSH (secure shell) dan tidak menyediakan hal lain, sehingga terminal adalah satu-satunya antarmuka yang dapat digunakan bersama Anda. Cara menjalankannya memiliki aturan tersendiri. Penjelasan lengkapnya terdapat dalam menjalankan Claude Code pada VPS di dalam tmux, sedangkan menggunakan Claude untuk pekerjaan sysadmin sehari-hari membahas pekerjaan yang layak diserahkan kepadanya.

Integrasi editor berada di antara keduanya. Ekstensi VS Code memerlukan VS Code 1.94.0 atau yang lebih baru dan menyediakan panel grafis di dalam editor, lengkap dengan diff dan peninjauan rencana. Ekstensi tersebut menyertakan salinan privat CLI untuk panel itu dan tidak menambahkan claude ke PATH Anda. Karena itu, pengetikan claude di terminal terintegrasi tetap memerlukan instalasi mandiri. Editor yang dibuat berdasarkan VS Code memasang ekstensi yang sama dari registry Open VSX. Plugin JetBrains juga tersedia.

Apakah Anda memerlukan Node.js untuk menjalankan Claude Code di Linux?

Tidak jika menggunakan metode instalasi yang direkomendasikan. Pemasang native mengunduh binary terkompilasi, dan binary tersebut tidak berjalan di Node.js.

curl -fsSL https://claude.ai/install.sh | bash
claude --version

claude --version seharusnya menampilkan nomor versi seperti 2.1.211 (Claude Code). Jika hasilnya tidak sesuai, jalankan claude doctor. Perintah ini menampilkan diagnostik hanya-baca tentang instalasi dan file pengaturan Anda tanpa memulai sesi.

Node.js hanya diperlukan untuk metode npm. Mulai versi paket 2.1.198, paket npm memerlukan Node.js 22 atau yang lebih baru. Pada Node.js versi lama, npm menampilkan peringatan EBADENGINE, bukan mengalami kegagalan. Paket tersebut mengambil binary native yang sama sebagai dependensi khusus platform, lalu menautkannya ke lokasi yang sesuai.

npm install -g @anthropic-ai/claude-code

Jangan menjalankan perintah tersebut dengan sudo. Dokumentasi memperingatkan agar tidak menggunakan sudo npm install -g karena tindakan itu membuat file milik root di awalan npm global. Akibatnya, instalasi atau pembaruan berikutnya oleh pengguna tanpa hak istimewa gagal karena masalah izin. Jika direktori global npm tidak dapat ditulisi, pembaruan otomatis di latar belakang berhenti bekerja, dan claude doctor mencantumkan solusinya.

Anthropic juga menerbitkan repositori paket bertanda tangan untuk Debian, Fedora, RHEL, dan Alpine. Dengan demikian, sudo apt install claude-code bekerja hampir sama seperti paket desktop, dengan kunci penandatanganannya sendiri di https://downloads.claude.ai/keys/claude-code.asc.

Instalasi per pengguna atau untuk seluruh sistem?

Installer native melakukan instalasi per pengguna. Installer ini menempatkan launcher di ~/.local/bin/claude sebagai symlink ke ~/.local/share/claude/versions/, tidak memerlukan root, dan memperbarui dirinya di latar belakang. Setiap pengguna pada mesin tersebut memperoleh salinan terpisah dengan versi yang dapat berbeda.

Instalasi melalui package manager berlaku untuk seluruh sistem. Satu binary digunakan oleh semua pengguna, memerlukan root, dan tidak diperbarui otomatis melalui Claude Code. Anda memperbaruinya dengan sudo apt update && sudo apt upgrade claude-code, yaitu perintah yang sama dengan yang sudah Anda gunakan untuk berbagai kebutuhan lain pada server.

Pilih instalasi per pengguna pada mesin yang Anda akses sebagai akun sendiri. Pilihan ini cocok untuk sebagian besar pekerjaan VPS. Pilih instalasi melalui package manager pada server bersama atau machine image jika Anda ingin semua pengguna memakai satu versi dan ingin memperbaruinya sesuai jadwal Anda. Pada instalasi native, dua pengaturan di ~/.claude/settings.json menentukan perilaku pembaruan:

{
  "autoUpdatesChannel": "stable",
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Channel stable mengikuti rilis yang umurnya kira-kira satu minggu dan melewati rilis yang mengalami regresi besar. DISABLE_AUTOUPDATER hanya menghentikan pemeriksaan di latar belakang. Dengan demikian, claude update tetap berfungsi dan Anda tetap dapat menentukan kapan versi baru diterapkan. Hal ini penting pada server yang menjalankan pekerjaan lama tanpa pengawasan, ketika Anda tidak ingin binary berubah saat pekerjaan tersebut sedang berjalan.

Masuk melalui SSH dan pertahankan sesi tetap aktif

Saat pertama kali menjalankan CLI pada server sewaan, muncul dua masalah khusus Linux. Alur login memerlukan browser, sedangkan server tidak memilikinya. Jika koneksi SSH terputus, pekerjaan yang sedang berjalan juga ikut berhenti.

tmux mengatasi masalah kedua. Sesi tmux berada pada server tmux di mesin jarak jauh, bukan pada koneksi Anda. Karena itu, proses tetap berjalan ketika koneksi terputus.

tmux new -s claude
claude

Lepaskan sesi dengan Ctrl-b lalu d, dan kembali lagi nanti dengan tmux attach -t claude.

Login adalah masalah pertama. Jalankan claude untuk menampilkan URL autorisasi. Buka URL tersebut di browser pada komputer Anda sendiri. Setelah Anda masuk, browser menampilkan kode login, bukan mengarahkan kembali ke aplikasi, karena browser pada laptop Anda tidak dapat menjangkau server callback yang dijalankan Claude Code pada alamat loopback mesin jarak jauh. Tempelkan kode tersebut ke terminal pada prompt Paste code here if prompted. Terminal kemudian menampilkan Login successful.

Untuk sesi yang harus dimulai tanpa pemantauan langsung, claude setup-token membuka autorisasi browser yang sama dan menampilkan token OAuth dengan masa berlaku satu tahun pada terminal. Token tersebut tidak disimpan di mana pun. Salin token itu dan tetapkan di lokasi yang diperlukan.

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Token tersebut memerlukan paket berbayar dan hanya dapat digunakan untuk membuat permintaan model. Perlakukan token itu seperti kata sandi dengan masa berlaku satu tahun. Cara menyimpannya dan mencegah agent membacanya kembali dibahas dalam menjaga rahasia agar tidak dapat dijangkau agent AI.

Server kecil menghadapi satu kendala lagi. Instalasi memerlukan sekitar 512 MB memori bebas, sedangkan persyaratan perangkat keras yang terdokumentasi untuk menjalankannya adalah RAM 4 GB atau lebih. Karena itu, pada instance 1 GB, kernel out-of-memory killer menghentikan instalasi:

Setting up Claude Code...
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

Tambahkan swap, lalu jalankan kembali installer. Swap adalah ruang disk yang digunakan kernel sebagai memori cadangan. Swap jauh lebih lambat daripada RAM, tetapi cukup untuk menyelesaikan instalasi.

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

swapon mengaktifkan file tersebut hanya untuk boot ini. Tambahkan baris untuk /swapfile ke /etc/fstab jika ingin swap aktif kembali setelah reboot. Hal lain yang perlu diamankan sebelum mengizinkan agent menjalankan perintah pada server live dibahas dalam menjalankan Claude Code dengan aman pada VPS.

Lokasi kredensial Claude di Linux

Di Linux, /login menulis kredensial ke ~/.claude/.credentials.json dengan mode file 0600. macOS menyimpan kredensial yang sama di Keychain terenkripsi, sehingga kebiasaan yang Anda bentuk di Mac tidak berlaku di Linux: di Linux, token tersebut berupa file biasa di direktori home Anda, dan setiap proses yang berjalan sebagai pengguna Anda dapat membacanya. Mengatur CLAUDE_CONFIG_DIR memindahkan file tersebut ke dalam direktori itu.

Ada dua konsekuensi. Cadangan /home berisi login yang masih aktif, sehingga menyalin cadangan itu ke mesin bersama memberikan akses ke akun Anda kepada siapa pun yang juga dapat membacanya. Selain itu, image mesin yang dibuat dari komputer tempat Anda login akan menyertakan login tersebut pada setiap instance yang dibuat dari image itu. Jalankan /logout sebelum membuat snapshot apa pun.

Urutan prioritas kredensial sering membingungkan pengguna yang memiliki subscription dan API key secara bersamaan. Jika ANTHROPIC_API_KEY diatur di shell, Claude Code akan menggunakannya setelah Anda menyetujuinya. Subscription Anda tidak digunakan, sedangkan API key akan dikenai biaya per token. /status menampilkan kredensial yang aktif, dan unset ANTHROPIC_API_KEY mengembalikan Anda ke login subscription.

Login memiliki masa berlaku. Dalam tiga hari sebelum masa berlaku berakhir, baris saat startup menampilkan Your login expires in 3 days. Peringatan tersebut tidak pernah menghentikan request. Setelah masa berlaku berakhir, setiap request gagal dengan Login expired · Please run /login. Ketahui hal ini sebelum membiarkan session tanpa pengawasan berjalan sepanjang akhir pekan, karena session tersebut akan berhenti membuat kemajuan dan tidak dapat pulih sendiri.

Apakah satu langganan Claude mencakup semuanya?

Satu paket berbayar mencakup semua antarmuka dengan login yang sama. Akun Pro, Max, Team, atau Enterprise dapat digunakan untuk login ke claude.ai melalui browser, aplikasi desktop, CLI, dan ekstensi VS Code. Semuanya menggunakan langganan yang sama. Kuota penggunaan juga sama untuk semuanya. Jadi, eksekusi CLI yang lama di server mengurangi sisa kuota aplikasi desktop. Jika salah satu antarmuka mulai menolak pekerjaan, batas penggunaan yang tercapai dan tindakan yang perlu dilakukan adalah hal yang harus diperiksa. Paket claude.ai gratis tidak mencakup akses Claude Code. Karena itu, CLI dan fitur Claude Code pada aplikasi desktop memerlukan paket berbayar atau akun Claude Console.

API adalah produk yang berbeda dengan penagihan yang berbeda. Akun Console ditagih berdasarkan token yang benar-benar Anda kirim. Model ini sesuai untuk layanan yang Anda bangun, bukan untuk penggunaan interaktif melalui terminal. Menetapkan ANTHROPIC_API_KEY memindahkan CLI ke skema penagihan tersebut. Ini adalah pilihan yang Anda buat, bukan mekanisme cadangan.

Harga dan batas paket terlalu sering berubah untuk dicantumkan kembali di sini. Dua halaman berikut melacak angka terbaru: biaya penggunaan Claude Code yang sebenarnya dan paket Claude yang Anda perlukan. Jika Anda membandingkan penagihan berdasarkan token dengan paket bulanan, perbandingan API dengan langganan menjelaskan titik impasnya.

Error instalasi yang akan Anda temui

bash: claude: command not found tepat setelah instalasi berhasil. Binary berada di ~/.local/bin/claude, tetapi direktori tersebut tidak ada dalam search path shell Anda. Konfirmasikan dengan echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin". Perintah ini tidak mencetak apa pun jika entri tersebut tidak ada. Perbaiki untuk bash dengan echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc, lalu jalankan source ~/.bashrc. Menginstal ekstensi VS Code saja tidak pernah membuat file tersebut karena ekstensi menyimpan salinan CLI di dalam direktori ekstensi.

Error loading shared library libstdc++.so.6. Installer memilih build musl untuk sistem glibc. Hal ini terjadi ketika paket cross-compilation musl tersedia dan proses deteksi salah membacanya. Jalankan ldd --version 2>&1 | head -1: penamaan output GNU libc atau GLIBC berarti Anda menggunakan glibc dan menerima binary yang salah. Hapus instalasi tersebut, lalu jalankan kembali installer. Pada Alpine dan sistem musl lainnya, perbaikannya justru sebaliknya, yaitu apk add libgcc libstdc++ ripgrep.

Dua salinan claude pada satu mesin. which -a claude mencantumkan setiap kecocokan dalam PATH Anda. Instalasi native berupa symlink dari ~/.local/bin/claude ke ~/.local/share/claude/versions/, instalasi npm lokal lama berada di bawah ~/.claude/local/, dan npm -g ls @anthropic-ai/claude-code menampilkan instalasi npm global. Hapus salinan yang tidak diinginkan karena salinan lama yang berada lebih awal dalam PATH membuat bug yang sudah diperbaiki terlihat seolah-olah belum diperbaiki.

Tempat memeriksa status saat ini

• Status desktop Linux, persyaratan, dan perintah instalasi: code.claude.com/docs/en/desktop-linux
• Distribusi yang didukung dan semua metode instalasi untuk CLI: code.claude.com/docs/en/setup
• Platform yang menyediakan aplikasi untuk diunduh: claude.com/download
• Isi setiap paket dan harganya: claude.com/pricing

Setiap nomor versi dan tanggal dalam panduan ini merupakan gambaran pada August 2026. Struktur umumnya tetap sama: empat antarmuka, satu login untuk layanan berbayar, dan satu keputusan tentang apakah CLI akan digunakan oleh pengguna Anda atau oleh seluruh mesin.

FAQ

Apakah ada aplikasi desktop Claude untuk Linux?

Ya. Per Agustus 2026, aplikasi ini masih dalam versi beta dan mendukung Ubuntu 22.04 atau yang lebih baru serta Debian 12 atau yang lebih baru pada amd64 atau arm64. Instal aplikasi dengan sudo apt install claude-desktop setelah menambahkan repositori apt Anthropic dan signing key-nya agar versi baru diterima melalui pembaruan sistem biasa. Build Linux memiliki tab yang sama seperti aplikasi macOS, termasuk tab Claude Code. Computer Use dan dikte suara belum tersedia pada build Linux. Fedora dan RHEL juga belum memiliki paket, sehingga pada distribusi tersebut gunakan CLI atau claude.ai di browser.

Apakah saya memerlukan Node.js untuk menjalankan Claude Code di Linux?

Tidak untuk instalasi yang direkomendasikan. curl -fsSL https://claude.ai/install.sh | bash mengunduh binary terkompilasi yang tidak menggunakan Node.js saat runtime. Node.js hanya diperlukan jika Anda menginstal paket npm, yang meminta Node.js 22 atau yang lebih baru pada version 2.1.198. Pada Node.js versi lama, npm menampilkan peringatan EBADENGINE, tetapi instalasi tetap selesai karena binary native yang sama diambil sebagai dependensi per-platform. Jangan menginstalnya dengan sudo npm install -g karena perintah tersebut membuat file yang dimiliki root di npm prefix dan mengganggu pembaruan berikutnya.

Bagaimana cara login ke Claude Code melalui SSH?

Jalankan claude. Perintah tersebut menampilkan URL otorisasi. Buka URL itu di browser pada komputer Anda sendiri, bukan di server. Setelah login, browser menampilkan kode login, bukan melakukan redirect, karena browser tidak dapat menjangkau listener callback yang dimulai Claude Code pada alamat loopback mesin remote. Tempelkan kode tersebut pada prompt Paste code here if prompted. Untuk sesi yang dimulai tanpa pengguna yang hadir, jalankan claude setup-token dan tetapkan token yang ditampilkan sebagai CLAUDE_CODE_OAUTH_TOKEN di setiap tempat yang memerlukannya.

Di mana Claude Code menyimpan login saya di Linux?

Di ~/.claude/.credentials.json dengan file mode 0600, atau di bawah CLAUDE_CONFIG_DIR jika Anda menetapkan variabel tersebut. Linux tidak menggunakan keychain, berbeda dari macOS. Karena itu, proses apa pun yang berjalan sebagai user Anda dapat membaca file tersebut. Oleh sebab itu, backup /home atau machine image dapat membawa login yang masih aktif. Jalankan /logout sebelum membuat snapshot atau menyalin sistem. Jika ANTHROPIC_API_KEY juga ditetapkan di environment Anda, variabel tersebut memiliki prioritas atas login subscription yang tersimpan setelah Anda menyetujuinya. /status menunjukkan login yang sedang aktif.

Apakah subscription Claude Pro saya juga mencakup CLI dan aplikasi web?

Ya. Paket Pro, Max, Team, atau Enterprise memungkinkan Anda login ke claude.ai, aplikasi desktop, CLI, dan ekstensi VS Code dengan satu akun. Paket claude.ai gratis tidak mencakup Claude Code, sehingga CLI terminal memerlukan paket berbayar atau akun Claude Console. API ditagihkan secara terpisah per token dari akun Console. Produk tersebut berbeda dari subscription.