1. Claude Code là gì?

Claude Code là công cụ AI chạy trong terminal (dòng lệnh) của Anthropic. Nó đọc được thư mục dự án, có thể viết, sửa, chạy và kiểm tra code thay người dùng. Đây là môi trường mà các Skill của chuỗi bài này sẽ được xây dựng và thử nghiệm.

Lưu ý quan trọng trước khi bắt đầu: việc cài đặt là miễn phí, nhưng sử dụng thì không. Claude Code yêu cầu một trong các phương án: gói Claude Pro/Max, gói Team/Enterprise, hoặc tài khoản Anthropic Console tính phí theo token. Gói Claude.ai miễn phí không bao gồm quyền truy cập Claude Code.

2. Yêu cầu hệ thống

Yêu cầu Chi tiết
Hệ điều hành macOS, Windows, hoặc Linux
RAM Tối thiểu 4GB
Tài khoản Gói Claude trả phí hoặc API key
Node.js Phiên bản 18 trở lên — chỉ cần nếu dùng cách cài bằng npm
Git Tùy chọn, nhưng nên có (phục vụ quản lý phiên bản)

GPU không cần thiết. Mọi xử lý AI diễn ra trên máy chủ của Anthropic; máy của bạn chỉ chạy ứng dụng dòng lệnh và gửi yêu cầu qua mạng.

3. Mở terminal — bước đầu tiên cho người chưa quen

Mọi lệnh trong bài đều gõ vào terminal (còn gọi là command line / dòng lệnh).

  • macOS: Mở Spotlight (Cmd + Space), gõ Terminal, nhấn Enter.
  • Windows: Mở Start, gõ PowerShell, nhấn Enter. (Hoặc cài WSL nếu muốn môi trường giống Linux.)
  • Linux: Mở ứng dụng Terminal có sẵn.

Cửa sổ hiện ra có một con trỏ nhấp nháy — đây là nơi gõ lệnh.

4. Hai phương pháp cài đặt

Anthropic cung cấp nhiều cách cài, nhưng với người mới có hai lựa chọn chính. Dưới đây là so sánh để chọn đúng:

  Native installer (khuyến nghị) npm
Cần Node.js? Không Có (v18+)
Tự động cập nhật Có Không (cập nhật thủ công)
Phù hợp với Dùng hằng ngày trên máy cá nhân Cần ghim phiên bản cụ thể (CI/CD), team đã chuẩn hóa npm

Native installer là phương pháp Anthropic khuyến nghị: không cần phụ thuộc, tự cập nhật nền. Với người mới chưa từng cài Node.js, đây là lựa chọn đơn giản nhất.

4a. Cách 1 — Native installer (khuyến nghị)

macOS / Linux: dán lệnh sau vào terminal rồi nhấn Enter:

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

Windows (PowerShell):

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

Lệnh này tải đúng bản binary cho hệ thống, đặt vào PATH và cấu hình tự cập nhật. Sau khi cài, đóng cửa sổ terminal hiện tại và mở cửa sổ mới để hệ thống nhận diện lệnh claude.

4b. Cách 2 — Cài bằng npm

Chỉ chọn cách này nếu cần ghim phiên bản hoặc team đã dùng npm. Trước tiên kiểm tra Node.js:

 
 
bash
node --version

Nếu kết quả là v18.0.0 trở lên thì tiếp tục. Nếu thấp hơn hoặc báo lỗi, cần cài Node.js trước.

Cảnh báo về phiên bản Node.js: Claude Code được phân phối dưới dạng ES module. Node.js dưới v18 vẫn cài được nhưng sẽ lỗi cú pháp khi chạy. Hãy đảm bảo v18 trở lên (bản LTS hiện tại là v22, hoạt động tốt).

Cài Node.js qua nvm (khuyến nghị cho macOS/Linux):

 
 
bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install --lts

Hoặc tải bản LTS trực tiếp từ trang chủ nodejs.org. Sau khi cài Node.js, đóng terminal và mở lại để làm mới PATH.

Sau đó cài Claude Code:

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

Lưu ý: Không dùng sudo với lệnh npm install. Nếu gặp lỗi quyền truy cập (permission), cách đúng là dùng nvm để cài Node.js trong thư mục home, thay vì chạy npm với quyền root.

5. Kiểm tra cài đặt

Bất kể dùng cách nào, xác minh bằng:

 
 
bash
claude --version

Kết quả là một số phiên bản (ví dụ 2.1.x). Có thể chạy thêm lệnh chẩn đoán môi trường:

 
 
bash
claude doctor

Lệnh này kiểm tra cấu hình và báo các vấn đề nếu có.

6. Đăng nhập lần đầu

Vào thư mục dự án bất kỳ rồi khởi động:

 
 
bash
cd ten-thu-muc-du-an
claude

Lần chạy đầu tiên, Claude Code mở trình duyệt mặc định và yêu cầu đăng nhập tài khoản Anthropic. Làm theo hướng dẫn để cấp quyền cho công cụ dòng lệnh.

Lưu ý bảo mật: Bước đăng nhập, nhập mật khẩu hoặc khóa API là thao tác người dùng tự thực hiện trên giao diện chính thức của trình duyệt. Không chia sẻ khóa API trong văn bản, ảnh chụp màn hình hay nơi công khai.

7. Bảng xử lý lỗi thường gặp

Triệu chứng Nguyên nhân Cách xử lý
Lệnh claude không nhận diện PATH chưa cập nhật Đóng terminal, mở cửa sổ mới
Lỗi cú pháp khi chạy (npm) Node.js dưới v18 Nâng cấp Node.js bằng nvm
Lỗi permission khi npm install Chạy npm với quyền root Dùng nvm thay vì sudo
Không vào được Claude Code Tài khoản chưa có quyền Kiểm tra gói trả phí / API key

8. Tổng kết bài 2

  • Cài đặt miễn phí; sử dụng cần gói trả phí hoặc API key.
  • Native installer là cách đơn giản nhất cho người mới: không cần Node.js, tự cập nhật.
  • Nếu dùng npm, bắt buộc Node.js v18+ và không dùng sudo.
  • Sau mọi bước cài đặt liên quan đến PATH, hãy mở lại terminal.
  • Kiểm tra bằng claude --version và claude doctor.

Bài tiếp theo (Bài 3): Mổ xẻ cấu trúc một Skill — đi sâu vào SKILL.md, scripts/, references/, assets/ và các quy tắc đặt tên bắt buộc.