Claude Code Templates

1. Claude Code Templates là gì?

Claude Code Templates là một "kho đồ có sẵn" cho Claude Code, trợ lý lập trình bằng AI của Anthropic. Thay vì tự viết từng lời nhắc dài hay tự cấu hình từng thứ, bạn chọn trong kho những thành phần người khác đã làm sẵn và cài bằng một dòng lệnh. Kho có trang web riêng để duyệt tại https://aitmpl.com

Có sáu loại thành phần:

Loại	Là gì	Ví dụ
Agent	Một "chuyên gia" AI cho một mảng việc	Chuyên gia giao diện web, người rà soát bảo mật
Command	Lệnh tắt bắt đầu bằng dấu /	/generate-tests để sinh bài kiểm tra
MCP	Cầu nối giữa Claude Code và dịch vụ bên ngoài	GitHub, PostgreSQL, Stripe
Setting	Bộ cấu hình sẵn cho Claude Code	Thời gian chờ, chế độ chỉ đọc
Hook	Việc tự động chạy khi có sự kiện	Kiểm tra code trước khi lưu phiên bản
Skill	Khả năng dùng lại được	Xử lý PDF, tự động hóa Excel

Ngoài kho thành phần, công cụ còn kèm vài tiện ích: bảng theo dõi phiên làm việc, trình xem hội thoại trên điện thoại, và lệnh kiểm tra "sức khỏe" cấu hình Claude Code.

Nói thẳng: đây là công cụ cho người dùng Claude Code để lập trình. Nó không phải một ứng dụng độc lập. Công cụ miễn phí, giấy phép MIT; từng thành phần trong kho giữ giấy phép gốc của tác giả nó. Khoản mất tiền là tài khoản Claude Code.

Hợp với bạn nếu:

• Bạn đang dùng Claude Code và muốn nó giỏi hơn ở một mảng cụ thể mà không phải tự cấu hình.
• Bạn muốn xem người khác thiết lập Claude Code ra sao để học theo.
• Bạn muốn theo dõi các phiên Claude Code của mình qua một bảng điều khiển.

Chưa hợp nếu:

• Bạn chưa cài hoặc chưa từng dùng Claude Code.
• Bạn cần một ứng dụng chat AI thông thường.
• Bạn không muốn đụng tới cửa sổ dòng lệnh. Trang aitmpl.com giúp bạn chọn, nhưng bước cài vẫn là một dòng lệnh.

2. Cần chuẩn bị gì?

• Máy tính chạy Windows, macOS hoặc Linux, có mạng.
• Node.js. Phần mềm nền để chạy công cụ viết bằng JavaScript; cài xong bạn có lệnh npx dùng ở mục 3. Tài liệu của dự án chỗ ghi tối thiểu bản 14, chỗ ghi bản 18 (phần kiểm tra sức khỏe); cài bản LTS hiện tại là an toàn nhất. Tải tại https://nodejs.org
• Claude Code, đã cài và đăng nhập. Xem cách cài và các gói trả phí tại https://code.claude.com
• Git (tùy chọn). Công cụ quản lý phiên bản mã nguồn, tài liệu ghi là tùy chọn, dùng cho phần tích hợp quản lý phiên bản (ví dụ các hook liên quan tới Git). Tải tại https://git-scm.com
• Một thư mục dự án. Thành phần được cài vào thư mục con .claude của thư mục bạn đang đứng, nên hãy mở cửa sổ dòng lệnh ngay tại thư mục dự án code của bạn.

Một số MCP cần khóa API của dịch vụ tương ứng (ví dụ token GitHub). Khóa đó do dịch vụ kia cấp, có mất tiền hay không tùy dịch vụ.

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

Bạn không cần "cài" công cụ này lên máy. Lệnh npx tải bản mới nhất về, chạy, rồi thôi.

Bước 1: Kiểm tra Node.js

node --version

Đúng là khi máy in ra một số phiên bản, ví dụ v22.x. Nếu báo "not found" hoặc "is not recognized", cài Node.js theo link ở mục 2, đóng cửa sổ dòng lệnh và mở lại.

Bước 2: Chọn thành phần trên trang web (cách dễ nhất)

1. Mở https://aitmpl.com trên trình duyệt.
2. Duyệt theo loại (Agents, Commands, MCPs…) hoặc gõ từ khóa vào ô tìm kiếm.
3. Bấm vào một thành phần để đọc mô tả. Trang hiện sẵn dòng lệnh cài cho thành phần đó.
4. Chép dòng lệnh.

Bước 3: Chạy lệnh cài trong thư mục dự án

Mở cửa sổ dòng lệnh tại thư mục dự án, dán lệnh vừa chép rồi Enter. Ví dụ, lệnh cài một agent rà soát code:

npx claude-code-templates@latest --agent development-tools/code-reviewer --yes

Phần --yes nghĩa là bỏ qua các câu hỏi xác nhận. Lần đầu, npx có thể hỏi có tải gói về không; gõ y rồi Enter.

Đúng là khi bạn thấy thông báo thành phần đã được cài thành công, và trong thư mục dự án xuất hiện thư mục .claude/agents/ chứa một file .md mang tên agent.

Cách khác: dùng menu tương tác

Nếu chưa biết cần gì, chạy lệnh không kèm tham số:

npx claude-code-templates@latest

Một menu hiện ra. Dùng phím mũi tên để di chuyển, phím cách để đánh dấu, Enter để xác nhận. Chọn Project Setup, rồi lần lượt chọn mẫu theo ngôn ngữ, các agent, command, MCP, hook, setting bạn muốn. Cuối cùng công cụ hiện bảng tóm tắt và hỏi có tiến hành không.

Cài nhiều thứ một lần

Ghép nhiều tham số vào cùng một lệnh:

npx claude-code-templates@latest --agent development-team/frontend-developer --command testing/generate-tests --mcp development/github-integration --yes

Xem trước mà chưa cài

Thêm --dry-run để công cụ chỉ liệt kê file nào sẽ được tạo, thư mục nào sẽ thay đổi:

npx claude-code-templates@latest --agent frontend-developer --dry-run

Thành phần được đặt ở đâu

Loại	Vị trí
Agent	.claude/agents/
Command	.claude/commands/
MCP	gộp vào file .mcp.json của dự án
Setting và hook	ghi vào file settings; công cụ sẽ hỏi bạn muốn áp dụng cho mọi dự án, cho dự án này, hay chỉ riêng bạn

4. Dùng lần đầu

1. Vẫn trong thư mục dự án, gõ claude để mở Claude Code. Nếu Claude Code đang mở sẵn từ trước, thoát ra và mở lại để nó nạp thành phần mới.
2. Gọi agent vừa cài bằng lời thường:

Use the code-reviewer agent to review the changes I just made

Kết quả đúng: Claude Code giao việc cho agent đó và trả về nhận xét theo đúng chuyên môn của agent.

3. Nếu bạn cài một command, gõ dấu / trong Claude Code để xem danh sách lệnh, rồi chọn lệnh mới, ví dụ:

/generate-tests src/components/Button.tsx

4. Thử tiện ích kiểm tra sức khỏe. Thoát Claude Code rồi chạy:

npx claude-code-templates@latest --health-check

Công cụ rà hệ thống, bản cài Claude Code, cấu hình dự án, agent, MCP, command và hook, rồi chấm điểm kèm gợi ý.

Các tiện ích khác đi kèm:

Lệnh	Tác dụng
npx claude-code-templates@latest --analytics	Mở bảng theo dõi các phiên Claude Code trên trình duyệt, tại địa chỉ http://localhost:3333
npx claude-code-templates@latest --chats	Giao diện xem hội thoại, tối ưu cho màn hình điện thoại
npx claude-code-templates@latest --chats --tunnel	Như trên, có thêm đường truy cập từ xa qua Cloudflare Tunnel
npx claude-code-templates@latest --plugins	Bảng xem các plugin và marketplace đã cài

5. Lỗi thường gặp và cách sửa

Gõ npx thì máy báo không tìm thấy lệnh

• Nguyên nhân: chưa cài Node.js, hoặc cài xong chưa mở lại cửa sổ dòng lệnh.
• Cách sửa: cài Node.js từ https://nodejs.org, mở cửa sổ mới, kiểm tra bằng node --version.

Cài xong nhưng Claude Code không thấy agent hoặc lệnh mới

• Nguyên nhân: Claude Code đang mở ở thư mục khác với thư mục bạn đã cài, hoặc chưa khởi động lại.
• Cách sửa: kiểm tra thư mục dự án có thư mục .claude không. Mở Claude Code đúng tại thư mục đó. Khởi động lại Claude Code. Nếu vẫn không được, chạy npx claude-code-templates@latest --health-check.

Báo lỗi không có quyền ghi khi cài (macOS / Linux)

• Nguyên nhân: bạn đang đứng ở thư mục không có quyền ghi.
• Cách sửa: chuyển sang một thư mục của bạn, hoặc chỉ định nơi cài:

npx claude-code-templates@latest --directory ~/my-project

MCP không kết nối được

• Nguyên nhân: thiếu khóa API hoặc thông tin đăng nhập của dịch vụ bên ngoài; hoặc dịch vụ đó chưa chạy.
• Cách sửa: đọc mô tả của MCP trên aitmpl.com xem cần biến môi trường nào (ví dụ GITHUB_TOKEN), điền đúng giá trị, rồi khởi động lại Claude Code. Thay đổi MCP chỉ có hiệu lực sau khi khởi động lại.

Lưu ý: Đừng đưa file .env chứa khóa API lên GitHub hay gửi cho người khác.

Công cụ hỏi có ghi đè cấu hình không

• Nguyên nhân: setting hoặc MCP bạn cài trùng tên với cái đã có nhưng giá trị khác.
• Cách sửa: đọc kỹ câu hỏi. Nếu không chắc, chọn không ghi đè và chạy lại với --dry-run để xem thay đổi.

Bản cài toàn cục chạy phiên bản cũ

• Nguyên nhân: bạn đã cài bằng npm install -g từ trước và chưa cập nhật.
• Cách sửa: xem mục 6, hoặc dùng npx claude-code-templates@latest để luôn lấy bản mới.

6. Gỡ cài đặt / cập nhật

Cập nhật

Nếu bạn dùng npx claude-code-templates@latest như hướng dẫn trên thì không cần làm gì: phần @latest luôn lấy bản mới nhất. Bản mới nhất tại ngày viết là 1.29.6 (phát hành 17/9/2026).

Nếu bạn đã cài toàn cục:

npm update -g claude-code-templates

Gỡ công cụ

Dùng qua npx thì không có gì nằm lại để gỡ. Nếu đã cài toàn cục:

npm uninstall -g claude-code-templates

Gỡ thành phần đã cài vào dự án

Tài liệu chính thức không có lệnh gỡ riêng cho thành phần trong dự án. Mỗi agent và command là một file trong .claude/agents/ và .claude/commands/; xóa file tương ứng rồi khởi động lại Claude Code. Với MCP, xóa mục tương ứng trong file .mcp.json. Với setting và hook, xóa phần tương ứng trong file settings mà bạn đã chọn khi cài. Hãy sao lưu file trước khi sửa.

Riêng "agent toàn cục" (tạo bằng --create-agent) có lệnh gỡ riêng; thay tên agent vào cuối lệnh:

npx claude-code-templates@latest --remove-agent customer-support

7. Câu hỏi hay gặp

Có mất tiền không? Công cụ và kho thành phần miễn phí. Bạn trả tiền cho Claude Code. Một số MCP nối tới dịch vụ có tính phí riêng.

Có cần mạng không? Có. npx tải công cụ và thành phần từ mạng mỗi lần chạy, và Claude Code cũng cần mạng.

Công cụ có gửi dữ liệu gì đi không? Theo tài liệu, mỗi lần bạn cài một thành phần, công cụ gửi về máy chủ của dự án loại, tên, đường dẫn, nhóm của thành phần và phiên bản công cụ, để thống kê lượt tải. Muốn tắt, đặt biến môi trường CCT_NO_TRACKING=true trước khi chạy. Bảng --analytics chạy trên chính máy bạn tại localhost.

Thành phần trong kho có an toàn không? Kho gom từ nhiều nguồn cộng đồng. Agent và command là file văn bản, bạn mở ra đọc được. Hook và MCP thì chạy lệnh thật trên máy, nên hãy đọc nội dung trước khi cài và dùng --dry-run khi chưa chắc.

Cài vào một dự án rồi, dự án khác có dùng được không? Agent và command được cài theo từng thư mục dự án. Với setting và hook, bạn có thể chọn mức "User settings" để áp dụng cho mọi dự án.