Crush：终端里的 AI 编程助手

项目简介

Crush 是一款运行在终端里的 AI 编程助手，由 Charm 团队开发。它把你的工具、代码与工作流接入所选的 LLM，让你在熟悉的终端中与模型协作写代码。该项目使用 Go 编写，构建于 Charm 生态之上。

主要功能

• 多模型：可选多种 LLM，也可通过 OpenAI 或 Anthropic 兼容 API 添加自己的提供方
• 灵活切换：在同一会话中切换模型，并保留上下文
• 基于会话：每个项目可维护多个工作会话与上下文
• LSP 增强：像你一样借助 LSP 获取额外上下文
• 可扩展：通过 MCP 添加能力，支持 http、stdio 和 sse
• 跨平台终端：在 macOS、Linux、Windows（PowerShell 和 WSL）、Android、FreeBSD、OpenBSD、NetBSD 上都有良好支持

安装与使用

使用包管理器安装：

brew install charmbracelet/tap/crush
npm install -g @charmland/crush

也可以用 Go 安装：

go install github.com/charmbracelet/crush@latest

Windows 用户可用 Winget 或 Scoop；Arch Linux、Nix、FreeBSD、Debian/Ubuntu、Fedora/RHEL 等平台也有对应的安装方式，或直接从 Releases 下载二进制与软件包。

上手最快的方式是在模型选择器中选一个 Hyper 模型，按提示完成认证即可。也要以使用其他提供方：按 <kbd>ctrl+l</kbd> 打开模型选择器，选中提供方并粘贴 API key；或者直接设置环境变量，例如 HYPER_API_KEY、ANTHROPIC_API_KEY、OPENAI_API_KEY、GEMINI_API_KEY、OPENROUTER_API_KEY 等。

配置使用 crushrc，它就是带有 Crush 内建命令的 Bash，因为它内置了 Bash 解释器，在所有平台上行为一致。例如：

provider add ollama --type ollama --base-url "http://localhost:11434/v1"
model add ollama/llama3.3 --name "Llama 3.3" --context-window 128000
permissions allow view edit

配置文件按优先级加载：./.crushrc、./crushrc、~/.config/crush/crushrc（Windows 为 %USERPROFILE%\.config\crush\crushrc）。Crush 也内置了用于配置自身的技能，通常直接告诉它要改什么即可。

注意事项

• Crush 默认的模型列表由 Catwalk 维护，这是一个社区支持的开源仓库，欢迎贡献新的提供方与模型。
• 除云端服务外，Crush 也能接入本地模型，具体见 README 中的 Local Models 与 Custom Providers 章节。
• crushrc 中的命令会直接执行，添加第三方提供方或 MCP 服务前请确认来源可信。

---

本作品整理自 GitHub 开源项目 charmbracelet/crush，原作者 @charmbracelet。中文介绍由 AI 根据项目 README 整理，以原仓库为准。