crush 完整教學 2026：charmbracelet 打造的 Agentic Coding CLI，27K★ 繁中首發深度解析

📅 2026-08-30 · AutoDev AI Team · 繁中首發 · 約 2,500 字

一、crush 是什麼？charmbracelet 為何做這個工具

如果你熟悉 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 月）的高度關注。在英文社群有大量討論的情況下，繁中教學至今幾乎是零——這就是本文的切入點。

二、核心功能：Agentic Loop、工具呼叫與多模型支援

crush 的設計哲學可以用三個詞概括：終端機原生、agentic、多模型。以下是每個面向的具體說明：

1. Agentic Loop（自主任務執行）

crush 不只是一個「問問題、看回答」的 chat CLI。它實作了完整的 agentic loop：接收任務 → 規劃步驟 → 呼叫工具（讀/寫檔案、執行指令、搜尋） → 觀察結果 → 重新規劃 → 直到任務完成。這個模式和 Claude Code 的核心架構相同，但 crush 是在終端機環境中以更輕量的方式實現。

典型的 agentic loop 場景：你給 crush 一個 issue 描述，它會自動讀取相關檔案、撰寫修改程式碼、執行測試、根據測試結果修正，最終提交 patch——全部在終端機中完成，不需要切換視窗。

2. 工具呼叫（Tool Use）

crush 內建了一組完整的工具集，讓 AI 模型能真正「動手」：

• 檔案操作：read_file、write_file、create_file、delete_file、list_dir
• Shell 執行：run_command（可執行任意 shell 指令，含測試、build、git）
• 搜尋：search_files（ripgrep 整合）、web_search（可選）
• Git 整合：git_diff、git_log、git_commit

這些工具讓 crush 能完成真實的開發任務，而不只是生成程式碼片段。

3. 多模型支援

crush 支援透過環境變數切換不同 AI 後端，這是它相較於 Claude Code（鎖定 Anthropic）最靈活的地方：

• Anthropic：Claude Sonnet 5、Claude Haiku 3.5（預設推薦）
• OpenAI：GPT-5.4、GPT-5.6 Sol/Terra/Luna
• Google：Gemini 2.5 Pro、Gemini Flash
• 本機模型：透過 Ollama 接入 Llama 4.1、Qwen3.8-27B 等
• OpenRouter：統一 API 閘道，支援 100+ 模型

4. Charmbracelet TUI 美學

這是 crush 與其他 agentic CLI（如 Codex CLI、aider）最大的視覺差距。charmbracelet 用 bubbletea + lipgloss 打造了一個真正好看的終端機介面：彩色語法高亮、進度指示器、可捲動的工具呼叫歷史、清晰的 diff 顯示。在終端機裡工作 8 小時，視覺舒適度不是小事。

三、安裝教學：5 步驟在 macOS / Linux / Windows 跑起來

brew install charmbracelet/tap/crush

curl -sSL https://github.com/charmbracelet/crush/releases/latest/download/crush_linux_amd64.tar.gz | tar xz
sudo mv crush /usr/local/bin/

go install github.com/charmbracelet/crush@latest

scoop bucket add charm https://github.com/charmbracelet/scoop-bucket.git
scoop install crush

export ANTHROPIC_API_KEY="sk-ant-..."
# OpenAI 用戶
export OPENAI_API_KEY="sk-..."
# Google Gemini 用戶
export GOOGLE_API_KEY="AIza..."

crush init

# ~/.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 TUI 輸入框中輸入：
/summarize
# crush 會自動掃描目錄、讀取關鍵檔案，輸出 codebase 摘要

四、工具比較表：crush vs Claude Code vs Codex vs Gemini CLI vs OpenCode

2026 年 agentic coding CLI 市場競爭激烈，以下是主要選項的完整比較：

crush 在「多模型支援 + TUI 品質 + 完全開源」三個維度的組合上目前無競爭對手。OpenCode 是最接近的競品（同樣 Go 語言、多模型），但 charmbracelet 在 TUI 美學上有明顯的積累優勢。

和 Claude Code 相比，crush 最大的優勢是不鎖定 Anthropic——如果你想在 Claude 費用太貴時切到 DeepSeek V4 Pro 或本機 Ollama，一個設定即可完成，不需要換工具。這對需要控制成本的開發者來說是關鍵差異。

五、4 個台灣開發者實戰場景

場景 1：自動化 Code Review

你剛 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。

場景 2：從 GitHub Issue 到 Patch

你有一個 bug report，想讓 crush 自動定位問題並提出修復方案：

# 在 crush 中輸入：
Issue #234：使用者在切換語言後，購物車數量顯示不正確。
請：
1. 找出負責語言切換的相關程式碼
2. 找出購物車狀態管理的相關程式碼
3. 找出可能的問題點
4. 提出修復方案並說明原因
5. 如果你有信心，可以直接修改程式碼

crush 的 agentic loop 會自動搜尋相關檔案（ripgrep 整合），讀取程式碼，分析問題，必要時執行測試確認 fix。整個過程你只需要在旁確認每個工具呼叫是否合理。

場景 3：在 VPS 上遠端執行（SSH + tmux）

這是 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 環境都能完美運作。

場景 4：省錢的模型路由策略

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   # 重大架構重構

六、API 費用估算：每月實際要花多少錢

crush 本身免費，費用完全取決於你使用哪個 AI 模型 API 及用量。以下是幾個典型場景的月費估算：

對比 Cursor Pro ($20/月固定)，如果你是中輕度用戶，用 crush + Claude Haiku 3.5 其實更便宜。如果是重度用戶，Cursor 的固定費反而合算。關鍵在於你的用量——你可以用我們的 AI Token 費用計算器 估算你的實際用量。

七、優缺點總結與適用族群

crush 最適合誰？

• 終端機派開發者：你的工作環境是 tmux + neovim / vim，完全不需要 GUI
• 需要彈性切換模型的開發者：你有多個 API key，想根據任務選最划算的模型
• VPS / 伺服器端工作者：你需要在遠端伺服器跑 agentic coding，IDE 擴充套件沒辦法用
• 開源貢獻者：你想要一個真正開源、可以修改的 agentic coding 框架
• 成本控管嚴格的開發者：你不想花 $20/月固定費，prefer 按用量付費

crush 不適合誰？

• GUI 習慣者：如果你離不開滑鼠和點擊操作，Cursor 或 IDE 插件更適合
• 需要大型社群支援的初學者：Claude Code 的中文教學資源目前明顯更多
• Windows 主力用戶：Windows 上的終端機環境相對複雜，macOS / Linux 體驗更流暢

八、常見問題 FAQ

結語：crush 是 2026 年終端機派開發者的最佳 Agentic CLI

charmbracelet/crush 在一個競爭激烈的市場中找到了清晰的定位：給那些在終端機生活、不願被單一 AI 廠商鎖定、同時對工具的視覺品質有要求的開發者。27,000+ 顆 star 和活躍的社群討論不是偶然——它確實做到了很多競品沒做到的事。

如果你還在用純 chat 方式和 AI 互動（問問題、複製貼上程式碼、再問問題），crush 的 agentic loop 會讓你體驗到完全不同的工作流。AI 不只是「回答問題的工具」，而是「能真正做事的同事」。

安裝 crush 花 5 分鐘，讓它跑一個真實任務看看。如果你已經在用 Claude Code，把 crush 加進來試試多模型切換——你的 API 費用可能會有驚喜。

相關文章： OpenCode Zen vs Go 費用比較 · Grok 4.6 完整評測 · DeepSeek V4 Pro 評測 · AI Token 費用計算器 · 更多 AI 工具教學