Cách Cài Đặt Claude Code

Claude Code Là Gì?

Claude Code là một trợ lý lập trình AI chạy trong terminal. Bạn đưa cho nó hướng dẫn (như các prompt mà SiteKit tạo ra), và nó viết mã, tạo tệp, và xây dựng dự án của bạn. Nó được phát triển bởi Anthropic, công ty đứng sau Claude.

Bước 1: Cài Đặt Node.js

Claude Code yêu cầu Node.js phiên bản 18 trở lên. Kiểm tra xem bạn đã có chưa:

node --version

Nếu bạn thấy số phiên bản (v18 trở lên) là được. Nếu không:

macOS: brew install node (hoặc tải từ nodejs.org)
Windows: Tải từ nodejs.org và chạy trình cài đặt
Linux: Dùng trình quản lý gói, ví dụ sudo apt install nodejs npm

Bước 2: Cài Đặt Claude Code

Chạy lệnh này trong terminal:

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

Kiểm tra xem đã cài thành công chưa:

claude --version

Để xem hướng dẫn cài đặt mới nhất, hãy kiểm tra tài liệu chính thức của Claude Code. Phương pháp cài đặt có thể thay đổi theo thời gian.

Bước 3: Đăng Nhập

Lần đầu chạy Claude Code, nó sẽ yêu cầu bạn đăng nhập:

claude

Làm theo hướng dẫn để xác thực. Bạn có thể dùng:

Tài khoản Claude (bao gồm một số lượt dùng miễn phí)
API key của Anthropic (thanh toán theo lượt sử dụng)

Sử Dụng Claude Code Với Các Prompt SiteKit

Sau khi cài đặt xong, đây là quy trình làm việc thông thường:

Di chuyển đến thư mục dự án:

cd your-project-folder

Khởi động Claude Code:

claude

Đưa prompt cho nó. Bạn có thể:
- Dán prompt trực tiếp vào phiên Claude Code
- Tham chiếu tệp nếu bạn đã lưu nó trong thư mục dự án:

Read stage-1-scaffold.md and follow all the instructions in it to build this project.

Để Claude thực hiện theo hướng dẫn. Nó sẽ tạo tệp, cài đặt các gói phụ thuộc, và thiết lập dự án của bạn.

Mẹo: Claude Code hoạt động tốt nhất khi bạn để nó chạy hết toàn bộ prompt mà không bị gián đoạn. Nếu bạn cần thay đổi, hãy đợi nó hoàn thành, rồi yêu cầu điều chỉnh.

Khắc Phục Sự Cố

“command not found: claude” Đảm bảo thư mục bin toàn cục của npm nằm trong PATH. Thử đóng và mở lại terminal, hoặc chạy npx @anthropic-ai/claude-code.

Lỗi quyền truy cập khi cài đặt Trên macOS/Linux, bạn có thể cần sửa quyền npm. Xem tài liệu npm về cách sửa quyền.

Claude chạy chậm hoặc bị timeout Các prompt lớn (như Giai đoạn 1) liên quan đến việc tạo nhiều tệp. Hãy cho nó vài phút. Nếu bị treo, bạn luôn có thể khởi động lại phiên và yêu cầu nó tiếp tục từ chỗ dừng.