Hướng dẫn nhanh

Hướng dẫn này giúp bạn dùng được Claude Code chỉ trong vài phút. Sau khi đọc xong, bạn sẽ hiểu cách dùng Claude Code cho các tác vụ phát triển phần mềm phổ biến.

Trước khi bắt đầu

Bạn cần:

Một terminal hoặc command prompt đang mở. Nếu chưa từng dùng terminal, xem qua hướng dẫn về terminal trước.
Một dự án code bất kỳ để thực hành.
Tài khoản Claude (Pro, Max, Team, hoặc Enterprise), tài khoản Claude Console, hoặc quyền truy cập qua một cloud provider được hỗ trợ.

Hướng dẫn này tập trung vào CLI chạy trong terminal. Claude Code cũng có sẵn trên web, dưới dạng app Desktop, trong VS Code và JetBrains, trong Slack, và trong CI/CD với GitHub Actions và GitLab - xem Tổng quan để biết tất cả các môi trường có thể dùng Claude Code.

Bước 1: Cài đặt Claude Code

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

Ngoài cách cài đặt trên (khuyến nghị, tự động cập nhật), còn có thể cài qua Homebrew (brew install --cask claude-code) hoặc WinGet (winget install Anthropic.ClaudeCode) - tuy nhiên các cách này không tự cập nhật Claude Code. Trên Debian, Fedora, RHEL, Alpine cũng có thể cài qua apt, dnf, hoặc apk. Xem chi tiết đầy đủ tại Tổng quan § Cài đặt Claude Code.

Kiểm tra cài đặt thành công:

claude --version

Lệnh này in ra một số phiên bản kèm theo (Claude Code).

Bước 2: Đăng nhập vào tài khoản

Claude Code cần đăng nhập tài khoản mới dùng được. Khởi động một phiên tương tác bằng lệnh claude, bạn sẽ được yêu cầu đăng nhập ở lần chạy đầu tiên:

claude

Với tài khoản Claude subscription hoặc Console, làm theo hướng dẫn để hoàn tất xác thực trong trình duyệt. Nếu đã đặt biến môi trường ANTHROPIC_API_KEY, Claude Code sẽ bỏ qua bước đăng nhập và chỉ hỏi bạn xác nhận dùng key đó. Muốn đổi tài khoản sau này hoặc xác thực lại, gõ /login ngay trong session đang chạy.

Bạn có thể đăng nhập bằng một trong các loại tài khoản sau:

Claude Pro, Max, Team, hoặc Enterprise (khuyến nghị)
Claude Console (truy cập API bằng credit trả trước). Lần đăng nhập đầu tiên, một workspace “Claude Code” sẽ tự động được tạo trong Console để theo dõi chi phí tập trung.
Amazon Bedrock, Google Cloud’s Agent Platform, hoặc Microsoft Foundry (các cloud provider dành cho doanh nghiệp)
Một Claude apps gateway tự triển khai, nếu tổ chức của bạn có dùng: admin cấu hình sẵn URL gateway, và /login sẽ mở thẳng màn hình Cloud gateway để bạn đăng nhập bằng SSO nội bộ.

Sau khi đăng nhập, thông tin xác thực được lưu lại trên máy - bạn không cần đăng nhập lại mỗi lần. Xem thêm ở Authentication (Xác thực).

Bước 3: Khởi động phiên làm việc đầu tiên

Mở terminal trong thư mục dự án và khởi động Claude Code:

cd /path/to/your/project
claude

Thay /path/to/your/project bằng đường dẫn tới dự án bạn muốn làm việc.

Bạn sẽ thấy dấu nhắc của Claude Code, kèm phiên bản, model đang dùng và thư mục làm việc hiện tại phía trên. Gõ /help để xem các lệnh có sẵn, hoặc /resume để tiếp tục một cuộc hội thoại trước đó.

Bước 4: Đặt câu hỏi đầu tiên

Bắt đầu bằng việc tìm hiểu codebase. Thử một trong các câu sau:

> dự án này làm gì?

Claude sẽ phân tích các file trong dự án và đưa ra bản tóm tắt. Bạn cũng có thể hỏi cụ thể hơn:

> dự án dùng công nghệ gì?
> entrypoint chính nằm ở đâu?
> giải thích cấu trúc thư mục

Bạn cũng có thể hỏi về chính khả năng của Claude Code:

> Claude Code làm được những gì?
> làm sao để tạo custom skill trong Claude Code?
> Claude Code có làm việc được với Docker không?

Claude Code tự đọc file trong dự án khi cần - bạn không cần tự thêm ngữ cảnh (context) theo cách thủ công.

Bước 5: Thực hiện thay đổi code đầu tiên

Giờ hãy để Claude Code viết code thật sự. Thử một tác vụ đơn giản:

> thêm một hàm hello world vào file main.py

Claude Code sẽ:

Tìm file phù hợp.
Đề xuất thay đổi (hiển thị diff - những phần sẽ thay đổi).
Hỏi xác nhận trước khi sửa file, tuỳ theo chế độ quyền hạn đang bật.
Thực hiện sửa file.

Việc Claude Code có hỏi xác nhận trước khi sửa file hay không phụ thuộc vào chế độ quyền hạn. Ở chế độ mặc định, Claude luôn xin phê duyệt trước mỗi lần sửa. Nhấn Shift+Tab để chuyển qua các chế độ: acceptEdits tự động chấp nhận mọi thay đổi file, còn plan chỉ để Claude đề xuất thay đổi mà không sửa gì cả. Một số tài khoản còn có chế độ auto, chạy kiểm tra an toàn ở nền và chỉ chặn các hành động rủi ro, quay lại hỏi xác nhận sau khi bị chặn nhiều lần.

Bước 6: Dùng Git cùng Claude Code

Claude Code biến các thao tác Git thành hội thoại bằng ngôn tự nhiên:

> tôi đã thay đổi những file nào?
> commit thay đổi này với message mô tả rõ ràng

Bạn cũng có thể yêu cầu các thao tác Git phức tạp hơn:

> tạo branch mới tên feature/quickstart
> cho xem 5 commit gần nhất
> giúp tôi giải quyết conflict khi merge

Bước 7: Sửa lỗi hoặc thêm tính năng

Claude có khả năng debug lẫn triển khai tính năng mới.

Mô tả điều bạn muốn bằng ngôn ngữ tự nhiên:

> thêm input validation cho form đăng ký người dùng

Hoặc sửa lỗi có sẵn:

> có một lỗi xảy ra là người dùng submit được form trống - sửa lỗi này

Claude Code sẽ:

Xác định đoạn code liên quan.
Hiểu ngữ cảnh.
Triển khai giải pháp.
Chạy test nếu dự án có sẵn test.

Bước 8: Thử thêm vài quy trình phổ biến khác

Có nhiều cách khác để làm việc cùng Claude:

Refactor code

> refactor module authentication để dùng async/await thay vì callback

Viết test

> viết unit test cho các hàm trong calculator

Cập nhật tài liệu

> cập nhật README với hướng dẫn cài đặt

Review code

> review các thay đổi của tôi và đề xuất cải thiện

Các lệnh cần nhớ

Đây là những lệnh quan trọng nhất cho việc dùng hằng ngày. Shell command chạy từ terminal để khởi động hoặc tiếp tục Claude Code; session command chạy bên trong Claude Code sau khi đã khởi động.

Shell command:

Lệnh	Chức năng	Ví dụ
`claude`	Khởi động một session mới	`claude`
`claude "tác vụ"`	Chạy một tác vụ một lần	`claude "sửa lỗi build"`
`claude -p "câu hỏi"`	Chạy một truy vấn một lần rồi thoát	`claude -p "giải thích hàm này"`
`claude -c`	Tiếp tục cuộc hội thoại gần nhất trong thư mục hiện tại	`claude -c`
`claude -r`	Chọn lại một cuộc hội thoại trước đó	`claude -r`

Session command:

Lệnh	Chức năng	Ví dụ
`/clear`	Xoá lịch sử hội thoại hiện tại	`/clear`
`/help`	Xem các lệnh có sẵn	`/help`
`/exit` hoặc `Ctrl+D` (2 lần)	Thoát Claude Code	`/exit`

Xem đầy đủ hơn tại Tra cứu CLI (toàn bộ shell command) và Lệnh & chế độ quyền hạn (toàn bộ session command).

Mẹo cho người mới

Xem thêm Best practices và Quy trình thường gặp để tìm hiểu sâu hơn.

Mô tả yêu cầu một cách rõ ràng: thay vì “sửa bug đi”, hãy nói “sửa bug ở trang đăng nhập, người dùng thấy màn hình trắng sau khi nhập sai mật khẩu”.

Chia nhỏ tác vụ phức tạp thành từng bước:

> 1. tạo bảng database mới cho user profile
  2. tạo API endpoint để lấy và cập nhật profile
  3. tạo trang web cho phép người dùng xem và sửa thông tin

Để Claude khám phá trước khi sửa: hỏi “phân tích schema database này” hay “hãy tìm những sản phẩm bị khách hàng UK trả lại nhiều nhất” trước khi yêu cầu thay đổi code.
Dùng phím tắt để tiết kiệm thời gian: gõ / để xem toàn bộ lệnh và skill; nhấn Tab để auto-complete lệnh; phím ↑ để xem lại lệnh cũ; Shift+Tab để chuyển chế độ quyền hạn.

Bước tiếp theo

Sau khi đã nắm những điều cơ bản, khám phá các tính năng nâng cao hơn:

Cách Claude Code hoạt động - vòng lặp agentic, các tool có sẵn, và cách Claude Code tương tác với dự án của bạn
Best practices - có kết quả tốt hơn nhờ prompting hiệu quả và thiết lập dự án đúng cách
Quy trình thường gặp - hướng dẫn từng bước cho các tác vụ phổ biến
Mở rộng Claude Code - tuỳ biến bằng CLAUDE.md, skill, hook, MCP, và nhiều hơn nữa

Cần trợ giúp?

Trong Claude Code: gõ /help hoặc hỏi thẳng “làm sao để…”
Tài liệu: bạn đang ở đây! Xem thêm các trang hướng dẫn khác trên site này
Cộng đồng: tham gia Discord của Anthropic để trao đổi và nhận hỗ trợ