Claude Code là công cụ lập trình của Anthropic: Claude đọc mã nguồn trong dự án của bạn, sửa file, chạy lệnh và làm việc với Git, nhưng luôn hỏi trước khi thay đổi gì. Bài mở đầu Module 11 này dẫn bạn đi hết “ngày đầu tiên”: cài đặt, đăng nhập, mở dự án, thực hiện thay đổi đầu tiên và một bước thiết lập nên làm trước khi tắt máy. Help Center ước tính cả quá trình mất khoảng 15 phút.
Bạn cần chuẩn bị gì?
- Một dự án code để làm việc (một thư mục mã nguồn, tốt nhất đã dùng Git).
- Một tài khoản: gói Claude Pro, Max, Ultra, Team hoặc Enterprise (cách được khuyên dùng), hoặc tài khoản Claude Console trả theo API, hoặc quyền truy cập qua nhà cung cấp đám mây như Amazon Bedrock.
- Nếu chưa từng dùng terminal, tài liệu chính thức có hướng dẫn riêng; hoặc bạn chọn cách dùng qua ứng dụng desktop ở dưới.
Bước 1: Mở Claude Code (khoảng 2 phút)
Cách dễ nhất: ứng dụng Claude Desktop
Help Center khuyên người mới cài Claude Desktop, đăng nhập bằng gói trả phí rồi mở tab Code. Claude Code đã có sẵn trong ứng dụng, không cần cài thêm gì, và bạn cũng bỏ qua được bước đăng nhập ở dưới.
Cách dùng terminal
Mở terminal và chạy lệnh cài đặt gốc (native) phù hợp với máy:
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# Homebrew (macOS)
brew install --cask claude-code
# WinGet (Windows)
winget install Anthropic.ClaudeCodeBản cài native tự cập nhật trong nền; bản Homebrew và WinGet thì không, bạn phải tự chạy lệnh nâng cấp. Trên Windows, tài liệu khuyên cài thêm Git for Windows để Claude Code dùng được công cụ Bash. Help Center cũng nêu cách cài qua npm (cần Node 18 trở lên) và lưu ý không dùng sudo để tránh lỗi quyền file về sau.
Cài xong, mở cửa sổ terminal mới và kiểm tra bằng claude --version. Nếu thấy số phiên bản là thành công.
Bước 2 và 3: Đăng nhập, mở dự án
- Di chuyển vào thư mục dự án rồi khởi động:
cd đường/dẫn/dự-án, sau đó gõclaude. - Lần đầu, Claude Code yêu cầu đăng nhập. Với gói Claude hoặc tài khoản Console, làm theo hướng dẫn để xác nhận trên trình duyệt (kể cả SSO nếu công ty yêu cầu). Không chắc mình thuộc loại nào thì hỏi quản trị viên hoặc thử
/logintrước. - Đăng nhập một lần là đủ; thông tin được lưu lại. Muốn đổi tài khoản, gõ
/loginngay trong phiên.
Trên desktop, bạn chỉ cần tạo phiên mới trong tab Code và chọn thư mục dự án. Bạn không phải tải file lên: Claude Code tự đọc file khi cần.
Bước 4: Quy tắc an toàn duy nhất cần nhớ
Claude luôn hỏi trước khi sửa file hay chạy lệnh. Bạn sẽ thấy phần thay đổi (diff) và được chọn: đồng ý lần này, đồng ý và không hỏi lại về việc sửa file trong phiên, hoặc từ chối kèm lý do. Nhấn Shift+Tab để chuyển giữa các chế độ quyền, ví dụ Plan (chỉ đọc và đề xuất) hay Accept Edits (tự chấp nhận sửa file).
Mọi thay đổi chưa được commit cho đến khi bạn commit, nên nếu không ưng, bạn vẫn có thể hoàn tác bằng git checkout.
Bước 5: Năm việc nên thử đầu tiên
- Làm quen dự án: nhờ Claude tóm tắt ngắn codebase và chỉ ra điểm khởi chạy. Bạn sẽ thấy Claude tự đi đọc các file.
- Tìm một chức năng: hỏi phần xác thực người dùng được xử lý ở đâu. Cách này nhanh hơn tìm thủ công khi bạn không nhớ tên chính xác.
- Sửa an toàn: nhờ viết chú thích (docstring) cho một hàm cụ thể. Đây là bài tập tốt để quen với việc đọc diff.
- Sửa lỗi thật: dán thông báo lỗi của một test đang hỏng, nhờ Claude tìm nguyên nhân và sửa. Đây là quy trình làm việc chính.
- Giao việc Git: nhờ stage thay đổi và viết commit message theo phong cách của repo. Claude sẽ hỏi trước khi chạy lệnh git.
Prompt mẫu cho ngày đầu (gõ tiếng Việt thoải mái):
“Dự án này làm gì? Tóm tắt trong 5 gạch đầu dòng và cho biết file khởi chạy chính.”
“Test trong file tests/test_cart.py đang lỗi với thông báo dưới đây. Tìm nguyên nhân, đề xuất cách sửa và chờ tôi đồng ý rồi mới sửa: [dán lỗi]”
Càng cụ thể càng tốt: thay vì “sửa lỗi đi”, hãy nói rõ lỗi gì, xảy ra khi nào.
Bước 6: Trước khi kết thúc ngày đầu
Chạy /init một lần cho mỗi dự án. Lệnh này quét mã nguồn và tạo file CLAUDE.md ở thư mục gốc, ghi lại quy ước của dự án.
Claude đọc file này ở đầu mọi phiên, nên Help Center coi đây là bước thiết lập đáng giá nhất. Cách viết CLAUDE.md cho tốt sẽ có ở bài CLAUDE.md và cách viết prompt hiệu quả.
Vài mẹo nhỏ: gõ / để xem các lệnh có sẵn, /help để được trợ giúp, /resume để mở lại phiên cũ, và /exit để thoát.
Danh sách đầy đủ có trong bài tiếp theo.
Những điều bạn học được trong bài này
- Có thể dùng Claude Code qua tab Code của Claude Desktop hoặc cài bằng terminal
- Kiểm tra cài đặt bằng claude –version, khởi động bằng claude trong thư mục dự án
- Claude luôn hỏi trước khi sửa file hoặc chạy lệnh; Shift+Tab đổi chế độ quyền
- Thay đổi chưa commit thì vẫn hoàn tác được bằng Git
- Năm việc nên thử: tóm tắt dự án, tìm chức năng, sửa nhỏ, sửa lỗi thật, giao việc Git
- Chạy /init để tạo CLAUDE.md cho mỗi dự án
Cần nhớ: Đọc kỹ diff trước khi đồng ý, nhất là trong những ngày đầu. Làm việc trong một repo Git để luôn có đường lùi, và đừng vội bật chế độ tự chấp nhận cho đến khi bạn đã quen cách Claude làm việc.
Nguồn tham khảo: Your first day in Claude Code – Claude Help Center; Quickstart – Claude Code Docs
Câu hỏi thường gặp
Gói Free có dùng được Claude Code không?
Tài liệu chính thức liệt kê các loại tài khoản đăng nhập được: gói Pro, Max, Ultra, Team, Enterprise, tài khoản Claude Console, hoặc qua nhà cung cấp đám mây. Gói Free không nằm trong danh sách này.
Gõ claude mà terminal báo không tìm thấy lệnh thì sao?
Thường là thư mục cài đặt chưa nằm trong PATH. Hãy mở cửa sổ terminal mới rồi thử lại; nếu vẫn lỗi, xem trang Troubleshoot installation trong tài liệu Claude Code.
Tôi có phải tải toàn bộ mã nguồn lên cho Claude không?
Không. Bạn chỉ cần mở Claude Code trong thư mục dự án; Claude tự đọc những file cần thiết khi làm việc.
Claude sửa sai thì làm sao quay lại?
Claude không tự commit thay bạn nếu bạn chưa đồng ý. Thay đổi chưa commit có thể hoàn tác bằng Git, ví dụ git checkout.
