Cara Menjalankan Claude di Linux: Desktop dan CLI

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

Claude di Linux berjalan pada empat antarmuka terpisah, dan per Agustus 2026 keempatnya berfungsi pada mesin Ubuntu atau Debian standar. Aplikasi desktop diinstal dari repositori apt milik Anthropic dan saat ini berstatus beta. Claude Code CLI (antarmuka baris perintah) adalah biner terkompilasi, dan aplikasi ini berjalan pada lebih banyak distribusi dibandingkan aplikasi desktop. Aplikasi web di claude.ai hanya memerlukan browser, dan API adalah endpoint HTTPS yang Anda panggil dari kode Anda sendiri.

Dua fitur yang tersedia di macOS dan Windows tidak ada pada versi beta desktop Linux: Computer Use, di mana Claude mengendalikan aplikasi di layar Anda, dan dikte suara. Anthropic mendokumentasikan keduanya sebagai fitur yang belum tersedia di Linux. CLI memiliki fitur dikte suaranya sendiri, jadi kesenjangan ini ada pada aplikasi desktop, bukan pada Claude itu sendiri.

Ketersediaan fitur dapat berubah, jadi bacalah halaman ini sebagai deskripsi antarmuka dan periksa status terkini sebelum Anda merencanakan implementasi. Bagian terakhir mencantumkan halaman yang perlu diperiksa.

Menginstal aplikasi desktop Claude di Ubuntu atau Debian

Persyaratan yang didokumentasikan adalah Ubuntu 22.04 atau yang lebih baru, atau Debian 12 atau yang lebih baru, pada arsitektur x86_64 (yang dpkg sebut sebagai amd64) atau arm64. Distribusi berbasis Debian lainnya mungkin dapat berfungsi namun tidak diuji. Fedora dan RHEL belum memiliki paket, jadi pada sistem tersebut Anda harus menggunakan CLI atau browser.

Instal dari repositori apt alih-alih dari file .deb yang diunduh. Aplikasi Linux tidak memiliki pembaru mandiri, sehingga versi baru hanya dapat Anda terima melalui manajer paket, dan mendaftarkan repositori adalah cara agar apt upgrade dapat mendeteksinya.

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 mencetak fingerprint 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Bandingkan fingerprint tersebut sebelum Anda mendaftarkan repositori, karena kunci penandatanganan yang tidak Anda periksa adalah kunci yang Anda percayai secara buta. Jika gpg melaporkan bahwa file tersebut tidak berisi data OpenPGP yang valid, berarti pengunduhan gagal, dan apt update kemudian akan gagal dengan NO_PUBKEY BAA929FF1A7ECACE.

Mendaftarkan repositori adalah satu baris deb yang ditulis 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 tertulis di sana. Alamat repositori adalah bagian dari prosedur ini yang paling mungkin berubah, dan baris yang diketik berdasarkan ingatan adalah penyebab Anda mendapati E: Unable to locate package claude-desktop nantinya. Baca baris tersebut sebelum Anda menempelkannya: arch=amd64,arm64 adalah alasan mengapa apt pada arsitektur lain tidak menemukan apa pun, dan signed-by= mengarah pada file keyring yang baru saja Anda periksa, yang membatasi kunci tersebut hanya untuk repositori ini alih-alih mempercayainya untuk semua hal lain yang dibaca oleh apt.

sudo apt update && sudo apt install claude-desktop

Jalankan aplikasi dari peluncur aplikasi Anda, atau jalankan claude-desktop di terminal. Masuk dengan akun claude.ai Anda, atau melalui SSO (single sign-on) organisasi Anda jika perusahaan Anda telah mengaturnya. Aplikasi desktop tidak menerima API key Claude Console: autentikasi berbasis kunci 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, dan dpkg --print-architecture seharusnya mencetak amd64 atau arm64, karena tidak ada paket yang dipublikasikan untuk arsitektur lain. Pembaruan kemudian akan tiba bersamaan dengan sisa sistem Anda, dari sudo apt update && sudo apt upgrade.

Apa yang hanya ada di peramban

claude.ai berfungsi di peramban terkini apa pun pada distribusi apa pun, yang menjadikannya solusi di Fedora, RHEL, Arch, openSUSE, dan sistem lainnya tanpa paket instalasi. Peramban juga mendapatkan Claude Code di web, di mana sesi berjalan di cloud Anthropic alih-alih di mesin Anda, dan sesi tersebut selalu menggunakan kredensial langganan Anda.

Batasan peramban adalah hal yang berguna untuk dipahami. Sesi cloud tidak dapat membaca file di server Anda sendiri atau menjalankan perintah di dalamnya. Apa pun yang menyentuh mesin Anda memerlukan perangkat lunak di mesin tersebut, yang berarti CLI atau aplikasi desktop.

Apa yang diberikan CLI kepada Anda yang tidak dimiliki aplikasi web

Jalankan claude di dalam sebuah direktori dan alat tersebut akan bekerja pada direktori itu. Itulah perbedaannya, dan sisanya mengikuti prinsip tersebut.

• Alat ini membaca dan menyunting file di direktori kerja Anda, serta menunjukkan setiap suntingan sebelum menerapkannya.
• Alat ini menjalankan perintah shell yang Anda setujui, sehingga dapat membangun proyek, menjalankan rangkaian pengujian, membaca log, atau memeriksa layanan pada mesin itu sendiri.
• Alat ini berjalan tanpa sesi interaktif: claude -p "read the nginx error log and summarise it" mencetak satu jawaban lalu keluar, yang merupakan cara Anda menggunakannya dari cron job atau pipeline. Bagaimana jawaban tersebut terbaca adalah hak Anda untuk mengaturnya, karena gaya output menyunting prompt sistem di balik setiap balasan dan dapat menjaga agar eksekusi skrip tetap ringkas sementara sesi interaktif memberikan penjelasan.
• Alat ini menghubungkan server MCP (model context protocol) dengan claude mcp add, yang memberikan alat tambahan bagi model di luar sistem file.
• Alat ini berjalan di tempat yang tidak memiliki desktop grafis sama sekali, yaitu setiap VPS (virtual private server) yang akan Anda sewa.

Poin terakhir itulah alasan mengapa panduan server mementingkan CLI. Server sewaan hanya memiliki SSH (secure shell) dan tidak ada yang lain, sehingga terminal adalah satu-satunya antarmuka yang dapat menyertai Anda. Menjalankannya dengan cara tersebut memiliki aturannya sendiri, yang dibahas secara lengkap dalam menjalankan Claude Code pada VPS di dalam tmux, dan menggunakan Claude untuk pekerjaan sysadmin sehari-hari membahas tugas-tugas yang layak diserahkan kepadanya.

Integrasi editor berada di antara keduanya. Ekstensi VS Code memerlukan VS Code 1.94.0 atau yang lebih baru dan memberikan Anda panel grafis di dalam editor, lengkap dengan diff dan tinjauan rencana. Ekstensi ini menyertakan salinan privat CLI untuk panel tersebut dan tidak menempatkan claude pada PATH Anda, sehingga mengetik claude di terminal terintegrasi tetap memerlukan instalasi mandiri. Editor yang dibangun di atas VS Code menginstal ekstensi yang sama dari registry Open VSX, dan tersedia juga plugin untuk JetBrains.

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

Tidak dengan metode instalasi yang direkomendasikan. Installer native mengunduh binary yang telah dikompilasi, dan binary tersebut tidak berjalan di atas Node.js.

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

claude --version seharusnya mencetak nomor versi seperti 2.1.211 (Claude Code). Jika ada yang terlihat tidak beres, jalankan claude doctor, yang akan mencetak diagnostik read-only mengenai instalasi dan file pengaturan Anda tanpa memulai sesi.

Node.js hanya relevan pada jalur npm. Per paket versi 2.1.198, paket npm meminta Node.js 22 atau yang lebih baru, dan pada Node.js versi lama npm akan mencetak peringatan EBADENGINE alih-alih gagal, karena paket tersebut menarik binary native yang sama sebagai dependensi per-platform dan menautkannya ke tempatnya.

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

Jangan jalankan itu dengan sudo. Dokumentasi memperingatkan agar tidak menggunakan sudo npm install -g karena hal itu akan meninggalkan file dengan kepemilikan root di prefix npm global Anda, sehingga instalasi atau pembaruan berikutnya oleh pengguna biasa akan gagal karena masalah izin. Ketika direktori global npm tidak dapat ditulis, pembaruan otomatis di latar belakang akan berhenti bekerja dan claude doctor mencantumkan perbaikannya.

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

Haruskah Anda menginstal per pengguna atau di seluruh sistem?

Installer bawaan adalah instalasi per pengguna. Installer ini menempatkan peluncur di ~/.local/bin/claude sebagai symlink ke ~/.local/share/claude/versions/, tidak memerlukan akses root, dan memperbarui dirinya sendiri di latar belakang. Setiap pengguna di mesin tersebut mendapatkan salinan terpisah dengan versi yang berbeda.

Instalasi melalui manajer paket bersifat di seluruh sistem. Satu biner melayani setiap pengguna, memerlukan akses root, dan tidak memperbarui diri secara otomatis melalui Claude Code. Anda melakukan upgrade dengan sudo apt update && sudo apt upgrade claude-code, perintah yang sama yang sudah Anda jalankan untuk semua hal lain di mesin tersebut.

Pilih instalasi per pengguna pada mesin yang Anda akses sebagai diri sendiri, yang mencakup sebagian besar pekerjaan VPS. Pilih instalasi paket pada server bersama atau pada image mesin, di mana Anda menginginkan satu versi untuk semua orang dan Anda ingin pembaruan dilakukan sesuai jadwal Anda. Pada instalasi bawaan, dua pengaturan di ~/.claude/settings.json menentukan bagaimana pembaruan berperilaku:

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

Channel stable mengikuti rilis yang berumur sekitar satu minggu dan melewati rilis dengan regresi besar. DISABLE_AUTOUPDATER hanya menghentikan pemeriksaan latar belakang, sehingga claude update tetap berfungsi dan Anda tetap memegang kendali kapan versi baru diterapkan. Hal ini penting pada server tempat pekerjaan jangka panjang berjalan tanpa pengawasan dan Anda lebih memilih agar biner tidak berubah saat proses tersebut berjalan.

Masuk melalui SSH dan jaga sesi tetap aktif

Dua masalah spesifik Linux muncul saat Anda pertama kali menjalankan CLI di server sewaan. Alur masuk memerlukan browser, sedangkan server tidak memilikinya. Koneksi SSH yang terputus akan menghentikan pekerjaan yang sedang berjalan.

tmux menyelesaikan masalah kedua. Sesi tmux dimiliki oleh server tmux di mesin remote, bukan oleh koneksi Anda, sehingga koneksi yang terputus membiarkan proses tetap berjalan.

tmux new -s claude
claude

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

Masalah pertama adalah proses masuk. Jalankan claude dan sistem akan mencetak URL otorisasi. Buka URL tersebut di browser pada komputer Anda sendiri. Setelah Anda masuk, browser akan menampilkan kode login alih-alih melakukan redirect, karena browser di laptop Anda tidak dapat menjangkau server callback yang dijalankan Claude Code pada alamat loopback mesin remote. Tempel kode tersebut ke terminal pada prompt Paste code here if prompted, dan terminal akan melaporkan Login successful.

Untuk sesi yang harus dimulai tanpa pengawasan, claude setup-token membuka otorisasi browser yang sama dan mencetak token OAuth satu tahun ke terminal. Token ini tidak disimpan di mana pun, jadi salin dan atur di tempat yang Anda perlukan.

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Token tersebut memerlukan paket berbayar dan hanya dapat membuat permintaan model. Perlakukan token ini sebagai kata sandi dengan masa berlaku satu tahun. Tempat menyimpannya, dan cara mencegah agen membacanya kembali, adalah subjek dari menjaga rahasia agar tidak diakses agen AI.

Server kecil menghadapi satu kendala lagi. Instalasi memerlukan sekitar 512 MB memori bebas, dan persyaratan perangkat keras yang didokumentasikan untuk menjalankannya adalah 4 GB RAM atau lebih, sehingga pada instance 1 GB, kernel out-of-memory killer akan 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 luapan. Swap jauh lebih lambat daripada RAM, namun 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 saja. Tambahkan baris untuk /swapfile ke /etc/fstab jika Anda ingin mengaktifkannya kembali setelah reboot. Hal lain yang perlu diamankan sebelum Anda membiarkan agen menjalankan perintah di server live adalah subjek dari menjalankan Claude Code dengan aman di VPS.

Lokasi kredensial Claude Anda di Linux

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

Dua hal muncul dari kondisi tersebut. Cadangan dari /home berisi login yang aktif, sehingga menyalin cadangan tersebut ke mesin bersama akan memberikan akses akun Anda kepada siapa pun yang dapat membacanya. Selain itu, citra mesin (machine image) yang dibuat dari sistem tempat Anda login akan menyertakan login tersebut ke setiap instans yang dikloning darinya. Jalankan /logout sebelum Anda membuat snapshot apa pun.

Prioritas kredensial sering kali membingungkan pengguna yang memiliki langganan sekaligus kunci API. Saat ANTHROPIC_API_KEY diatur di shell Anda, Claude Code akan menggunakannya setelah Anda menyetujuinya, sehingga langganan Anda tidak terpakai sementara kunci tersebut menagih biaya per token. /status menunjukkan kredensial mana yang aktif, dan unset ANTHROPIC_API_KEY mengembalikan Anda ke login langganan.

Login memiliki masa berlaku. Dalam tiga hari sebelum kedaluwarsa, baris startup akan menampilkan Your login expires in 3 days, dan peringatan tersebut tidak akan memblokir permintaan. Setelah kedaluwarsa, setiap permintaan akan gagal dengan Login expired · Please run /login. Ketahui hal ini sebelum Anda meninggalkan sesi tanpa pengawasan selama akhir pekan, karena sesi tersebut akan berhenti memproses dan tidak dapat pulih dengan sendirinya.

Apakah satu langganan Claude mencakup semuanya?

Satu paket berbayar mencakup setiap antarmuka dengan login yang sama. Akun Pro, Max, Team, atau Enterprise memungkinkan Anda masuk ke claude.ai melalui peramban, aplikasi desktop, CLI, dan ekstensi VS Code, dan semuanya menggunakan langganan yang sama. Kuota penggunaan juga bersifat terpadu di semua platform tersebut, sehingga penggunaan CLI yang intensif di server Anda akan mengurangi sisa kuota aplikasi desktop, dan jendela batas mana yang telah Anda capai dan apa yang harus dilakukan adalah hal yang perlu diperiksa ketika salah satu antarmuka mulai menolak permintaan. Paket gratis claude.ai tidak mencakup akses Claude Code, sehingga bagian CLI dan fitur Claude Code pada aplikasi desktop memerlukan paket berbayar atau akun Claude Console.

API adalah produk berbeda dengan penagihan yang berbeda pula. Akun Console menagih berdasarkan jumlah token dari apa yang Anda kirimkan, yang lebih cocok untuk layanan yang sedang Anda bangun daripada untuk penggunaan terminal secara interaktif. Pengaturan ANTHROPIC_API_KEY akan memindahkan CLI ke jalur penagihan tersebut, dan itu adalah pilihan yang Anda buat, bukan opsi cadangan.

Harga dan batas paket terlalu sering berubah untuk dicantumkan di sini. Dua halaman berikut melacak angka terkini: berapa biaya Claude Code sebenarnya dan paket Claude mana yang Anda butuhkan. Jika Anda sedang mempertimbangkan penagihan per-token dibandingkan paket bulanan, perbandingan API dengan langganan akan membantu Anda menentukan titik impasnya.

Error instalasi yang akan Anda temui

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

Error loading shared library libstdc++.so.6. Installer memilih build musl untuk sistem glibc. Hal ini terjadi ketika paket kompilasi silang musl terdeteksi dan salah diinterpretasikan. Jalankan ldd --version 2>&1 | head -1: output yang menyebutkan GNU libc atau GLIBC berarti Anda menggunakan glibc dan menerima binary yang salah, jadi hapus instalasi tersebut dan jalankan kembali installer. Pada Alpine dan sistem musl lainnya, perbaikannya adalah sebaliknya, apk add libgcc libstdc++ ripgrep.

Dua salinan claude pada satu mesin. which -a claude mencantumkan setiap kecocokan di PATH Anda. Instalasi native adalah symlink dari ~/.local/bin/claude ke ~/.local/share/claude/versions/, instalasi npm lokal versi lama berada di bawah ~/.claude/local/, dan npm -g ls @anthropic-ai/claude-code menampilkan instalasi npm global. Hapus salinan yang tidak Anda inginkan, karena salinan usang yang berada lebih awal di PATH Anda adalah penyebab bug yang sudah diperbaiki tampak seolah 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 setiap metode instalasi untuk CLI: code.claude.com/docs/en/setup
• Platform mana saja yang memiliki aplikasi untuk diunduh: claude.com/download
• Paket mana yang menyertakan fitur apa, dan berapa biayanya: claude.com/pricing

Setiap nomor versi dan tanggal dalam panduan ini adalah snapshot dari Agustus 2026. Bentuknya tetap konsisten: empat antarmuka, satu login untuk semua paket berbayar, dan satu keputusan mengenai apakah CLI milik pengguna Anda atau seluruh mesin.

FAQ

Apakah tersedia aplikasi desktop Claude untuk Linux?

Ya. Per Agustus 2026, aplikasi ini dalam tahap beta dan mendukung Ubuntu 22.04 atau versi lebih baru serta Debian 12 atau versi lebih baru pada arsitektur amd64 atau arm64. Instal aplikasi tersebut dengan sudo apt install claude-desktop setelah menambahkan repositori apt Anthropic dan kunci penandatanganannya, agar versi baru dapat diterima bersamaan dengan pembaruan sistem reguler Anda. Build Linux memiliki tab yang sama dengan aplikasi macOS, termasuk tab Claude Code. Fitur Computer Use dan dikte suara belum tersedia di build Linux, dan karena belum ada paket untuk Fedora maupun RHEL, gunakan CLI atau claude.ai di peramban pada distribusi tersebut.

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

Tidak untuk metode instalasi yang direkomendasikan. curl -fsSL https://claude.ai/install.sh | bash mengunduh biner terkompilasi yang tidak menggunakan Node.js saat runtime. Node.js hanya relevan jika Anda menginstal paket npm, yang memerlukan Node.js 22 atau versi lebih baru per versi 2.1.198. Pada Node.js versi lama, npm akan mencetak peringatan EBADENGINE dan instalasi tetap selesai, karena biner native yang sama ditarik sebagai dependensi per platform. Jangan pernah menginstalnya dengan sudo npm install -g, karena akan meninggalkan file yang dimiliki root di prefix npm Anda dan merusak pembaruan di kemudian hari.

Bagaimana cara masuk ke Claude Code melalui SSH?

Jalankan claude dan sistem akan mencetak URL otorisasi. Buka URL tersebut di peramban pada komputer Anda sendiri, bukan di server. Setelah Anda masuk, peramban akan menampilkan kode login alih-alih melakukan pengalihan, karena peramban tidak dapat menjangkau listener callback yang dijalankan Claude Code pada alamat loopback mesin remote. Tempelkan kode tersebut pada prompt Paste code here if prompted. Untuk sesi yang dimulai tanpa kehadiran pengguna, jalankan claude setup-token dan atur token yang dicetak sebagai CLAUDE_CODE_OAUTH_TOKEN di mana pun diperlukan.

Di mana Claude Code menyimpan login saya di Linux?

Di ~/.claude/.credentials.json dengan mode file 0600, atau di bawah CLAUDE_CONFIG_DIR jika Anda mengatur variabel tersebut. Tidak ada keychain yang terlibat di Linux, tidak seperti macOS, sehingga proses apa pun yang berjalan sebagai pengguna Anda dapat membaca file tersebut. Oleh karena itu, cadangan /home atau image mesin akan membawa login yang aktif: jalankan /logout sebelum Anda melakukan snapshot atau menyalin sistem. Jika ANTHROPIC_API_KEY juga diatur di lingkungan Anda, variabel tersebut akan diutamakan daripada login langganan yang tersimpan setelah Anda menyetujuinya, dan /status akan menunjukkan mana yang sedang aktif.

Apakah langganan Claude Pro saya mencakup CLI dan aplikasi web?

Ya. Paket Pro, Max, Team, atau Enterprise memungkinkan Anda masuk ke claude.ai, aplikasi desktop, CLI, dan ekstensi VS Code dengan satu akun. Paket gratis claude.ai tidak mencakup Claude Code, sehingga CLI terminal memerlukan paket berbayar atau akun Claude Console. API ditagih secara terpisah per token dari akun Console, yang merupakan produk berbeda dari langganan.