Cara Pasang Claude Desktop dan CLI di Linux

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 mencetak cap jari 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Bandingkannya sebelum anda mendaftarkan repositori, kerana kunci penandatangan 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 /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 dicetak di sana. Alamat repositori adalah bahagian prosedur ini yang paling berkemungkinan berubah, dan baris yang ditaip berdasarkan ingatan adalah punca anda terpaksa merenung E: Unable to locate package claude-desktop selepas itu. Baca baris tersebut sebelum anda menampalnya: arch=amd64,arm64 adalah sebab 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 mencetak amd64 atau arm64, kerana tiada pakej diterbitkan untuk seni bina lain. Kemas kini kemudian akan tiba bersama-sama 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 untuk 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, dan 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.

Apa yang CLI tawarkan 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 apa yang anda gunakan daripada cron job atau pipeline. Cara jawapan itu dibaca terpulang kepada anda untuk menetapkannya, kerana gaya output menyunting prompt sistem di sebalik setiap balasan dan boleh memastikan larian skrip kekal ringkas manakala sesi interaktif memberikan penjelasan.
• Ia menghubungkan 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 yang disewa mempunyai SSH (secure shell) dan tiada yang lain, jadi terminal adalah satu-satunya permukaan yang boleh ada bersama anda. Menjalankannya dengan cara itu mempunyai peraturannya sendiri, yang menjalankan Claude Code pada VPS di dalam tmux liputi sepenuhnya, dan menggunakan Claude untuk kerja pentadbiran sistem harian liputi 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 menggabungkan 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 di atas 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, 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 dari versi pakej 2.1.198, pakej npm memerlukan Node.js 22 atau lebih baharu. Jika menggunakan 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 betul.

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 prefiks 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 langkah pembaikan.

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 jalankan untuk semua perkara lain 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 dipasang. Ini penting pada pelayan di mana tugas yang panjang berjalan tanpa pengawasan dan anda lebih suka binari tersebut tidak berubah semasa tugas sedang berjalan.

Log masuk melalui SSH dan kekalkan sesi aktif

Dua masalah khusus Linux muncul apabila anda menjalankan CLI buat kali pertama pada pelayan sewaan. Aliran log masuk memerlukan pelayar web, namun pelayan tiada pelayar web. 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 pautan 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, pembunuh kehabisan memori (out-of-memory killer) kernel 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 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 arahan 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 menyimpan kelayakan yang sama 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.

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 API key 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 merentas semua platform tersebut, jadi penggunaan CLI yang lama pada pelayan anda akan mengurangkan baki kuota aplikasi desktop, dan tingkap had yang telah anda capai dan perkara yang perlu dilakukan adalah perkara yang perlu disemak apabila mana-mana antara muka mula menolak tugasan. Pelan percuma claude.ai tidak merangkumi akses Claude Code, jadi bahagian CLI dan Claude Code pada aplikasi desktop memerlukan pelan berbayar atau akaun Claude Console.

API ialah produk berbeza dengan pengebilan yang berbeza. Akaun Console mengenakan caj setiap token berdasarkan apa yang anda hantar, yang lebih sesuai untuk perkhidmatan 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 diukur berbanding langganan akan membantu anda menentukan titik pulang modal.

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 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 pemasang sekali lagi. 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 tersebut 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 biasa anda. 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 tiada pakej untuk Fedora atau RHEL. Oleh itu, pada pengedaran tersebut, gunakan CLI atau claude.ai melalui pelayar web.

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

Tidak perlu 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 versi 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 menyebabkan kemas kini seterusnya gagal.

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. Untuk 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 mengatasi 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.