Hướng dẫn nhanh

Hướng dẫn này đưa bạn qua một vòng làm việc thực tế đầu tiên với Claude Code — từ cài đặt, đăng nhập, đến sửa bug và commit. Chỉ cần khoảng 10-15 phút.

Trước khi bắt đầu

Bạn cần:

• Terminal đã mở, đã cài Claude Code.
• Một dự án code bất kỳ để thực hành (dự án cá nhân nhỏ cũng được).
• Tài khoản Claude (Pro/Max/Team/Enterprise) hoặc tài khoản Anthropic Console.

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

claude --version

1. Đăng nhập

Chạy claude lần đầu sẽ tự động yêu cầu đăng nhập qua trình duyệt:

claude

Làm theo hướng dẫn để đăng nhập. Sau lần đầu, thông tin đăng nhập được lưu lại — không cần đăng nhập lại mỗi lần. Nếu cần đổi tài khoản sau này, gõ /login ngay trong phiên.

2. Khởi động Claude Code trong dự án

cd du-an-cua-ban
claude

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 — đây là chế độ tương tác (interactive mode), một phiên trò chuyện với Claude Code ngay trong terminal.

3. Khám phá codebase

Hỏi Claude về dự án để nó tự đọc hiểu code trước khi thao tác — bạn không cần tự paste code vào, Claude Code tự đọc file khi cần:

> dự án này làm gì?
> 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 Claude Code:

> Claude Code làm được những gì?
> Claude Code có làm việc được với Docker không?

4. Thực hiện một thay đổi nhỏ

Mô tả yêu cầu bằng ngôn ngữ tự nhiên:

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

Claude Code sẽ:

1. Tìm file phù hợp.
2. Đề xuất thay đổi (hiển thị diff).
3. Hỏi xác nhận trước khi sửa file — tuỳ chế độ quyền hạn đang bật; ở chế độ mặc định, Claude luôn hỏi trước mỗi lần sửa. Nhấn Shift+Tab để chuyển qua chế độ tự động chấp nhận sửa file (acceptEdits) hoặc chế độ chỉ lên kế hoạch, không sửa gì (plan).
4. Thực hiện sửa file sau khi bạn đồng ý.

5. Dùng git một cách hội thoại

> tôi đã thay đổi những file nào?
> commit các thay đổi này với message mô tả rõ ràng
> 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

Claude Code sẽ tự viết commit message phù hợp với lịch sử commit của dự án.

6. Sửa lỗi hoặc thêm tính năng

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

hoặc với lỗi có sẵn:

> có bug là người dùng submit được form trống — sửa giúp

Claude Code sẽ định vị đoạn code liên quan, hiểu ngữ cảnh, triển khai giải pháp, và chạy test nếu dự án có sẵn test.

7. Vài quy trình phổ biến khác

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

Mẹo

Nói chuyện với Claude Code như với một đồng nghiệp giỏi: mô tả điều bạn muốn đạt được, nó sẽ giúp bạn đi đến đó — không cần viết câu lệnh kiểu “thần chú”.

Các lệnh cần nhớ

Lệnh gõ ở terminal (trước khi vào hoặc để khởi động lại phiên):

Lệnh	Chức năng
claude	Khởi động phiên tương tác trong thư mục hiện tại
claude "mô tả tác vụ"	Khởi động và giao tác vụ ngay
claude -p "câu lệnh"	Chế độ headless: chạy một lần, in kết quả, thoát — phù hợp cho script/CI
claude -c (--continue)	Tiếp tục phiên gần nhất trong thư mục hiện tại
claude -r (--resume)	Chọn một phiên cũ để tiếp tục

Lệnh gõ bên trong phiên (bắt đầu bằng /):

Lệnh	Chức năng
/help	Xem trợ giúp và danh sách lệnh
/clear	Xoá lịch sử hội thoại hiện tại, bắt đầu phiên mới
/exit hoặc Ctrl+D (2 lần)	Thoát Claude Code

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

Mẹo cho người mới

• Cụ thể hoá yêu cầu: 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.
• Tận dụng phím tắt: 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

• Quy trình thường gặp — các pattern dùng Claude Code hiệu quả hơn
• CLAUDE.md — cho Claude ghi nhớ quy ước và ngữ cảnh dự án
• Hooks — tự động hoá hành động trước/sau khi Claude thao tác

Nguồn

Dịch và biên soạn từ Quickstart chính thức. Một số chi tiết CLI có thể thay đổi theo phiên bản — kiểm tra claude --help hoặc gõ /help trong phiên để chắc chắn.