Tất cả những gì bạn cần biết để sử dụng Claude Code và ClaudeKit hiệu quả cho mọi dự án.
Hiểu đơn giản 2 công cụ này và tại sao dùng cùng nhau sẽ mạnh hơn.
Công cụ AI lập trình chạy trên Terminal. Bạn nói tiếng Việt, Claude Code tự viết code, sửa bug, deploy — giống như có 1 lập trình viên AI ngồi cạnh bạn 24/7.
# Mở Terminal → vào dự án → chạy Claude Code cd /đường-dẫn/dự-án claude # Rồi nói tiếng Việt bình thường: "Sửa lỗi đăng nhập, thêm nút logout, đẩy lên git" # → Claude AI tự làm hết!
Bộ công cụ nâng cấp cho Claude Code. Thêm 14 agent chuyên biệt, 32+ lệnh, 50+ skills. Giúp Claude Code làm việc có quy trình, ít sai, chất lượng cao hơn.
Engineer Kit ($99) — 14 agents, 32+ commands, 50+ skills cho lập trình.
Marketing Kit ($99) — 32 agents, 119+ commands, 21+ skills cho marketing.
Cả 2 kit có thể cài chung trong 1 dự án. → Mua ClaudeKit tại đây
Bạn vẫn nói tiếng Việt bình thường. Chỉ thêm lệnh / để Claude làm bài bản hơn.
/plan, /cook chỉ là shortcut giúp Claude làm bài bản hơn. Nếu lười, nói tự nhiên cũng OK — ClaudeKit chạy ngầm phía sau.Phần mềm cần có trên máy Mac. Chỉ cài 1 lần cho máy.
Vào nodejs.org → Tải bản LTS → Cài. Kiểm tra: node --version
brew install gh gh auth login # Chọn: GitHub.com → HTTPS → Yes → Login with web browser # Mở trình duyệt, nhập code → Done! # Kiểm tra: gh auth status # Phải hiện: ✓ Logged in to github.com as TEN_GITHUB
npm install -g @anthropic-ai/claude-codeCần có tài khoản Claude Pro/Max ($20-100/tháng).
npm install -g claudekit-cli # Kiểm tra: ck --version
node -v , gh --version , claude --version , ck --version — tất cả phải hiện số version.Mỗi dự án mới cài 1 lần. Sau đó chỉ cần mở Claude Code là làm việc.
# Bước 1: Vào thư mục dự án cd /đường-dẫn/dự-án # Bước 2: Cài Engineer Kit ck init --kit engineer # Chọn: target = . → Yes → Yes (dependencies) → Yes (script) # Chọn: Yes (global Gemini key) → Enter (skip Discord) → No (extra keys) # Bước 3: (Tùy chọn) Cài thêm Marketing Kit ck init --kit marketing # Bước 4: Mở Claude Code claude # Bước 5: Chạy 1 lần để quét project (5-10 phút) /docs:init
/docs:init chỉ chạy 1 lần, mất 5-10 phút vì quét toàn bộ codebase. Các lần sau mở Claude Code chỉ vài giây. Cần cập nhật docs thì dùng /docs:update (nhanh hơn).cd /đường-dẫn/dự-ánck init --kit engineerclaude (mở Claude Code)/docs:init (quét project)/scout (khám phá cấu trúc)/plan → /cook → /testĐây là phần quan trọng nhất — workflow bạn dùng mỗi ngày.
cd /đường-dẫn/dự-án claude # Xong! Mở trong vài giây. Gõ lệnh hoặc nói tự nhiên.
# Bước 1: Lên kế hoạch (Claude nghiên cứu trước) /plan thêm tính năng thanh toán online với Stripe # Bước 2: Đọc plan → OK thì triển khai /cook implement theo plan # Bước 3: Chạy test /test # Bước 4: Review code trước khi push /review:codebase # Bước 5: Commit & push (nói tự nhiên) "commit và push lên git"
/plan thêm tính năng thanh toán online cho website/plan fix lỗi bảo mật authentication/plan thêm tính năng chat real-time cho ứng dụng# Bug đơn giản: /fix:fast lỗi đăng nhập không redirect về dashboard # Bug phức tạp: /fix:hard race condition khi 2 user submit cùng lúc # Cần phân tích sâu: /debug tại sao API trả về 500 khi tạo đơn hàng mới
/ask rate limiting hoạt động thế nào? /ask giải thích flow xử lý thanh toán /ask file nào xử lý authentication? /scout # Xem tổng quan cấu trúc project
Không nhớ lệnh? Cứ nói tự nhiên — ClaudeKit chạy ngầm hỗ trợ.
"Sửa lỗi login, thêm validation cho form đăng ký" "Tạo thêm trang quản lý sản phẩm cho admin" "Đổi database từ SQLite sang PostgreSQL" "Deploy bản mới lên VPS của mình"
Không cần nhớ hết, chỉ cần biết vài lệnh chính. Còn lại nói tự nhiên.
| Lệnh | Mô tả | Khi nào dùng |
|---|---|---|
/plan | Lên kế hoạch chi tiết | Trước khi code bất kỳ tính năng nào |
/cook | Triển khai code theo plan | Sau khi đã có plan OK |
/test | Chạy test tự động | Sau khi code xong |
/review:codebase | Review toàn bộ code | Trước khi commit/push |
/fix:fast | Fix bug nhanh | Bug đơn giản, rõ nguyên nhân |
/fix:hard | Fix bug phức tạp | Bug khó, cần phân tích |
/debug | Debug sâu | Không biết bug ở đâu |
/ask | Hỏi về project | Muốn hiểu code |
/scout | Xem cấu trúc project | Mới vào project, muốn nắm bao quát |
/docs:update | Cập nhật tài liệu | Sau khi thay đổi lớn |
| Nhóm | Lệnh | Mô tả |
|---|---|---|
| 📋 Planning | /plan | Lên kế hoạch 1 giải pháp |
/plan:two | So sánh 2 giải pháp | |
/plan:three | So sánh 3 giải pháp | |
| 🍳 Cooking | /cook | Code theo plan (hỏi xác nhận) |
/cook:auto | Code tự động không hỏi | |
/cook:iterate | Cải tiến code hiện tại | |
| 🔧 Fixing | /fix:fast | Fix bug nhanh |
/fix:hard | Fix bug phức tạp | |
/debug | Debug chi tiết | |
| 🧪 Testing | /test | Viết + chạy test |
/review:codebase | Review toàn bộ code | |
| 📄 Docs | /docs:init | Tạo docs lần đầu (1 lần) |
/docs:update | Cập nhật docs | |
/docs:check | Kiểm tra docs còn đúng không | |
| 🔀 Tiện ích | /scout | Khám phá codebase |
/ask | Hỏi đáp về project | |
/brainstorm | Brainstorm ý tưởng | |
/kanban | Xem bảng công việc | |
/git:cm | Tạo commit message chuẩn |
Mỗi agent là 1 chuyên gia. Khi bạn gõ lệnh, đúng agent tự động được kích hoạt.
Lên kế hoạch trước khi code
Nghiên cứu công nghệ, so sánh
Viết code, implement features
Viết test, kiểm tra chất lượng
Tìm root cause, fix bug
Review security, performance
Brainstorm giải pháp
Thiết kế giao diện
Quản lý tài liệu
Theo dõi tiến độ
Commit, push, branches
Ghi nhật ký dự án
Quản lý kết nối ngoài
Khám phá codebase
Những tình huống thực tế bạn sẽ gặp khi làm việc với bất kỳ dự án nào.
Phát hiện lỗ hổng bảo mật cần sửa ngay.
# Lên kế hoạch fix /plan fix lỗi SQL injection trong API tìm kiếm - validate input trước khi query # Đọc plan → OK → Triển khai /cook implement theo plan # Test /test # Review /review:codebase
Thêm module quản lý đơn hàng cho ứng dụng.
/plan thêm module quản lý đơn hàng - gồm: danh sách, chi tiết, tạo mới, cập nhật trạng thái, thông báo email khi đổi trạng thái # Đọc plan → OK /cook implement module đơn hàng theo plan
Cần chọn giữa nhiều phương án kỹ thuật.
/plan:two thêm tính năng real-time notifications - so sánh: (1) WebSocket (2) Server-Sent Events # So sánh 2 phương án → Chọn phương án tốt nhất /cook implement phương án 1
Không cần lệnh, nói bình thường cũng OK.
"Thêm dark mode cho toàn bộ giao diện" "Thêm tính năng export báo cáo ra Excel cho admin" "API endpoint trả về 500 khi tạo user mới, sửa lại"
Bộ công cụ marketing automation. Cài chung trong cùng dự án với Engineer Kit.
cd /đường-dẫn/dự-án ck init --kit marketing # Chọn giống lúc cài Engineer Kit # 2 kit hoạt động song song, không xung đột
Lead gen, content gaps, tăng traffic
Technical SEO, keyword research, rankings
Scoring, intent detection, ưu tiên leads
Market intel, trends, competitive analysis
Email sequences, automation, drip campaigns
Collateral, pitches, battlecards
CRO, A/B testing, tối ưu funnel
Blogs, videos, ads, multimedia
Retention, engagement, giữ chân khách
Revenue expansion, tăng AOV
Multi-channel orchestration
High-converting copy, headlines
Multi-platform social content
Engagement, moderation
Data insights, reporting, KPIs
| Lệnh | Mô tả | Ví dụ |
|---|---|---|
/campaign create | Tạo campaign mới | /campaign create "Ra mắt sản phẩm Q2" |
/campaign:email | Email drip campaigns | /campaign:email "welcome sequence" |
/content:good | Tạo landing page / content | /content:good "landing page sản phẩm" |
/seo:audit | Audit SEO toàn site | /seo:audit |
/seo:keywords | Nghiên cứu keywords | /seo:keywords "từ khóa ngành của bạn" |
/email | Email marketing | /email "gửi thông báo cho khách hàng" |
/social | Social media content | /social "post Facebook ra mắt sản phẩm" |
/write | Viết content | /write "blog post về chủ đề X" |
/analyze | Phân tích data | /analyze "conversion rate trang đăng ký" |
/dashboard | Marketing dashboard | /dashboard |
Google Analytics 4 — data, reporting
Campaign optimization, bidding
Email delivery, automation
Modern email API
Facebook/Instagram advertising
| Workflow | Flow |
|---|---|
| Campaign | Ý tưởng → Triển khai → Đo lường |
| Content | Ideation → Creation → Distribution → Optimization |
| SEO | Audit → Keyword research → Optimize → Monitor |
| Build list → Segment → Sequence → A/B test | |
| Social | Plan → Create → Schedule → Engage |
| Sales | Lead gen → Nurture → Close |
| Analytics | Setup tracking → Analyze → Report → Action |
| Brand | Define brand → Guidelines → Enforce |
# Tạo campaign ra mắt sản phẩm /campaign create "Ra mắt sản phẩm mới tháng 4" # Tạo landing page /content:good "landing page sản phẩm - highlight: tính năng, giá, đánh giá" # Viết email sequence chào mừng /campaign:email "welcome sequence 5 emails cho khách hàng mới" # Nghiên cứu SEO /seo:keywords "từ khóa chính cho ngành của bạn" # Social media posts /social "10 posts Facebook/Instagram quảng bá sản phẩm" # Phân tích conversion /analyze "tỷ lệ đăng ký từ landing page"
/campaign create, nhiều agents tự phối hợp: Campaign Manager lên chiến lược → Copywriter viết nội dung → Email Wizard tạo sequences → Social Media Manager lên lịch đăng → Analytics Analyst định KPIs.Các lỗi bạn có thể gặp và cách fix nhanh.
SSH key chưa cấu hình. Dùng HTTPS thay thế:
gh auth login # Chọn: GitHub.com → HTTPS → Yes → Login with web browser
File settings bị corrupted (đặc biệt khi có nội dung markdown dài). Xóa đi:
rm /đường-dẫn/dự-án/.claude/settings.local.json claude # Mở lại → file tự tạo mới
Chưa đăng nhập GitHub hoặc tài khoản không có quyền:
# Kiểm tra đăng nhập gh auth status # Kiểm tra quyền truy cập repo gh repo view claudekit/claudekit-engineer --json name # Phải hiện: {"name": "claudekit-engineer"} # Nếu không có quyền → Đăng nhập lại gh auth login
Lần đầu Claude Code sẽ hỏi permission. Luôn chọn option 2 ("Yes, and don't ask again...") để không bị hỏi lại cho loại lệnh tương tự.
Đây là bình thường! /docs:init chỉ chạy 1 lần duy nhất cho mỗi project. Nó quét toàn bộ codebase nên mất 5-15 phút tùy project. Các lần sau mở Claude Code chỉ vài giây.
Cứ nói tiếng Việt tự nhiên! ClaudeKit sẽ chạy ngầm phía sau. Hoặc gõ / rồi nhấn Tab để xem danh sách lệnh.
| Mục | Chi phí | Ghi chú |
|---|---|---|
| Claude Pro/Max | $20-100/tháng | Subscription Anthropic, dùng Claude Code |
| ClaudeKit Engineer | $99 (1 lần) | Lifetime, cập nhật miễn phí — Mua tại đây |
| ClaudeKit Marketing | $99 (1 lần) | Lifetime, cập nhật miễn phí — Mua tại đây |
| Gemini API | Miễn phí | Free tier 15 req/min, cho AI multimodal |
| Kênh | Liên hệ |
|---|---|
| Mua ClaudeKit | claudekit.cc |
| Docs | docs.claudekit.cc |
| Twitter/X | @goon_nguyen |
| Cập nhật kit | ck update |
Quy trình deploy dự án lên VPS với Docker, Nginx, Cloudflare SSL.
cd ~/ten-du-an claude # Dùng ClaudeKit: /plan, /cook, /review:codebase # Claude Code tự commit + push GitHub
# Mở Claude Code web app → nói:
deploy du an len VPS, git pull va rebuild docker.
VPS: root@IP_VPS_CUA_BAN, folder /opt/TEN_DU_ANBrowser → Cloudflare (HTTPS) → Nginx:443 → Next.js:3000 → PostgreSQL:5432
ssh root@IP_VPS curl -fsSL https://get.docker.com | sh
# Lấy token trên Mac trước gh auth token # Copy chuỗi token # Trên VPS git clone https://USERNAME:TOKEN@github.com/USERNAME/REPO.git /opt/TEN_DU_AN
cd /opt/TEN_DU_AN cat > .env << 'EOF' DATABASE_URL=postgresql://dbuser:MATKHAU@postgres:5432/ten_database?schema=public OPENAI_API_KEY=sk-... JWT_SECRET=chuoi-dai-random-32-ky-tu RESEND_API_KEY=re_... NODE_ENV=production NEXT_PUBLIC_APP_URL=https://domain-cua-ban.com DB_PASSWORD=MATKHAU DB_USER=dbuser DB_NAME=ten_database EOF
# Trên Cloudflare Dashboard: # 1. SSL/TLS → Origin Server → Create Certificate # 2. Copy Origin Certificate → lưu file origin.pem # 3. Copy Private Key → lưu file origin.key # 4. SSL/TLS → Overview → chọn "Full" # Upload certs lên VPS (trên Mac): scp ~/origin.pem root@IP_VPS:/opt/TEN_DU_AN/nginx/certs/ scp ~/origin.key root@IP_VPS:/opt/TEN_DU_AN/nginx/certs/
docker compose up -d --build docker compose exec app npx prisma@5.22.0 migrate deploy docker compose exec app npx tsx prisma/seed-courses.ts
Cần thêm env vars placeholder trong Dockerfile khi build:
# Thêm trước dòng RUN npm run build
ENV JWT_SECRET=build-placeholder
ENV RESEND_API_KEY=build-placeholder
ENV OPENAI_API_KEY=build-placeholder
ENV DATABASE_URL=postgresql://fake:fake@localhost:5432/fakeThiếu OpenSSL trong Docker Alpine. Thêm vào Dockerfile:
RUN apk add --no-cache libc6-compat opensslDocker compose dùng biến khác với .env. Thêm vào .env:
echo 'DB_PASSWORD=MatKhauCuaBan' >> .env echo 'DB_USER=dbuser' >> .env echo 'DB_NAME=ten_database' >> .env docker compose down && docker compose up -d
VPS đã có Nginx cài sẵn. Tắt nó đi:
systemctl stop nginx systemctl disable nginx docker compose up -d nginx
SSL mode sai trên Cloudflare. Vào Cloudflare Dashboard:
SSL/TLS → Overview → đổi sang "Full" (không phải Flexible)
Nếu vẫn lỗi, mở Incognito (Command + Shift + N) để tránh cache.
Nếu VPS chạy nhiều project, Docker cache có thể bị chia sẻ. Xóa cache và build lại:
docker compose down docker system prune -af docker compose up -d --build
⚠️ Chỉ xóa cache build, KHÔNG xóa code hay dữ liệu các project khác.
Token không đúng hoặc hết hạn. Trên Mac lấy token mới:
# Trên Mac gh auth token # Copy token # Trên VPS git clone https://USERNAME:TOKEN@github.com/USERNAME/REPO.git /opt/TEN_DU_AN
# Xem tất cả container đang chạy docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}" # Xem logs app docker compose logs app --tail 20 # Xem logs nginx docker compose logs nginx --tail 20 # Test app có chạy không curl -k https://localhost # Restart tất cả docker compose down && docker compose up -d
# Bước 1: Mac Terminal — sửa code cd ~/ten-du-an && claude # ClaudeKit tự push GitHub # Bước 2: Web App Claude Code — deploy # Nói: "deploy du an, git pull và rebuild docker" # Claude Code tự SSH vào VPS làm hết!
cd /đường-dẫn/dự-án → claude — xong, làm việc luôn.
/plan [mô tả] → đọc plan → /cook — tránh code sai hướng.
/test → /review:codebase — bắt bug + lỗi security.
Không nhớ lệnh? Cứ nói tiếng Việt — ClaudeKit chạy ngầm phía sau.
rm .claude/settings.local.json → claude — fix hầu hết lỗi khởi động.
/plan cho tính năng đầu tiên và dần dần khám phá thêm các lệnh khác. Chúc dự án thành công!