Bắt đầu với Claude Code: hướng dẫn dùng thử lần đầu cho người mới

Bạn có bao giờ ước mình có một trợ lý AI ngay trong terminal, có thể đọc hiểu toàn bộ project và thực thi lệnh giúp bạn? Claude Code của Anthropic chính là câu trả lời. Đây không phải một công cụ auto-complete, mà là một "tác nhân lập trình" thực thụ. Bài viết này sẽ hướng dẫn bạn từ bước cài đặt đầu tiên, cách ra lệnh cho Claude đọc và sửa file, cho đến việc tự động chạy test hoặc build project, tất cả trong một giao diện duy nhất.

Claude Code là gì và tại sao nó khác biệt? 🧐

Claude Code không chỉ là một công cụ gợi ý code thông thường. Đây là một tác nhân lập trình (programming agent) của Anthropic, hoạt động trực tiếp trong terminal của bạn [F1]. Nó được thiết kế để thực thi các tác vụ và tự động hóa quy trình làm việc, chứ không chỉ đơn thuần là hoàn thành dòng code.

Khác với các công cụ như GitHub Copilot tập trung vào hỗ trợ viết code, Claude Code có thể xử lý các tác vụ kỹ thuật phức tạp và tự động hóa quy trình làm việc [F5]. Thậm chí, nó có thể điều khiển các ứng dụng không có API bằng cách mô phỏng hành động của con người [F3]. Điều này biến nó thành một công cụ mạnh mẽ, được nhiều startup tin dùng để giải quyết các vấn đề thực tế [F5].

Sức mạnh của Claude Code đến từ khả năng hiểu và thực thi các yêu cầu phức tạp. Nó có thể được cài đặt trên bộ điều khiển và cấp quyền truy cập cấp hệ thống để điều tra, giải quyết các vấn đề như lỗi hệ thống video [F4]. Claude Code cũng có thể được sử dụng cho các tác vụ ngoài lập trình, như tự động hóa hành động trên máy tính để bàn (khởi động trò chơi, đăng nhập nhân vật) [F2].

Bài viết này dành cho những bạn lập trình viên đã có kinh nghiệm, muốn tìm hiểu cách Claude Code có thể giúp tự động hóa các công việc lặp đi lặp lại trong terminal, từ đó tối ưu hóa hiệu suất làm việc của mình.

Cài đặt và Cấu hình Môi trường Lần đầu 🔧

Để bắt đầu sử dụng Claude Code, mình cần cài đặt công cụ này và cấu hình API key. Claude Code là một tác nhân lập trình dựa trên terminal của Anthropic [F1]. Nó có thể giúp bạn tự động hóa nhiều tác vụ lập trình và thậm chí cả các hành động trên máy tính để bàn [F2, F3].

Quá trình cài đặt khá đơn giản với một lệnh duy nhất. Sau đó, mình sẽ cấu hình API key để Claude Code có thể kết nối với dịch vụ của Anthropic. Bạn cần có một API key hợp lệ từ tài khoản Anthropic của mình.

Sau khi cài đặt, mình sẽ khởi tạo Claude Code trong thư mục dự án. Điều này giúp nó nhận diện cấu trúc dự án và tạo các file cấu hình cần thiết, ví dụ như `.claudeignore`. File này cho phép bạn chỉ định những file hoặc thư mục mà Claude Code không nên truy cập hoặc sửa đổi.

# 1. Cài đặt Claude Code CLI
npx @anthropic/claude-code-cli@latest

# 2. Cấu hình API Key
# Thay YOUR_ANTHROPIC_API_KEY bằng API key của bạn
export ANTHROPIC_API_KEY="YOUR_ANTHROPIC_API_KEY"

# (Tùy chọn) Để lưu biến môi trường vĩnh viễn, thêm vào ~/.bashrc hoặc ~/.zshrc
# echo 'export ANTHROPIC_API_KEY="YOUR_ANTHROPIC_API_KEY"' >> ~/.zshrc # hoặc ~/.bashrc
# source ~/.zshrc # hoặc source ~/.bashrc

# 3. Khởi tạo Claude Code trong thư mục dự án hiện tại
claude-code init

Sau khi chạy lệnh `claude-code init`, bạn sẽ thấy một số file cấu hình được tạo ra trong thư mục dự án. Đặc biệt, file `.claudeignore` rất quan trọng để kiểm soát quyền truy cập của Claude Code vào các phần nhạy cảm hoặc không cần thiết của dự án.

Phiên làm việc đầu tiên: Mở project và 'trò chuyện' với codebase

Để bắt đầu một phiên làm việc với Claude Code, bạn cần mở terminal và điều hướng đến thư mục gốc của dự án. Sau đó, bạn có thể gọi Claude Code bằng một lệnh đơn giản. Claude Code là tác nhân lập trình dựa trên terminal của Anthropic [F1], nên việc tương tác trực tiếp qua dòng lệnh rất tiện lợi.

Khi đã ở trong thư mục dự án, mình thường bắt đầu bằng cách yêu cầu Claude phân tích cấu trúc tổng thể. Ví dụ, bạn có thể nhập câu lệnh sau:

claude-code analyze "Hãy phân tích cấu trúc của project này và cho tôi biết các thư viện chính đang được sử dụng."

Claude Code sẽ đọc các file cấu hình như `package.json`, `pom.xml`, `requirements.txt` hoặc các file tương tự để xác định các dependency chính. Nó cũng có thể quét qua cấu trúc thư mục để đưa ra cái nhìn tổng quan về các module hoặc thành phần chính của dự án. Điều này giúp bạn nhanh chóng nắm bắt bức tranh lớn mà không cần phải tự mình duyệt qua từng file.

Sau khi có cái nhìn tổng quan, bạn có thể đi sâu vào các phần cụ thể của codebase. Khả năng hiểu ngữ cảnh toàn bộ project là một điểm mạnh của Claude Code. Bạn không cần phải chỉ định file cụ thể, mà có thể hỏi những câu hỏi mang tính chức năng hoặc cấu trúc.

Ví dụ, để tìm kiếm một đoạn code cụ thể, bạn có thể hỏi:

claude-code find "Tìm cho tôi function xử lý việc xác thực người dùng."

Hoặc nếu bạn muốn tìm định nghĩa của một component UI, bạn có thể hỏi:

claude-code find "File nào định nghĩa component Button?"

Claude Code sẽ quét qua các file trong project, sử dụng ngữ cảnh đã thu thập được để xác định vị trí và hiển thị đoạn code liên quan. Điều này giúp tiết kiệm đáng kể thời gian tìm kiếm và điều hướng trong các dự án lớn, phức tạp.

Chỉnh sửa code và Refactor bằng ngôn ngữ tự nhiên

Claude Code là một tác nhân lập trình dựa trên terminal [F1]. Khả năng của nó không chỉ dừng lại ở việc đọc hiểu code, mà còn có thể thực hiện các thay đổi phức tạp dựa trên hướng dẫn bằng ngôn ngữ tự nhiên của bạn. Điều này giúp mình tiết kiệm đáng kể thời gian khi cần sửa lỗi nhỏ hoặc refactor một phần code.

Để Claude Code thay đổi code, bạn chỉ cần mô tả rõ ràng yêu cầu của mình. Ví dụ, mình có thể yêu cầu nó thêm một endpoint mới vào file API hiện có. Claude Code sẽ phân tích yêu cầu, xác định vị trí cần thay đổi và đề xuất code mới.

Ví dụ, nếu bạn muốn thêm một endpoint để lấy danh sách bài viết của người dùng, bạn có thể ra lệnh như sau:

Trong file `src/api/user.ts`, hãy thêm một endpoint GET `/users/{id}/posts` để lấy tất cả bài viết của một người dùng cụ thể.

Một trường hợp sử dụng mạnh mẽ khác là refactor code. Khi một function trở nên quá lớn hoặc khó đọc, bạn có thể nhờ Claude Code chia nhỏ nó ra. Nó sẽ không chỉ tách function mà còn đảm bảo tính đúng đắn và dễ kiểm thử hơn.

Function `calculatePrice` trong file `utils.js` quá dài. Hãy tách nó thành 3 function nhỏ hơn và dễ test hơn.

Sau khi nhận được yêu cầu, Claude Code sẽ hiển thị một bản diff (sự khác biệt giữa code cũ và code mới) ngay trên terminal. Bạn có thể xem xét các thay đổi này trước khi quyết định áp dụng. Đây là một bước quan trọng để đảm bảo mọi thứ diễn ra đúng như mong muốn.

Bạn có ba lựa chọn chính khi Claude Code đề xuất thay đổi:

Dưới đây là một ví dụ minh họa cách Claude Code có thể refactor một function TypeScript đơn giản. Giả sử chúng ta có một function `calculateOrderTotal` ban đầu:

function calculateOrderTotal(items: { price: number; quantity: number }[], discount: number, taxRate: number): number {
  let subtotal = 0;
  for (const item of items) {
    subtotal += item.price * item.quantity;
  }

  const discountedSubtotal = subtotal * (1 - discount);
  const total = discountedSubtotal * (1 + taxRate);
  return total;
}

Sau khi yêu cầu Claude Code tách function này thành các phần nhỏ hơn, nó có thể đề xuất một cấu trúc như sau:

function calculateSubtotal(items: { price: number; quantity: number }[]): number {
  let subtotal = 0;
  for (const item of items) {
    subtotal += item.price * item.quantity;
  }
  return subtotal;
}

function applyDiscount(subtotal: number, discount: number): number {
  return subtotal * (1 - discount);
}

function applyTax(amount: number, taxRate: number): number {
  return amount * (1 + taxRate);
}

function calculateOrderTotal(items: { price: number; quantity: number }[], discount: number, taxRate: number): number {
  const subtotal = calculateSubtotal(items);
  const discountedSubtotal = applyDiscount(subtotal, discount);
  const total = applyTax(discountedSubtotal, taxRate);
  return total;
}

Việc này giúp code dễ đọc, dễ bảo trì và dễ kiểm thử hơn rất nhiều. Claude Code đã trở thành một công cụ lập trình AI mặc định trong các công ty khởi nghiệp nhờ khả năng xử lý các tác vụ kỹ thuật phức tạp và quy trình làm việc tự động [F5].

Thực thi lệnh Terminal và Tự động hóa Workflow 🚀

Một trong những tính năng mạnh mẽ nhất của Claude Code là khả năng thực thi lệnh terminal một cách an toàn. Đây là một tác nhân lập trình dựa trên terminal của Anthropic [F1], cho phép bạn giao tiếp trực tiếp với môi trường phát triển của mình.

Bạn có thể yêu cầu Claude Code thực hiện các tác vụ cơ bản. Ví dụ, khi bạn nói "Hãy cài đặt thư viện `zod` và thêm nó vào `package.json`", Claude Code sẽ tự động chạy lệnh `npm install zod` cho bạn. Điều này giúp tiết kiệm thời gian và giảm thiểu sai sót khi gõ lệnh thủ công.

Đối với các tác vụ phức tạp hơn, Claude Code cũng có thể xử lý hiệu quả. Chẳng hạn, nếu bạn vừa sửa đổi một file và muốn chạy lại các bài test liên quan, bạn có thể yêu cầu "Hãy chạy lại các bài test cho file vừa sửa đổi". Claude Code sẽ tự xác định file test tương ứng và thực thi lệnh như `npm test -- src/components/Button.test.tsx`.

Điểm quan trọng là cơ chế an toàn. Claude Code luôn hỏi xác nhận của bạn trước khi thực thi bất kỳ lệnh nào có khả năng thay đổi hệ thống. Điều này đảm bảo bạn có toàn quyền kiểm soát và tránh những thay đổi không mong muốn.

Khả năng này mở ra tiềm năng lớn cho việc tự động hóa các workflow phức tạp. Claude Code có thể xử lý các tác vụ kỹ thuật phức tạp và quy trình làm việc tự động [F5], thậm chí điều tra và giải quyết các vấn đề như lỗi hệ thống video bằng cách được cấp quyền truy cập cấp hệ thống [F4]. Nó còn có thể tự động hóa các hành động trên máy tính để bàn, như khởi động trò chơi hoặc đăng nhập vào nhân vật [F2], và sử dụng các ứng dụng không có API bằng cách hoạt động như con người [F3].

Tóm lại, bạn đã có đủ hành trang cho phiên làm việc đầu tiên với Claude Code, từ đọc hiểu codebase đến thực thi lệnh terminal. Bước tiếp theo là hãy thử áp dụng nó vào một repo cá nhân của bạn và xem hiệu quả. Các bài viết sau sẽ đi sâu vào kỹ thuật prompt nâng cao hơn.