
Crush
Charmbracelet 出品的终端 AI 编程 agent——多模型切换 + LSP + MCP + Agent Skills 标准
终端原生 AI agent 的标杆——TUI 颜值 + 多模型切换 + LSP + MCP + Skills 全栈。终端控 / 远程开发 / SSH 工作流首选。GUI / IDE 党仍建议 Cursor / Claude Code。
TL;DR
Crush 是 Charmbracelet 2025-07 发布的终端 AI 编程 agent,Go 编写、TUI 体验、24,700+ GitHub stars、160+ releases。差异点: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 协议有限制)。
核心能力
- 多模型 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/crushNPM 包:跨平台一键安装
价格
- Free:$0;FSL-1.1-MIT(2 年后转 MIT)
- 真实成本 = LLM API 费用(自带 key)
省钱组合:日常用 Ollama 本地 7B / 13B 跑简单任务;难任务切 Claude Sonnet / GPT-5 / Z.AI GLM Coding。
实测(终端主力 / macOS + Linux SSH)
亮点:
- 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 体验更好
上手
# 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 | Claude Code | Aider | Codex CLI |
|---|---|---|---|---|
| TUI 颜值 | ✅ 顶级 | ✅ 良好 | 文本朴素 | 一般 |
| 多模型切换 | ✅ mid-session | Claude only | ✅ 任意 | OpenAI only |
| LSP | ✅ | – | – | – |
| MCP | ✅ 全 transport | ✅ 全 transport | – | 部分 |
| Skills | ✅ 标准 | ✅ Skills 体系 | – | – |
| AGENTS.md | ✅ | ✅ | – | – |
| 协议 | FSL-1.1-MIT | 闭源 | Apache 2.0 | 闭源 |
| 平台 | 极广 | macOS/Linux/Win | 全平台 | macOS/Linux/Win |
| 起价 | $0 + API 费 | API 费 / Pro | $0 + API 费 | API 费 / Plus |
| 适合 | 终端 + 多模型 + Power user | Anthropic 生态 | Git refactor | OpenAI 生态 |
避坑
- FSL 协议商业审查:商业竞品场景前法务过一遍,2 年后转 MIT
- API Key 管理:用
pass/ 1Password CLI / direnv,不硬编码crush.json - breaking change 跟进: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 协议要审)
相关阅读
来源
- Charmbracelet/crush GitHub(24.7k stars / 160 releases / FSL-1.1-MIT)https://github.com/charmbracelet/crush
- Artificialus — Crush 评测 2026 https://artificialus.com/agents/crush
- Typevar — Crush 入门 + 安装 https://typevar.dev/articles/charmbracelet/crush
- Z.AI Devpack — Crush + GLM Coding Plan 集成 https://docs.z.ai/devpack/tool/crush
| 计划 | 价格 | 限制 | 国内支付 | 备注 |
|---|---|---|---|---|
| Free | $0 | — | — |
Crush 和 Claude Code / Aider / Codex 怎么选?
Crush 强在『终端原生 TUI 颜值 + 多模型 mid-session 切换 + LSP + 跨平台二进制 + 不绑特定模型』;Claude Code 强在『Anthropic 官方 + Skills 生态 + computer use』;Aider 强在『Git 集成 + 多文件 refactor + 模型成本最优』;Codex 强在『OpenAI 官方 + 桌面集成 + Mac 体验最佳』。要终端 + 多模型 + LSP 体验 → Crush;要 Claude 全家桶 → Claude Code;要 Git refactor → Aider;要 OpenAI + macOS → Codex。
FSL-1.1-MIT 是什么协议?
Functional Source License 1.1:禁止商业竞品场景使用,2 年后自动转为 MIT 完全开放。对个人 / 内部使用 / 学习无影响,企业级商业竞品要看条款。社区有声音质疑这不是『OSI 标准开源』,使用前企业法务建议过一下。
用什么模型最划算?
Crush 不绑定模型,常见组合:Anthropic Claude Sonnet(日常 coding,性价比平衡)+ GPT-5.x(推理重任务)+ Gemini Flash(速度优先)+ Ollama / LM Studio(本地 free)+ Z.AI GLM Coding Plan(中文 + 价格低)。多账户 + OpenRouter 中转管理最方便。
配置文件在哪?
macOS/Linux:~/.config/crush/crush.json;Windows:%USERPROFILE%\.config\crush\crush.json。可加自定义 provider(如 Z.AI Coding Plan 用 https://api.z.ai/api/coding/paas/v4)+ MCP server + Skills 配置。