TÀI LIỆU HƯỚNG DẪN · CLAUDE CODE · PLUGIN

Hướng dẫn cài và dùng Ponytail: để AI viết ít code mà vẫn đủ

Ponytail là plugin miễn phí khiến AI agent như Claude Code chọn cách đơn giản nhất: dùng cái có sẵn trước, viết ít code hơn, không bỏ bảo mật.

Cập nhật: 08/10/2026 · Thời gian đọc: ~ 11 phút · Chưa kiểm chứng thực tế

1. Giới thiệu

Bạn nhờ AI làm một ô chọn ngày. Nó cài thêm thư viện, viết một component bọc ngoài, thêm file CSS, rồi bàn luôn chuyện múi giờ. Ponytail sinh ra để chặn đúng thói quen đó.

Ponytail thực chất là một prompt (file skills/ponytail/SKILL.md). Nó bắt AI agent cư xử như một lập trình viên lão làng "lười" nhất phòng: trước khi viết code phải tự hỏi việc này có cần không, dự án đã có sẵn chưa, thư viện chuẩn hay trình duyệt làm được không. Phần còn lại của repo chỉ để nạp prompt đó vào các agent khác nhau — README ghi chạy được với 20 agent như Claude Code, Codex, Cursor, Copilot, Gemini CLI.

Bài này dành cho bạn nếu đang dùng AI để làm web/app và thấy code AI viết ra dài, khó đọc, kéo theo nhiều thư viện thừa. Lưu ý: Ponytail không phải app chạy riêng — nó gắn vào AI agent bạn đang dùng. Bài hướng dẫn theo Claude Code trên Windows.

Bạn sẽ học được gì?

Ponytail là gì và vì sao AI hay "viết thừa" code.
Cài Node.js, Claude Code và plugin Ponytail trên Windows.
Đổi mức độ lite / full / ultra và các lệnh /ponytail-review, /ponytail-audit.
Cách nhận ra bản giả mạo và gỡ cài đặt sạch sẽ.

2. Tải mã nguồn

Với Claude Code bạn không cần tải tay — plugin tự lấy từ GitHub ở mục 4. Chỉ tải về khi muốn đọc prompt, hoặc dùng file AGENTS.md cho agent khác.

Mở trang repo: github.com/DietrichGebert/ponytail
Bấm nút Code → Download ZIP, rồi giải nén.
Hoặc nếu máy có Git, mở PowerShell và chạy lệnh bên dưới.

Tải bằng Git (PowerShell / Terminal)

git clone https://github.com/DietrichGebert/ponytail

Repo: DietrichGebert/ponytail

skills/ — 6 skill; prompt chính nằm ở skills/ponytail/SKILL.md
hooks/ — Script Node.js chạy khi mở phiên, gửi prompt, tạo agent con
commands/ — Định nghĩa các lệnh /ponytail-*
examples/ — Ví dụ có và không có Ponytail (output thật)
benchmarks/ — Bộ đo và kết quả benchmark
docs/ — Tài liệu thêm (Cursor hooks, chuyển sang agent khác)
i18n/ — README tiếng Tây Ban Nha, Hàn, Trung, Nhật
.claude-plugin/ — Khai báo plugin cho Claude Code
AGENTS.md — Bản rút gọn của prompt cho agent đọc file luật
INSTALL.md — Hướng dẫn cài cho từng agent
README.md
LICENSE — Giấy phép MIT

3. Chuẩn bị & cài đặt môi trường

Bạn cần 2 thứ: một AI agent (ở đây là Claude Code) và Node.js — vì plugin chạy vài script nhỏ bằng node mỗi khi mở phiên.

Windows 10/11 (Mac, Linux cũng được).
Node.js bản LTS — tải ở nodejs.org. Lệnh node phải chạy được trong terminal.
Claude Code + tài khoản Claude. Ponytail miễn phí, nhưng Claude Code dùng tài khoản/gói của bạn.
Git for Windows (khuyến nghị theo tài liệu Claude Code; không bắt buộc với Ponytail).

Kiểm tra Node.js đã cài chưa (PowerShell)

node --version

Cài Claude Code — Windows (PowerShell)

irm https://claude.ai/install.ps1 | iex

Cài Claude Code — Mac / Linux

curl -fsSL https://claude.ai/install.sh | bash

4. Cài Ponytail & chạy

Ponytail không cần API key hay file .env. Cài trong Claude Code bằng 2 tin nhắn riêng biệt.

Mở PowerShell trong thư mục dự án của bạn và gõ claude.
Gửi tin nhắn thứ nhất để thêm "chợ plugin" của Ponytail.
Gửi tin nhắn thứ hai (riêng, không gộp chung) để cài plugin.
Mở phiên mới. Dòng khởi động sẽ báo Ponytail đang bật ở mức nào.

Mở Claude Code (PowerShell)

claude

Tin nhắn 1 trong Claude Code

/plugin marketplace add DietrichGebert/ponytail

Tin nhắn 2 trong Claude Code

/plugin install ponytail@ponytail

Dùng app Claude Code Desktop? Gõ y hệt 2 lệnh trên vào ô chat ở tab Code, hoặc bấm nút + cạnh ô chat → Plugins → Add plugin.

Sau khi cài, Ponytail bật ở mọi phiên, mặc định mức full. Đổi mức bằng lệnh:

/ponytail lite — vẫn làm đúng yêu cầu, chỉ gợi ý thêm một cách lười hơn để bạn chọn.
/ponytail full — mặc định: áp dụng đủ "thang 7 bậc", ưu tiên cái có sẵn.
/ponytail ultra — cực đoan: ưu tiên xoá hơn thêm, chất vấn luôn cả yêu cầu.
/ponytail off — tắt.

Muốn mọi phiên mới bắt đầu ở mức khác, đặt biến môi trường PONYTAIL_DEFAULT_MODE, hoặc tạo file %APPDATA%\ponytail\config.json có nội dung {"defaultMode": "lite"}.

Đặt mức mặc định là lite (lệnh cho Windows — README gốc chỉ nêu tên biến môi trường)

setx PONYTAIL_DEFAULT_MODE lite
# Đóng PowerShell, mở cửa sổ mới rồi chạy lại claude

5. Ví dụ sử dụng

Tình huống 1 — Form đăng ký cần ô chọn ngày sinh. Bạn gõ bình thường, ví dụ: "Thêm ô chọn ngày sinh vào form đăng ký". Theo ví dụ trong README, thay vì cài thư viện chọn ngày, Ponytail dùng luôn ô có sẵn của trình duyệt:

Kết quả mẫu trong README

<!-- ponytail: browser has one -->
<input type="date">

Tình huống 2 — Rà code AI vừa viết trước khi lưu. Gõ /ponytail-review. Nó soát phần thay đổi hiện tại và trả về danh sách những chỗ nên xoá vì làm quá tay. Có thể nói rõ phạm vi: uncommitted, staged, branch hoặc dán link Pull Request.

Trong Claude Code

/ponytail-review uncommitted

Tình huống 3 — Dự án cũ ngày càng phình to. /ponytail-audit soát cả repo chứ không chỉ phần vừa sửa. /ponytail-debt gom các chỗ AI đánh dấu ponytail: (làm tạm, để sau) thành một danh sách, để "để sau" không thành "không bao giờ".

Thư mục examples/ của repo có output thật của Claude Haiku 4.5, cùng đề bài, có và không có Ponytail:

Kiểm tra email: 75 → 3 dòng.
Debounce: 116 → 10 dòng.
Đồng hồ đếm ngược React: 267 → 9 dòng.

6. Mở rộng & tuỳ chỉnh

Dùng với agent khác: Codex, Copilot CLI, Gemini CLI, OpenCode… mỗi agent có lệnh riêng trong INSTALL.md. Với Cursor, Windsurf, Cline, Copilot Chat: chép file AGENTS.md hoặc file rule tương ứng vào dự án.
Ghép với Caveman: README gợi ý dùng chung — Caveman làm AI *nói* ngắn gọn, Ponytail làm AI *viết code* ít đi.
Không áp cho agent con chỉ đọc: đặt biến PONYTAIL_SUBAGENT_MATCHER (biểu thức chính quy theo loại agent), ví dụ ^general$.
Xem bảng điểm: /ponytail-gain hiện số liệu benchmark; /ponytail-help liệt kê các lệnh.

7. Lưu ý quan trọng

README ghi Ponytail giúp ít hơn ~54% code, rẻ hơn ~20%, nhanh hơn ~27%. Đây là số tác giả tự đo: Claude Code chạy Haiku 4.5 trên một repo FastAPI + React, 12 tác vụ, mỗi tác vụ 4 lần. Tác giả cũng nói rõ giới hạn: mới đo một model, và với model suy luận như GPT-5.5 chi phí có thể còn tăng.

Biểu đồ so sánh số dòng code, token, chi phí và thời gian khi có và không có Ponytail — Kết quả do tác giả tự đo: Claude Code + Haiku 4.5, 12 tác vụ, mỗi tác vụ chạy 4 lần. Ảnh: DietrichGebert/ponytail trên GitHub (assets/benchmark-agentic.svg)

Giấy phép MIT, plugin miễn phí. Chi phí nằm ở AI agent bạn dùng.
Ponytail cam kết không cắt kiểm tra dữ liệu đầu vào, xử lý lỗi, bảo mật, khả năng truy cập — nhưng bạn vẫn nên đọc lại code trước khi đưa lên thật.
Plugin chỉ đọc/ghi vài file trạng thái trong thư mục .claude của bạn; mình không thấy đoạn nào gửi dữ liệu ra mạng trong các script hook (đọc mã nguồn ngày 2026-10-08).
Muốn gỡ sạch: chạy node scripts/uninstall.js từ thư mục đã tải repo trước, rồi mới /plugin remove ponytail trong Claude Code.

Gỡ cài đặt (chạy trong thư mục repo đã tải)

node scripts/uninstall.js

Sau đó, trong Claude Code

/plugin remove ponytail

Lỗi thường gặp & cách sửa

UserPromptSubmit hook error — node: command not found: Máy chưa có Node.js hoặc node không nằm trong PATH. Cài Node.js LTS, mở terminal mới kiểm tra node --version, rồi mở lại Claude Code (issue #708). Trên Windows câu báo lỗi có thể khác một chút.
Claude Code bị treo hoặc chậm vài giây mỗi lần gửi prompt (Windows): Lỗi hook trên Windows đã được sửa ở các bản gần đây (#443, #790). Hãy dùng bản mới nhất: gỡ bằng /plugin remove ponytail rồi cài lại 2 lệnh ở mục 4. Vẫn bị thì mở issue mới trên repo.
Chữ [PONYTAIL] trên thanh trạng thái biến mất sau khi cập nhật: statusLine trong ~/.claude/settings.json đang trỏ vào thư mục của phiên bản cũ đã bị xoá (issue #1032). Sửa đường dẫn trỏ về file ponytail-statusline.ps1 nằm thẳng trong thư mục .claude của bạn.
Failed to set model: Unexpected token … is not valid JSON: File settings.json (hoặc config.json) bị lưu kèm ký tự BOM — hay gặp khi sửa bằng Notepad hoặc PowerShell cũ. Mở bằng VS Code, chọn mã hoá UTF-8 (không BOM) rồi lưu lại (#443, #375).
Microsoft Defender báo Trojan:Win64/DLLHijack sau khi cài "ponytail": Bạn có thể đã cài bản giả mạo (ponytail-improved, issue #735). Gỡ plugin đó ngay, quét lại máy, và chỉ cài từ DietrichGebert/ponytail.

Lời khuyên

Cứ để mức full mặc định và thử trên một dự án nhỏ trước. Tập thói quen gõ /ponytail-review trước khi lưu code. Thấy AI cắt tay quá thì chuyển sang /ponytail lite.

Tags: #Ponytail #Claude Code #AI Agent #Plugin #GitHub #Lập trình với AI

← Danh sách tài liệu RootCoder