Claude trên Linux: cài Desktop App và CLI

Những phần nào của Claude hiện chạy native trên Linux

Claude trên Linux chạy trên 4 surface riêng biệt. Tính đến October 2026, cả 4 surface đều hoạt động trên máy Ubuntu hoặc Debian thông thường. Desktop app được cài từ apt repository của Anthropic và hiện ở trạng thái beta. Claude Code CLI (command line interface) là một binary đã biên dịch. Nó chạy trên nhiều distribution hơn desktop app. Web app tại claude.ai chỉ cần browser. API là một HTTPS endpoint mà bạn gọi từ code của mình.

Ba tính năng có trên macOS và Windows đang bị thiếu hoặc bị giới hạn trong bản Linux desktop beta: Computer Use, cho phép Claude điều khiển app trên màn hình; voice dictation; và Quick Entry global hotkey. Anthropic ghi rõ Computer Use và dictation chưa có trên Linux. Quick Entry hotkey hoạt động trong X11 session. Trong native Wayland session, tính năng này cần GlobalShortcuts portal của desktop environment. Nếu không có portal đó, hotkey sẽ không khả dụng. echo $XDG_SESSION_TYPE in x11 hoặc wayland và cho biết bạn đang ở trường hợp nào. CLI có voice dictation riêng. Vì vậy, phần thiếu dictation nằm ở desktop app, không phải ở bản thân Claude.

Tình trạng hỗ trợ có thể thay đổi. Hãy xem trang này là mô tả về các surface hiện có và kiểm tra trạng thái hiện tại trước khi dựa vào chúng để lập kế hoạch. Phần cuối liệt kê các trang cần kiểm tra.

Cài ứng dụng Claude Desktop trên Ubuntu hoặc Debian

Yêu cầu được nêu trong tài liệu là Ubuntu 22.04 trở lên hoặc Debian 12 trở lên, chạy trên x86_64 (mà dpkg gọi là amd64) hoặc arm64. Các bản phân phối dựa trên Debian khác có thể hoạt động nhưng chưa được kiểm thử. Fedora và RHEL hiện chưa có package, nên trên các hệ thống đó bạn dùng CLI hoặc trình duyệt.

Hãy cài đặt từ apt repository thay vì từ file .deb đã tải xuống. Ứng dụng Linux không có cơ chế tự cập nhật, nên các phiên bản mới chỉ đến qua package manager. Việc đăng ký repository cho phép apt upgrade nhìn thấy các phiên bản đó.

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 phải in ra fingerprint 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Hãy đối chiếu fingerprint trước khi đăng ký repository, vì signing key mà bạn chưa kiểm tra là key bạn đang tin tưởng một cách mù quáng. Nếu gpg báo file không chứa dữ liệu OpenPGP hợp lệ, quá trình tải xuống đã thất bại và apt update sẽ fail ở bước sau với NO_PUBKEY BAA929FF1A7ECACE.

Đăng ký repository là một dòng deb được ghi vào /etc/apt/sources.list.d/claude-desktop.list. Hãy sao chép dòng đó từ trang cài đặt Linux của Anthropic, code.claude.com/docs/en/desktop-linux, đúng nguyên văn như trên trang. Địa chỉ repository là phần có khả năng thay đổi nhất trong quy trình này. Nếu tự gõ dòng lệnh theo trí nhớ, bạn có thể phải xử lý E: Unable to locate package claude-desktop sau đó. Hãy đọc dòng lệnh trước khi paste: arch=amd64,arm64 khiến apt trên mọi architecture khác không tìm thấy package nào, còn signed-by= trỏ đến keyring file bạn vừa kiểm tra. Cách này giới hạn key đó cho riêng repository này thay vì tin tưởng nó cho mọi dữ liệu khác mà apt đọc.

sudo apt update && sudo apt install claude-desktop

Hãy khởi động ứng dụng từ application launcher hoặc chạy claude-desktop trong terminal. Đăng nhập bằng tài khoản claude.ai hoặc qua SSO (single sign-on) của tổ chức nếu công ty bạn đã cấu hình. Đây là 2 phương thức đăng nhập được trang cài đặt Linux của Anthropic liệt kê; người dùng API key được hướng dẫn sử dụng CLI. Anthropic cũng mô tả riêng một chế độ triển khai thứ hai của cùng ứng dụng: khi được cấu hình với inference provider (Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, LLM gateway hoặc trực tiếp với Anthropic API), màn hình đăng nhập sẽ cho phép bỏ qua bước xác thực với Anthropic. Provider sẽ xử lý inference và billing cho Chat, Cowork và Code. Tài liệu đó chỉ định vị trí cấu hình được quản lý trên Linux là /etc/claude-desktop/managed-settings.json, và trang cài đặt Linux hiện liên kết đến tài liệu triển khai của bên thứ ba. Trên các thiết bị chưa có cấu hình Claude Desktop, Claude Desktop 3.1623.1 trở lên cũng hiển thị tùy chọn Use your Claude API account trên màn hình đăng nhập thông thường. Tại đó, bạn có thể đăng nhập bằng Claude Console hoặc nhập API key mà không cần cấu hình trước. Trong Claude Desktop 4.23118.0 trở lên, liên kết này bị ẩn tại máy tính đăng nhập mà tổ chức chặn các account khác, kể cả khi không quản lý thiết bị.

Các task Cowork chạy trên máy của bạn sử dụng virtual machine. Vì vậy, hardware virtualization phải được bật và user của bạn phải thuộc group kvm (chạy sudo usermod -aG kvm $USER, sau đó đăng xuất và đăng nhập lại). Không phải task Cowork nào cũng chạy cục bộ. Từ October 6, 2026, các task Cowork mới trên các plan Pro, Max và Ultra chạy trên cloud của Anthropic. Không có setting để giữ các task đó trên máy tính của bạn. Các tổ chức Team và Enterprise đã bật trải nghiệm Chat và Cowork hợp nhất cũng chạy task trên cloud. Với các plan đó, virtual machine chỉ cần thiết cho những task đã bắt đầu trên máy tính của bạn. Anthropic hướng dẫn chuyển các công việc mới bắt buộc phải chạy cục bộ sang Claude Code trong ứng dụng desktop.

E: Unable to locate package claude-desktop có nghĩa là apt chưa từng đọc repository. cat /etc/apt/sources.list.d/claude-desktop.list phải hiển thị dòng deb bạn đã ghi, còn dpkg --print-architecture phải in ra amd64 hoặc arm64 vì không có package nào được phát hành cho các architecture khác. Sau đó, bản cập nhật sẽ đến cùng các bản cập nhật hệ thống khác từ sudo apt update && sudo apt upgrade.

Những gì chỉ có trong trình duyệt

claude.ai hoạt động trên mọi trình duyệt hiện đại trên mọi distribution, nên đây là lựa chọn dành cho Fedora, RHEL, Arch, openSUSE và mọi hệ thống khác không có package. Trình duyệt cũng cung cấp Claude Code trên web. Trong đó, session chạy trên hạ tầng cloud thay vì trên máy của bạn: mặc định là hạ tầng của Anthropic, hoặc môi trường self-hosted riêng của tổ chức bạn nếu tổ chức định tuyến session đến đó. Tính năng này luôn dùng thông tin xác thực subscription của bạn.

Điều quan trọng cần hiểu là giới hạn của trình duyệt. Bản thân trình duyệt không thể đọc các file trên server của bạn hoặc chạy command trên đó. Mọi tác vụ tác động đến máy của bạn đều cần phần mềm chạy trên chính máy đó, tức là CLI, desktop app hoặc self-hosted runner đã được cấu hình. Các session Cowork trên cloud có thể truy cập những thư mục cục bộ đã kết nối thông qua desktop app khi app vẫn đang mở.

CLI cung cấp những gì mà web app không có

Khởi chạy claude trong một thư mục thì nó sẽ làm việc trên thư mục đó. Đó là điểm khác biệt, và mọi thứ khác đều bắt nguồn từ đây.

• Nó đọc và chỉnh sửa các file trong thư mục làm việc của bạn, đồng thời hỏi trước khi áp dụng chỉnh sửa trong Manual mode. Auto mode áp dụng chỉnh sửa cùng các kiểm tra an toàn chạy nền và là chế độ mặc định tích hợp sẵn cho các phiên tương tác hiện tại, trừ khi settings hoặc policy thay đổi chế độ này. Hãy bắt đầu bằng claude --permission-mode default để tự xem xét các hành động.
• Nó chạy shell command theo permission mode của phiên, nên có thể build project, chạy test suite, đọc log hoặc kiểm tra service ngay trên máy.
• Nó chạy mà không cần phiên tương tác: claude -p "read the nginx error log and summarise it" in ra một câu trả lời rồi thoát. Đây là cách bạn dùng từ cron job hoặc pipeline. Trong Claude Code 2.1.302 trở lên, các lần chạy này bắt đầu ở Manual mode khi chưa đặt permission mode, và các hành động cần phê duyệt sẽ bị từ chối nếu bạn không cung cấp cơ chế phê duyệt; truyền --permission-mode auto để classifier xem xét chúng. Bạn có thể tự đặt định dạng của câu trả lời, vì output style chỉnh sửa system prompt đứng sau mọi câu trả lời và có thể giữ cho lần chạy bằng script ngắn gọn, trong khi phiên tương tác vẫn tự giải thích.
• Nó kết nối các server MCP (model context protocol) bằng claude mcp add, cung cấp cho model các tool vượt ra ngoài filesystem.
• Nó chạy ở nơi hoàn toàn không có desktop đồ họa, tức là mọi VPS (virtual private server) bạn thuê.

Điểm cuối này là lý do tài liệu hướng dẫn server cần đề cập đến CLI. Server thuê có SSH (secure shell) và không có gì khác, nên terminal là giao diện duy nhất có thể dùng để quản trị máy. Cách chạy này có các quy tắc riêng. Chạy Claude Code trên VPS bên trong tmux trình bày đầy đủ các quy tắc đó, còn dùng Claude cho công việc sysadmin hằng ngày trình bày những việc đáng giao cho nó.

Tích hợp với editor nằm ở giữa hai cách trên. VS Code extension cần VS Code 1.94.0 trở lên và cung cấp một panel đồ họa bên trong editor, kèm diff và bước xem xét plan. Extension này đóng gói một bản CLI riêng cho panel đó và không đặt claude vào PATH của bạn, nên khi nhập claude trong integrated terminal, bạn vẫn cần cài bản standalone. Các editor được xây dựng trên VS Code cài cùng extension từ registry Open VSX, và cũng có plugin JetBrains.

Bạn có cần Node.js để chạy Claude Code trên Linux không?

Không cần nếu dùng cách cài được khuyến nghị. Native installer tải xuống một binary đã compile, và binary đó không chạy trên Node.js.

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

claude --version phải in ra một version number, chẳng hạn 2.1.211 (Claude Code). Nếu kết quả có vẻ bất thường, chạy claude doctor. Lệnh này in thông tin chẩn đoán chỉ đọc về bản cài đặt và các settings file của bạn mà không khởi động session.

Node.js chỉ cần thiết khi dùng npm route. Tính đến October 2026, npm package yêu cầu Node.js 22 trở lên. Trên Node.js cũ hơn, npm in ra cảnh báo EBADENGINE thay vì fail, vì package kéo cùng native binary vào dưới dạng per-platform dependency rồi link binary đó vào đúng vị trí.

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

Trên npm 12, postinstall step bị bỏ qua theo mặc định, khiến claude không chạy được. Nếu npm --version khởi động cùng 12, hãy dùng native installer ở trên hoặc thêm Claude Code vào allow-scripts trong npm configuration của user trước khi cài lại.

Không chạy lệnh đó với sudo. Tài liệu cảnh báo không dùng sudo npm install -g vì cách này tạo các file do root sở hữu trong global npm prefix, khiến lần cài đặt hoặc update tiếp theo của user không có quyền root bị lỗi permission. Khi npm global directory không cho phép ghi, background auto-update sẽ dừng hoạt động và claude doctor liệt kê các cách khắc phục.

Anthropic cũng phát hành các package repository có chữ ký cho Debian, Fedora, RHEL và Alpine, nên sudo apt install claude-code hoạt động gần giống package trên desktop, với signing key riêng tại https://downloads.claude.ai/keys/claude-code.asc.

Cài theo user hay trên toàn hệ thống?

Installer native cài theo từng user. Nó đặt một launcher tại ~/.local/bin/claude dưới dạng symlink trỏ đến ~/.local/share/claude/versions/, không cần root và tự cập nhật trong background. Mỗi user trên máy có một bản riêng với version riêng.

Cài bằng package manager là cài trên toàn hệ thống. Một binary phục vụ tất cả user, cần root và không tự update thông qua Claude Code. Bạn nâng cấp bằng sudo apt update && sudo apt upgrade claude-code, cùng lệnh bạn đã dùng cho mọi thứ khác trên máy.

Chọn cài theo từng user trên máy mà bạn đăng nhập bằng tài khoản của mình; đây là trường hợp phổ biến khi làm việc với VPS. Chọn cài bằng package trên shared server hoặc machine image khi bạn muốn mọi người dùng chung một version và muốn cập nhật theo lịch của mình. Với native install, 2 thiết lập trong ~/.claude/settings.json quyết định cách update:

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

Channel stable dùng một release cũ khoảng 1 tuần và bỏ qua các release có regression nghiêm trọng. DISABLE_AUTOUPDATER chỉ tắt việc kiểm tra trong background, nên claude update vẫn hoạt động và bạn vẫn kiểm soát thời điểm version mới được cài. Điều này quan trọng trên server có job chạy lâu ở chế độ không giám sát, khi bạn không muốn binary tự thay đổi trong lúc job đang chạy.

Đăng nhập qua SSH và duy trì session

Có hai vấn đề riêng của Linux thường xuất hiện khi bạn chạy CLI lần đầu trên server thuê. Quy trình đăng nhập yêu cầu browser, nhưng server không có browser. Khi kết nối SSH bị ngắt, công việc đang chạy cũng bị ngắt theo.

tmux giải quyết vấn đề thứ hai. Một session tmux thuộc về tmux server trên máy từ xa, không thuộc về kết nối của bạn. Vì vậy, khi đường truyền bị ngắt, process vẫn tiếp tục chạy.

tmux new -s claude
claude

Detach bằng Ctrl-b rồi d, sau đó quay lại bằng tmux attach -t claude.

Đăng nhập là vấn đề đầu tiên. Chạy claude rồi copy URL authorisation riêng được hiển thị phía trên prompt paste của terminal. Mở URL đó trong browser trên máy tính của bạn. Sau khi đăng nhập qua URL đó, browser hiển thị login code thay vì quay lại localhost. Paste code đó vào terminal tại prompt Paste code here if prompted. Terminal sẽ báo Login successful.

Nếu cần khởi động session mà không có ai theo dõi, claude setup-token sẽ mở cùng trang authorisation trong browser và in OAuth token có thời hạn một năm ra terminal. Token không được lưu ở đâu, nên hãy copy token rồi đặt vào nơi bạn cần.

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Token này yêu cầu paid plan và chỉ có thể thực hiện model request. Hãy coi token như password có thời hạn một năm. Việc lưu token ở đâu và cách ngăn agent đọc ngược token ra là nội dung của giữ secret ngoài tầm với của AI agent.

Các server nhỏ còn gặp thêm một giới hạn. Việc cài đặt cần khoảng 512 MB memory trống. Hardware requirement được tài liệu hóa để chạy phần mềm là 4 GB RAM trở lên. Vì vậy, trên instance 1 GB có rất ít memory trống, kernel out-of-memory killer có thể kết thúc quá trình cài đặt, sau đó installer sẽ báo:

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

Thêm swap rồi chạy lại installer. Swap là disk space mà kernel dùng làm memory tràn. Swap chậm hơn RAM rất nhiều, nhưng đủ để hoàn tất quá trình cài đặt.

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

swapon chỉ enable file này cho lần boot hiện tại. Thêm một dòng cho /swapfile vào /etc/fstab nếu muốn swap hoạt động lại sau khi reboot. Những gì cần lock down trước khi cho agent chạy command trên live server là nội dung của chạy Claude Code an toàn trên VPS.

Vị trí lưu credential Claude trên Linux

Trên Linux, /login ghi credential vào ~/.claude/.credentials.json với file mode 0600. macOS thường lưu credential đó trong Keychain được mã hóa, nhưng sẽ chuyển sang cùng file dạng plain text nếu Keychain từ chối thao tác ghi. Trên Linux, token là một plain file trong thư mục home của bạn, và mọi process chạy bằng user của bạn đều có thể đọc file này. Đặt CLAUDE_CONFIG_DIR sẽ chuyển file vào thư mục đó.

Điều này dẫn đến 2 rủi ro. Bản backup của /home chứa thông tin đăng nhập còn hiệu lực, nên nếu copy backup đó sang máy dùng chung, bạn sẽ giao account của mình cho bất kỳ ai có thể đọc nó. Machine image được tạo từ một máy đã đăng nhập cũng đưa thông tin đăng nhập đó vào mọi instance được clone từ image. Hãy chạy /logout trước khi tạo snapshot.

Thứ tự ưu tiên credential dễ gây nhầm lẫn khi bạn vừa có subscription vừa có API key. Khi ANTHROPIC_API_KEY được set trong shell, Claude Code sẽ dùng credential này sau khi bạn chấp thuận, nên subscription không được sử dụng còn API key vẫn bị tính phí theo token. /status cho biết credential nào đang active, còn unset ANTHROPIC_API_KEY đưa bạn trở lại login bằng subscription.

Login sẽ hết hạn. Trong vòng 3 ngày trước khi hết hạn, dòng khởi động sẽ hiển thị Your login expires in 3 days; cảnh báo này không bao giờ chặn request. Sau khi hết hạn, nếu login không thể được refresh, mọi request đến model đều fail với Login expired · Please run /login. Hãy biết điều này trước khi để một session không có người giám sát chạy suốt cuối tuần, vì session đó sẽ ngừng xử lý và không thể tự khôi phục.

Một subscription Claude có bao phủ tất cả không?

Một gói trả phí bao phủ mọi giao diện bằng cùng một thông tin đăng nhập, ngoại trừ một số gói Enterprise. Tài khoản Pro, Max, Ultra hoặc Team cho phép bạn đăng nhập vào claude.ai trên trình duyệt, desktop app, CLI và extension VS Code; mỗi nơi đều dùng cùng một subscription. Tài khoản Enterprise trên gói mới hoặc gói self-serve, không thuộc tổ chức đã sẵn sàng cho HIPAA, cũng hoạt động như vậy; một Enterprise seat duy nhất đã bao gồm Claude Code. Các gói Enterprise cũ vẫn tách loại seat: khi đó, các giao diện Claude Code cần seat Chat + Claude Code hoặc seat Premium trên gói tính theo seat đời cũ; seat Chat-only hoặc Standard không bao gồm các giao diện này. Tổ chức Enterprise đã sẵn sàng cho HIPAA cũng dùng riêng các loại seat Chat và Chat + Claude Code. Trên gói Enterprise đã sẵn sàng cho HIPAA, Claude Code cần seat Chat + Claude Code; để terminal và tab Code của Claude Desktop được BAA bao phủ, cần cấu hình HIPAA hoặc phạm vi zero data retention áp dụng. Extension VS Code và JetBrains cùng các cloud session không được cấu hình HIPAA bao phủ. Trên các gói Pro, Max, Ultra, Team và Enterprise tính theo seat, tất cả các giao diện cũng dùng chung một hạn mức sử dụng. Vì vậy, một phiên CLI chạy lâu trên server sẽ làm giảm phần hạn mức còn lại của desktop app. Khi một giao diện bắt đầu từ chối xử lý, bạn cần xác định bạn đã chạm hạn mức nào và cần làm gì tiếp theo. Gói Enterprise tính theo mức sử dụng không có hạn mức bao gồm để dùng hết: mọi giao diện đều tính phí theo mức API ngay từ token đầu tiên. Gói claude.ai miễn phí không bao gồm quyền truy cập Claude Code. Nếu không có gói trả phí, CLI có thể đăng nhập bằng tài khoản Claude Console. Nếu tổ chức của bạn dùng Amazon Bedrock, Google Cloud's Agent Platform hoặc Microsoft Foundry, CLI cũng có thể xác thực qua provider đó mà không cần đăng nhập trên trình duyệt. Khi dùng subscription claude.ai hoặc đăng nhập qua SSO, các phần Claude Code của desktop app cần gói trả phí. Chế độ bên thứ ba được cấu hình riêng như mô tả ở trên và, nếu được cung cấp, tùy chọn tài khoản Claude API trên các thiết bị không được quản lý cho phép desktop app dùng billing của Console hoặc provider.

API là một sản phẩm khác với cách tính phí khác. Tài khoản Console tính phí theo token dựa trên nội dung bạn thực sự gửi, phù hợp với một service bạn đang xây dựng hơn là việc bạn nhập lệnh trực tiếp trong terminal. Đặt ANTHROPIC_API_KEY sẽ chuyển CLI sang cách tính phí đó. Đây là lựa chọn do bạn chủ động thực hiện, không phải phương án dự phòng. Ở chế độ chuẩn, desktop app đăng nhập bằng OAuth. Ở chế độ bên thứ ba, app dùng credential trong cấu hình riêng của nó.

Giá và giới hạn của các gói thay đổi quá thường xuyên nên không thể ghi lại đầy đủ ở đây. Hai trang sau theo dõi các con số hiện tại: chi phí thực tế của Claude Code và bạn cần gói Claude nào. Nếu bạn đang cân nhắc billing theo token so với gói tháng, so sánh API với subscription sẽ giúp xác định điểm hòa vốn.

Các lỗi cài đặt bạn thực sự sẽ gặp

bash: claude: command not found ngay sau khi cài đặt thành công. Binary nằm tại ~/.local/bin/claude nhưng thư mục đó không có trong search path của shell. Xác nhận bằng echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin". Lệnh này không in gì nếu entry bị thiếu. Sửa cho bash bằng echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc, sau đó chạy source ~/.bashrc. Việc tự cài VS Code extension không bao giờ tạo file đó, vì extension giữ bản CLI bên trong thư mục extension.

Error loading shared library libstdc++.so.6. Installer có thể đã tải sai biến thể binary, thường là bản build cho musl trên hệ thống glibc, hoặc bạn đang dùng hệ thống musl nhưng thiếu runtime library. Sai biến thể xảy ra khi có các package cross-compilation cho musl và bước detection nhận diện sai. Chạy ldd --version 2>&1 | head -1: output có tên GNU libc hoặc GLIBC nghĩa là bạn đang dùng glibc nhưng đã nhận binary sai. Khi đó, xóa bản cài đặt và chạy lại installer. Trên Alpine và các hệ thống musl khác, cách sửa ngược lại là apk add libgcc libstdc++ ripgrep.

Có 2 bản claude trên cùng một máy. which -a claude liệt kê mọi kết quả khớp trong PATH. Bản cài native là symlink từ ~/.local/bin/claude đến ~/.local/share/claude/versions/, bản cài npm local cũ nằm dưới ~/.claude/local/, còn npm -g ls @anthropic-ai/claude-code cho biết có bản cài npm global. Xóa những bản bạn không muốn dùng, vì bản cũ nằm trước trong PATH sẽ khiến một lỗi đã sửa trông như vẫn chưa được sửa.

Nơi kiểm tra trạng thái hiện tại

• Trạng thái Linux desktop, yêu cầu và lệnh cài đặt: code.claude.com/docs/en/desktop-linux
• Các distribution được hỗ trợ và mọi phương thức cài đặt CLI: code.claude.com/docs/en/setup
• Những nền tảng có app để tải xuống: claude.com/download
• Mỗi plan bao gồm những gì và chi phí bao nhiêu: claude.com/pricing

Chính sách đăng nhập tài khoản Claude API, mặc định cấp quyền khi chạy không cần giám sát, quy trình đăng nhập SSH và cách lưu credential được kiểm tra vào ngày November 7, 2026; các số phiên bản và ngày tháng khác trong hướng dẫn này vẫn là snapshot của October 2026. Điều không đổi là mô hình tổng thể: bốn bề mặt, một lần đăng nhập cho các bề mặt có tính phí và một quyết định về việc CLI thuộc về user của bạn hay toàn bộ máy.

FAQ

Có ứng dụng Claude cho máy tính để bàn trên Linux không?

Có. Tính đến tháng 10 năm 2026, ứng dụng đang ở giai đoạn beta và hỗ trợ Ubuntu 22.04 trở lên và Debian 12 trở lên trên amd64 hoặc arm64. Cài đặt bằng sudo apt install claude-desktop sau khi thêm apt repository và signing key của Anthropic, để các phiên bản mới được cài cùng với các bản nâng cấp hệ thống thông thường. Bản Linux có các tab giống ứng dụng macOS, bao gồm cả tab Claude Code. Computer Use và đọc chính tả bằng giọng nói chưa có trên bản Linux. Phím tắt toàn cục Quick Entry hoạt động trên X11, nhưng cần GlobalShortcuts portal của desktop environment khi chạy trên phiên Wayland native. Fedora và RHEL chưa có package, nên trên các distribution này hãy dùng CLI hoặc claude.ai trong trình duyệt.

Tôi có cần Node.js để chạy Claude Code trên Linux không?

Không cần nếu bạn dùng cách cài đặt được khuyến nghị. curl -fsSL https://claude.ai/install.sh | bash tải một binary đã biên dịch, không dùng Node.js khi runtime. Node.js chỉ cần thiết nếu bạn cài npm package. Tính đến tháng 10 năm 2026, package này yêu cầu Node.js 22 trở lên. Với Node.js cũ hơn, npm in cảnh báo EBADENGINE nhưng quá trình cài đặt vẫn hoàn tất, vì cùng binary native được tải xuống dưới dạng dependency theo từng platform. Không bao giờ cài bằng sudo npm install -g, vì lệnh này tạo các file thuộc sở hữu root trong npm prefix của bạn và làm hỏng các lần update sau.

Làm cách nào để đăng nhập Claude Code qua SSH?

Chạy claude rồi sao chép URL authorisation riêng được hiển thị phía trên prompt dán của terminal. Mở URL đó trong trình duyệt trên máy tính của bạn, không mở trên server. Sau khi đăng nhập qua URL đó, trình duyệt hiển thị login code thay vì quay lại localhost. Dán code đó tại prompt Paste code here if prompted. Với các session khởi động khi không có người thao tác, chạy claude setup-token rồi đặt token được in ra làm CLAUDE_CODE_OAUTH_TOKEN ở mọi nơi cần dùng.

Claude Code lưu thông tin đăng nhập ở đâu trên Linux?

Thông tin được lưu trong ~/.claude/.credentials.json với file mode 0600, hoặc trong CLAUDE_CONFIG_DIR khi bạn đặt biến đó. Linux không dùng keychain. macOS thường dùng Keychain được mã hóa, nhưng sẽ fallback về cùng plain file nếu Keychain từ chối ghi. Bất kỳ process nào chạy dưới user của bạn đều có thể đọc credential file trên Linux. Vì vậy, một bản backup /home hoặc machine image có thể chứa login đang hoạt động. Hãy chạy /logout trước khi tạo snapshot hoặc sao chép system. Nếu ANTHROPIC_API_KEY cũng được đặt trong environment, nó sẽ được ưu tiên hơn subscription login đã lưu sau khi bạn approve. /status cho biết credential nào đang active.

Subscription Claude Pro có bao gồm CLI cũng như web app không?

Có. Gói Pro, Max, Ultra hoặc Team đăng nhập bạn vào claude.ai, desktop app, CLI và extension VS Code bằng cùng một account. Enterprise cũng hoạt động như vậy, ngoại trừ các gói Enterprise cũ và Enterprise hỗ trợ HIPAA chỉ bao gồm Claude Code trên những seat có quyền này, chẳng hạn seat Chat + Claude Code. Các tổ chức hỗ trợ HIPAA dùng riêng hai loại seat là Chat và Chat + Claude Code. Chỉ seat Chat + Claude Code mới bao gồm Claude Code. Gói claude.ai miễn phí không bao gồm Claude Code. Vì vậy, terminal CLI cần một gói trả phí, account Claude Console hoặc cloud provider mà tổ chức bạn sử dụng, chẳng hạn Amazon Bedrock, Agent Platform của Google Cloud hoặc Microsoft Foundry. Desktop app hỗ trợ đăng nhập bằng subscription hoặc SSO và inference của bên thứ ba đã được cấu hình. Trên các thiết bị không có cấu hình Claude Desktop, từ version 3.1623.1 trở lên còn có tùy chọn account Claude API, chấp nhận đăng nhập Console hoặc API key mà không cần cấu hình trước. Từ version 4.23118.0 trở lên, liên kết đó bị ẩn trên máy tính nơi tổ chức chặn các account khác, ngay cả khi không có device management. API được tính phí riêng theo từng token từ account Console. Đây là sản phẩm khác với subscription.