Cài đặt Claude Code — npm, trình cài đặt gốc, Windows, macOS, Linux (2026)

Node.js cho Claude Code: dùng phiên bản nào và cách không cần dùng Node.js

Cách cài bằng npm yêu cầu Node.js 18 trở lên — node -v để kiểm tra; nvm (nvm install --lts) để khắc phục. Node phiên bản cũ là lý do phổ biến nhất khiến bản cài đặt mới không khởi động được. Nếu Node không nằm trong bộ công cụ của bạn, hãy bỏ qua: trình cài đặt gốc bên dưới cung cấp tệp thực thi độc lập và tự cập nhật.

Lựa chọn 1 — npm (mọi hệ điều hành có Node.js 18 trở lên)

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

Nếu npm install -g thất bại với EACCES trên macOS hoặc Linux, đừng dùng sudo — thay vào đó, hãy sửa prefix của npm: npm config set prefix ~/.npm-global và thêm ~/.npm-global/bin vào PATH của bạn. Trên Windows, chạy lệnh cài đặt từ terminal thông thường (không có quyền quản trị).

Lựa chọn 2 — trình cài đặt gốc cho Mac, Linux và Windows (không cần Node.js)

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD (the one-liner people search for)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Cài đặt Claude Code trên Linux và Ubuntu

Trên Ubuntu, Debian, Fedora hoặc bất kỳ bản phân phối nào: trình cài đặt gốc (curl -fsSL https://claude.ai/install.sh | bash) đặt một tệp thực thi tự cập nhật trong thư mục cá nhân của bạn, không cần quyền root và không cần Node.js. Nếu bạn muốn dùng npm, trước tiên hãy cài Node 18 trở lên từ NodeSource hoặc nvm — Node từ apt của Ubuntu thường quá cũ — rồi npm install -g @anthropic-ai/claude-code. Trên máy chủ chỉ có terminal hoặc trong container, tệp thực thi gốc là lựa chọn tốt hơn; thêm hai biến cổng API vào ~/.bashrc và nó hoạt động qua SSH giống hệt như khi chạy cục bộ.

Bản dựng gốc tự cập nhật và tránh xung đột phiên bản Node. Đây là lựa chọn tốt hơn trên các máy mà Node chưa nằm trong bộ công cụ của bạn.

Lựa chọn 3 — ứng dụng máy tính hoặc tiện ích mở rộng IDE

Ứng dụng Claude cho máy tính tích hợp Claude Code, còn các tiện ích mở rộng VS Code và JetBrains sẽ cài CLI cho bạn khi sử dụng lần đầu. Xem hướng dẫn về web, ứng dụng máy tính và IDE để biết mỗi giao diện có thể và không thể làm gì.

Lưu ý cho Windows

Claude Code chạy trực tiếp trên Windows 10/11 (PowerShell hoặc Git Bash) và trong WSL. WSL mang lại trải nghiệm mượt mà hơn cho các dự án yêu cầu shell Unix. Nếu claude không được tìm thấy sau khi cài bằng npm trên Windows, hãy mở terminal mới để PATH được đọc lại, hoặc kiểm tra npm config get prefix và thêm thư mục bin của nó.

Chạy Claude Code không cần đăng nhập: xác thực bằng khóa API

Chạy claude và chọn /login để đăng nhập bằng gói thuê bao Claude Pro/Max — hoặc bỏ qua hoàn toàn bước đăng nhập. Khi ANTHROPIC_API_KEY (hoặc ANTHROPIC_AUTH_TOKEN) được đặt, Claude Code không bao giờ hiển thị màn hình đăng nhập và chạy cục bộ, kết nối đến endpoint mà ANTHROPIC_BASE_URL chỉ định; đây cũng là cách chạy trên các máy không thể mở trình duyệt. Với cổng API này, hãy dùng cách xác thực bằng khóa:

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key   # or ANTHROPIC_AUTH_TOKEN
claude

Đặt hai dòng đó vào ~/.zshrc, ~/.bashrc hoặc hồ sơ PowerShell của bạn để mọi terminal mới đều có chúng. Trong Claude Code, /status hiển thị endpoint và khóa đang được sử dụng.

Cách cập nhật và gỡ cài đặt Claude Code

claude update                      # native / self-update
npm update -g @anthropic-ai/claude-code   # npm install
npm uninstall -g @anthropic-ai/claude-code

Nếu cài đặt thành công nhưng Claude Code không khởi động

command not found → PATH: mở shell mới hoặc thêm thư mục bin toàn cục của npm.
Node version báo lỗi → yêu cầu Node.js 18 trở lên; node -v để kiểm tra, hoặc chuyển sang trình cài đặt gốc.
Bị treo khi khởi chạy lần đầu → proxy doanh nghiệp; đặt HTTPS_PROXY, hoặc URL cơ sở của cổng API nếu mạng của bạn chặn api.anthropic.com.
401 / khóa không hợp lệ → khóa phải là khóa gateway khi ANTHROPIC_BASE_URL trỏ đến đây; khóa từ bảng điều khiển Anthropic sẽ bị từ chối.

Dùng thử miễn phí trước

Tài khoản mới nhận được $5 tín dụng API miễn phí với mã CLAUDECODE — đủ cho một buổi tối dùng Claude Code với Sonnet — sau đó là tín dụng có giá trị sử dụng gấp 7.69231× mệnh giá.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Tạo tài khoản với mã CLAUDECODE

Câu hỏi thường gặp

Tôi có cần Node.js để cài đặt Claude Code không?

Chỉ khi cài qua npm. Trình cài đặt gốc (curl trên macOS/Linux, PowerShell trên Windows) và ứng dụng máy tính không cần Node.

Claude Code có chạy trên Windows không?

Có, chạy trực tiếp trong PowerShell hoặc Git Bash, cũng như bên trong WSL. Nên dùng WSL cho các dự án theo kiểu Unix.

Tôi có thể cài đặt Claude Code mà không có gói thuê bao Claude không?

Có. Việc cài đặt là miễn phí; hãy xác thực bằng khóa API thay vì /login. Có thể dùng khóa gateway từ trang này để thay thế trực tiếp.

Chạy Claude Code trên cổng API

Vẫn các mô hình đó, hai biến môi trường, tín dụng có giá trị sử dụng gấp 7.69231× mệnh giá — hoặc gói không giới hạn với phí cố định. Tài khoản mới: $5 tín dụng API miễn phí với mã CLAUDECODE.

Lấy khóa API Xem các gói không giới hạn

AI Prime Tech là một cổng API độc lập, không có quan hệ liên kết với Anthropic và không được Anthropic chứng thực hay tài trợ. “Claude” và “Claude Code” là các nhãn hiệu của Anthropic. Các tính năng Claude Code được mô tả ở đây dựa trên tài liệu công khai của Anthropic tại thời điểm viết và thường xuyên thay đổi; giá và danh sách mô hình trên trang này được đọc từ cấu hình hiện hành của cổng API này.

Cách cài đặt Claude Code

TLDR