SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor

Cara Pasang Claude Desktop dan Claude Code di Linux

Ketahui cara memasang Claude Desktop melalui apt untuk Ubuntu 22.04 dan Debian 12. Dapatkan panduan pemasangan Claude Code CLI bagi repositori apt, dnf, dan apk sekarang.

Bahagian Claude yang manakah berjalan secara natif pada Linux hari ini

Claude pada Linux berjalan pada empat permukaan berasingan, dan setakat Oktober 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 web, dan API ialah endpoint HTTPS yang anda panggil daripada kod anda sendiri.

Tiga ciri yang dimiliki oleh macOS dan Windows tiada atau terhad dalam versi beta desktop Linux: Computer Use, di mana Claude mengawal aplikasi pada skrin anda, imlak suara (voice dictation), dan kekunci pintas global Quick Entry. Anthropic mendokumentasikan Computer Use dan imlak suara sebagai tidak tersedia pada Linux. Kekunci pintas Quick Entry berfungsi pada sesi X11, tetapi pada sesi Wayland natif, ia memerlukan portal GlobalShortcuts persekitaran desktop anda, jadi tanpa portal tersebut, kekunci pintas tidak tersedia. echo $XDG_SESSION_TYPE mencetak x11 atau wayland dan memberitahu anda situasi yang sedang dihadapi. CLI mempunyai imlak suaranya sendiri, jadi jurang imlak suara tersebut adalah 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 berdasarkan maklumat ini. Bahagian terakhir menyenaraikan halaman yang perlu 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 ini tidak mempunyai pengemas kini sendiri, jadi versi baharu hanya sampai kepada anda melalui pengurus pakej anda, dan mendaftarkan repositori adalah perkara yang membolehkan apt upgrade melihat versi tersebut.

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 penandatanganan yang tidak anda semak ialah 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 kemudian akan gagal dengan NO_PUBKEY BAA929FF1A7ECACE.

Mendaftarkan repositori ialah 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 ialah bahagian prosedur ini yang paling berkemungkinan berubah, dan baris yang ditaip berdasarkan ingatan adalah punca anda terpaksa berdepan dengan E: Unable to locate package claude-desktop selepas itu. Baca baris tersebut sebelum anda menampalnya: arch=amd64,arm64 ialah 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 menyediakannya. Itu adalah dua cara log masuk yang disenaraikan oleh halaman pemasangan Linux Anthropic, dan ia menghantar pengguna kunci API ke CLI. Anthropic mendokumenkan mod penggunaan kedua bagi aplikasi yang sama secara berasingan: dikonfigurasikan dengan pembekal inferens (Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, get laluan LLM, atau API Anthropic secara terus), skrin log masuk menawarkan untuk melangkau pengesahan Anthropic, dan pembekal mengendalikan inferens serta pengebilan untuk Chat, Cowork dan Code. Dokumen tersebut menamakan lokasi Linux untuk konfigurasi terurus, /etc/claude-desktop/managed-settings.json, dan halaman pemasangan Linux kini memaut ke dokumen penggunaan pihak ketiga. Pada peranti tanpa konfigurasi Claude Desktop, Claude Desktop 3.1623.1 atau lebih baharu juga menawarkan Use your Claude API account pada skrin log masuk standard, di mana anda boleh log masuk dengan Claude Console atau memasukkan kunci API tanpa konfigurasi awal. Dalam Claude Desktop 4.23118.0 atau lebih baharu, pautan tersebut disembunyikan pada log masuk komputer di mana organisasi menyekat akaun lain, walaupun tanpa pengurusan peranti.

Tugas Cowork yang dijalankan pada mesin anda sendiri menggunakan mesin maya, jadi ia memerlukan virtualisasi perkakasan dihidupkan dan pengguna anda berada dalam kumpulan kvm (sudo usermod -aG kvm $USER, kemudian log keluar dan log masuk semula). Tidak semua tugas Cowork dijalankan secara setempat. Sejak 6 Oktober 2026, tugas Cowork baharu pada pelan Pro, Max dan Ultra dijalankan dalam awan Anthropic, tanpa tetapan untuk mengekalkannya pada komputer anda, dan organisasi Team serta Enterprise yang menghidupkan pengalaman Chat dan Cowork bersepadu juga menjalankan tugas dalam awan. Pada pelan tersebut, mesin maya hanya penting untuk tugas yang telah dimulakan pada komputer anda, dan Anthropic menghalakan kerja baharu yang perlu kekal setempat ke Claude Code dalam aplikasi desktop.

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 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 berjalan pada infrastruktur awan dan bukannya pada mesin anda: secara lalai ia menggunakan infrastruktur Anthropic, atau persekitaran self-hosted organisasi anda sendiri jika ia menghalakan sesi ke sana. Ia sentiasa menggunakan kelayakan langganan anda.

Had pelayar adalah perkara berguna yang perlu difahami. Pelayar dengan sendirinya 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, aplikasi desktop atau runner self-hosted yang dikonfigurasikan. Sesi awan Cowork boleh mencapai folder tempatan yang disambungkan melalui aplikasi desktop semasa ia dibuka.

Apa yang CLI tawarkan berbanding aplikasi web

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

  • Ia membaca dan menyunting fail dalam direktori kerja anda, serta meminta pengesahan sebelum menggunakan suntingan dalam mod Manual. Mod Auto menggunakan suntingan dengan pemeriksaan keselamatan latar belakang dan merupakan tetapan lalai terbina dalam untuk sesi interaktif semasa, melainkan tetapan atau polisi mengubahnya. Mulakan dengan claude --permission-mode default untuk menyemak tindakan sendiri.
  • Ia menjalankan arahan shell di bawah mod kebenaran sesi, 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, yang merupakan perkara yang anda gunakan daripada cron job atau pipeline. Dalam Claude Code 2.1.302 atau lebih baharu, larian ini bermula dalam mod Manual apabila tiada mod kebenaran ditetapkan, dan tindakan yang memerlukan kelulusan akan ditolak melainkan anda menyediakan mekanisme kelulusan; hantar --permission-mode auto untuk meminta pengelas menyemaknya. Cara jawapan itu dibaca adalah 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 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 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 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 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 pemasangan yang disyorkan. Pemasang natif memuat turun binari yang telah dikompil, dan binari tersebut tidak berjalan pada Node.js.

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

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

Node.js hanya penting pada laluan npm. Setakat Oktober 2026, pakej npm meminta Node.js 22 atau lebih baharu, dan pada Node.js yang lebih lama, npm mencetak amaran EBADENGINE dan bukannya gagal, kerana pakej tersebut menarik binari natif yang sama sebagai dependency per-platform dan memautkannya ke tempatnya.

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

Pada npm 12, langkah postinstall dilangkau secara lalai, menyebabkan claude tidak dapat berjalan. Jika npm --version bermula dengan 12, gunakan pemasang natif di atas atau tambahkan Claude Code ke allow-scripts dalam konfigurasi npm pengguna anda sebelum memasang semula.

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

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 tandatangannya sendiri 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 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 akan 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 salin URL pengesahan berasingan yang ditunjukkan di atas prompt tampal terminal. Buka URL tersebut dalam pelayar pada komputer anda sendiri. Selepas anda mendaftar masuk melalui URL tersebut, pelayar akan memaparkan kod log masuk dan bukannya kembali ke localhost. Tampal kod tersebut ke dalam terminal pada prompt Paste code here if prompted, dan terminal akan melaporkan Login successful.

Untuk sesi yang perlu bermula 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 selama satu tahun. Tempat untuk menyimpannya, dan cara untuk 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 adalah 4 GB RAM atau lebih. Oleh itu, pada instans 1 GB dengan memori bebas yang sedikit, pembunuh kehabisan memori (out-of-memory killer) kernel boleh menamatkan pemasangan, dan pemasang kemudian melaporkan:

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, namun 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 membenarkan 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 biasanya meletakkan kelayakan yang sama dalam Keychain yang disulitkan, tetapi akan menggunakan fail biasa yang sama apabila Keychain menolak penulisan tersebut. 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 kunci API pada masa yang sama. Apabila ANTHROPIC_API_KEY ditetapkan dalam shell anda, Claude Code akan menggunakannya sebaik sahaja anda meluluskannya, jadi 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, jika log masuk tidak dapat diperbaharui, setiap permintaan model 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, dengan pengecualian pada beberapa pelan Enterprise. Akaun Pro, Max, Ultra atau Team membolehkan anda log masuk ke claude.ai dalam pelayar, aplikasi desktop, CLI dan sambungan VS Code, dan ia merupakan langganan yang sama setiap kali. Begitu juga dengan akaun Enterprise pada pelan baharu atau layan diri di luar organisasi yang sedia untuk HIPAA, yang mana satu seat Enterprise merangkumi Claude Code. Pelan Enterprise yang lebih lama mengekalkan jenis seat yang berasingan: di situ antara muka Claude Code memerlukan seat Chat + Claude Code, atau seat Premium pada pelan berasaskan seat yang lebih lama, manakala seat Chat-sahaja atau Standard tidak merangkuminya. Organisasi Enterprise yang sedia untuk HIPAA juga menggunakan jenis seat Chat dan Chat + Claude Code yang berasingan. Pada pelan Enterprise yang sedia untuk HIPAA, Claude Code memerlukan seat Chat + Claude Code, dan perlindungan BAA untuk terminal serta tab Code dalam Claude Desktop memerlukan konfigurasi HIPAA atau perlindungan pengekalan data sifar yang berkenaan. Sambungan VS Code dan JetBrains serta sesi awan tidak dilindungi oleh konfigurasi HIPAA. Pada pelan Pro, Max, Ultra, Team dan Enterprise berasaskan seat, ia juga merupakan satu peruntukan penggunaan merentas kesemuanya, jadi penggunaan CLI yang lama pada pelayan anda akan mengurangkan baki yang ada pada aplikasi desktop, dan had tetingkap yang telah anda capai dan tindakan yang perlu diambil adalah perkara yang perlu diselesaikan apabila mana-mana antara muka mula menolak tugasan. Pelan Enterprise berasaskan penggunaan tidak mempunyai peruntukan yang boleh habis: setiap antara muka dibilkan pada kadar API bermula dari token pertama. Pelan percuma claude.ai tidak merangkumi akses Claude Code. Tanpa pelan berbayar, CLI boleh log masuk dengan akaun Claude Console, atau, jika organisasi anda menggunakan Amazon Bedrock, Google Cloud's Agent Platform atau Microsoft Foundry, sahkan melalui penyedia tersebut tanpa log masuk pelayar. Dengan langganan claude.ai atau log masuk SSO, bahagian Claude Code pada aplikasi desktop memerlukan pelan berbayar. Mod pihak ketiga yang dikonfigurasikan secara berasingan seperti yang diterangkan di atas dan, jika ditawarkan, pilihan akaun Claude API pada peranti yang tidak diurus membolehkan aplikasi desktop menggunakan bil Console atau penyedia sebagai ganti.

API ialah produk berbeza dengan bil yang berbeza. Akaun Console dibilkan setiap token berdasarkan apa yang anda hantar sebenarnya, yang lebih sesuai untuk servis yang anda bina berbanding anda menaip di terminal. Menetapkan ANTHROPIC_API_KEY mengalihkan CLI ke laluan bil tersebut, dan itu adalah pilihan yang anda buat, bukan sandaran. Dalam mod standardnya, aplikasi desktop log masuk dengan OAuth, dan dalam mod pihak ketiga ia menggunakan kelayakan dalam konfigurasinya sendiri.

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 menimbangkan bil setiap token berbanding pelan bulanan, API berbanding langganan 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. Selesaikan masalah ini 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-nya di dalam direktori sambungan.

Error loading shared library libstdc++.so.6. Sama ada pemasang memuat turun varian binari yang salah, biasanya binaan musl pada sistem glibc, atau anda berada pada sistem musl yang kekurangan pustaka runtime. Varian yang salah berlaku apabila pakej cross-compilation musl hadir dan pengesanan tersalah baca pakej tersebut. 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 adalah 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 perlukan, kerana salinan lama yang berada lebih awal dalam PATH anda adalah punca pepijat yang telah dibaiki kelihatan seperti belum dibaiki.

Tempat untuk menyemak status semasa

Polisi daftar masuk akaun Claude API, tetapan lalai kebenaran tanpa pengawasan, aliran daftar masuk SSH dan storan kelayakan telah disemak pada 7 November 2026; nombor versi dan tarikh lain dalam panduan ini kekal sebagai gambaran pada Oktober 2026. Bentuknya adalah perkara yang kekal benar: empat permukaan, satu daftar masuk merentas pelan berbayar, dan satu keputusan tentang sama ada CLI tersebut milik pengguna anda atau milik keseluruhan mesin.

FAQ

Adakah aplikasi desktop Claude untuk Linux?

Ya. Setakat Oktober 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 serta kunci penandatanganannya, 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 hotkey global Quick Entry berfungsi pada X11 tetapi memerlukan portal GlobalShortcuts persekitaran desktop anda pada sesi Wayland asli. Fedora dan 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 pemasangan yang disyorkan. curl -fsSL https://claude.ai/install.sh | bash memuat turun binari terkompil 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 Oktober 2026. Pada Node.js yang lebih lama, npm akan memaparkan amaran EBADENGINE dan pemasangan tetap selesai, kerana binari asli yang sama ditarik masuk sebagai dependency bagi setiap 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 untuk log masuk ke Claude Code melalui SSH?

Jalankan claude dan salin URL pengesahan berasingan yang dipaparkan di atas prompt tampal terminal. Buka URL tersebut dalam pelayar web pada komputer anda sendiri, bukan pada pelayan. Selepas anda log masuk melalui URL tersebut, pelayar akan memaparkan kod log masuk dan bukannya kembali ke localhost. 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; macOS biasanya menggunakan Keychain yang disulitkan tetapi akan kembali kepada fail teks biasa yang sama apabila Keychain menolak penulisan. Sebarang proses yang berjalan sebagai pengguna anda boleh membaca fail kelayakan Linux tersebut. Oleh itu, sandaran /home atau imej mesin akan membawa 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, Ultra atau Team membolehkan anda log masuk ke claude.ai, aplikasi desktop, CLI dan sambungan VS Code dengan satu akaun, begitu juga dengan Enterprise. Walau bagaimanapun, pelan Enterprise yang lebih lama dan yang sedia untuk HIPAA hanya menyertakan Claude Code pada tempat duduk (seats) yang menyokongnya, seperti tempat duduk Chat + Claude Code. Organisasi yang sedia untuk HIPAA menggunakan jenis tempat duduk Chat dan Chat + Claude Code yang berasingan, dan hanya tempat duduk Chat + Claude Code yang menyertakan Claude Code. Pelan percuma claude.ai tidak menyertakan Claude Code, jadi CLI terminal memerlukan pelan berbayar, akaun Claude Console, atau penyedia awan yang digunakan oleh organisasi anda, seperti Amazon Bedrock, Google Cloud's Agent Platform atau Microsoft Foundry. Aplikasi desktop menyokong log masuk langganan atau SSO serta inferens pihak ketiga yang dikonfigurasikan; pada peranti tanpa konfigurasi Claude Desktop, versi 3.1623.1 atau lebih baharu juga menawarkan pilihan akaun Claude API yang menerima log masuk Console atau kunci API tanpa konfigurasi awal. Dalam versi 4.23118.0 atau lebih baharu, pautan tersebut disembunyikan pada log masuk komputer di mana organisasi menyekat akaun lain, walaupun tanpa pengurusan peranti. API dibilkan secara berasingan bagi setiap token daripada akaun Console, yang merupakan produk berbeza daripada langganan.

Adakah artikel ini berguna?