Crush

TL;DR

Crush 是 Charmbracelet 2025-07 发布的终端 AI 编程 agent，Go 编写、TUI 体验、28,833 GitHub stars（2026-10-27 实测）。差异点：mid-session 多模型切换（Anthropic / OpenAI / Gemini / Bedrock / Groq / OpenRouter / Azure / Vertex / Ollama / LM Studio / Z.AI 等数十家）+ LSP 集成 + MCP（stdio/HTTP/SSE）+ Agent Skills 标准 + SQLite session 持久化 + AGENTS.md 项目上下文。FSL-1.1-MIT 开源（2 年后转 MIT），全平台二进制（macOS / Linux / Windows / WSL / FreeBSD / OpenBSD / NetBSD / Android）。

适合：终端控 / SSH 远程开发 / 不想离开命令行的工程师；要在多个 LLM 间灵活切换；用 Ollama / LM Studio 本地模型；颜值 + 功能都不愿妥协的 power user。不适合：纯 GUI / IDE 党（Cursor 更顺）；要 Anthropic 官方 Skills 生态深度（用 Claude Code）；企业商业竞品场景（FSL 协议有限制）。

Crush 核心能力

• 多模型 mid-session 切换：不重启 session 切 Claude / GPT / Gemini / Groq / Bedrock / OpenRouter / Azure / Vertex
• LSP 集成：自动发现 + on-demand 启动，context-aware 代码理解
• MCP 支持：stdio / HTTP / SSE 三种 transport
• Agent Skills 标准：内置 skill discovery
• AGENTS.md：项目级 context 文件
• SQLite session 持久化：history navigation + 多会话隔离
• 桌面通知：权限确认 + agent turn 完成提醒
• 跨平台二进制：macOS + Linux + Windows（PowerShell + WSL）+ FreeBSD + OpenBSD + NetBSD + Android
• Charm 生态：Bubble Tea TUI + Lip Gloss 样式 + Glamour markdown + Bubbles 组件 + Fantasy LLM 抽象
• @charmland/crush NPM 包：跨平台一键安装

Crush 价格

• Free：$0；FSL-1.1-MIT（2 年后转 MIT）
• 真实成本 = LLM API 费用（自带 key）

省钱组合：日常用 Ollama 本地 7B / 13B 跑简单任务；难任务切 Claude Sonnet / GPT-5 / Z.AI GLM Coding。

Crush 实测

亮点：

• TUI 颜值在终端 agent 里独一档，Bubble Tea 的丝滑动效
• mid-session 切模型在『Claude 推理够用 → GPT 思考 hard task → Gemini Flash 跑批 commit 文档』场景极有用
• LSP 集成对 Go / Rust / TS / Python 大型项目特别管用
• MCP 三种 transport 覆盖几乎所有用例
• AGENTS.md 让项目级 prompt 不丢
• SQLite 多 session 隔离干净
• 跨平台二进制保留 SSH + 远程开发用户

踩坑：

• FSL-1.1-MIT 不是 OSI 标准开源，企业法务要审一遍
• 自带 API Key，新手要先准备至少一家 provider
• ~22MB+ 二进制 + Go runtime + SQLite，比 aider 重
• 仅 TUI，没 IDE 插件 / web UI
• 160+ releases 节奏快，breaking change 偶发
• 中文 prompt 效果取决于底层模型，UI 文档英文为主
• 多模型 routing 默认策略可能不省钱，手动配 crush.json 更精细
• Windows 原生 PowerShell 偶有渲染问题，WSL 体验更好

Crush 上手 5 分钟

# macOS
brew install charmbracelet/tap/crush

# 跨平台 NPM
npm install -g @charmland/crush

# Go 直装
go install github.com/charmbracelet/crush@latest

# 配置 API Key（任选）
export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."

# 启动
crush

# Ctrl+P → Switch Model 切换；Ctrl+S 切 session；输入 /help 看命令

crush.json 加 Z.AI GLM Coding Plan 自定义 provider：

{
  "providers": {
    "zai": {
      "id": "zai",
      "name": "ZAI Provider",
      "base_url": "https://api.z.ai/api/coding/paas/v4",
      "api_key": "your_api_key"
    }
  }
}

Crush 与同类对比

Crush 避坑清单

• FSL 协议商业审查：商业竞品场景前法务过一遍，2 年后转 MIT
• API Key 管理：用 pass / 1Password CLI / direnv，不硬编码 crush.json
• breaking change 跟进：发版节奏快（2026-06 口径已 160+ releases），pin 版本到 stable
• LSP 启动慢：大项目首次启动数秒，正常现象
• Ollama 本地优先：日常简单任务跑 7B，复杂任务再切云
• Windows 用 WSL：原生 PowerShell 有 ANSI 渲染坑
• AGENTS.md 写好：项目 context 决定 80% 体验，按官方模板写
• session 切换勤快点：不同任务开不同 session，history 干净
• MCP server 信任评估：装新 MCP 前看 source / 权限

适合 / 不适合

• 终端主力 / SSH 远程开发
• 多模型用户（Claude + GPT + Gemini + Ollama 一起用）
• Go / Rust / TS / Python 大型项目（LSP 加成大）
• 不想被单一 vendor 绑定
• 纯 GUI / IDE 党
• 要 Anthropic 官方 Skills 体系（用 Claude Code）
• 要 OpenAI 桌面深度（用 Codex）
• 商业竞品 / 法务严格场景（FSL 协议要审）

相关阅读

• Claude Code 评测
• Aider 评测
• Codex 评测

Long-tail quick picks

长尾检索速查：下面三项对应「Crush 开源版 / 免费版 / 国内可用」等搜索意图，方便直接跳转。

Open-source alternatives

• 是否开源：是（支持自托管）
• 想找开源替代？看这几个：Trae · Cline · Aider

Free tier

• 是否有免费档：是
• 价格概要：免费开源（FSL-1.1-MIT，2 年后转 MIT）/ 用户自带 LLM API Key
• 预算敏感用户可先用免费档；进阶需求参考 通义灵码 / CodeGeex（国内免费额度更友好）。

China availability

• 是否国内可用：否
• 中文友好度评分：3 / 5
• 国内访问需稳定代理；高频切 IP 可能触发风控。中文场景可考虑 Trae / 通义灵码 / Comate。

相关替代品：

• claude-code
• aider
• codex

2026-10-27 复核与纠错：frontmatter 的 github 原写 crushofficial/crush（404），正确仓库为 charmbracelet/crush，已更正；实测 28,833 star（原「24,700+」为 2026-06 口径），当日仍在提交。

来源

1. Charmbracelet/crush GitHub（2026-10-27 实测 28,833 stars / FSL-1.1-MIT）https://github.com/charmbracelet/crush
2. Artificialus — Crush 评测 2026 https://artificialus.com/agents/crush
3. Typevar — Crush 入门 + 安装 https://typevar.dev/articles/charmbracelet/crush
4. Z.AI Devpack — Crush + GLM Coding Plan 集成 https://docs.z.ai/devpack/tool/crush