Cài đặt Claude Code free? Hướng dẫn chính thức và điều kiện tài khoản

Claude Code là gì và tại sao nó chạy trong terminal?#

Terminal khiến gần như tất cả những người bắt đầu viết mã bằng cách mô tả yêu cầu mà không có nền tảng phát triển phần mềm đều e ngại. Nó trông như cửa sổ đen trong phim hacker, nhưng thực ra chỉ là một dòng để nhập lệnh. Claude Code cần terminal chính là để mở tệp, thay đổi chúng và tự chạy kiểm tra trong khi bạn mô tả nhiệm vụ bằng lời.

Anthropic mô tả sản phẩm như sau.

Khác biệt với một cuộc trò chuyện quen thuộc rất đơn giản. Trong trình duyệt, bạn tự sao chép mã qua lại giữa cửa sổ và trình soạn thảo. Claude Code đi vào thư mục dự án, đọc những tệp cần thiết, thực hiện thay đổi và cho bạn biết nó đã sửa gì. Bạn vẫn là người quyết định và phê duyệt; nó làm các công việc cơ học thay bạn.

Nếu thực sự không muốn dùng terminal, Anthropic có ứng dụng máy tính để bàn với cửa sổ thông thường và phiên bản web tại claude.ai/code, chạy ngay trong trình duyệt. Nhưng lựa chọn mạnh mẽ và linh hoạt nhất là phiên bản terminal, cũng là nội dung chính của toàn bài viết này.

Claude Code cài đặt như thế nào? URL chính thức và tệp cần tải#

Điều đầu tiên khiến người mới bối rối là trang web chính thức của Claude Code ở đâu và cần nhấp vào đâu để tải. Dưới đây là bảng các địa chỉ chính thức của Anthropic để bạn không phải đoán.

Bạn không tải trình cài đặt từ trang web như với một chương trình thông thường, trái với điều nhiều người mong đợi. Thay vào đó, bạn cài đặt bằng lệnh terminal; lệnh này sẽ tải phiên bản phù hợp với hệ thống. Bài viết có các lệnh chính xác cho Mac, Windows và Linux.

Một cái bẫy phổ biến là tên gọi: mọi người thường viết sai thành clode code, clade code, слод код hoặc clode design. Tên sản phẩm là Claude Code, có au. Hãy nhớ điều đó khi tìm trang web chính thức: các tên miền có cách viết tương tự thuộc về người khác.

Bạn cũng nên biết chính xác tên gói npm. Tên gói chuẩn là @anthropic-ai/claude-code, có tiền tố @anthropic-ai/. Anthropic sở hữu tên ngắn claude-code không có tiền tố — đó là đường dẫn chính thức của họ đến cùng một gói. Quy tắc đơn giản: nhà phát hành phải là Anthropic và tên dùng để cài đặt phải có tiền tố.

Cần gì để cài đặt: yêu cầu đối với máy tính#

Yêu cầu của Claude Code khá khiêm tốn: máy chủ của Anthropic đảm nhận phần việc nặng; máy của bạn chỉ gửi yêu cầu và nhận phản hồi.

Nói riêng về Node.js vì đây là chủ đề có nhiều hiểu lầm nhất. Trình cài đặt native — phương thức mà chính Anthropic khuyến nghị — hoàn toàn không cần Node.js: nó cài đặt dưới dạng một tệp độc lập duy nhất. Chỉ cần Node.js nếu bạn cài Claude Code qua npm; khi đó cần phiên bản 22 trở lên. Các bài viết cũ nói “Node 18 trở lên” đã lỗi thời; hãy lấy 22+ làm mốc.

Bạn cần terminal cho phiên bản chính. Nếu không muốn dùng terminal, hãy cài ứng dụng máy tính để bàn với cửa sổ thông thường hoặc dùng phiên bản web tại claude.ai/code. Phiên bản terminal vẫn có nhiều tính năng mạnh hơn, vì vậy phần còn lại của bài viết hướng dẫn cách cài phiên bản này.

Cài Claude Code giống như có một công cụ trong tay. Nhưng khi đứng riêng, nó thường bị ảo giác: quên dự án của bạn, bịa ra mọi thứ và mất mạch giữa chừng. Kết hợp ba yếu tố sẽ giúp nó đáng tin cậy: bản sao AI, Bộ não thứ hai và kỹ thuật ngữ cảnh. Đây là ba trụ cột giúp AI không bị ảo giác.

Cài đặt Claude Code trên Mac và MacBook như thế nào?#

Mở Terminal (máy Mac nào cũng có sẵn: nhấn Cmd+Space trong Spotlight rồi nhập “Terminal”) và dán dòng này:

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

Lệnh này tải trình cài đặt từ địa chỉ chính thức của Anthropic và cài Claude Code. Không cần Node.js. Phương thức native cũng tiện ở khâu cập nhật.

Nếu đã dùng Homebrew, bạn có thêm lựa chọn thứ hai:

brew install --cask claude-code

Khác biệt nằm ở cách cập nhật: trình cài đặt native tự cập nhật, còn Homebrew thì không — bạn cần cập nhật thủ công bằng lệnh brew upgrade claude-code. Bản thân chương trình giống nhau, nên hãy chọn cách bạn quen dùng. Nếu chưa chắc, hãy dùng cách đầu tiên.

Cài đặt Claude Code trên Windows như thế nào?#

Trước tiên, hãy xác định bạn đang dùng gì. Windows có hai shell và mỗi shell có lệnh riêng. Mở cửa sổ rồi nhìn phần đầu của dấu nhắc: PS C:\> nghĩa là PowerShell, còn C:\> không có PS nghĩa là Command Prompt (CMD).

Đối với PowerShell (cách mở dễ nhất là nhấp chuột phải vào nút Start rồi chọn “Terminal”):

irm https://claude.ai/install.ps1 | iex

Đối với Command Prompt (CMD):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Có lựa chọn thứ ba là dùng trình quản lý gói WinGet tích hợp sẵn:

winget install Anthropic.ClaudeCode

Nếu đã có môi trường WSL hoạt động (Linux bên trong Windows), hãy cài Claude Code ngay trong WSL bằng lệnh tương tự như trên Linux. WSL có một điểm cần lưu ý riêng liên quan đến Node; tôi sẽ nói về vấn đề đó bên dưới trong phần lỗi thường gặp.

Cài đặt Claude Code trên Ubuntu và các bản phân phối Linux như thế nào?#

Phương thức cơ bản cho mọi bản phân phối phổ biến đều dùng cùng một trình cài đặt độc lập:

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

Không cần Node.js; chương trình được cung cấp dưới dạng một tệp duy nhất và từ đó tự cập nhật.

Nếu bạn quen chỉ cài chương trình qua trình quản lý gói của hệ thống, có thể thêm các kho chính thức của Anthropic: apt cho Debian và Ubuntu, dnf cho Fedora và RHEL, apk cho Alpine. Các kho này được ký bằng khóa và có kênh stable lẫn latest. Cách này quá rườm rà đối với người mới, nên tôi để phần chi tiết trong tài liệu ở mục nguồn và mặc định khuyến nghị lệnh ở trên.

Máy chủ giá rẻ đôi khi gặp một trở ngại. Nếu máy có rất ít bộ nhớ trống, quá trình cài đặt có thể dừng với từ Killed (mã 137) — hệ thống đã dừng tiến trình vì hết bộ nhớ. Cách khắc phục là thêm tệp swap: Claude Code cần khoảng 512 MB bộ nhớ trống để cài đặt.

Khởi chạy Claude Code lần đầu như thế nào?#

Lần khởi chạy đầu tiên mất vài phút. Quy trình như sau.

1. Đi đến thư mục dự án

   Trong terminal, dùng lệnh cd path-to-project để đi đến thư mục bạn muốn làm việc, sau đó nhập claude.

2. Đăng nhập vào tài khoản

   Trình duyệt sẽ mở cửa sổ đăng nhập. Nếu cửa sổ không tự mở, nhấn c để sao chép liên kết rồi tự dán vào trình duyệt. Nếu trình duyệt hiển thị mã (điều này có thể xảy ra trong WSL và trên máy chủ từ xa), hãy dán mã đó trở lại terminal.

3. Chờ xác nhận

   Sau khi đăng nhập, terminal sẽ hiển thị Login successful và yêu cầu bạn nhấn Enter.

4. Đặt câu hỏi đầu tiên

   Hãy hỏi điều gì đó đơn giản về dự án, chẳng hạn “dự án này làm gì?”. Claude sẽ đọc tệp và trả lời.

5. Phê duyệt thay đổi đầu tiên

   Khi bạn yêu cầu thay đổi điều gì đó, Claude sẽ hiển thị những thay đổi được đề xuất và yêu cầu xác nhận. Bạn có thể chuyển chế độ truy cập bằng Shift+Tab.

Nên làm quen ngay với một vài lệnh cơ bản trong phiên: /help liệt kê các lệnh, /clear xóa lịch sử cuộc trò chuyện và /exit thoát (nhấn Ctrl+D hai lần cũng có tác dụng tương tự). Claude sẽ tự hiển thị tất cả những thông tin này nếu bạn nhập /help.

Đăng nhập bằng gói đăng ký hay khóa API: nên chọn cách nào?#

Đây là câu hỏi đầu tiên xuất hiện khi đăng nhập.

Có hai cách đăng nhập và chúng khác nhau ở cách thanh toán.

Để đăng nhập bằng gói đăng ký, chỉ cần dùng tài khoản Claude.ai. Để đăng nhập bằng khóa API, hãy lấy khóa từ Claude Console (platform.claude.com); phí sử dụng được trừ vào số dư trả trước khi bạn làm việc. Đặt khóa trong biến môi trường ANTHROPIC_API_KEY để Claude Code không mở trình duyệt mỗi lần.

Bạn có thể đổi tài khoản trong phiên bằng /login và đăng xuất bằng /logout.

Nhưng Claude Code sẽ không khởi chạy nếu không có quyền truy cập trả phí. Nếu chưa có tài khoản, trước tiên hãy tìm hiểu nên dùng địa chỉ email nào để đăng ký: sau này bạn không thể thay đổi.

Làm sao kiểm tra mọi thứ đã được cài đúng?#

Có ba lệnh đáng biết ngay từ đầu.

Lệnh đầu tiên kiểm tra phiên bản:

claude --version

Bản cài đặt hoạt động sẽ trả về số theo định dạng X.Y.Z (Claude Code). Các chữ số cụ thể thay đổi theo từng phiên bản; điều quan trọng là lệnh có trả về số phiên bản. Nếu nhận được “command not found”, đó là vấn đề khác — tôi sẽ đề cập ở phần tiếp theo.

Lệnh thứ hai dùng để chẩn đoán khi có sự cố.

Lệnh thứ ba là /status trong phiên: lệnh này cho biết bạn đã đăng nhập bằng cách nào, email hoặc tổ chức nào được liên kết và quyền truy cập đã hết hạn hay chưa. Còn claude update áp dụng bản cập nhật mới nhất ngay lập tức thay vì chờ cập nhật nền.

Vì sao không tìm thấy lệnh claude sau khi cài đặt?#

Đây là phàn nàn phổ biến nhất của người mới và nghe đáng sợ hơn thực tế. Terminal không tìm lệnh trên toàn bộ máy tính; nó chỉ kiểm tra các thư mục trong PATH. Claude Code tự đặt ở ~/.local/bin/claude (trên Mac và Linux) hoặc %USERPROFILE%\\.local\\bin\\claude.exe (trên Windows); nếu thư mục đó không có trong PATH, terminal đơn giản là không thấy chương trình.

Trên Mac và Linux, hãy thêm thư mục vào danh sách. Mở tệp thiết lập shell (~/.zshrc cho Zsh, ~/.bashrc cho Bash) rồi thêm dòng này vào cuối tệp:

export PATH="$HOME/.local/bin:$PATH"

Sau đó đóng rồi mở lại terminal (hoặc chạy source ~/.zshrc). Tiếp theo, lệnh claude sẽ được tìm thấy.

Các lỗi thường gặp khi cài đặt và khởi chạy lần đầu#

Hãy lần lượt xem xét từng vấn đề; tất cả đều có trong hướng dẫn khắc phục sự cố chính thức của Anthropic.

1. Node cũ khi cài qua npm. Gói @anthropic-ai/claude-code yêu cầu Node.js 22 trở lên. Trên Windows, npm có thể thất bại với thông báo về việc tập lệnh bị vô hiệu hóa — chính sách của PowerShell đang chặn chúng chạy. Trong WSL, lỗi thường gặp là exec: node: not found: WSL đang dùng Node của Windows thay vì Node của Linux. Nếu npm gây rắc rối, hãy chuyển sang trình cài đặt native; phương thức đó không cần Node.
2. Trình cài đặt không phù hợp với shell. 'irm' is not recognized nghĩa là bạn đã dán lệnh PowerShell vào Command Prompt. The token '&&' is not a valid statement separator nghĩa là bạn làm ngược lại và chạy lệnh CMD trong PowerShell. A parameter cannot be found that matches parameter name 'fsSL' nghĩa là bạn chạy lệnh Mac/Linux trong PowerShell. Kiểm tra đầu dấu nhắc: PS C:\ là PowerShell, còn C:\ là CMD.
3. Khóa API cũ ghi đè gói đăng ký. Nếu gói đăng ký còn hoạt động nhưng môi trường vẫn đặt khóa cũ, bạn sẽ thấy API Error: 400 ... This organization has been disabled. Khóa được ưu tiên hơn đăng nhập bằng gói đăng ký. Xóa khóa bằng unset ANTHROPIC_API_KEY (trong PowerShell, dùng Remove-Item Env:ANTHROPIC_API_KEY), kiểm tra ~/.zshrc và ~/.bashrc, sau đó nhập /status.
4. Máy chủ yếu không đủ bộ nhớ. Quá trình cài đặt dừng với từ Killed và mã 137 — nghĩa là không đủ RAM. Bạn cần khoảng 512 MB bộ nhớ trống; thêm swap sẽ khắc phục được.
5. Trình cài đặt trả về nội dung khác. Lỗi syntax error near unexpected token '<' hoặc nội dung nhắc đến <!DOCTYPE html> nghĩa là URL cài đặt đã trả về một trang web thay vì tập lệnh cài đặt — thường do khu vực của bạn, tường lửa công ty hoặc sự cố tạm thời. Hãy thử phương thức khác (Homebrew, WinGet) hoặc thử lại sau vài phút.

Với bất kỳ lỗi nào trong số này, bước đầu tiên đều giống nhau: chạy claude doctor. Công cụ sẽ cho biết vấn đề và gợi ý nơi cần kiểm tra.

Có một điểm cần lưu ý khi chẩn đoán: lỗi 403 đơn thuần trong lúc cài đặt cũng có thể do tường lửa hoặc proxy của công ty gây ra. Vì vậy, nếu đang dùng mạng văn phòng, trước tiên hãy kiểm tra xem mạng có chặn truy cập hay không.

Sau khi cài đặt cần làm gì: các bước đầu tiên#

Cài đặt chỉ là bước khởi đầu. Công việc thực sự bắt đầu sau đó, và điều đầu tiên mọi người gặp phải là bộ nhớ. Mô hình ngôn ngữ không nhớ bạn giữa các cuộc trò chuyện: trong một cuộc trò chuyện mới, nó chỉ biết những gì bạn đưa vào ngữ cảnh.

Vì thế, bước thực sự đầu tiên sau khi cài đặt là tạo tệp CLAUDE.md ở thư mục gốc dự án. Đây là tệp văn bản chứa các quy tắc và ngữ cảnh của dự án mà Claude Code đọc mỗi khi khởi chạy. Chỉ cần mô tả một lần bạn làm gì, dự án được tổ chức ra sao và điều gì quan trọng — bạn sẽ không phải lặp lại trong từng cuộc trò chuyện.

Tôi hướng dẫn cách tạo tệp đó và tùy chỉnh Claude trong một bài riêng: cách tùy chỉnh Claude. Tôi cũng đã tổng hợp bản đồ tổng quan về các công cụ vibe coding năm 2026.

Mọi người còn hỏi gì?#

Khung vibe coding hoàn chỉnh: bản sao AI + Bộ não thứ hai + Kỹ thuật ngữ cảnh.