charmbracelet/crush 是 Charm（Bubble Tea、Hugo 那家）2025 年 5 月立项的终端编程 agent，GitHub 27274 颗星（实时变动，以 GitHub 为准）、2143 个 fork，Go 写的，最近一次 push 就在今天（2026-08-11），未归档，629 个开放 issue 说明社区在真用。README 定位原话："Your new coding bestie, now available in your favourite terminal. Your tools, your code, and your workflows, wired into your LLM of choice."（终端里的编程新搭档，全面兼容主流 LLM。）差异点：Claude Code 绑死 Anthropic 模型 + 订阅，Cursor 是闭源 IDE 副驾，crush 走"软件开源、模型你挑"--OpenAI/Anthropic 兼容 API 都能接，还能会话中途换模型不丢上下文。但避坑也在这：它的许可证不是你以为的 MIT，是 FSL-1.1-MIT，有竞争性使用限制。本文把这条和另外几条坑一起拆开。
本文基于 charmbracelet/crush 的 GitHub README 与 LICENSE.md 梳理，事实截至 2026-08-11，星数实时变动。与本站 GLM 编程套餐升级热点、AI 编程套餐横评、AI 编程上下文工程 SOP 互补但独立，和 cua 资源盘、openclaw 资源盘 各管不同地盘。
一、定位：终端里的编程搭档，不是又一个 IDE
crush 跑在终端里：你在命令行跟它对话，它读代码、改文件、跑命令、调工具，干"帮你写代码"的活。它不是 Cursor 那种编辑器里的 GUI 副驾--没有多窗格 diff、没有文件树点选、没有 IDE 那套可视化。交互界面是 TUI，而 Charm 的看家本领正是终端 UI（Bubble Tea 框架就是他们的），所以 crush 的终端体验比大多数命令行工具养眼。
为什么押终端？一是可 SSH：服务器、容器、远程开发机没 GUI 也能跑，后端和运维刚需。二是轻：不用起 Electron 吃内存，一个终端窗口搞定。三是跨平台全：README 列了 macOS、Linux、Windows（PowerShell 和 WSL）、Android、FreeBSD、OpenBSD、NetBSD--Android 和三个 BSD 都在列，编程 agent 里相当罕见，靠的是 Go 编译加原生 Bash 解释器。README 标 "Industrial Grade"，理由是 Charm 生态 powering 25k+ applications，不是实验品。
但"终端 agent"本身劝退一部分人：习惯 Cursor 那种"左代码右对话、改哪行高亮给你看"的，回纯文本终端会不适应。crush 的目标用户是已经活在终端里的人--后端、DevOps、系统编程、vim/tmux 工作流的极客。一看命令行就头疼的，这篇可以划走。
二、核心特性：六张牌
Multi-Model：模型你挑，不绑死。 最硬的差异化。原生支持 OpenAI 和 Anthropic 兼容 API，官方 OpenAI/Anthropic 自不必说，OpenRouter、Azure OpenAI、AWS Bedrock、Google VertexAI 都有内置环境变量。README 明说能"add your own via OpenAI- or Anthropic-compatible APIs"--自家 LLM 也能接。Charm 还开了官方 provider 叫 Hyper（hyper.charm.land），订阅制带免费层，主打零数据留存（ZDR）和 GDPR 合规。
Flexible：会话中途换模型，上下文不丢。 值钱的一条。先用便宜模型做粗活（读代码、搜符号），遇到硬骨头切强模型，Ctrl+L 唤选择器当场切，上下文保留。按任务难度动态分配算力，不是"选一个用到黑"。
Session-Based：多项目多会话并行。 每个项目独立会话和上下文，切来切去不串味，适合同时跟进几个仓库。
LSP-Enhanced：用 LSP 拿上下文，跟你一样。 crush 接语言服务器协议拿符号、定义、引用这些结构化上下文，不只靠读文件。README 原话："Crush uses LSPs for additional context, just like you do." 能开 gopls（Go）、nil（Nix）等，让 agent 看懂代码结构而不是把文件当纯文本，比纯文件读取准很多。
Extensible：靠 MCP 扩能力。 支持 MCP 的三种传输：http、stdio、sse。能挂数据库、浏览器、文件系统、内部 API，扩展成不止"写代码"的 agent。配套有 Catwalk--社区维护的 crush 兼容模型仓库，缺模型往上加。
Works Everywhere + crushrc。 平台覆盖前面说了。配置系统值得一提：crush 用 crushrc 文件，本质是 Bash 脚本加几个 crush 专属内建命令，就像 .bashrc 之于 shell。因 crush 内置原生 Bash 解释器，这套配置在所有平台（含 Windows）行为一致。加本地 Ollama 两行：
provider add ollama --type ollama --base-url "http://localhost:11434/v1"
model add ollama/llama3.3 --name "Llama 3.3" --context-window 128000三、和 Claude Code、Cursor、openclaw 怎么分地盘
最容易问混的就是这几个。Cursor 住在编辑器里：强项是仓库级多文件改写、可视化 diff、IDE 级导航，闭源订阅。Claude Code 是 Anthropic 的命令行/桌面 agent，强在长上下文推理和工程协作，但闭源、绑 Anthropic 模型、订阅约 20 美元/月。crush 和 Claude Code 最像（都是终端编程 agent），但两条核心差异：一是模型不绑死，crush 任意兼容模型都能接；二是许可证，Claude Code 闭源，crush 源码可见（FSL 不是 MIT，见第五节）。
openclaw 是完全不同的物种：个人助手，替你管邮件、日程、文件这些生活/办公杂活，强项是本地自动化，不写代码。crush 的地盘是代码仓库，openclaw 的地盘是收件箱和日历。一句话：crush 是"终端里帮你写代码的搭档"，Claude Code 是"绑 Anthropic 的工程协作 agent"，Cursor 是"编辑器 GUI 副驾"，openclaw 是"替你管杂活的个人助手"。
| 维度 | charmbracelet/crush | Claude Code | Cursor | openclaw |
|---|---|---|---|---|
| 地盘 | 终端编程 agent | 终端/桌面编程 agent | IDE 编程副驾 | 个人助手·杂活自动化 |
| 模型 | 任意（兼容 API） | 仅 Anthropic | 绑定产品 | 多家（BYOK） |
| 界面 | TUI 终端 | 终端/桌面 | GUI IDE | 跨平台 app |
| 许可证 | FSL-1.1-MIT | 闭源 | 闭源 | MIT |
| 费用 | 软件免费·模型自付 | 订阅 $20/月 | 订阅 | 软件免费·模型自付 |
它们更多互补而非纯替代。常见组合：Cursor 做 GUI 下的快速改写，Claude Code 啃长上下文难题，crush 在服务器/远程环境干活（SSH 就能用、不挑模型）。选型前对照本站 AI 编程套餐横评 算笔账。
四、上手：装好、接模型、开干
装。 最常用两条：
brew install charmbracelet/tap/crush # Homebrew
npm install -g @charmland/crush # npm 全平台Windows 还能 winget install charmbracelet.crush 或 scoop install crush，甚至 go install github.com/charmbracelet/crush@latest 从源码装。
接模型。 最快路径：装完 Ctrl+L 唤模型选择器，选 Hyper 模型按提示认证，免费层够试水。不想用 Hyper 就设环境变量，crush 认一长串：ANTHROPIC_API_KEY、OPENAI_API_KEY、ZAI_API_KEY（Z.ai/智谱）、MINIMAX_API_KEY、MOONSHOT_API_KEY、GEMINI_API_KEY、OPENROUTER_API_KEY 等都有。
接国产模型/本地模型。 这是 crush 对中国用户友好的关键。Z.ai（智谱）、MiniMax、月之暗面、阿里都有原生环境变量，不用拼兼容层。DeepSeek 没专属变量，但 API 是 OpenAI 兼容的，crushrc 加自定义 provider 两行：
provider add deepseek --type openai --base-url "https://api.deepseek.com/v1"
model add deepseek/deepseek-chat --name "DeepSeek Chat" --context-window 64000想零 API 费就接本地 Ollama（前面那两行）。整体上手：装一行、配一个 key、Ctrl+L 选模型，三步开干。
五、避坑代价：五条必须知道的坑
坑一：许可证不是 MIT，是 FSL-1.1-MIT（最该读的一条）。 GitHub SPDX 探测器对 crush 返回 NOASSERTION。点进仓库读 LICENSE.md，开头写的是"Functional Source License, Version 1.1, MIT Future License"，缩写 FSL-1.1-MIT，版权归 Charmbracelet, Inc.。这跟 Charm 家的 Bubble Tea、Hugo（都是 MIT）不一样--别因同门就假设 crush 也是 MIT。FSL 核心：你可以用、改、复制、二次开发、再分发，但只能用于"Permitted Purpose"；"Competing Use"被禁止--指把 crush 拿去做商业产品或服务、替代 crush 本身或 Charm 的其他产品、或提供与 crush 实质相同的功能。内部使用、非商业教育/研究、给 crush 被许可方提供专业服务都没问题。还有"未来许可"：crush 发布满两年后自动转 MIT。严谨说法是当前"源码可见 + 竞争性使用受限"，两年后转 MIT。个人写代码、公司内部用完全没事；想 fork 做竞品 SaaS 卖，头两年不行。商业集成前务必自己读 LICENSE.md 原文。
坑二：终端不是 IDE，期望别跑偏。 冲着"Cursor 平替"来会发现没有可视化 diff、文件树点选、多窗格布局。crush 是 TUI，所有交互在终端文本里。对终端原住民是优势（轻、快、可 SSH），对 IDE 重度用户是门槛。建议先跑两天试手感，别急着整体迁移。
坑三：模型 API 自付，model-agnostic 是双刃剑。 软件免费，但 LLM 调用烧你的 API 额度。自由选模型能挑便宜的（DeepSeek、MiniMax、本地 Ollama），但没人帮你管成本--长会话 token 悄悄涨上去，账单是你的。Hyper 免费层能缓冲但额度有限。建议：粗活便宜模型，硬骨头切强模型（正好用 Flexible 中途切换），别全程挂最贵的。
坑四：MCP 配置有门槛。 扩展能力靠 MCP，挂外部工具要写配置。crushrc 是 Bash 语法，会写脚本的人顺手，不熟 Bash 的是学习曲线。好在 crush 内置"自我配置"技能--大多数时候用自然语言告诉它"帮我加个 Ollama provider"，它自己改 crushrc。
坑五（反过来的甜头）：中国可用性反而友好。 model-agnostic 意味着不强制海外模型：Z.ai（智谱）、MiniMax、月之暗面、阿里都有原生环境变量，DeepSeek 走 OpenAI 兼容端点两行 crushrc 搞定，本地还能接 Ollama 完全离线。比起被锁在单一海外模型的闭源 agent，crush 在国内可用性反而更强--挑个国产便宜模型，成本和速度都比硬蹭海外 API 划算。选模型可参考本站 GLM 编程套餐升级热点。
适合：活在终端里的后端/DevOps/系统开发者；想要模型自由、不愿绑死单一厂商的人；需要在服务器和远程环境跑编程 agent 的人；想接国产模型控成本的中国开发者。别凑热闹：你要 GUI IDE--Cursor 更对路；要开箱即用零配置--Claude Code 订阅更省心；要替你管邮件日程--openclaw 才是那个物种。
六、常见问题
Q：crush 是 MIT 许可证吗？ A：不是。GitHub SPDX 报 NOASSERTION，LICENSE.md 实际是 FSL-1.1-MIT（Functional Source License v1.1, MIT Future License）。可以用、改、二次开发，但不能做"竞争性使用"（拿它做替代 crush 的商业产品/服务）。发布满两年后自动转 MIT。个人和内部用没问题，商业集成前务必读 LICENSE.md 原文。
Q：crush 和 Claude Code 有什么区别？ A：都是终端编程 agent，两条核心差异：一是模型--Claude Code 只能用 Anthropic、订阅约 $20/月，crush 任意兼容模型都能接、软件免费、模型费自付、还能会话中途切模型；二是许可证--Claude Code 闭源，crush 源码可见（FSL-1.1-MIT）。
Q：在中国能用吗？接哪些模型？ A：能，而且比绑死海外模型的 agent 友好。Z.ai（智谱）、MiniMax、月之暗面、阿里都有原生环境变量；DeepSeek 走 OpenAI 兼容端点用 crushrc 加自定义 provider 两行搞定；还能接本地 Ollama 完全离线。挑国产便宜模型控成本完全可行。
Q：怎么装，要付费吗？
A：软件免费。brew install charmbracelet/tap/crush 或 npm install -g @charmland/crush，Windows 用 winget/scoop。装完 Ctrl+L 选模型：用 Hyper 有免费层，或设环境变量接自己的 API key。模型调用烧你的 API 额度，接本地 Ollama 则零 API 费。
Q：2.7 万星，项目成熟吗？ A：活跃但仍在高速迭代。2025-05-21 创建，今天还在 push，未归档，629 个开放 issue。Charm 生态（Bubble Tea/Hugo）工程底子扎实，但 crush 本身接口和文档还在变动，生产接入前建议自己跑一遍你的场景。
参考来源
- charmbracelet/crush GitHub 仓库（27274 star / 2143 fork，Go，FSL-1.1-MIT 许可证）：https://github.com/charmbracelet/crush
- crush 官网（Charm 出品）：https://stuff.charm.sh/crush
- LICENSE.md（FSL-1.1-MIT 全文，含竞争性使用条款与两年转 MIT 条款）：https://github.com/charmbracelet/crush/blob/main/LICENSE.md
- Charm Hyper 官方 provider（订阅制带免费层，ZDR）：https://hyper.charm.land
- Catwalk（社区维护的 crush 兼容模型仓库）：https://github.com/charmbracelet/catwalk
- 本站相关：GLM 编程套餐升级热点 ｜ AI 编程套餐横评 ｜ AI 编程上下文工程 SOP ｜ cua 资源盘 ｜ openclaw 资源盘