Cara Pasang Claude di Linux: Desktop App dan CLI

Bahagian Claude yang manakah berjalan secara natif pada Linux hari ini

Claude pada Linux berjalan pada empat permukaan berasingan, dan setakat Ogos 2026 kesemuanya berfungsi pada mesin Ubuntu atau Debian biasa. Aplikasi desktop dipasang daripada repositori apt Anthropic dan berada dalam fasa beta. Claude Code CLI (antara muka baris perintah) ialah binari yang dikompilasi, dan ia berjalan pada lebih banyak pengedaran berbanding aplikasi desktop. Aplikasi web di claude.ai hanya memerlukan pelayar, dan API ialah endpoint HTTPS yang anda panggil daripada kod anda sendiri.

Dua ciri yang dimiliki oleh macOS dan Windows tiada dalam versi beta desktop Linux: Computer Use, di mana Claude mengawal aplikasi pada skrin anda, dan imlak suara. Anthropic mendokumentasikan kedua-duanya sebagai belum tersedia pada Linux. CLI mempunyai imlak suaranya sendiri, jadi jurang tersebut terletak pada aplikasi desktop dan bukannya pada Claude itu sendiri.

Ketersediaan sentiasa berubah, jadi baca halaman ini sebagai penerangan tentang permukaan tersebut dan semak status semasa sebelum anda merancang mengenainya. Bahagian terakhir menyenaraikan halaman untuk disemak.

Memasang aplikasi desktop Claude pada Ubuntu atau Debian

Keperluan yang didokumenkan ialah Ubuntu 22.04 atau lebih baharu, atau Debian 12 atau lebih baharu, pada x86_64 (yang dpkg panggil amd64) atau arm64. Pengedaran berasaskan Debian yang lain mungkin berfungsi tetapi tidak diuji. Fedora dan RHEL belum mempunyai pakej, jadi pada sistem tersebut anda perlu menggunakan CLI atau pelayar web.

Pasang daripada repositori apt dan bukannya daripada fail .deb yang dimuat turun. Aplikasi Linux tidak mempunyai pengemaskini sendiri, jadi versi baharu hanya sampai kepada anda melalui pengurus pakej anda, dan mendaftarkan repositori adalah perkara yang membolehkan apt upgrade melihatnya.

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 sepatutnya memaparkan cap jari 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Bandingkannya sebelum anda mendaftarkan repositori, kerana kunci tandatangan yang tidak anda semak adalah kunci yang anda percayai secara membuta tuli. Jika gpg melaporkan bahawa fail tersebut tidak mengandungi data OpenPGP yang sah, muat turun telah gagal, dan apt update kemudiannya akan gagal dengan NO_PUBKEY BAA929FF1A7ECACE.

Mendaftarkan repositori adalah satu baris deb yang ditulis ke dalam /etc/apt/sources.list.d/claude-desktop.list. Salin baris tersebut daripada halaman pemasangan Linux Anthropic, code.claude.com/docs/en/desktop-linux, tepat seperti yang dipaparkan di sana. Alamat repositori adalah bahagian prosedur ini yang paling berkemungkinan berubah, dan baris yang ditaip berdasarkan ingatan adalah punca anda terpaksa berhadapan dengan E: Unable to locate package claude-desktop kemudiannya. Baca baris tersebut sebelum anda menampalnya: arch=amd64,arm64 adalah sebab mengapa apt pada seni bina lain tidak menemui apa-apa, dan signed-by= menghala ke fail keyring yang baru anda semak, yang mengehadkan kunci tersebut kepada repositori ini sahaja dan bukannya mempercayainya untuk semua perkara lain yang dibaca oleh apt.

sudo apt update && sudo apt install claude-desktop

Mulakannya daripada pelancar aplikasi anda, atau jalankan claude-desktop dalam terminal. Log masuk dengan akaun claude.ai anda, atau melalui SSO (single sign-on) organisasi anda jika syarikat anda telah menetapkannya. Aplikasi desktop tidak menerima kunci API Claude Console: pengesahan berasaskan kunci adalah ciri CLI.

E: Unable to locate package claude-desktop bermaksud apt tidak pernah membaca repositori tersebut. cat /etc/apt/sources.list.d/claude-desktop.list sepatutnya menunjukkan baris deb yang anda tulis, dan dpkg --print-architecture sepatutnya memaparkan amd64 atau arm64, kerana tiada pakej diterbitkan untuk seni bina lain. Kemas kini kemudiannya akan tiba bersama sistem anda yang lain, daripada sudo apt update && sudo apt upgrade.

Perkara yang hanya wujud dalam pelayar

claude.ai berfungsi dalam mana-mana pelayar semasa pada sebarang pengedaran, yang menjadikannya jawapan bagi Fedora, RHEL, Arch, openSUSE dan apa-apa sahaja yang tidak mempunyai pakej. Pelayar juga mendapat Claude Code di web, di mana sesi dijalankan dalam awan Anthropic dan bukannya pada mesin anda, serta ia sentiasa menggunakan kelayakan langganan anda.

Had pelayar adalah perkara berguna yang perlu difahami. Sesi awan tidak boleh membaca fail pada pelayan anda sendiri atau menjalankan arahan padanya. Apa-apa sahaja yang menyentuh mesin anda memerlukan perisian pada mesin tersebut, yang bermaksud CLI atau aplikasi desktop.

Kelebihan CLI berbanding aplikasi web

Mulakan claude dalam direktori dan ia berfungsi pada direktori tersebut. Itulah perbezaannya, dan selebihnya adalah kesan daripadanya.

• Ia membaca dan menyunting fail dalam direktori kerja anda, serta menunjukkan setiap suntingan kepada anda sebelum ia melaksanakannya.
• Ia menjalankan arahan shell yang anda luluskan, jadi ia boleh membina projek, menjalankan suite ujian, membaca log, atau memeriksa servis pada mesin itu sendiri.
• Ia berjalan tanpa sesi interaktif: claude -p "read the nginx error log and summarise it" mencetak satu jawapan dan keluar, iaitu cara yang anda gunakan daripada cron job atau pipeline.
• Ia menyambungkan pelayan MCP (model context protocol) dengan claude mcp add, yang memberikan model alatan di luar sistem fail.
• Ia berjalan di tempat yang tiada desktop grafik langsung, iaitu setiap VPS (virtual private server) yang akan anda sewa.

Perkara terakhir itulah sebabnya panduan pelayan mementingkan CLI. Pelayan sewaan hanya mempunyai SSH (secure shell) dan tiada yang lain, jadi terminal adalah satu-satunya antara muka yang boleh ada bersama anda. Menjalankannya dengan cara itu mempunyai peraturannya sendiri, yang diliputi sepenuhnya dalam menjalankan Claude Code pada VPS di dalam tmux, dan menggunakan Claude untuk kerja pentadbiran sistem harian meliputi tugasan yang berbaloi untuk diserahkan kepadanya.

Integrasi editor berada di antara kedua-duanya. Sambungan VS Code memerlukan VS Code 1.94.0 atau lebih baharu dan memberikan anda panel grafik di dalam editor, dengan diff dan semakan pelan. Ia menyertakan salinan peribadi CLI untuk panel tersebut dan tidak meletakkan claude pada PATH anda, jadi menaip claude dalam terminal bersepadu masih memerlukan pemasangan kendiri. Editor yang dibina berasaskan VS Code memasang sambungan yang sama daripada registri Open VSX, dan terdapat juga pemalam JetBrains.

Adakah anda memerlukan Node.js untuk menjalankan Claude Code pada Linux?

Tidak perlu dengan kaedah pemasangan yang disyorkan. Pemasang natif memuat turun binari yang telah dikompilasi, dan binari tersebut tidak berjalan di atas Node.js.

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

claude --version sepatutnya memaparkan nombor versi seperti 2.1.211 (Claude Code). Jika terdapat sesuatu yang tidak kena, jalankan claude doctor, yang akan mencetak diagnostik baca-sahaja mengenai pemasangan dan fail tetapan anda tanpa memulakan sesi.

Node.js hanya penting jika menggunakan laluan npm. Bermula daripada pakej versi 2.1.198, pakej npm memerlukan Node.js 22 atau lebih baharu. Pada Node.js yang lebih lama, npm akan memaparkan amaran EBADENGINE dan bukannya gagal, kerana pakej tersebut menarik binari natif yang sama sebagai dependensi per-platform dan memautkannya ke lokasi yang sepatutnya.

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

Jangan jalankan arahan tersebut dengan sudo. Dokumentasi memberi amaran terhadap sudo npm install -g kerana ia meninggalkan fail milik root dalam awalan npm global anda, menyebabkan pemasangan atau kemas kini tanpa keistimewaan seterusnya gagal disebabkan masalah kebenaran (permissions). Apabila direktori global npm tidak boleh ditulis, kemas kini automatik latar belakang akan berhenti berfungsi dan claude doctor menyenaraikan cara pembaikannya.

Anthropic juga menerbitkan repositori pakej yang ditandatangani untuk Debian, Fedora, RHEL dan Alpine, jadi sudo apt install claude-code berfungsi hampir sama seperti pakej desktop, dengan kunci tandatangan tersendiri di https://downloads.claude.ai/keys/claude-code.asc.

Patutkah anda memasang bagi setiap pengguna atau seluruh sistem?

Pemasang natif adalah pemasangan bagi setiap pengguna. Ia meletakkan pelancar di ~/.local/bin/claude sebagai symlink ke dalam ~/.local/share/claude/versions/, tidak memerlukan root, dan mengemas kini dirinya sendiri di latar belakang. Setiap pengguna pada mesin mendapat salinan berasingan pada versi yang berasingan.

Pemasangan pengurus pakej adalah untuk seluruh sistem. Satu binari melayani setiap pengguna, ia memerlukan root, dan ia tidak mengemas kini secara automatik melalui Claude Code. Anda menaik tarafnya dengan sudo apt update && sudo apt upgrade claude-code, arahan yang sama yang anda sudah jalankan untuk segala-galanya pada mesin tersebut.

Pilih pemasangan bagi setiap pengguna pada mesin yang anda log masuk sebagai diri sendiri, yang merangkumi kebanyakan kerja VPS. Pilih pemasangan pakej pada pelayan kongsi atau pada imej mesin, di mana anda mahukan satu versi untuk semua orang dan anda mahu ia berubah mengikut jadual anda. Pada pemasangan natif, dua tetapan dalam ~/.claude/settings.json menentukan cara kemas kini berfungsi:

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

Saluran stable mengikuti keluaran yang berusia kira-kira seminggu dan melangkau keluaran dengan regresi utama. DISABLE_AUTOUPDATER hanya menghentikan semakan latar belakang, jadi claude update masih berfungsi dan anda mengekalkan kawalan tentang bila versi baharu akan tiba. Ini penting pada pelayan di mana tugasan yang lama berjalan tanpa pengawasan dan anda lebih suka binari tersebut tidak berubah semasa tugasan sedang berjalan.

Log masuk melalui SSH dan pastikan sesi kekal aktif

Dua masalah khusus Linux muncul apabila anda menjalankan CLI buat kali pertama pada pelayan sewaan. Aliran log masuk memerlukan pelayar web, namun pelayan tidak mempunyai pelayar. Sambungan SSH yang terputus akan menyebabkan kerja yang sedang berjalan turut terhenti.

tmux menyelesaikan masalah kedua. Sesi tmux tergolong kepada pelayan tmux pada mesin jauh, bukan kepada sambungan anda, jadi sambungan yang terputus membiarkan proses terus berjalan.

tmux new -s claude
claude

Nyahlampirkan (detach) dengan Ctrl-b kemudian d, dan kembali semula kemudian dengan tmux attach -t claude.

Log masuk adalah masalah pertama. Jalankan claude dan ia akan mencetak URL pengesahan. Buka URL tersebut dalam pelayar web pada komputer anda sendiri. Selepas anda log masuk, pelayar akan memaparkan kod log masuk dan bukannya mengubah hala kembali, kerana pelayar pada komputer riba anda tidak dapat mencapai pelayan panggil balik (callback server) yang dimulakan oleh Claude Code pada alamat loopback mesin jauh. Tampal kod tersebut ke dalam terminal pada gesaan Paste code here if prompted, dan terminal akan melaporkan Login successful.

Untuk sesi yang perlu dimulakan tanpa pengawasan, claude setup-token membuka pengesahan pelayar yang sama dan mencetak token OAuth selama satu tahun ke terminal. Ia tidak menyimpan token tersebut di mana-mana, jadi salin dan tetapkan ia di tempat yang anda perlukan.

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Token tersebut memerlukan pelan berbayar dan hanya boleh membuat permintaan model. Anggap ia sebagai kata laluan dengan tempoh hayat satu tahun. Di mana untuk menyimpannya, dan cara menghalang ejen daripada membacanya semula, adalah subjek bagi menyimpan rahsia daripada capaian ejen AI.

Pelayan kecil menghadapi satu lagi halangan. Pemasangan memerlukan kira-kira 512 MB memori bebas, dan keperluan perkakasan yang didokumenkan untuk menjalankannya ialah 4 GB RAM atau lebih, jadi pada instans 1 GB, kernel out-of-memory killer akan menamatkan pemasangan:

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

Tambah swap, kemudian jalankan pemasang sekali lagi. Swap ialah ruang cakera yang digunakan oleh kernel sebagai memori limpahan. Ia jauh lebih perlahan daripada RAM, dan ia mencukupi untuk menyelesaikan pemasangan.

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

swapon mendayakan fail tersebut untuk but ini sahaja. Tambah baris untuk /swapfile ke dalam /etc/fstab jika anda mahukannya kembali selepas but semula. Perkara lain yang perlu dikunci sebelum anda membiarkan ejen menjalankan perintah pada pelayan langsung adalah subjek bagi menjalankan Claude Code dengan selamat pada VPS.

Lokasi kelayakan Claude anda pada Linux

Pada Linux, /login menulis kelayakan tersebut ke ~/.claude/.credentials.json dengan mod fail 0600. macOS meletakkan kelayakan yang sama ke dalam Keychain yang disulitkan, jadi tabiat yang anda bentuk pada Mac tidak terpakai di sini: pada Linux, token tersebut merupakan fail biasa dalam direktori home anda, dan setiap proses yang berjalan sebagai pengguna anda boleh membacanya. Menetapkan CLAUDE_CONFIG_DIR akan memindahkan fail tersebut ke bawah direktori itu sebagai gantinya.

Dua perkara timbul daripada keadaan ini. Sandaran bagi /home mengandungi log masuk yang aktif, jadi menyalin sandaran tersebut ke mesin yang dikongsi akan memberikan akses akaun anda kepada sesiapa sahaja yang boleh membacanya. Selain itu, imej mesin yang dibina daripada kotak di mana anda telah log masuk akan membawa log masuk tersebut ke setiap instans yang diklon daripadanya. Jalankan /logout sebelum anda membuat sebarang snapshot.

Keutamaan kelayakan sering mengelirukan pengguna yang memegang langganan dan kunci API pada masa yang sama. Apabila ANTHROPIC_API_KEY ditetapkan dalam shell anda, Claude Code akan menggunakannya sebaik sahaja anda meluluskannya, menyebabkan langganan anda tidak digunakan sementara kunci tersebut mengenakan caj bagi setiap token. /status menunjukkan kelayakan mana yang aktif, dan unset ANTHROPIC_API_KEY mengembalikan anda kepada log masuk langganan.

Log masuk akan tamat tempoh. Dalam tempoh tiga hari sebelum tamat tempoh, baris permulaan akan memaparkan Your login expires in 3 days, dan amaran tersebut tidak akan menyekat sebarang permintaan. Selepas tamat tempoh, setiap permintaan akan gagal dengan Login expired · Please run /login. Ketahui perkara ini sebelum anda membiarkan sesi tanpa pengawasan berjalan sepanjang hujung minggu, kerana sesi sedemikian akan berhenti membuat kemajuan dan tidak dapat pulih dengan sendirinya.

Adakah satu langganan Claude merangkumi semuanya?

Satu pelan berbayar merangkumi setiap antara muka dengan log masuk yang sama. Akaun Pro, Max, Team atau Enterprise membolehkan anda log masuk ke claude.ai dalam pelayar, aplikasi desktop, CLI dan sambungan VS Code, dan ia merupakan langganan yang sama setiap kali. Ia juga merupakan satu kuota penggunaan untuk kesemuanya, jadi penggunaan CLI yang lama pada pelayan anda akan mengurangkan baki kuota aplikasi desktop, dan tingkap had yang telah anda capai dan tindakan yang perlu diambil adalah perkara yang perlu diselesaikan apabila mana-mana antara muka mula menolak tugasan. Pelan percuma claude.ai tidak menyertakan akses Claude Code, jadi bahagian CLI dan Claude Code pada aplikasi desktop memerlukan pelan berbayar atau akaun Claude Console.

API merupakan produk berbeza dengan pengebilan yang berbeza. Akaun Console mengenakan caj setiap token berdasarkan apa yang anda hantar, yang lebih sesuai untuk servis yang sedang anda bina berbanding anda menaip di terminal. Menetapkan ANTHROPIC_API_KEY akan menukar CLI ke laluan pengebilan tersebut, dan itu adalah pilihan yang anda buat, bukan pilihan sandaran.

Harga dan had pelan berubah terlalu kerap untuk dinyatakan di sini. Dua halaman menjejaki angka semasa: kos sebenar Claude Code dan pelan Claude yang anda perlukan. Jika anda sedang menimbang pengebilan setiap token berbanding pelan bulanan, API berbanding langganan akan menjelaskan di mana titik pulang modal berada.

Ralat pemasangan yang akan anda temui

bash: claude: command not found sejurus selepas pemasangan berjaya. Binari tersebut berada di ~/.local/bin/claude dan direktori itu tidak berada dalam laluan carian shell anda. Sahkan perkara ini dengan echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin", yang tidak akan memaparkan apa-apa jika entri tersebut tiada. Betulkan untuk bash dengan echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc, kemudian jalankan source ~/.bashrc. Memasang sambungan VS Code secara berasingan tidak akan mencipta fail tersebut, kerana sambungan itu menyimpan salinan CLI miliknya di dalam direktori sambungan.

Error loading shared library libstdc++.so.6. Pemasang telah memilih binaan musl untuk sistem glibc. Ini berlaku apabila pakej penyilangan kompilasi (cross-compilation) musl hadir dan pengesanan tersalah membacanya. Jalankan ldd --version 2>&1 | head -1: output yang menamakan GNU libc atau GLIBC bermakna anda berada pada glibc dan menerima binari yang salah, jadi buang pemasangan tersebut dan jalankan semula pemasang. Pada Alpine dan sistem musl lain, penyelesaiannya adalah sebaliknya, apk add libgcc libstdc++ ripgrep.

Dua salinan claude pada satu mesin. which -a claude menyenaraikan setiap padanan dalam PATH anda. Pemasangan natif ialah symlink dari ~/.local/bin/claude ke ~/.local/share/claude/versions/, pemasangan npm tempatan legasi berada di bawah ~/.claude/local/, dan npm -g ls @anthropic-ai/claude-code mendedahkan pemasangan npm global. Buang salinan yang tidak anda inginkan, kerana salinan lama yang berada lebih awal dalam PATH anda adalah punca pepijat yang telah dibaiki kelihatan seolah-olah belum dibaiki.

Tempat untuk menyemak status semasa

• Status desktop Linux, keperluan dan arahan pemasangan: code.claude.com/docs/en/desktop-linux
• Pengedaran yang disokong dan setiap kaedah pemasangan untuk CLI: code.claude.com/docs/en/setup
• Platform yang mempunyai aplikasi untuk dimuat turun: claude.com/download
• Pelan yang merangkumi apa, dan kosnya: claude.com/pricing

Setiap nombor versi dan tarikh dalam panduan ini adalah gambaran pada Ogos 2026. Bentuknya adalah perkara yang kekal benar: empat permukaan, satu log masuk merentas pelan berbayar, dan satu keputusan sama ada CLI milik pengguna anda atau milik keseluruhan mesin.

FAQ

Adakah aplikasi desktop Claude untuk Linux?

Ya. Setakat Ogos 2026, ia berada dalam fasa beta dan menyokong Ubuntu 22.04 atau lebih baharu serta Debian 12 atau lebih baharu pada seni bina amd64 atau arm64. Pasang aplikasi tersebut menggunakan sudo apt install claude-desktop selepas menambah repositori apt Anthropic dan kunci tandatangannya, supaya versi baharu diterima bersama naik taraf sistem anda yang biasa. Binaan Linux mempunyai tab yang sama seperti aplikasi macOS, termasuk tab Claude Code. Ciri Computer Use dan imlak suara belum tersedia dalam binaan Linux, dan Fedora serta RHEL tidak mempunyai pakej, jadi pada pengedaran tersebut, gunakan CLI atau claude.ai dalam pelayar web.

Adakah saya memerlukan Node.js untuk menjalankan Claude Code pada Linux?

Tidak untuk kaedah pemasangan yang disyorkan. curl -fsSL https://claude.ai/install.sh | bash memuat turun binari yang telah dikompilasi yang tidak menggunakan Node.js semasa runtime. Node.js hanya penting jika anda memasang pakej npm, yang memerlukan Node.js 22 atau lebih baharu setakat versi 2.1.198. Pada Node.js yang lebih lama, npm akan memaparkan amaran EBADENGINE dan pemasangan tetap selesai, kerana binari natif yang sama ditarik masuk sebagai dependency mengikut platform. Jangan sekali-kali memasangnya dengan sudo npm install -g, kerana ia akan meninggalkan fail milik root dalam prefix npm anda dan merosakkan kemas kini pada masa hadapan.

Bagaimanakah cara saya log masuk ke Claude Code melalui SSH?

Jalankan claude dan ia akan memaparkan URL pengesahan. Buka URL tersebut dalam pelayar web pada komputer anda sendiri, bukan pada pelayan. Selepas anda log masuk, pelayar akan memaparkan kod log masuk dan bukannya melakukan redirect, kerana ia tidak dapat mencapai callback listener yang dimulakan oleh Claude Code pada alamat loopback mesin jauh. Tampal kod tersebut pada prompt Paste code here if prompted. Bagi sesi yang bermula tanpa kehadiran pengguna, jalankan claude setup-token dan tetapkan token yang dipaparkan sebagai CLAUDE_CODE_OAUTH_TOKEN di mana sahaja ia diperlukan.

Di manakah Claude Code menyimpan maklumat log masuk saya pada Linux?

Dalam ~/.claude/.credentials.json dengan mod fail 0600, atau di bawah CLAUDE_CONFIG_DIR apabila anda menetapkan pemboleh ubah tersebut. Tiada keychain yang terlibat pada Linux, tidak seperti macOS, jadi mana-mana proses yang berjalan sebagai pengguna anda boleh membaca fail tersebut. Oleh itu, sandaran /home atau imej mesin akan membawa maklumat log masuk yang aktif: jalankan /logout sebelum anda membuat snapshot atau menyalin sistem. Jika ANTHROPIC_API_KEY turut ditetapkan dalam persekitaran anda, ia akan diutamakan berbanding log masuk langganan yang disimpan sebaik sahaja anda meluluskannya, dan /status akan menunjukkan yang mana satu sedang aktif.

Adakah langganan Claude Pro saya meliputi CLI dan juga aplikasi web?

Ya. Pelan Pro, Max, Team atau Enterprise membolehkan anda log masuk ke claude.ai, aplikasi desktop, CLI dan sambungan VS Code dengan satu akaun. Pelan percuma claude.ai tidak merangkumi Claude Code, jadi CLI terminal memerlukan pelan berbayar atau akaun Claude Console. API dibilkan secara berasingan mengikut token daripada akaun Console, yang merupakan produk berbeza daripada langganan.