📖 Dành cho Huỳnh Chí Tâm — Project master-color

Hướng Dẫn
Claude + ClaudeKit
Từ A đến Z

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.

📌 Phần 1

Claude Code là gì? ClaudeKit là gì?

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.

🤖 Claude Code

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.

Terminal
# Mở Terminal → vào dự án → chạy Claude Code
cd /Users/huynhchitam/master-color
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!

🧰 ClaudeKit (CK)

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.

💡
Ví dụ dễ hiểu: Claude Code = thợ xây giỏi. ClaudeKit = bộ dụng cụ chuyên nghiệp + đội ngũ 14 chuyên gia (kiến trúc sư, kỹ sư, QA tester…) hỗ trợ thợ xây.

📦 2 Kit bạn đã mua

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

🔄 Phần 2

Trước và Sau khi có ClaudeKit

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.

❌ Không có ClaudeKit

  • Nói → Claude làm luôn, hay sai hướng
  • Không có kế hoạch trước khi code
  • Quên test, quên viết docs
  • 1 "Claude biết tuốt" làm hết
  • Code lộn xộn, khó maintain
  • Không review trước khi deploy

✓ Có ClaudeKit

  • Plan trước → Code → Test → Review
  • 14 agent chuyên biệt phối hợp
  • Tự động test + cập nhật docs
  • Code có cấu trúc, dễ maintain
  • Bắt lỗi security trước deploy
  • Docs được tạo tự động
Lưu ý: Bạn vẫn nói tự nhiên được! Lệnh /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 3

Cài đặt từ đầu (1 lần duy nhất)

Phần mềm cần có trên máy Mac. Chỉ cài 1 lần cho máy.

1

Cài Node.js

Vào nodejs.org → Tải bản LTS → Cài. Kiểm tra: node --version

2

Cài GitHub CLI & Đăng nhập

Terminal
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 mgrows
3

Cài Claude Code

Terminal
npm install -g @anthropic-ai/claude-code

Cần có tài khoản Claude Pro/Max ($20-100/tháng).

4

Cài ClaudeKit CLI

Terminal
npm install -g claudekit-cli

# Kiểm tra:
ck --version
⚠️
Kiểm tra nhanh tất cả: Chạy lần lượt node -v , gh --version , claude --version , ck --version — tất cả phải hiện số version.
📂 Phần 4

Cài ClaudeKit vào dự án (1 lần / dự án)

Mỗi dự án mới cài 1 lần. Sau đó chỉ cần mở Claude Code là làm việc.

Terminal — Ví dụ với dự án master-color
# Bước 1: Vào thư mục dự án
cd /Users/huynhchitam/master-color

# 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).

✅ Checklist cho dự án mới

🔧 Phần 5

Quy trình làm việc hàng ngày

Đây là phần quan trọng nhất — workflow bạn dùng mỗi ngày.

Terminal — Mở dự án mỗi ngày
cd /Users/huynhchitam/master-color
claude
# Xong! Mở trong vài giây. Gõ lệnh hoặc nói tự nhiên.

Flow chính: Plan → Cook → Test → Review → Commit

📋 /plan
🍳 /cook
🧪 /test
🔍 /review
✅ commit

🟢 Khi muốn THÊM TÍNH NĂNG

Claude Code
# 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 Premium với Stripe

# Bước 2: Đọc plan → OK thì triển khai
/cook implement thanh toán Stripe 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"
💡
Ví dụ thực tế cho master-color:
/plan thêm khóa học Joico Color Expert
/plan fix JWT_SECRET fallback hardcoded
/plan thêm tính năng voice chat với AI colorist

🟡 Khi có BUG

Claude Code
# 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 formula cho level 10

🔵 Khi muốn HỎI VỀ CODE

Claude Code
/ask rate limiting hoạt động thế nào?
/ask giải thích flow AI formula generation
/ask file nào xử lý certificate PDF?
/scout  # Xem tổng quan cấu trúc project

💬 Hoặc CỨ NÓI TIẾNG VIỆT bình thường!

Không nhớ lệnh? Cứ nói tự nhiên — ClaudeKit chạy ngầm hỗ trợ.

Claude Code — Nói tự nhiên
"Sửa lỗi JWT_SECRET, thêm validation cho form đăng ký"

"Tạo thêm module 6 cho khóa Pravana về Vivid Colors"

"Đổi database từ SQLite sang PostgreSQL"

"Deploy bản mới lên VPS của mình"
📋 Phần 6

Bảng lệnh thường dùng

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.

🔥 Top 10 lệnh hay dùng nhất

LệnhMô tảKhi nào dùng
/planLên kế hoạch chi tiếtTrước khi code bất kỳ tính năng nào
/cookTriển khai code theo planSau khi đã có plan OK
/testChạy test tự độngSau khi code xong
/review:codebaseReview toàn bộ codeTrước khi commit/push
/fix:fastFix bug nhanhBug đơn giản, rõ nguyên nhân
/fix:hardFix bug phức tạpBug khó, cần phân tích
/debugDebug sâuKhông biết bug ở đâu
/askHỏi về projectMuốn hiểu code
/scoutXem cấu trúc projectMới vào project, muốn nắm bao quát
/docs:updateCập nhật tài liệuSau khi thay đổi lớn

📋 Tất cả lệnh Engineer Kit

NhómLệnhMô tả
📋 Planning/planLên kế hoạch 1 giải pháp
/plan:twoSo sánh 2 giải pháp
/plan:threeSo sánh 3 giải pháp
🍳 Cooking/cookCode theo plan (hỏi xác nhận)
/cook:autoCode tự động không hỏi
/cook:iterateCải tiến code hiện tại
🔧 Fixing/fix:fastFix bug nhanh
/fix:hardFix bug phức tạp
/debugDebug chi tiết
🧪 Testing/testViết + chạy test
/review:codebaseReview toàn bộ code
📄 Docs/docs:initTạo docs lần đầu (1 lần)
/docs:updateCập nhật docs
/docs:checkKiểm tra docs còn đúng không
🔀 Tiện ích/scoutKhám phá codebase
/askHỏi đáp về project
/brainstormBrainstorm ý tưởng
/kanbanXem bảng công việc
/git:cmTạo commit message chuẩn
🤖 Phần 7

14 Agent trong Engineer Kit

Mỗi agent là 1 chuyên gia. Khi bạn gõ lệnh, đúng agent tự động được kích hoạt.

📋

Planner

Lên kế hoạch trước khi code

🔬

Researcher

Nghiên cứu công nghệ, so sánh

👨‍💻

Fullstack Dev

Viết code, implement features

🧪

Tester

Viết test, kiểm tra chất lượng

🐛

Debugger

Tìm root cause, fix bug

🔍

Code Reviewer

Review security, performance

💡

Brainstormer

Brainstorm giải pháp

🎨

UI/UX Designer

Thiết kế giao diện

📄

Docs Manager

Quản lý tài liệu

📊

Project Manager

Theo dõi tiến độ

🔀

Git Manager

Commit, push, branches

📝

Journal Writer

Ghi nhật ký dự án

🔌

MCP Manager

Quản lý kết nối ngoài

🔭

Scout

Khám phá codebase

🎯 Phần 8

Ví dụ thực tế cho dự án master-color

Những tình huống bạn sẽ gặp khi làm việc với project nhuộm tóc AI.

🎯 Ví dụ 1: Fix lỗi bảo mật JWT

Claude đã phát hiện JWT_SECRET có fallback hardcoded (nguy hiểm).

Claude Code
# Lên kế hoạch fix
/plan fix JWT_SECRET fallback hardcoded - không cho phép chạy app nếu không set env variable

# Đọc plan → OK → Triển khai
/cook implement theo plan

# Test
/test

# Review
/review:codebase

🎯 Ví dụ 2: Thêm khóa học mới

Thêm khóa Joico Color Expert giống cấu trúc Pravana.

Claude Code
/plan thêm khóa học Joico Color Intensity - cấu trúc giống Pravana Color Expert, gồm 5 modules, mỗi module 2-3 lessons, có quiz cuối module

# Đọc plan → OK
/cook tạo khóa Joico theo plan

🎯 Ví dụ 3: Nâng cấp database

Chuyển từ SQLite sang PostgreSQL cho production.

Claude Code
/plan:two chuyển database từ SQLite sang PostgreSQL - so sánh: (1) dùng Supabase hosted (2) self-host trên VPS

# So sánh 2 phương án → Chọn phương án tốt nhất
/cook implement phương án 1

🎯 Ví dụ 4: Nói tự nhiên

Không cần lệnh, nói bình thường cũng OK.

Claude Code — Nói tự nhiên
"Cập nhật bảng giá Pravana ChromaSilk trong file brands.ts - thêm màu mới 11A, 11G, 11N"

"Thêm tính năng cho admin export danh sách học viên ra Excel"

"AI chatbot trả lời sai công thức cho tóc đã nhuộm level 7R, sửa lại prompt"
📢 Phần 9

Marketing Kit — 32 Agents, 119 Commands

Bộ công cụ marketing automation. Cài chung trong cùng dự án với Engineer Kit.

📦 Cài Marketing Kit

Terminal — Cùng thư mục dự án
cd /Users/huynhchitam/master-color
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

🔀 32 Agents theo Marketing Funnel

🟢 TOFU — Thu hút khách hàng

🧲

Attraction Specialist

Lead gen, content gaps, tăng traffic

🔍

SEO Specialist

Technical SEO, keyword research, rankings

🎯

Lead Qualifier

Scoring, intent detection, ưu tiên leads

🔬

Researcher

Market intel, trends, competitive analysis

🟡 MOFU — Nuôi dưỡng & Chuyển đổi

📧

Email Wizard

Email sequences, automation, drip campaigns

💼

Sales Enabler

Collateral, pitches, battlecards

🏗️

Funnel Architect

CRO, A/B testing, tối ưu funnel

✍️

Content Creator

Blogs, videos, ads, multimedia

🔄

Continuity Specialist

Retention, engagement, giữ chân khách

🔴 BOFU & Core Operations

💰

Upsell Maximizer

Revenue expansion, tăng AOV

📊

Campaign Manager

Multi-channel orchestration

✒️

Copywriter

High-converting copy, headlines

📱

Social Media Manager

Multi-platform social content

👥

Community Manager

Engagement, moderation

📈

Analytics Analyst

Data insights, reporting, KPIs

📋 Lệnh Marketing hay dùng nhất

LệnhMô tảVí dụ
/campaign createTạo campaign mới/campaign create "Ra mắt khóa Joico"
/campaign:emailEmail drip campaigns/campaign:email "welcome sequence"
/content:goodTạo landing page / content/content:good "landing page khóa Pravana"
/seo:auditAudit SEO toàn site/seo:audit
/seo:keywordsNghiên cứu keywords/seo:keywords "nhuộm tóc Pravana"
/emailEmail marketing/email "gửi OTP cho học viên"
/socialSocial media content/social "post Facebook ra mắt khóa"
/writeViết content/write "blog post về color theory"
/analyzePhân tích data/analyze "conversion rate trang đăng ký"
/dashboardMarketing dashboard/dashboard

🔌 8+ MCP Integrations

📊

GA4

Google Analytics 4 — data, reporting

📣

Google Ads

Campaign optimization, bidding

📧

SendGrid

Email delivery, automation

✉️

Resend

Modern email API

📱

Meta Ads

Facebook/Instagram advertising

🔄 11 Marketing Workflows

WorkflowFlow
CampaignÝ tưởng → Triển khai → Đo lường
ContentIdeation → Creation → Distribution → Optimization
SEOAudit → Keyword research → Optimize → Monitor
EmailBuild list → Segment → Sequence → A/B test
SocialPlan → Create → Schedule → Engage
SalesLead gen → Nurture → Close
AnalyticsSetup tracking → Analyze → Report → Action
BrandDefine brand → Guidelines → Enforce

🎯 Ví dụ thực tế cho master-color

📢 Marketing khóa học Pravana Color Expert

Claude Code — Marketing Kit
# Tạo campaign ra mắt khóa học
/campaign create "Ra mắt khóa Pravana Color Expert"

# Tạo landing page đăng ký
/content:good "landing page khóa Pravana - highlight: certificate, AI formula, thực hành"

# Viết email sequence chào mừng học viên
/campaign:email "welcome sequence 5 emails cho học viên mới đăng ký"

# SEO cho trang khóa học
/seo:keywords "học nhuộm tóc chuyên nghiệp Pravana Việt Nam"

# Social media posts
/social "10 posts Facebook/Instagram quảng bá khóa học nhuộm tóc"

# Phân tích conversion
/analyze "tỷ lệ đăng ký từ landing page"
💡
Multi-Agent tự động: Khi bạn gõ /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.
🔥 Phần 10

Xử lý lỗi thường gặp

Các lỗi bạn có thể gặp và cách fix nhanh.

❌ Permission denied (publickey) khi ck init

SSH key chưa cấu hình. Dùng HTTPS thay thế:

Fix
gh auth login
# Chọn: GitHub.com → HTTPS → Yes → Login with web browser
❌ Settings Error — settings.local.json bị lỗi

File settings bị corrupted (đặc biệt khi có nội dung markdown dài). Xóa đi:

Fix
rm /Users/huynhchitam/master-color/.claude/settings.local.json
claude  # Mở lại → file tự tạo mới
❌ "No kit access found" khi ck init

Chưa đăng nhập GitHub hoặc tài khoản không có quyền:

Fix
# 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
❌ Claude Code hỏi "Do you want to proceed?" liên tục

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ự.

❌ /docs:init chạy lâu quá (10+ phú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.

❌ Quên lệnh / không nhớ dùng lệnh nào

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.

💰 Phần 11

Chi phí & Thông tin cần biết

MụcChi phíGhi chú
Claude Max$100/thángSubscription 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 APIMiễn phíFree tier 15 req/min, cho AI multimodal

📞 Hỗ trợ

KênhLiên hệ
Mua ClaudeKitclaudekit.cc
Docsdocs.claudekit.cc
Twitter/X@goon_nguyen
Cập nhật kitck update
🎯 Tóm tắt

Chỉ cần nhớ 5 điều này

1

Mở dự án mỗi ngày

cd /đường-dẫn/dự-ánclaude — xong, làm việc luôn.

2

Plan trước, Cook sau

/plan [mô tả] → đọc plan → /cook — tránh code sai hướng.

3

Test & Review trước khi push

/test/review:codebase — bắt bug + lỗi security.

4

Nói tự nhiên cũng OK

Không nhớ lệnh? Cứ nói tiếng Việt — ClaudeKit chạy ngầm phía sau.

5

Khi có lỗi, xóa settings.local.json

rm .claude/settings.local.jsonclaude — fix hầu hết lỗi khởi động.

🎉
Chúc mừng! Bạn đã sẵn sàng sử dụng Claude + ClaudeKit. Bắt đầu với /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 master-color thành công!