Trải nghiệm khi dùng Crush
Bạn cài Crush bằng trình quản lý gói quen thuộc: winget trên Windows, Homebrew trên macOS, hoặc npm. Sau đó mở Terminal trong thư mục dự án và gõ crush. Một giao diện văn bản dựng đẹp mắt hiện ra ngay trong Terminal, với khung chat và danh sách phiên làm việc. README gợi ý cách nhanh nhất là chọn một mô hình của Hyper, nhà cung cấp mô hình chính thức của Charm, trong bảng chọn mô hình rồi làm theo bước đăng nhập.
Nếu bạn đã có API key của Anthropic, OpenAI, Gemini, OpenRouter hay nhà cung cấp khác, bấm ctrl+l để mở bảng chọn mô hình, chọn nhà cung cấp và dán khoá. Hoặc đặt biến môi trường như ANTHROPIC_API_KEY trước khi chạy. Crush cũng tự phát hiện mô hình chạy trên máy qua các nhà cung cấp cục bộ như Ollama hoặc LM Studio theo cấu hình trong tài liệu.
Khi làm việc, bạn mô tả việc cần làm, Crush đọc code, đề xuất và hỏi xin phép trước khi chạy công cụ. Bạn có thể đổi mô hình giữa chừng mà vẫn giữ ngữ cảnh, giữ nhiều phiên làm việc riêng cho từng dự án, và nối thêm công cụ qua MCP.
Tính năng nổi bật
Nhiều mô hình, đổi giữa chừng
Dùng nhiều nhà cung cấp hoặc API tương thích OpenAI/Anthropic, và chuyển mô hình trong phiên mà vẫn giữ ngữ cảnh.
Phiên làm việc theo dự án
Mỗi dự án có nhiều phiên và ngữ cảnh riêng, dễ quay lại việc đang làm dở.
Tăng ngữ cảnh bằng LSP
Dùng language server để hiểu code sâu hơn, giống cách một lập trình viên dùng trình soạn thảo.
Mở rộng bằng MCP
Nối thêm công cụ qua máy chủ MCP kiểu http, stdio và sse.
Chạy trên nhiều hệ điều hành
Hỗ trợ macOS, Linux, Windows (PowerShell và WSL), Android và các hệ BSD.
Hỏi quyền trước khi chạy công cụ
Mặc định Crush xin phép trước mỗi lần dùng công cụ; bạn có thể cho phép sẵn một số công cụ hoặc chặn hẳn công cụ không muốn dùng.
Tận dụng Crush vào việc gì?
Lập trình viên
Hỏi đáp và sửa code ngay trong Terminal
Mô tả lỗi hoặc tính năng, để Crush đọc dự án, đề xuất thay đổi và áp dụng sau khi bạn đồng ý.
Người muốn tiết kiệm chi phí
Dùng mô hình rẻ hoặc cục bộ
Nối Crush với Ollama, LM Studio hoặc nhà cung cấp tương thích để giảm tiền API.
Người mày mò AI
Thử nhiều mô hình trên cùng một dự án
Đổi mô hình giữa phiên để so sánh cách trả lời mà không phải bắt đầu lại.
Quản trị hệ thống, dev backend
Làm việc trên máy chủ qua SSH
Vì chạy hoàn toàn trong Terminal nên dùng được khi kết nối từ xa; README còn có thông báo qua OSC khi qua SSH.
Lập trình viên nâng cao
Gắn công cụ riêng qua MCP
Cho Crush truy cập tài liệu thư viện, cơ sở dữ liệu hoặc dịch vụ nội bộ bằng máy chủ MCP.
Cần chuẩn bị gì?
- Terminal trên Windows (PowerShell hoặc WSL), macOS, Linux hoặc hệ khác được README liệt kê.
- Một nguồn mô hình AI: API key hoặc mô hình cục bộ.
- Winget, Scoop, Homebrew, npm hoặc Go tuỳ cách cài bạn chọn.
Hướng dẫn cài đặt chi tiết
Cài trên Windows
Mở PowerShell và cài bằng winget (cách ghi trong README).
winget install charmbracelet.crushHoặc dùng Scoop nếu bạn đã có.
scoop bucket add charm https://github.com/charmbracelet/scoop-bucket.git scoop install crushHoặc cài bằng npm (cần Node.js).
npm install -g @charmland/crush
Cài trên macOS / Linux
Cài bằng Homebrew.
brew install charmbracelet/tap/crushHoặc cài bằng npm trên bất kỳ hệ nào có Node.js.
npm install -g @charmland/crushTrên Linux cũng có kho gói Debian, Ubuntu, Fedora, Arch và Nix. Xem README để lấy đúng lệnh cho bản phân phối của bạn, hoặc tải gói và file chạy ở trang Releases.
https://github.com/charmbracelet/crush/releases
Dùng thử lần đầu
Mở Terminal trong thư mục dự án và chạy Crush.
crushBấm ctrl+l để mở bảng chọn mô hình, chọn nhà cung cấp và dán API key (hoặc chọn mô hình Hyper và làm theo bước đăng nhập).
Chạy khởi tạo dự án để Crush phân tích code và tạo file ngữ cảnh (tên mặc định là AGENTS.md theo README).
Hỏi một câu cụ thể về dự án, ví dụ: giải thích cấu trúc thư mục này và chỉ ra file nào xử lý đăng nhập.
Khi Crush xin phép dùng công cụ, đọc kỹ rồi chấp nhận hoặc từ chối từng lần.
Mẹo dùng hay
- Mặc định Crush hỏi trước khi dùng công cụ; chỉ cho phép sẵn những công cụ chỉ đọc như xem file hoặc tìm kiếm.
- Cờ --yolo bỏ qua mọi bước xin phép; README cảnh báo dùng cực kỳ cẩn thận, tốt nhất chỉ trong môi trường thử.
- Dùng biến môi trường cho khoá API thay vì dán khoá vào file cấu hình đưa lên Git.
- Muốn dùng mô hình cục bộ, xem mục Local Models trong README để thêm nhà cung cấp kiểu ollama hoặc lmstudio.
Lưu ý và hạn chế
- Giấy phép là Functional Source License (FSL-1.1-MIT), không phải giấy phép mã nguồn mở thuần; hãy đọc file LICENSE nếu bạn có kế hoạch thương mại.
- Crush có thể đọc, sửa file và chạy lệnh trong dự án; hãy sao lưu hoặc dùng Git và không bật --yolo trên dữ liệu quan trọng.
- Dùng mô hình đám mây thì nội dung dự án được gửi tới nhà cung cấp và tốn phí API; Crush tự nó miễn phí.
Câu hỏi thường gặp
Crush có miễn phí không?
Phần mềm tải về dùng miễn phí. Bạn trả tiền cho nhà cung cấp mô hình nếu dùng API tính phí hoặc gói của Hyper; dùng mô hình cục bộ thì không tốn phí API.
Có chạy trên Windows không?
Có. README nói hỗ trợ PowerShell và WSL, và đưa lệnh cài bằng winget hoặc Scoop.
Crush khác gì Claude Code hay Aider?
Đều là công cụ code AI trong Terminal. Điểm nhấn của Crush là giao diện Terminal đẹp, nhiều nhà cung cấp mô hình, đổi mô hình giữa phiên và hỗ trợ MCP; chọn công cụ nào còn tuỳ thói quen của bạn.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/charmbracelet/crush.gitRepo tương tự nên xem
OpenCode
anomalyco / opencode
Trợ lý AI viết code mã nguồn mở, chạy trong Terminal hoặc app desktop, nối được nhiều nhà cung cấp mô hình
Aider
Aider-AI / aider
Lập trình cặp với AI ngay trong Terminal: AI sửa code trong dự án và tự commit Git cho bạn
goose
aaif-goose / goose
Trợ lý AI tự làm việc trên máy bạn: viết code, xử lý file, tự động hoá, có app desktop và dòng lệnh