如果你熟悉 Go 生態系,一定聽過 charmbracelet——他們是 bubbletea、lipgloss、glow 等知名終端機 UI 函式庫的作者,在 GitHub 上累積了超過 200,000 顆 star。2025 年底,charmbracelet 推出了 crush:一個為終端機設計、原生支援 agentic coding loop 的 AI CLI 工具。
crush 的誕生背景很清楚:2025-2026 年 AI Coding 工具市場爆炸,但主流選項(Claude Code、GitHub Copilot、Cursor)大多深度綁定 IDE,或需要透過 GUI 操作。charmbracelet 的工程師天生就在終端機生活,他們想要一個「在 tmux 裡跑、不需要滑鼠、能做完整 agentic loop」的工具。crush 就是這個答案。
到 2026 年 8 月底,crush 已累積超過 27,700 顆 GitHub star,在 agentic-ai topic 下排名前五,並受到 HackerNews 社群(367 分,2025 年 7 月)的高度關注。在英文社群有大量討論的情況下,繁中教學至今幾乎是零——這就是本文的切入點。
crush 的設計哲學可以用三個詞概括:終端機原生、agentic、多模型。以下是每個面向的具體說明:
crush 不只是一個「問問題、看回答」的 chat CLI。它實作了完整的 agentic loop:接收任務 → 規劃步驟 → 呼叫工具(讀/寫檔案、執行指令、搜尋) → 觀察結果 → 重新規劃 → 直到任務完成。這個模式和 Claude Code 的核心架構相同,但 crush 是在終端機環境中以更輕量的方式實現。
典型的 agentic loop 場景:你給 crush 一個 issue 描述,它會自動讀取相關檔案、撰寫修改程式碼、執行測試、根據測試結果修正,最終提交 patch——全部在終端機中完成,不需要切換視窗。
crush 內建了一組完整的工具集,讓 AI 模型能真正「動手」:
read_file、write_file、create_file、delete_file、list_dirrun_command(可執行任意 shell 指令,含測試、build、git)search_files(ripgrep 整合)、web_search(可選)git_diff、git_log、git_commit這些工具讓 crush 能完成真實的開發任務,而不只是生成程式碼片段。
crush 支援透過環境變數切換不同 AI 後端,這是它相較於 Claude Code(鎖定 Anthropic)最靈活的地方:
這是 crush 與其他 agentic CLI(如 Codex CLI、aider)最大的視覺差距。charmbracelet 用 bubbletea + lipgloss 打造了一個真正好看的終端機介面:彩色語法高亮、進度指示器、可捲動的工具呼叫歷史、清晰的 diff 顯示。在終端機裡工作 8 小時,視覺舒適度不是小事。
macOS(推薦用 Homebrew):
brew install charmbracelet/tap/crush
Linux(直接下載 binary):
curl -sSL https://github.com/charmbracelet/crush/releases/latest/download/crush_linux_amd64.tar.gz | tar xz sudo mv crush /usr/local/bin/
Go 用戶(從原始碼編譯):
go install github.com/charmbracelet/crush@latest
Windows(PowerShell + Scoop):
scoop bucket add charm https://github.com/charmbracelet/scoop-bucket.git scoop install crush
在 ~/.bashrc(或 ~/.zshrc)新增你要使用的模型 API key。以 Claude 為例:
export ANTHROPIC_API_KEY="sk-ant-..." # OpenAI 用戶 export OPENAI_API_KEY="sk-..." # Google Gemini 用戶 export GOOGLE_API_KEY="AIza..."
設定完成後執行 source ~/.zshrc 讓環境變數生效。
crush init
這會在 ~/.config/crush/config.yaml 建立設定檔。預設模型為 claude-sonnet-5,可根據需求修改:
# ~/.config/crush/config.yaml model: claude-sonnet-5 # 預設模型 max_tokens: 8192 # 單次最大回應 token context_window: 200000 # 上下文視窗(依模型而定) tool_timeout: 30 # 工具執行超時(秒) auto_approve_tools: false # 每次工具呼叫是否需要確認
cd ~/my-project crush
crush 會自動讀取當前目錄的 CRUSH.md(類似 Claude Code 的 CLAUDE.md)作為專案說明。如果沒有,可以先執行 crush init-project 生成一個基本範本。
# 在 crush TUI 輸入框中輸入: /summarize # crush 會自動掃描目錄、讀取關鍵檔案,輸出 codebase 摘要
這一步很重要——讓 crush 建立對你專案的上下文理解,後續任務的準確率會大幅提升。
auto_approve_tools: false,每次工具呼叫(寫檔、執行指令)都需要你按 Y 確認。這是安全設計。在你熟悉 crush 行為之前,建議保持這個設定——別在生產環境設成 true。
2026 年 agentic coding CLI 市場競爭激烈,以下是主要選項的完整比較:
| 工具 | 開源授權 | 語言 | 模型綁定 | TUI 品質 | 工具呼叫 | 月費 |
|---|---|---|---|---|---|---|
| crush(charmbracelet) | MIT | Go | 多模型 ✅ | ⭐⭐⭐⭐⭐ | 完整 | 免費(API 費另計) |
| Claude Code(Anthropic) | 部分開源 | TypeScript | Anthropic 限定 | ⭐⭐⭐⭐ | 完整 | 免費(API 費另計) |
| Codex CLI(OpenAI) | MIT | TypeScript | OpenAI 限定 | ⭐⭐⭐ | 完整 | 免費(API 費另計) |
| Gemini CLI(Google) | Apache 2.0 | TypeScript | Google 限定 | ⭐⭐⭐ | 完整 | 免費(API 費另計) |
| OpenCode | MIT | Go | 多模型 ✅ | ⭐⭐⭐⭐ | 完整 | 免費(API 費另計) |
| aider | Apache 2.0 | Python | 多模型 ✅ | ⭐⭐ | 有限 | 免費(API 費另計) |
| Cursor | 閉源 | TypeScript | 多模型 | GUI | 完整 | $20/月起 |
crush 在「多模型支援 + TUI 品質 + 完全開源」三個維度的組合上目前無競爭對手。OpenCode 是最接近的競品(同樣 Go 語言、多模型),但 charmbracelet 在 TUI 美學上有明顯的積累優勢。
和 Claude Code 相比,crush 最大的優勢是不鎖定 Anthropic——如果你想在 Claude 費用太貴時切到 DeepSeek V4 Pro 或本機 Ollama,一個設定即可完成,不需要換工具。這對需要控制成本的開發者來說是關鍵差異。
你剛 push 了一個 feature branch,想在發 PR 前先讓 AI 做一輪 review。
cd my-project crush # 在 crush 輸入: 請 review 目前 git diff 中的所有修改,重點關注: 1. 潛在的 null pointer / undefined behavior 2. 未處理的錯誤 3. 效能問題(N+1 queries 等) 4. 安全漏洞(SQL injection、XSS) 輸出格式:按嚴重程度排列,每個問題說明位置和修復建議。
crush 會自動執行 git diff、讀取相關檔案,輸出結構化的 review 報告。這個流程用 Claude Haiku 3.5 跑一次約 $0.01-0.05,一個月跑 100 次也不到 $5。
你有一個 bug report,想讓 crush 自動定位問題並提出修復方案:
# 在 crush 中輸入: Issue #234:使用者在切換語言後,購物車數量顯示不正確。 請: 1. 找出負責語言切換的相關程式碼 2. 找出購物車狀態管理的相關程式碼 3. 找出可能的問題點 4. 提出修復方案並說明原因 5. 如果你有信心,可以直接修改程式碼
crush 的 agentic loop 會自動搜尋相關檔案(ripgrep 整合),讀取程式碼,分析問題,必要時執行測試確認 fix。整個過程你只需要在旁確認每個工具呼叫是否合理。
這是 crush 相較於 IDE-based 工具最大的優勢場景。你在 DigitalOcean 的 VPS 上 SSH 進去:
ssh user@your-vps-ip # VPS 上已裝好 crush + tmux tmux new -s coding cd /var/www/my-app crush
在本地咖啡廳用 iPhone 的 Termius 都可以繼續讓 crush 在遠端伺服器做 agentic coding,不需要回家開桌機。crush 的純終端機設計讓它在任何 SSH 環境都能完美運作。
crush 的多模型支援讓你可以根據任務複雜度動態切換模型,大幅降低 API 費用:
# 在 crush config 中設定別名
# ~/.config/crush/config.yaml
profiles:
cheap: # 簡單任務用便宜模型
model: claude-haiku-3-5
max_tokens: 4096
standard: # 一般開發任務
model: claude-sonnet-5
max_tokens: 8192
power: # 複雜架構設計或大型 refactor
model: claude-opus-5
max_tokens: 16384
free: # 本機完全免費
model: ollama/llama-4.1:8b
max_tokens: 4096
# 切換 profile crush --profile cheap # 快速 lint 修復 crush --profile power # 重大架構重構
crush 本身免費,費用完全取決於你使用哪個 AI 模型 API 及用量。以下是幾個典型場景的月費估算:
| 使用強度 | 推薦模型 | 每日 token 用量(估) | 月費(估) |
|---|---|---|---|
| 輕度(學習用) | Claude Haiku 3.5 | ~50K tokens/天 | 約 $3-8/月 |
| 中度(日常開發) | Claude Sonnet 5 | ~200K tokens/天 | 約 $30-80/月 |
| 重度(全職 AI 輔助) | Claude Sonnet 5 | ~500K tokens/天 | 約 $80-200/月 |
| 本機部署(零 API 費) | Ollama + Llama 4.1 | 無限制 | $0(電費另計) |
| 省錢混合策略 | Haiku 3.5 + DeepSeek V4 Pro | ~200K tokens/天 | 約 $8-20/月 |
對比 Cursor Pro ($20/月固定),如果你是中輕度用戶,用 crush + Claude Haiku 3.5 其實更便宜。如果是重度用戶,Cursor 的固定費反而合算。關鍵在於你的用量——你可以用我們的 AI Token 費用計算器 估算你的實際用量。
在 DigitalOcean Droplet 上部署 crush + 你的專案,讓 agentic coding 在雲端 24 小時待命。最便宜的 Droplet 每月 $6,加上 API 費用,遠比 Cursor Pro 划算。
☁️ DigitalOcean — 領取 $200 免費額度 🧮 計算我的 API 月費crush 只是工具,真正的能力來自對 LLM API、prompt engineering 和 agentic 架構的深度理解。DataCamp 的 AI / ML 課程從 OpenAI API 入門到大型語言模型部署,適合各階段開發者。
🎓 DataCamp — 免費開始學習auto_approve_tools: false)下,crush 在執行任何工具呼叫(包括寫入/刪除檔案、執行 shell 指令)前都會先顯示將要做的事並等待你按 Y 確認。這個設計讓你完全掌控 AI 的行為。建議在初期使用時保持這個設定,熟悉 crush 的行為模式後再考慮開啟自動批准(僅建議在 CI/CD 環境或有充分備份的情況下)。我們整理了一套針對台灣開發者的 crush 快速上手包,包含 20+ 個常用任務 prompt 範本、多語言 CRUSH.md 範例(TypeScript / Python / Go / PHP),以及費用優化設定。
📦 查看完整資源包 ⭐ GitHub 原始碼charmbracelet/crush 在一個競爭激烈的市場中找到了清晰的定位:給那些在終端機生活、不願被單一 AI 廠商鎖定、同時對工具的視覺品質有要求的開發者。27,000+ 顆 star 和活躍的社群討論不是偶然——它確實做到了很多競品沒做到的事。
如果你還在用純 chat 方式和 AI 互動(問問題、複製貼上程式碼、再問問題),crush 的 agentic loop 會讓你體驗到完全不同的工作流。AI 不只是「回答問題的工具」,而是「能真正做事的同事」。
安裝 crush 花 5 分鐘,讓它跑一個真實任務看看。如果你已經在用 Claude Code,把 crush 加進來試試多模型切換——你的 API 費用可能會有驚喜。
brew install charmbracelet/tap/crush 安裝 crushANTHROPIC_API_KEY 環境變數crush init-project相關文章: OpenCode Zen vs Go 費用比較 · Grok 4.6 完整評測 · DeepSeek V4 Pro 評測 · AI Token 費用計算器 · 更多 AI 工具教學