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

> Cài đặt Claude Code trên MacBook bằng trình cài đặt chính thức; hướng dẫn yêu cầu máy, Windows, Linux, khởi chạy lần đầu, lỗi thường gặp và PATH.

Source: https://ailoot.ai/blog/vi/install-claude-code/
Canonical: https://ailoot.ai/blog/vi/install-claude-code/
Language: vi
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-150
Revision: sha256-aa85986bfb7d458018849cabce4867e7b53d31bc282f55d1a18ecd91981d77a2


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Điểm chính">

Điểm chính

Claude Code được cài đặt trong terminal bằng một lệnh duy nhất. Bài viết này hướng dẫn tìm trang web chính thức của Claude Code ở đâu, cần tải chính xác những gì, cách cài đặt trên macOS, Windows và Linux, cách khởi chạy lần đầu và đăng nhập vào tài khoản. Ngoài ra còn có cách xử lý khi không tìm thấy lệnh `claude`.

</div>



<div class="aside" data-semantic="ailoot-docs-link" role="note" aria-label="Tài liệu Ailoot">

[Tài liệu Ailoot](https://ailoot.ai/docs/) mô tả cách kết nối các mô hình và làm việc với API.

</div>

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Điểm chính">

Điểm chính

Claude Code là công cụ của Anthropic chạy trực tiếp trong terminal trên máy tính của bạn. Công cụ này có thể xem toàn bộ dự án, chỉnh sửa tệp, chạy lệnh và xử lý cả một nhiệm vụ, trong khi bạn chỉ cần nói cho nó biết phải làm gì bằng ngôn từ thông thường và ngôn ngữ bạn muốn. Khác với cuộc trò chuyện trên claude.ai bị giới hạn trong trình duyệt, Claude Code có quyền truy cập vào tệp và mã của bạn.

</div>

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.

<figure>
<blockquote>
<p>Claude Code là công cụ lập trình dạng tác tử hoạt động ngay trong terminal, hiểu mã của bạn và đẩy nhanh công việc: công cụ đảm nhận các tác vụ thường lệ, giải thích những phần phức tạp và xử lý quy trình git — tất cả bằng các câu lệnh thông thường bằng ngôn ngữ của con người.</p>
</blockquote>
<figcaption>— Anthropic, https://github.com/anthropics/claude-code</figcaption>
</figure>

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 {#trang-web-chính-thức-của-claude-code-ở-đâu-và-nên-tải-gì}

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Điểm chính">

Điểm chính

Trang sản phẩm chính thức là `claude.com/product/claude-code`. Trang web sản phẩm, có bảng giá và bản demo, là `code.claude.com`; tài liệu cũng nằm ở đó tại `code.claude.com/docs`. Tuy nhiên, ở đây không có tùy chọn quen thuộc kiểu “tải một tệp từ trang web”: bạn cài Claude Code bằng lệnh terminal để tải chương trình phù hợp. Gói npm chính thức duy nhất có tên `@anthropic-ai/claude-code`.

</div>

Đ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.

| Địa chỉ | Là gì |
|----|----|
| `claude.com/product/claude-code` | Trang sản phẩm: mô tả và liên kết cài đặt |
| `code.claude.com` | Trang web sản phẩm: bản demo, giá và chi tiết |
| `code.claude.com/docs` | Tài liệu chính thức: cài đặt, khởi chạy lần đầu, lỗi |
| `claude.ai/code` | Phiên bản web của Claude Code chạy ngay trong trình duyệt |
| `github.com/anthropics/claude-code` | Kho lưu trữ chính thức |
| `@anthropic-ai/claude-code` | Gói npm chính thức |

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Điểm chính">

Điểm chính

Claude Code chạy trên macOS 13 trở lên, Windows 10 trở lên (trực tiếp hoặc qua WSL) và hầu hết các bản phân phối Linux. Bạn cần 4 GB RAM, kết nối internet và một terminal bất kỳ. Node.js chỉ cần cho một trong số các phương thức cài đặt — trình cài đặt native hoàn toàn không cần Node.js.

</div>

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.

| Hạng mục | Yêu cầu |
|-----------|---------------------------------------------------------------|
| macOS | 13.0 trở lên |
| Windows | 10 (build 1809) trở lên, trực tiếp hoặc qua WSL |
| Linux | Ubuntu 20.04+, Debian 10+, Alpine 3.19+ |
| Bộ nhớ | 4 GB trở lên (khoảng 512 MB dung lượng trống là đủ cho riêng việc cài đặt) |
| Bộ xử lý | x64 hoặc ARM64 |
| Mạng | Kết nối internet liên tục |
| Shell | Bash, Zsh, PowerShell hoặc CMD |

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? {#cài-claude-code-trên-macos-như-thế-nào}

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Điểm chính">

Điểm chính

Trên Mac, cách cài Claude Code dễ nhất là dùng trình cài đặt native: chỉ cần một lệnh terminal, sau đó chương trình tự cập nhật trong nền. Không cần Node.js. Nếu dùng Homebrew, bạn cũng có thể cài theo cách đó. Cả hai phương thức đều cài cùng một chương trình; điểm khác biệt duy nhất là bên nào xử lý cập nhật.

</div>

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:

```bash
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.

<figure>
<blockquote>
<p>Bản cài đặt native tự cập nhật trong nền và luôn giữ bạn ở phiên bản mới nhất.</p>
</blockquote>
<figcaption>— Anthropic, tài liệu Claude Code, https://code.claude.com/docs/en/setup</figcaption>
</figure>

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

```bash
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? {#cài-claude-code-trên-windows-như-thế-nào}

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Điểm chính">

Điểm chính

Trên Windows 10 trở lên, Claude Code được cài đặt native mà không cần Node.js. Lệnh phụ thuộc vào shell của bạn: PowerShell dùng một lệnh, còn Command Prompt dùng lệnh khác — rất dễ nhầm và người mới thường mắc lỗi này. Bạn cũng có thể cài qua WinGet. Nên cài Git for Windows trước để có trải nghiệm đầy đủ.

</div>

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”):

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

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

```batch
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:

```powershell
winget install Anthropic.ClaudeCode
```

<div class="aside" data-semantic="callout" role="note" aria-label="Mẹo">

Mẹo

Anthropic khuyến nghị cài Git for Windows trước. Nhờ vậy, Claude Code có thể dùng Bash để chạy lệnh. Nếu không có Git, Claude Code vẫn hoạt động qua PowerShell, nhưng nhiều thao tác sẽ trơn tru hơn khi có Git.

</div>

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? {#cài-claude-code-trên-linux-như-thế-nào}

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Điểm chính">

Điểm chính

Cùng một trình cài đặt native hoạt động trên Ubuntu, Debian, Fedora và Alpine như trên Mac: một lệnh sẽ xử lý phần còn lại. Nếu muốn quản lý mọi thứ bằng trình quản lý gói của hệ thống, Anthropic có các kho apt, dnf và apk đã ký. Quá trình cài đặt có thể thất bại trên máy chủ ít bộ nhớ; nếu vậy, bạn sẽ cần swap.

</div>

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:

```bash
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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Điểm chính">

Điểm chính

Đi đến thư mục dự án, nhập `claude` rồi nhấn Enter — phiên tương tác sẽ mở ngay trong terminal. Lần đầu khởi chạy, Claude Code mở trình duyệt để bạn đăng nhập vào tài khoản. Sau đó, bạn có thể hỏi câu đầu tiên về dự án bằng lời lẽ đơn giản và nhận được câu trả lời hữu ích.

</div>

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Điểm chính">

Điểm chính

Claude Code không hoạt động với gói Claude.ai miễn phí. Bạn cần tài khoản đăng ký trả phí (Pro, Max, Team hoặc Enterprise) với mức phí cố định hằng tháng, hoặc khóa API từ Claude Console, nơi bạn thanh toán theo mức sử dụng thực tế. Với hầu hết chủ doanh nghiệp, gói đăng ký đơn giản và dễ dự đoán hơn: thanh toán mỗi tháng một lần mà không cần đếm token.

</div>

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

<figure>
<blockquote>
<p>Bạn cần tài khoản Pro, Max, Team, Enterprise hoặc Console. Gói Claude.ai miễn phí không cung cấp quyền truy cập Claude Code.</p>
</blockquote>
<figcaption>— Anthropic, tài liệu Claude Code, https://code.claude.com/docs/en/setup</figcaption>
</figure>

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

| Phương thức đăng nhập | Cách thanh toán | Dành cho ai |
|----|----|----|
| Gói đăng ký Claude.ai (Pro / Max / Team / Enterprise) | Số tiền cố định hằng tháng | Hầu hết mọi người: chi phí dễ dự đoán, đăng nhập bằng tài khoản Claude.ai |
| Claude Console (khóa API) | Thanh toán theo mức sử dụng thực tế | Người muốn chỉ trả cho phần đã dùng và theo dõi chi tiêu |

Để đă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ý](https://ailoot.ai/blog/vi/claude-registration-email/): sau này bạn không thể thay đổi.

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Điểm chính">

Điểm chính

Cách kiểm tra nhanh là chạy lệnh `claude --version`: nếu cài đặt hoạt động, lệnh sẽ in số phiên bản như “2.1.211 (Claude Code)”. Nếu xảy ra sự cố, `claude doctor` sẽ chẩn đoán cài đặt và thiết lập mà không khởi chạy phiên, đồng thời đề xuất cách khắc phục. Trong phiên, `/status` cho biết bạn đã đăng nhập bằng tài khoản nào và quyền truy cập còn hoạt động hay không.

</div>

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

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

```bash
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ố.

<figure>
<blockquote>
<p>claude doctor hiển thị chẩn đoán cài đặt và thiết lập mà không khởi chạy phiên: lệnh kiểm tra tình trạng cài đặt, tìm lỗi trong tệp thiết lập và đưa ra cảnh báo kèm đề xuất cần khắc phục điều gì.</p>
</blockquote>
<figcaption>— Anthropic, tài liệu Claude Code, https://code.claude.com/docs/en/setup</figcaption>
</figure>

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Điểm chính">

Điểm chính

Nếu terminal báo “command not found: claude” hoặc “'claude' is not recognized” sau khi cài đặt, điều đó có nghĩa là cài đặt đã thành công nhưng thư mục chứa chương trình chưa được thêm vào PATH — danh sách các vị trí terminal tìm kiếm lệnh. Chương trình nằm ở `~/.local/bin`. Cách khắc phục là thêm một dòng vào thiết lập shell rồi khởi động lại terminal.

</div>

Đâ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:

```bash
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.

<div class="aside" data-semantic="callout" role="note" aria-label="Cảnh báo">

Cảnh báo

Còn có một trở ngại khác: tiện ích Claude Code cho VS Code đặt bản sao chương trình của riêng nó trong thư mục tiện ích và không thêm vào PATH. Vì vậy nếu chỉ cài tiện ích, lệnh `claude` sẽ không chạy trong terminal — bạn cần cài Claude Code riêng cho terminal bằng lệnh trong bài viết này.

</div>

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Điểm chính">

Điểm chính

Ngoài việc thiếu mục PATH, có năm vấn đề thường khiến người mới gặp rắc rối: Node cũ khi cài qua npm, dùng nhầm trình cài đặt cho shell, khóa API vẫn còn đặt trong môi trường, máy chủ yếu thiếu bộ nhớ và dịch vụ không khả dụng ở khu vực của bạn. Khi gặp vấn đề, việc đầu tiên nên thử là chạy `claude doctor` — công cụ có thể tự chẩn đoán hầu hết trường hợp.

</div>

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Điểm chính">

Điểm chính

Claude Code đã được cài đặt, nhưng mỗi cuộc trò chuyện mới vẫn bắt đầu lại từ đầu, không nhớ bạn hay dự án. Bước đầu tiên sau khi cài đặt là đặt tệp `CLAUDE.md` chứa quy tắc và ngữ cảnh vào dự án, để bạn không phải giải thích đi giải thích lại. Tôi hướng dẫn riêng cách tùy chỉnh Claude.

</div>

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](https://ailoot.ai/blog/vi/claude-personalization-profile-memory/). Tôi cũng đã tổng hợp [bản đồ tổng quan về các công cụ vibe coding năm 2026](https://ailoot.ai/blog/vi/ai-coding-tools/).

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Điểm chính">

Điểm chính

Sáu câu hỏi thường gặp nhất là: có cần biết lập trình không, có cần Node.js không, Claude Code khác cuộc trò chuyện thông thường trên claude.ai thế nào, có thể dùng mà không cần terminal không, chi phí bao nhiêu và cập nhật chương trình ra sao? Dưới đây là câu trả lời ngắn gọn, trực tiếp cho từng câu.

</div>

<div class="section">

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

Có cần biết lập trình để cài Claude Code không?

Không. Việc cài đặt cần vài lệnh mà bạn sao chép từ hướng dẫn rồi dán vào terminal. Bạn không cần biết lập trình để cài đặt hoặc giao nhiệm vụ cho Claude bằng ngôn từ thông thường sau đó.

Claude Code có cần Node.js không?

Chỉ khi cài đặt qua npm — khi đó bạn cần Node.js 22 trở lên. Trình cài đặt native (lệnh có install.sh hoặc install.ps1), Homebrew và WinGet cài chương trình sẵn sàng sử dụng dưới dạng một tệp duy nhất, không cần Node.js.

Claude Code khác cuộc trò chuyện trên claude.ai như thế nào?

Claude Code có quyền truy cập vào máy tính của bạn. Cuộc trò chuyện trong trình duyệt trả lời bằng văn bản, còn bạn tự chuyển mã. Claude Code chạy trong terminal, tự đọc và sửa các tệp dự án, chạy lệnh và cho bạn thấy những gì đã thay đổi.

Có thể dùng mà không cần terminal không?

Có. 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 trong trình duyệt. Phiên bản terminal vẫn có đầy đủ tính năng.

Claude Code có giá bao nhiêu?

Không có quyền truy cập miễn phí: bạn cần gói đăng ký Claude.ai (Pro, Max, Team hoặc Enterprise) với giá cố định hằng tháng, hoặc khóa API Claude Console với hình thức thanh toán theo mức sử dụng. 

Cập nhật Claude Code như thế nào?

Bản cài đặt native tự cập nhật trong nền, còn lệnh `claude update` áp dụng bản cập nhật ngay lập tức. Homebrew, WinGet và npm cần cập nhật thủ công: dùng `brew upgrade claude-code`, `winget upgrade Anthropic.ClaudeCode` hoặc cài lại gói với hậu tố @latest.

</div>

<div class="section" role="doc-bibliography" aria-label="Nguồn">

### Nguồn

- [Claude Code Docs - Tổng quan](https://code.claude.com/docs/en/overview)
- [Claude Code Docs - Bắt đầu nhanh](https://code.claude.com/docs/en/quickstart)
- [Claude Code Docs - Thiết lập nâng cao (cài đặt, yêu cầu, cập nhật, xác minh)](https://code.claude.com/docs/en/setup)
- [Claude Code Docs - Xác thực (đăng nhập, gói đăng ký so với Console)](https://code.claude.com/docs/en/authentication)
- [Claude Code Docs - Khắc phục sự cố cài đặt (hướng dẫn xử lý sự cố)](https://code.claude.com/docs/en/troubleshoot-install)
- [Claude Code Docs - Hướng dẫn terminal (dành cho người chưa từng dùng terminal)](https://code.claude.com/docs/en/terminal-guide)
- [Anthropic - trang sản phẩm Claude Code chính thức](https://claude.com/product/claude-code)
- [Anthropic - kho Claude Code chính thức trên GitHub](https://github.com/anthropics/claude-code)
- [npm - gói @anthropic-ai/claude-code](https://www.npmjs.com/package/@anthropic-ai/claude-code)
- [Anthropic - danh sách quốc gia được hỗ trợ](https://www.anthropic.com/supported-countries)
- [Claude Console (thanh toán API)](https://platform.claude.com/)
- [Claude Code trên trình duyệt](https://claude.ai/code)
- [Claude Code Docs - cài đặt trong VS Code](https://code.claude.com/docs/en/vs-code)
- [Claude Code Docs - plugin JetBrains](https://code.claude.com/docs/en/jetbrains)

</div>

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



<div class="aside" data-semantic="ailoot-link" role="note" aria-label="Ailoot">

Tiếp tục làm việc với AI trên [Ailoot](https://ailoot.ai/).

</div>

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

### Trình cài native Claude Code có cần Node.js không?

Không. Trình cài native cài chương trình độc lập. Node.js cần cho cách cài npm; chọn hướng dẫn khớp hệ điều hành và shell.

### Phân biệt cài thành công với lỗi đăng nhập thế nào?

Chạy `claude --version` để kiểm tra terminal tìm được chương trình. Xem `/status` trong phiên để kiểm tra truy cập tài khoản, và dùng `claude doctor` tìm lỗi cài đặt hoặc cấu hình.


## Ailoot · Công ty và danh mục dự án của công ty

Ailoot dựa trên kinh nghiệm vận hành tích lũy, cơ sở khách hàng lớn, dịch vụ ổn định và việc kiểm soát KPI liên tục.

Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.

Ailoot áp dụng kinh nghiệm vận hành này để cung cấp quyền truy cập API vào các tính năng AI trong sản phẩm của khách hàng, tác tử, ứng dụng và quy trình tự động hóa.