Học ClaudeKit

ClaudeKit là ba tầng, không phải một thứ

Nhầm lẫn hay gặp nhất là tưởng ClaudeKit là một phần mềm. Thực ra có ba thứ riêng biệt, tiền bạc và cách cập nhật cũng khác nhau.

Đường đi của một câu lệnh

Hiểu chuỗi này giúp bạn biết khi hỏng thì hỏng ở đâu.

Bạn gõ  /ck:cook "thêm đăng nhập"
   │
   ├─ Claude Code đọc  ~/.claude/skills/cook/SKILL.md
   │                   ← file hướng dẫn, do kit cài vào
   ├─ Hook chạy trước  session-init, dev-rules-reminder, ...
   │                   ← 11 hook, cấu hình trong .ck.json
   ├─ Claude làm việc  đọc code, sửa file, chạy test
   │
   └─ Kết quả          + báo cáo ghi vào plans/reports/

Nguyên tắc học

Đừng học thuộc 84 lệnh. 90% công việc thật nằm trong 9 quy trình ở tab 9 quy trình; phần còn lại chỉ để tra khi cần.

• Đừng hỏi "lệnh nào?", hãy hỏi "mình đang làm việc gì?" — chọn quy trình trước, lệnh tự lộ ra.
• Bạn hoàn toàn có thể chỉ mô tả việc bằng tiếng Việt. Claude tự chọn kỹ năng. Gõ lệnh chỉ để chắc chắn và tiết kiệm token.
• Thứ tự học đề nghị: tab này → Cài đặt → Cấu hình → 9 quy trình → Luật chơi. Tab tra cứu để dành lúc làm việc thật.

Cài đặt và khởi động

Ba bước. Nếu máy bạn đã chạy được ck --version thì bỏ qua bước 1.

Bước 1 — Cài CLI

npm install -g claudekit-cli
# hoặc dùng bun
bun add -g claudekit-cli

# kiểm tra
ck --version

Bước 2 — Khởi tạo trong dự án

cd ~/projects/du-an-cua-ban
ck init

Chọn Global (khuyên dùng) để dùng chung cho mọi dự án, hoặc Local nếu chỉ muốn dự án này có.

Xác thực chạy theo chuỗi, dừng ở cái đầu tiên tìm được:

Không muốn dùng API thì ck init --use-git để clone qua SSH/HTTPS bằng thông tin git sẵn có.

Bước 3 — Chạy

claude

# rồi gõ yêu cầu, ví dụ:
Dùng skill ui-ux-pro-max, làm landing page cho quán cà phê

# hoặc gọi thẳng lệnh:
/ck:cook "thêm nút đăng xuất vào header"

Bảo trì hằng ngày

Cấu hình

Hai file. .ck.json điều khiển hành vi ClaudeKit; settings.json là của Claude Code. Cấp dự án luôn thắng cấp global.

Những khoá đáng chỉnh nhất

Ví dụ: bắt Claude trả lời tiếng Việt

// ~/.claude/.ck.json
{
  "locale": {
    "thinkingLanguage": null,
    "responseLanguage": "vi"
  }
}

settings.json — của Claude Code

// ~/.claude/settings.json
{
  "$schema": "https://claudekit.cc/schemas/ck-config.schema.json",
  "statusline": "full",
  "gemini": { "model": "gemini-3-flash-preview" }
}

Mở bảng cấu hình bằng giao diện

Không thích sửa JSON tay thì có dashboard:

ck config              # mở bảng điều khiển
ck config --help       # xem các thao tác

19 lệnh ck ở terminal

Khác với /ck:* (gõ bên trong Claude Code), nhóm này gõ thẳng ở terminal. Lấy từ ck --help trên máy bạn.

Dùng nhiều nhất trong tuần

ck doctor              # có gì lạ là chạy cái này trước
ck plan status         # mọi plan đang tới đâu
ck plan kanban         # bảng kanban trong trình duyệt
ck config              # chỉnh cấu hình bằng giao diện
ck update              # nâng cấp CLI

Tuỳ chọn dùng chung

9 quy trình thực chiến

Đây là phần đáng học nhất. Mỗi quy trình gồm: các bước, cổng phải dừng xin bạn duyệt, cờ hay dùng, cái bẫy dễ dính, và một phiên mẫu để bắt chước lần đầu.

npm run dev 2>&1 | tee logs.txt

Luật chơi

Bảy thói quen phân biệt người dùng ClaudeKit hiệu quả với người gõ lệnh cầu may.

1 · Quét trước, làm sau

/ck:scout là thao tác rẻ nhất trong cả bộ. Bỏ 30 giây quét trước sẽ tránh được việc Claude sửa nhầm file hoặc viết lại thứ đã có sẵn.

2 · Đọc plan.md thật sự

Đây là cổng đắt giá nhất. Sửa một dòng trong kế hoạch tốn 10 giây; sửa cùng lỗi đó sau khi code xong tốn cả buổi. Claude sẽ hỏi bạn 3–8 câu trước khi chốt — trả lời nghiêm túc.

3 · Dùng log thật, đừng tả bằng lời

npm run dev 2>&1 | tee logs.txt
npm test 2>&1 | tee test.log
docker compose logs > docker.log

Rồi đưa @logs.txt. Một stack trace nói nhiều hơn ba đoạn văn mô tả.

4 · /clear giữa các giai đoạn

Lập kế hoạch và viết code cần hai loại context khác nhau. Gộp chung chỉ làm loãng. Kế hoạch đã nằm trong file, xoá context không mất gì.

5 · --dry-run trước khi làm thật

Áp dụng cho mọi thứ đụng tới git hoặc production. Đặc biệt là /ck:ship — nó không hỏi bạn ở từng bước.

6 · Tôn trọng privacy hook

Khi Claude cần đọc .env, hook sẽ hỏi xin phép bạn. Đừng tắt privacyBlock cho tiện — cứ duyệt từng lần, mất hai giây.

7 · Biết khi nào không cần lệnh

Việc nhỏ và rõ ràng thì cứ nói thẳng: "sửa lỗi chính tả trong README". Gọi /ck:fix cho việc đó chỉ thêm nghi thức. Lệnh có giá trị khi việc đủ lớn để cần quy trình.

Ký hiệu hay dùng

Context của phiên được tự lưu vào .claude/session-state/, nên đóng terminal không mất việc đang dở.

Tra cứu 84 kỹ năng

Gõ không dấu vẫn tìm được. Hầu hết gọi bằng /ck:tên; vài cái ngoại lệ ghi rõ trong thẻ.

Không có lệnh nào khớp. Thử từ khoá khác, hoặc gõ /ck:find-skills để Claude tự tìm.

Câu hỏi thường gặp & bẫy

Phải trả tiền những gì?

claudekit-cli miễn phí hoàn toàn, mã nguồn mở giấy phép MIT. Engineer Kit và Marketing Kit có phí — đó là nơi chứa 84 kỹ năng. Dùng CLI không mua kit vẫn được, nhưng gần như không có gì để chạy.

Tên lệnh đổi rồi

Bản cũ dùng /plan, /debug. Bản hiện tại thêm namespace: /ck:plan, /ck:debug. Tài liệu hay video cũ hơn một năm thường còn tên cũ.

Không phải kỹ năng nào cũng có tiền tố ck:

Ngoài ra tên thư mục khác tên lệnh ở vài chỗ: thư mục ck-plan nhưng lệnh là /ck:plan. Tương tự với ck-debug, ck-security, ck-code-review, ck-loop, ck-graphify, ck-predict, ck-scenario, ck-autoresearch.

Hai lệnh code-review trùng tên

/ck:code-review là kỹ năng của ClaudeKit. /code-review (không tiền tố) là lệnh sẵn có của Claude Code, có thêm chế độ ultra chạy nhiều agent trên cloud. Hai thứ khác nhau.

CCS — chuyển tài khoản, tiết kiệm tiền

Claude Code Switch cho phép đổi giữa tài khoản công việc và cá nhân, hoặc chuyển sang mô hình rẻ hơn như Gemini hay GLM. Tiết kiệm được nhiều.

Đang hỏng, sửa từ đâu?

Tài liệu web nói gì, máy bạn thật ra thế nào

Mọi chỗ hai nguồn web lệch với bản cài thật đều gom ở đây. Cách kiểm: chạy ck --help, đọc ~/.claude/.ck.json, và grep 84 file SKILL.md trong ~/.claude/skills/. Khi lệch, tin máy.

Bốn chỗ lệch

Tám khoá .ck.json tài liệu chưa nhắc

Có thật trên máy bạn nhưng không thấy trong bảng cấu hình của vividkit:

Cờ đã kiểm là có thật

Bài arealisticdreamer nêu một loạt cờ. Tôi grep lại trong SKILL.md tương ứng — tất cả đều tồn tại:

Con số 84, không phải 88

~/.claude/skills/ có 88 mục, nhưng 4 trong đó không phải kỹ năng — README.md, install.sh, _shared, common và vài file lẻ khác. Đếm theo thư mục thật sự chứa SKILL.md thì được 84. Bảng tra cứu có đủ cả 84, không thiếu cái nào.

Ba nguồn của trang này