[Series Claude Code - Bài 1] Khởi Đầu Hành Trình: Tổng Quan Và Cài Đặt Claude Code CLI

Chào các anh em lập trình viên trên Viblo! Dạo gần đây, làn sóng AI Agent (các đại lý AI có khả năng tự động thực hiện tác vụ) đang bùng nổ mạnh mẽ. Không đứng ngoài cuộc chơi, Anthropic đã tung ra Claude Code - một công cụ CLI mang sức mạnh của mô hình Claude trực tiếp vào terminal của bạn.

Nếu bạn đã chán việc phải copy-paste code qua lại giữa trình duyệt và IDE, hay muốn một "trợ lý" thực sự có thể tự đọc hiểu cả repo, tự chạy test và sửa lỗi thì đây chính là bài viết dành cho bạn. Trong bài học đầu tiên này, chúng ta sẽ cùng tìm hiểu Claude Code là gì và cách đưa nó lên "máy cày" của bạn nhé!

1. Claude Code Là Gì? Tại Sao Lại Khác Biệt?

Thông thường, khi dùng GitHub Copilot hay ChatGPT, AI hoạt động theo cơ chế Passive (Thụ động): Bạn hỏi, AI trả lời hoặc gợi ý dòng code tiếp theo.

Claude Code thì khác. Nó là một AI Agent hoạt động theo cơ chế Active (Chủ động) ngay trong Terminal của bạn. Nó có thể:

• Đọc và hiểu toàn bộ cấu trúc dự án: Tự động tìm kiếm file, đọc nội dung mà không cần bạn phải upload từng file.
• Tự thực thi lệnh: Nó có thể tự chạy npm test, go test, hay php artisan test để xem code nó vừa sửa có chạy đúng hay không.
• Tích hợp Git chặt chẽ: Tự tạo branch, xem git diff, và thậm chí viết commit message chuẩn chỉnh cho bạn.

Lưu ý quan trọng: Vì Claude Code có quyền chạy lệnh và sửa file trực tiếp trên máy của bạn, hãy luôn quan sát các quyền (permissions) mà nó yêu cầu trong quá trình chạy để đảm bảo an toàn hệ thống.

2. Điều Kiện Cần Có (Prerequisites)

Trước khi cài đặt, hãy đảm bảo môi trường của bạn đáp ứng các yêu cầu sau:

1. Hệ điều hành: Hỗ trợ tốt trên macOS, Linux. Đối với Windows, khuyến khích sử dụng WSL (Windows Subsystem for Linux).
2. Node.js: Phiên bản v18 trở lên.
3. Tài khoản Anthropic Console: Bạn cần có tài khoản và API Key từ Anthropic (Lưu ý: Tài khoản cần nạp sẵn một ít credit vì Claude Code sử dụng API trả phí theo lượng token tiêu thụ, cụ thể là model claude-3-7-sonnet).

3. Hướng Dẫn Cài Đặt Từng Bước

Hãy mở Terminal yêu thích của bạn lên và thực hiện các bước sau:

Bước 1: Cài đặt Claude Code toàn cục (Global)

Sử dụng npm (hoặc yarn/pnpm) để cài đặt package chính thức từ Anthropic:

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

Bước 2: Khởi chạy lần đầu và Liên kết tài khoản

Sau khi cài đặt xong, bạn gõ lệnh sau để khởi động:

claude

Lúc này, Terminal sẽ hiển thị một thông báo yêu cầu xác thực. Bạn sẽ thực hiện:

1. Bấm vào liên kết được hiển thị trên màn hình để mở trình duyệt.
2. Đăng nhập vào tài khoản Anthropic của bạn.
3. Copy mã xác thực (OAuth code) từ trình duyệt dán lại vào Terminal.

Bước 3: Cấu hình API Key (Nếu không dùng OAuth)

Nếu bạn muốn quản lý chi phí qua API Key riêng biệt, bạn có thể thiết lập biến môi trường:

export ANTHROPIC_API_KEY="your-api-key-here"

(Mẹo: Hãy thêm dòng này vào file .bashrc hoặc .zshrc để không phải nhập lại mỗi khi mở máy).

4. Các Option (Flags) Khởi Chạy Cơ Bản Nên Biết

Khi gõ claude, bạn có thể đi kèm với một số option (cờ - flags) để điều chỉnh chế độ hoạt động. Dưới đây là các option phổ biến nhất ở bài học khởi đầu này:

5. Trải Nghiệm Nhanh (Quick Start)

Hãy thử di chuyển vào một project bất kỳ của bạn (cd my-project) và gõ claude.

Giao diện chat sẽ xuất hiện. Hãy thử gõ câu lệnh đầu tiên:

Thử tìm xem trong dự án này có file cấu hình nào liên quan đến Database không và giải thích nó cho tôi.

Bạn sẽ thấy Claude bắt đầu quét thư mục, tìm file (như .env, database.php, hoặc config.json) và đưa ra câu trả lời cực kỳ thông minh. Để thoát khỏi môi trường Claude Code, bạn chỉ cần gõ /exit hoặc bấm Ctrl + C.

Tạm kết Bài 1

Vậy là chúng ta đã hoàn thành bước đệm đầu tiên: Hiểu về bản chất của Claude Code và cài đặt thành công nó vào môi trường làm việc. Sức mạnh thực sự của "con quái vật" này nằm ở khả năng thực thi lệnh và chỉnh sửa mã nguồn trực tiếp mà chúng ta sẽ khám phá ở các bài sau.

Ở Bài học 2, mình sẽ hướng dẫn các bạn Các lệnh điều hướng bên trong hệ thống (Slash Commands) và Cách kiểm soát Context (ngữ cảnh) để không bị tốn quá nhiều tiền API mà AI vẫn hiểu đúng ý mình.

Nếu gặp khó khăn trong quá trình cài đặt, các bạn hãy comment ngay phía dưới để mình hỗ trợ nhé. Đừng quên Upvote và Follow series này để không bỏ lỡ các bài học tiếp theo!

Cảm ơn các bạn đã đọc bài viết của mình trên Viblo!