Crush 使用教程
从入门到精通的完整指南
Crush 简介
Crush是Charmbracelet团队打造的开源终端AI编程助手，使用Go语言编写，提供精美的TUI终端界面。支持Anthropic、OpenAI、Google Gemini等20+模型提供商，可在对话中途无缝切换模型而不丢失上下文。集成LSP语言服务器和MCP扩展协议，支持macOS、Linux、Windows等多平台，是终端原生的AI编码解决方案。
详细功能介绍
【工具简介】
Crush是一款由Charmbracelet团队开发的终端原生AI编程智能体，以精美的TUI界面和广泛的模型兼容性著称。
【核心功能】
①广泛模型支持：兼容Anthropic、OpenAI、Google Gemini、Groq、OpenRouter、Azure OpenAI、AWS Bedrock、Cerebras等20+模型提供商，通过OpenAI/Anthropic兼容API可接入更多服务。
②中途切换模型：支持在对话进行中无缝切换不同的LLM，且不丢失已有上下文，便于对比不同模型效果。
③LSP集成：内置Language Server Protocol支持，像开发者一样获取代码补全、类型检查等语言服务上下文。
④MCP扩展：通过Model Context Protocol服务器（支持stdio、HTTP、SSE传输）扩展工具能力。
⑤多会话管理：支持每个项目维护多个并发工作会话，方便并行处理不同任务。
【适用场景】
①终端编码：在命令行环境中进行AI辅助的代码编写、调试和重构。
②多模型对比：通过中途切换模型功能，对比不同LLM在同一任务上的表现。
③跨平台开发：在macOS、Linux、Windows甚至Android和FreeBSD上统一使用AI编程助手。
【快速入门】
①通过Homebrew（brew install charmbracelet/tap/crush）、npm（npm install -g @charmland/crush）或系统包管理器安装。
②设置首选模型提供商的API密钥环境变量。
③在项目目录中运行 crush 命令启动终端界面。
④如需高级配置，可创建 .crush.json 项目级配置文件设置LSP、MCP服务器等。
【优缺点分析】
优点：
①模型提供商覆盖最广，几乎支持所有主流LLM服务。
②终端原生体验出色，Go语言编写运行流畅。
③通过MCP和LSP双重扩展机制，工具集成能力强。
缺点：
①项目较新（2025年中发布），仍有498个开放Issue，稳定性有待提升。
②高级配置项较多，初始学习曲线较陡。
③纯终端界面，不习惯TUI的用户可能有使用障碍。
【适合人群】
①终端重度用户：偏好命令行工作流、追求效率的开发者和运维人员。
②多模型用户：需要在同一工具中灵活切换和对比不同AI模型的技术人员。
③跨平台开发者：在多种操作系统上工作，需要统一AI编程体验的工程师。
1Crush终端AI编程助手入门教程
入门10分钟
Crush是Charmbracelet团队打造的开源终端AI编程助手，使用Go语言编写，提供精美的TUI终端界面，支持20+模型提供商。
快速开始
1. 访问GitHub仓库github.com/charmbracelet/crush，下载对应系统的安装包
2. macOS用户可使用brew install charmbracelet/tap/crush，Linux用户下载二进制文件并添加到PATH
3. 首次运行crush命令，按提示配置API密钥（如Anthropic API Key）
4. 配置完成后即可进入交互式终端界面开始对话
核心功能演示
功能一：多模型切换
在对话过程中输入/model命令，从列表中选择想要切换的模型（如Claude、GPT-4、Gemini等），切换后之前的对话上下文会保留，可以继续之前的讨论。
功能二：代码分析与修改
在Crush界面中使用/file命令加载项目文件，然后用自然语言描述需求，比如帮我优化这个函数的性能或给这段代码添加错误处理，Crush会直接在终端中展示修改建议和diff对比。
功能三：LSP语言服务器集成
Crush内置LSP支持，当你在对话中讨论代码时，它能理解项目的类型信息和引用关系。在设置中配置好语言服务器路径后，Crush的代码建议会更加精准。
实际使用案例
场景一：代码重构
开发者在维护一个老旧项目时，打开Crush并加载相关文件，描述把这个类拆分成更小的模块，Crush会分析代码结构并给出重构方案，开发者确认后直接应用修改。
场景二：调试排查
遇到一个难以复现的bug，将错误日志粘贴到Crush中，描述帮我分析这个错误可能的原因，Crush结合项目上下文给出排查思路和修复建议。
常见问题
Q：Crush支持哪些操作系统？
A：支持macOS、Linux和Windows，各平台均有对应的安装方式，Windows用户可通过scoop或直接下载exe文件。
Q：切换模型后之前的对话还在吗？
A：在的，Crush的一个核心优势就是模型切换不会丢失上下文，你可以在对话中途随意切换模型继续讨论。
Q：是否需要联网使用？
A：使用云端API（如Anthropic、OpenAI）时需要联网，但如果你配置了Ollama等本地模型，也可以离线使用。
小贴士
1. 善用/model命令尝试不同模型，不同任务适合不同模型，比如Claude擅长长文本分析，GPT-4擅长创意写作
2. 配置MCP扩展协议可以让Crush连接更多外部工具和服务，扩展其能力边界
3. 使用/clear命令清理上下文可以节省token消耗，当话题切换时建议重新开始对话