产品与定位
Crush 是终端 UI 团队 Charm（charmbracelet）推出的终端编程 Agent，Go 编写，与 Charm 自家的 Bubble Tea / Lip Gloss 生态同源。它的定位是「把你已有的工具、代码和工作流接进你选的 LLM」，因此在上下文获取上做得比多数同类更细：直接用 LSP 拿语言服务给的语义信息，而不是只靠 grep 加猜测。
截至 2026-09-22，仓库约 28,246 stars、2,277 forks，最新版本 v0.96.1（2026-09-21 发布），仍处于高频迭代阶段。
功能速览
| 功能 | 说明 |
|---|---|
| LSP 增强 | 通过语言服务器补全上下文，配置 lsp add go --command "gopls" |
| MCP 客户端 | 支持 stdio、http、sse 三种传输，支持 MCP OAuth 授权 |
| 多模型 | 内置大量供应商，也可用 OpenAI / Anthropic 兼容格式自定义 |
| 会话中换模型 | 切换 LLM 时保留当前上下文 |
| 多会话 | 每个项目可维护多个工作会话与上下文 |
crushrc 配置 | 内建 Bash 解释器做配置，跨平台行为一致 |
| Agent Skills | 支持 agentskills.io 开放标准，可读取 .claude/skills、.cursor/skills |
| 共享工作区 | crush serve 作为后端，多个客户端按 --cwd 加入同一 workspace |
| 跨平台 | macOS、Linux、Windows（PowerShell / WSL）、Android、BSD 系列 |
常用命令
| 命令 | 作用 |
|---|---|
crush | 启动 TUI |
crush logs --follow | 实时查看日志 |
crush update-providers | 手动更新模型/供应商目录 |
crush --yolo | 跳过全部权限确认（高风险） |
crushrc 中常用指令：
# 注册本地 Ollama 并自动发现模型
provider add ollama --type ollama --base-url "http://localhost:11434/v1"
# 放行部分工具，减少确认
permissions allow view edit
# 接入 MCP 服务器
mcp add github --type http --url "https://api.github.com/mcp/" \
--header Authorization "Bearer $GH_PAT"调用与兼容性
# Homebrew
brew install charmbracelet/tap/crush
# npm
npm install -g @charmland/crush
# Go
go install github.com/charmbracelet/crush@latest
# Windows
winget install charmbracelet.crush
scoop install crush供应商覆盖 Anthropic、OpenAI、Gemini、OpenRouter、Groq、Cerebras、Moonshot、MiniMax、Z.ai、Bedrock、Azure OpenAI、Vertex AI，以及 Ollama / LM Studio / llama.cpp / LiteLLM 等本地或自托管推理。调用 $OPENAI_API_KEY、$ANTHROPIC_API_KEY、$GEMINI_API_KEY 等环境变量即可接入。
版本与更新注意
- 许可证需注意：Crush 采用 FSL-1.1-MIT（Functional Source License），源码可见但限制竞品商用，发布满两年后自动转为 MIT。它不是 OSI 意义上的开源许可，商业选型前请确认适用性。GitHub API 的 license 字段显示为
Other / NOASSERTION，以仓库LICENSE.md为准。 - 配置格式正在迁移：新的
crushrc（Bash 风格）是推荐方式，旧的crush.json仍可用但已标记为 deprecated。 - Crush 默认会收集匿名使用指标（仅元数据，不含 prompt 与响应），可用
export CRUSH_DISABLE_METRICS=1或DO_NOT_TRACK=1关闭。 - 默认模型列表由社区维护的 Catwalk 提供，可自动更新，也可用
option provider-auto-update false关闭。 - 无独立产品官网，
charm.land/crush会 302 跳转到 GitHub 仓库。
选型建议
- 已经在用 Charm 生态（Glow、Gum、VHS 等）或看重终端视觉体验 → Crush 是最顺手的一个。
- 需要 LSP 提供重命名、跳转、诊断级别的代码语义 → Crush 的优势明显。
- 需要 MCP、Agent Skills、本地模型接入 → 开箱可用，配置成本低。
- 若强制要求 OSI 认证的开源许可 → 应选 OpenCode（MIT）或 Pi（MIT），Crush 的 FSL 许可不满足。