跳到主内容
AIHO 2026 全新改版上线
TOOL · AGENT #01/04桌面 Agent
Crush

Crush

Charmbracelet 出品的终端 AI 编程 agent——多模型切换 + LSP + MCP + Agent Skills 标准

terminal-agenttuimulti-modellspmcpopensourcecharmbracelet
访问官网
能力
5
易用
5
性价比
5
中文
3
稳定
4
编辑结论 综合4.4/ 5

终端原生 AI agent 的标杆——TUI 颜值 + 多模型切换 + LSP + MCP + Skills 全栈。终端控 / 远程开发 / SSH 工作流首选。GUI / IDE 党仍建议 Cursor / Claude Code。

01 / 03深度解读

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/crush NPM 包:跨平台一键安装

价格

  • 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"
    }
  }
}

对比

维度CrushClaude CodeAiderCodex CLI
TUI 颜值✅ 顶级✅ 良好文本朴素一般
多模型切换✅ mid-sessionClaude 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 userAnthropic 生态Git refactorOpenAI 生态

避坑

  • 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 协议要审)

相关阅读

来源

  1. Charmbracelet/crush GitHub(24.7k stars / 160 releases / 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
02 / 03价格速查
计划价格限制国内支付备注
Free$0
03 / 03 常见问题
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 配置。