Bỏ qua tới nội dung
Ông T.vn

SuperClaude Framework: nâng cấp Claude Code — hướng dẫn cài đặt và dùng

12 phút đọcCập nhật
SuperClaude Framework: nâng cấp Claude Code — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

SuperClaude Framework là framework cấu hình giúp Claude Code làm việc có cấu trúc hơn nhờ 30 lệnh slash, 20 agent, 7 chế độ hành vi và 8 tích hợp MCP. Cài đặt khá thẳng bằng pipx hoặc script có sẵn; MCP là phần tùy chọn.

SuperClaude Framework là framework cấu hình giúp biến Claude Code thành một nền tảng phát triển có quy trình rõ ràng hơn. Thay vì chỉ trò chuyện và nhận câu trả lời, bạn có thể dùng các lệnh slash để nghiên cứu, lập kế hoạch, viết mã, kiểm thử, quản lý công việc và triển khai.

Repo phù hợp với lập trình viên, nhóm sản phẩm, nhân viên văn phòng có việc phân tích lặp lại và người muốn dùng Claude Code theo một quy trình ổn định. Điểm đáng giá nhất là framework gom nhiều cách làm vào một bộ lệnh, agent và chế độ hành vi có sẵn. Bạn có thể bắt đầu với phần cài lệnh cơ bản, sau đó mới thêm MCP khi thật sự cần.

Framework

SuperClaude-Org/SuperClaude_Framework

Framework biến Claude Code thành nền tảng phát triển có lệnh slash, agent chuyên biệt, chế độ làm việc và tích hợp MCP.

★ 24kPythonMIT
Xem repo trên GitHub

I.SuperClaude Framework làm được gì

A.Điều phối quy trình phát triển bằng lệnh slash

Framework cung cấp 30 lệnh slash cho nhiều giai đoạn khác nhau. Bạn có thể dùng /brainstorm để mở rộng ý tưởng, /design để phân tích kiến trúc, /implement để viết mã, /test để tạo quy trình kiểm thử và /troubleshoot để tìm lỗi.

Lợi ích thực tế là bạn không phải tự nhớ một quy trình dài cho từng loại việc. Với mỗi mục tiêu, bạn chọn lệnh gần nhất rồi để Claude Code làm việc theo ngữ cảnh của dự án.

B.Hỗ trợ 20 agent chuyên biệt

SuperClaude có 20 agent chuyên biệt cho các lĩnh vực như quản lý dự án, nghiên cứu sâu, bảo mật và kiến trúc frontend. Framework có thể điều phối chuyên môn phù hợp với ngữ cảnh.

Điều này hữu ích khi một công việc cần nhiều góc nhìn. Ví dụ, một thay đổi giao diện có thể cần cả phân tích kỹ thuật, kiểm thử và đánh giá rủi ro bảo mật.

C.Bảy chế độ hành vi cho từng loại công việc

Bảy chế độ gồm Brainstorming, Business Panel, Deep Research, Orchestration, Token-Efficiency, Task Management và Introspection. Mỗi chế độ hướng Claude Code tới một cách làm khác nhau.

Bạn có thể dùng Brainstorming khi ý tưởng còn mơ hồ, Business Panel khi cần phân tích chiến lược, hoặc Token-Efficiency khi muốn tiết kiệm ngữ cảnh. Chế độ Deep Research phù hợp với các câu hỏi cần tìm hiểu nhiều bước.

D.Nghiên cứu web nhiều bước

Tính năng Deep Research hỗ trợ lập kế hoạch thích ứng, tìm kiếm nhiều vòng và đánh giá chất lượng nguồn. Hệ thống có thể mở rộng thực thể, đi sâu vào khái niệm, xem diễn tiến theo thời gian hoặc lần theo chuỗi nguyên nhân.

Theo README, nghiên cứu có thể đi qua tối đa 5 vòng tìm kiếm. Hệ thống cũng chấm điểm độ tin cậy nguồn, mức độ bao phủ và độ mạch lạc của phần tổng hợp. Đây là nền tảng tốt cho việc nghiên cứu thị trường, đọc tài liệu kỹ thuật hoặc chuẩn bị bản phân tích.

E.Kết nối tám MCP server tùy chọn

SuperClaude hỗ trợ tám MCP server gồm Tavily, Context7, Sequential-Thinking, Serena, Playwright, Magic, Morphllm-Fast-Apply và Chrome DevTools. Mỗi server phục vụ một nhóm nhu cầu như tìm kiếm web, tra tài liệu chính thức, ghi nhớ phiên làm việc, tự động hóa trình duyệt hoặc phân tích hiệu năng.

MCP không bắt buộc. README cho biết SuperClaude vẫn hoạt động đầy đủ khi không cài MCP. Khi bật các tích hợp phù hợp, dự án mô tả tốc độ có thể nhanh hơn 2-3 lần và giảm 30-50% số token sử dụng.

F.Quản lý phiên và công việc

Các lệnh /save và /load giúp lưu và khôi phục phiên. /pm, /task và /workflow hỗ trợ quản lý dự án, theo dõi nhiệm vụ và tự động hóa quy trình.

Với nhóm nhỏ, đây là cách giữ mạch làm việc khi dự án kéo dài qua nhiều buổi. Bạn cũng có thể dùng các lệnh này để chia một việc lớn thành những phần dễ kiểm tra hơn.

II.Cần chuẩn bị gì

Bạn cần có Claude Code để sử dụng framework. README mô tả SuperClaude là framework cấu hình cho Claude Code, nhưng phần tư liệu được cung cấp không ghi chi tiết cách đăng ký, cài đặt hoặc mức phí của Claude Code.

Nếu cài bằng gói Python, bạn cần Python từ 3.10 trở lên. README khuyến nghị dùng pipx cho cách cài đặt nhanh. Tư liệu không ghi phiên bản pipx cụ thể.

Nếu cài từ mã nguồn, bạn cần một môi trường có thể chạy script install.sh. README không cung cấp hướng dẫn Windows riêng cho script này. Repo cũng có pyproject.toml, setup.py, package.json và Makefile, nhưng README không yêu cầu bạn phải chạy trực tiếp các tệp đó.

Nếu muốn dùng phần MCP, bạn có thể cài thêm các server tùy chọn qua superclaude mcp. README không liệt kê API key bắt buộc cho từng server trong phần Quick Installation. Một số tích hợp bên ngoài có thể có yêu cầu riêng, vì vậy bạn nên xem tài liệu của server trước khi bật.

Repo có tệp .env.example với hai biến PYPI_API_TOKEN và TEST_PYPI_API_TOKEN. Đây là các biến liên quan tới việc đóng gói hoặc phát hành Python package trong repo. README không nói rằng người dùng bình thường phải điền chúng để chạy SuperClaude.

III.Cài đặt từng bước

  1. Chọn cách càiDùng pipx hoặc clone repo và chạy script có sẵn
  2. Cài lệnhCài toàn bộ 30 slash command của SuperClaude
  3. Thêm MCP tùy chọnXem danh sách hoặc cài các server cần thiết
  4. Kiểm traLiệt kê lệnh đã cài và chạy công cụ chẩn đoán
  5. Khởi động lạiMở lại Claude Code để dùng các lệnh mới

A.Cài bằng pipx

Đây là cách README khuyến nghị. Mở terminal trong môi trường đã có pipx, rồi chạy lệnh cài package Python:

Terminal
# Install from PyPI
pipx install superclaude

Lệnh này cài package có tên superclaude từ PyPI. Nếu terminal báo chưa nhận diện pipx, bạn cần cài và cấu hình pipx theo tài liệu của môi trường đang dùng. README không ghi lệnh cài pipx nên không nên tự đoán thêm lệnh ở đây.

B.Cài các slash command

Sau khi cài package, chạy:

Terminal
# Install commands (installs all 30 slash commands)
superclaude install

Lệnh này cài toàn bộ 30 slash command. Bạn không cần cài từng lệnh /brainstorm, /test hay /research riêng lẻ.

C.Xem và cài MCP tùy chọn

Nếu chỉ cần bộ lệnh cơ bản, bạn có thể bỏ qua bước này. Để xem các MCP server có thể cài, chạy:

Terminal
# Install MCP servers (optional, for enhanced capabilities)
superclaude mcp --list

Để mở trình cài đặt tương tác:

Terminal
superclaude mcp

Nếu đã biết muốn dùng server nào, README đưa ví dụ cài Tavily và Context7:

Terminal
superclaude mcp --servers tavily --servers context7

Tavily phù hợp với tìm kiếm web cho Deep Research. Context7 phục vụ tra cứu tài liệu chính thức. Các server khác có mục đích riêng như ghi nhớ phiên, tự động hóa trình duyệt, tạo giao diện hoặc phân tích hiệu năng.

MCP là phần tùy chọn. Hãy kiểm tra quyền truy cập, API key và chi phí riêng của từng dịch vụ trước khi bật. Không đưa token bí mật vào đoạn hội thoại hoặc kho mã nguồn.

D.Cài trực tiếp từ Git

README cũng cung cấp cách clone repo rồi chạy script cài đặt. Bạn có thể mở terminal tại thư mục muốn lưu mã nguồn và chạy:

Terminal
# Clone the repository
git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
cd SuperClaude_Framework

# Run the installation script
./install.sh

git clone tải mã nguồn về máy. cd SuperClaude_Framework chuyển terminal vào đúng thư mục. ./install.sh chạy script cài đặt có sẵn trong repo.

Cách này cần môi trường có thể chạy script shell. Tư liệu không đưa lệnh tương đương cho PowerShell hoặc Windows Command Prompt. Nếu bạn dùng Windows và không có môi trường chạy install.sh, hãy xem hướng dẫn cài đặt trong repo trước khi tự chuyển đổi lệnh.

E.Không dùng cách cài TypeScript đang được phát triển

README nói hệ thống plugin TypeScript chưa sẵn sàng. Các lệnh sau chỉ là tính năng dự kiến, không phải cách cài hiện tại:

Terminal
# This feature is not yet available
/plugin marketplace add SuperClaude-Org/superclaude-plugin-marketplace
/plugin install superclaude

Bạn không nên dùng chúng để thay thế cho cách cài bằng pipx hoặc script. README cũng không đưa thời điểm phát hành cụ thể cho hệ thống plugin này.

F.Khởi động lại Claude Code

Sau khi cài xong, hãy khởi động lại Claude Code. README nói các lệnh mới, gồm /sc:research, /sc:brainstorm, /sc:implement, /sc:test, /sc:pm và /sc, sẽ sẵn sàng sau khi khởi động lại.

IV.Kiểm tra đã chạy được chưa

Trước hết, kiểm tra danh sách lệnh đã cài:

Terminal
# Verify installation
superclaude install --list

Nếu lệnh hiển thị danh sách slash command, phần cài lệnh đã được nhận diện. README mô tả tổng cộng có 30 lệnh.

Tiếp theo, chạy công cụ chẩn đoán:

Terminal
superclaude doctor

Đây là cách kiểm tra được README cung cấp để xác minh môi trường. Nếu có lỗi, hãy đọc thông báo cụ thể trong terminal và xem phần tài liệu xử lý sự cố trong repo.

Sau khi khởi động lại Claude Code, nhập:

text
/sc

Kết quả mong đợi là danh sách các lệnh SuperClaude. Bạn cũng có thể thử một lệnh cụ thể như /sc:brainstorm hoặc /sc:implement trong một dự án phù hợp.

V.Dùng vào việc thật

A.Chủ shop muốn lập kế hoạch cải thiện cửa hàng trực tuyến

Một chủ shop có dữ liệu bán hàng, phản hồi khách hàng và vài ý tưởng chưa rõ ràng. Có thể mở Claude Code trong thư mục dự án, sau đó dùng lệnh brainstorming để phân loại vấn đề và đề xuất hướng đi:

text
/sc:brainstorm
Tôi muốn tăng tỷ lệ khách quay lại cho cửa hàng trực tuyến. Hãy giúp tôi phân tích vấn đề, đặt các câu hỏi cần thiết và đề xuất những hướng thử nghiệm có thể đo lường.

Kết quả mong đợi là một phiên động não có cấu trúc. Bạn có thể tiếp tục dùng /sc:business-panel để xem vấn đề từ nhiều góc độ kinh doanh, nhưng README chỉ mô tả đây là lệnh phân tích kinh doanh, không cam kết một mẫu đầu ra cố định.

B.Nhân viên văn phòng cần nghiên cứu một chủ đề

Một nhân viên cần chuẩn bị bản tổng hợp về một công nghệ hoặc xu hướng mới. Khi đã cài MCP phù hợp, có thể dùng Deep Research:

text
/research "market analysis"

Hoặc dùng câu hỏi cụ thể hơn:

text
/research "React patterns"

README cho biết hệ thống có thể dùng chiến lược lập kế hoạch, tìm kiếm nhiều vòng, lọc theo miền và đánh giá chất lượng nguồn. Nếu cần lọc miền, README đưa ví dụ reactjs.org,github.com. Kết quả phù hợp để làm bản nháp nghiên cứu, nhưng bạn vẫn nên tự kiểm tra nguồn trước khi đưa vào tài liệu chính thức.

Hãy để Claude Code đi theo quy trình phù hợp với công việc, thay vì bắt đầu mọi việc từ một câu lệnh trống.

Ông T

C.Lập trình viên mới muốn xây một tính năng

Một lập trình viên mới có thể dùng chuỗi lệnh từ thiết kế đến kiểm thử. Bắt đầu bằng yêu cầu rõ ràng:

text
/sc:design
Tôi cần thêm chức năng đăng ký tài khoản cho ứng dụng hiện tại. Hãy phân tích cấu trúc dự án và đề xuất thiết kế phù hợp.

Sau khi xem xét thiết kế, chuyển sang triển khai:

text
/sc:implement
Hãy triển khai chức năng đăng ký tài khoản theo thiết kế vừa thống nhất. Trước khi sửa, hãy nêu các tệp sẽ thay đổi.

Cuối cùng, yêu cầu tạo hoặc chạy quy trình kiểm thử:

text
/sc:test
Hãy đề xuất và thực hiện các kiểm thử cho chức năng đăng ký tài khoản, gồm trường hợp thành công và dữ liệu không hợp lệ.

Các lệnh tương ứng với khả năng được README mô tả: thiết kế hệ thống, triển khai mã và quy trình kiểm thử. Người mới nên yêu cầu Claude Code giải thích thay đổi trước khi chấp nhận chúng.

D.Nhóm phát triển cần tìm và ghi lại lỗi

Khi dự án có lỗi khó tái hiện, bạn có thể dùng lệnh xử lý sự cố và phân tích:

text
/sc:troubleshoot
Ứng dụng thỉnh thoảng trả về lỗi khi người dùng gửi biểu mẫu. Hãy phân tích mã nguồn, nêu giả thuyết nguyên nhân và đề xuất cách kiểm tra.

Sau khi sửa, dùng /sc:reflect để tổng kết bài học hoặc /sc:document để cập nhật tài liệu. Nếu cần giữ tiến độ qua nhiều phiên, /sc:save và /sc:load hỗ trợ lưu và khôi phục phiên theo mô tả trong README.

VI.Lỗi hay gặp và cách xử lý

A.Terminal không nhận diện pipx

Nguyên nhân thường là pipx chưa được cài hoặc đường dẫn thực thi chưa nằm trong PATH. README chỉ khuyến nghị pipx nhưng không ghi lệnh cài pipx. Hãy cài pipx theo tài liệu của hệ điều hành rồi mở lại terminal trước khi chạy pipx install superclaude.

B.Cài xong nhưng không thấy lệnh slash

Bạn có thể mới cài package mà chưa chạy superclaude install, hoặc Claude Code chưa được khởi động lại. Hãy chạy lại:

Terminal
superclaude install
superclaude install --list

Sau đó khởi động lại Claude Code và thử /sc.

C.Script ./install.sh không chạy trên Windows

README chỉ đưa lệnh shell này và không cung cấp hướng dẫn PowerShell riêng. Không nên tự đổi tên hoặc đoán tham số của script. Hãy dùng cách pipx nếu môi trường của bạn hỗ trợ, hoặc xem tài liệu cài đặt trong repo để biết lựa chọn phù hợp với Windows.

D.MCP không hoạt động hoặc nghiên cứu không có kết quả như mong muốn

MCP là phần tùy chọn và mỗi server có thể cần cấu hình riêng. Hãy chạy superclaude mcp --list, kiểm tra đúng tên server, xem tài liệu của dịch vụ đó và xác nhận các quyền hoặc API key cần thiết. Bạn vẫn có thể dùng SuperClaude không có MCP với hiệu năng tiêu chuẩn.

E.Dùng nhầm lệnh plugin TypeScript

Các lệnh /plugin marketplace add và /plugin install trong README chỉ dành cho hệ thống dự kiến, chưa khả dụng. Hãy quay lại cách pipx hoặc script install.sh của phiên bản hiện tại.

VII.Có nên dùng không

SuperClaude đáng thử nếu bạn đã dùng Claude Code và muốn một bộ quy trình có sẵn cho nghiên cứu, lập kế hoạch, viết mã, kiểm thử và quản lý dự án. Framework có nhiều thành phần: 30 lệnh, 20 agent, 7 chế độ và 8 MCP server. Repo dùng giấy phép MIT, có tài liệu, kiểm thử và vẫn được cập nhật.

Điểm mạnh là phạm vi sử dụng rộng, có lệnh rõ ràng và có thể mở rộng bằng MCP. Phần cài đặt cơ bản không quá phức tạp nếu bạn dùng pipx. Bạn cũng có thể bắt đầu không cần MCP rồi bổ sung từng server khi có nhu cầu.

Giới hạn là SuperClaude phụ thuộc vào Claude Code. README không giải thích đầy đủ yêu cầu tài khoản, chi phí Claude Code, cấu hình Windows hoặc yêu cầu riêng của từng MCP server. Các tính năng nghiên cứu web cũng phụ thuộc vào tích hợp bên ngoài nếu bạn muốn có tìm kiếm và trích xuất nâng cao.

Nếu bạn chỉ cần gọi mô hình để hỏi đáp đơn giản, framework này có thể nhiều hơn nhu cầu. Nếu bạn muốn quy trình phát triển lặp lại, nhiều vai trò chuyên môn và khả năng điều phối công cụ, SuperClaude là một lựa chọn đáng cân nhắc. Hãy bắt đầu bằng các slash command cơ bản, kiểm tra /sc, rồi chỉ bật MCP khi lợi ích thực tế đủ rõ.

4.3/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

SuperClaude Framework có miễn phí không?

Repo dùng giấy phép MIT. Tuy nhiên, README không xác nhận toàn bộ dịch vụ liên quan như Claude Code hoặc các MCP server đều miễn phí; một số dịch vụ có thể có chi phí riêng.

Có cần GPU để chạy SuperClaude không?

Tư liệu được cung cấp không nói SuperClaude yêu cầu GPU. README chỉ mô tả đây là framework cấu hình cho Claude Code và không nêu yêu cầu phần cứng cụ thể.

Có chạy được trên Windows không?

README không cung cấp hướng dẫn Windows riêng. Cách `./install.sh` cần môi trường chạy script shell; bạn nên dùng pipx nếu môi trường hỗ trợ hoặc xem tài liệu trong repo.

Có bắt buộc cài MCP server không?

Không. README nói SuperClaude vẫn hoạt động đầy đủ với hiệu năng tiêu chuẩn khi không có MCP. MCP chỉ dùng để tăng khả năng và hiệu năng cho các nhu cầu như tìm kiếm web, tra tài liệu hoặc tự động hóa.

Cần phiên bản Python và Node nào?

Package Python yêu cầu Python từ 3.10 trở lên. `package.json` yêu cầu Node từ 16 trở lên, nhưng README hướng dẫn cài hiện tại chủ yếu bằng pipx và script shell.

Dữ liệu và API key có an toàn không?

README không đưa cam kết bảo mật dữ liệu cụ thể. Repo có tệp `.env.example` với `PYPI_API_TOKEN` và `TEST_PYPI_API_TOKEN`, nhưng không nói người dùng bình thường phải điền các biến này; bạn không nên đưa token thật vào hội thoại hoặc kho mã nguồn.

Hệ thống plugin TypeScript đã dùng được chưa?

Chưa. README nói plugin TypeScript đang được phát triển và các lệnh cài plugin hiện chỉ là tính năng dự kiến; cách cài hiện tại là pipx hoặc chạy `install.sh`.

Chuyển nhanh tới mục

  1. I.SuperClaude Framework làm được gì
    1. A.Điều phối quy trình phát triển bằng lệnh slash
    2. B.Hỗ trợ 20 agent chuyên biệt
    3. C.Bảy chế độ hành vi cho từng loại công việc
    4. D.Nghiên cứu web nhiều bước
    5. E.Kết nối tám MCP server tùy chọn
    6. F.Quản lý phiên và công việc
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Cài bằng pipx
    2. B.Cài các slash command
    3. C.Xem và cài MCP tùy chọn
    4. D.Cài trực tiếp từ Git
    5. E.Không dùng cách cài TypeScript đang được phát triển
    6. F.Khởi động lại Claude Code
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop muốn lập kế hoạch cải thiện cửa hàng trực tuyến
    2. B.Nhân viên văn phòng cần nghiên cứu một chủ đề
    3. C.Lập trình viên mới muốn xây một tính năng
    4. D.Nhóm phát triển cần tìm và ghi lại lỗi
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Terminal không nhận diện pipx
    2. B.Cài xong nhưng không thấy lệnh slash
    3. C.Script ./install.sh không chạy trên Windows
    4. D.MCP không hoạt động hoặc nghiên cứu không có kết quả như mong muốn
    5. E.Dùng nhầm lệnh plugin TypeScript
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.