Chuyển đến nội dung

charmbracelet / crush

Crush

Trợ lý code AI trong Terminal của Charm: đổi mô hình giữa chừng, nối MCP, chạy cả trên Windows

Crush là công cụ code AI chạy trong Terminal (cửa sổ gõ lệnh) do nhóm Charm, tác giả của nhiều công cụ dòng lệnh đẹp mắt, phát triển. Bạn chọn mô hình từ nhiều nhà cung cấp hoặc mô hình cục bộ, trò chuyện với nó về dự án, và nó đọc, sửa file, chạy lệnh sau khi bạn cho phép. Giấy phép là FSL-1.1-MIT (Functional Source License, sau một thời gian chuyển thành MIT), không phải MIT thuần.

  • 29.098 sao
  • 2.366 fork
  • Go
  • Cập nhật hôm nay
  • Giấy phép riêng, xem trên GitHub
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Dòng lệnh (CLI)
Chạy trên
Windows, macOS, Linux, Android
Chi phí
Miễn phí (trả phí API AI nếu dùng)

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

  1. Mở PowerShell và cài bằng winget (cách ghi trong README).

    PowerShell
    winget install charmbracelet.crush
  2. Hoặc dùng Scoop nếu bạn đã có.

    PowerShell
    scoop bucket add charm https://github.com/charmbracelet/scoop-bucket.git
    scoop install crush
  3. Hoặc cài bằng npm (cần Node.js).

    PowerShell
    npm install -g @charmland/crush

Cài trên macOS / Linux

  1. Cài bằng Homebrew.

    Terminal
    brew install charmbracelet/tap/crush
  2. Hoặc cài bằng npm trên bất kỳ hệ nào có Node.js.

    Terminal
    npm install -g @charmland/crush
  3. Trê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.

    Văn bản
    https://github.com/charmbracelet/crush/releases

Dùng thử lần đầu

  1. Mở Terminal trong thư mục dự án và chạy Crush.

    Terminal
    crush
  2. Bấ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).

  3. 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).

  4. 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.

  5. 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.

Terminal
git clone https://github.com/charmbracelet/crush.git

Repo tương tự nên xem

AI hỗ trợ lập trình227K

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

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình50,1K

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

KhóWindowsmacOSLinuxPython
AI hỗ trợ lập trình56,7K

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

VừaWindowsmacOSLinux

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: AI hỗ trợ lập trình

AI hỗ trợ lập trình325K

Matt Pocock Skills

mattpocock / skills

Bộ skill nhỏ gọn giúp trợ lý AI viết code hỏi kỹ yêu cầu, viết test trước và giữ code gọn gàng

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình318K

Superpowers

obra / superpowers

Bộ kỹ năng biến trợ lý AI thành người làm phần mềm bài bản: hỏi ý, lập kế hoạch, viết test, rồi mới code

VừaWindowsmacOSLinux
AI hỗ trợ lập trình304K

ECC (Everything Claude Code)

affaan-m / ECC

Kho agent, skill, hook và quy tắc dựng sẵn để trợ lý AI lập trình làm việc có quy trình và có kiểm tra

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình233K

Karpathy-Inspired Claude Code Guidelines

multica-ai / andrej-karpathy-skills

Một file CLAUDE.md gồm bốn nguyên tắc giúp Claude Code bớt đoán mò, bớt làm phức tạp và sửa đúng chỗ cần sửa

DễWindowsmacOSLinux
AI hỗ trợ lập trình195K

Anthropic Agent Skills

anthropics / skills

Kho skill mẫu chính thức của Anthropic: dạy Claude làm Word, Excel, PDF, PowerPoint và việc chuyên biệt

DễWindowsmacOSLinuxWeb+1
AI hỗ trợ lập trình156K

Claude Code

anthropics / claude-code

Trợ lý AI viết code của Anthropic chạy trong Terminal, đọc hiểu dự án, sửa file và xử lý Git bằng lời thường

VừaWindowsmacOSLinux

Xem cả 30 repo AI hỗ trợ lập trình Về Kho Repo