Cài Claude Code & phiên đầu tiên trong repo thật

Stack công ty: Vue, PHP, Node. Template CLAUDE.md cho từng stack có sẵn trong folder templates/ — dùng ngay ở Bài 3.2.

🎯 Mục tiêu: Chạy được claude trong repo và hoàn thành 1 tác vụ nhỏ.

Cài đặt

Chọn 1 trong 2 cách:

# Cách 1 — Native installer (khuyến nghị: không cần Node, tự update)
curl -fsSL https://claude.ai/install.sh | bash        # macOS / Linux / WSL

# Cách 2 — npm (cần Node 18+; team ta có sẵn Node)
npm install -g @anthropic-ai/claude-code              # KHÔNG dùng sudo

Windows native hoặc Homebrew/WinGet: xem code.claude.com/docs (trang Setup). Kiểm tra: claude --version; gặp vấn đề chạy claude doctor.

Đăng nhập: vào thư mục dự án, gõ claude — lần đầu sẽ mở trình duyệt đăng nhập bằng tài khoản công ty (Team/Enterprise). Gói Free không dùng được Claude Code.

Phiên đầu tiên (làm ngay, 10 phút)

cd du-an-cua-ban
claude

Trong phiên, thử lần lượt:

1. Tóm tắt kiến trúc repo này: entry point, module chính, luồng dữ liệu — Claude tự grep/đọc file, không cần bạn dán code.
2. Tìm các TODO/FIXME trong src và nhóm theo mức độ nghiêm trọng
3. Quan sát permission prompt: mỗi khi Claude muốn chạy lệnh/sửa file, nó xin phép — bạn Approve/Deny. Đây là "phanh" của bạn.

Các bề mặt khác cùng engine: extension VS Code/JetBrains (thấy diff trực quan trong IDE), tab Code trong app desktop, Claude Code trên web/mobile. Settings, CLAUDE.md, MCP đi theo tài khoản/repo.

🏋️ Bài tập 3.1: Trong repo thật (nhánh riêng!), yêu cầu: "Thêm docblock/JSDoc cho 3 hàm public thiếu doc trong [file X]" → review diff → approve → git diff kiểm tra.

✅ ☐ Cài & login xong ☐ Hiểu permission prompt ☐ Hoàn thành edit đầu tiên trên nhánh riêng.