Crush 终端 AI 编程助手从安装到多模型配置只需一个 crushrc【免费下载链接】crushGlamourous agentic coding for all 项目地址: https://gitcode.com/gh_mirrors/crush3/crushCrush 是 Charm 团队用 Go 开发的开源终端 AI 编程助手它在终端里接入 LLM并给模型配上读代码、改文件、跑命令的工具。如果你习惯在终端里完成日常工作又不想被单一模型绑定Crush 可以让你在 Anthropic、OpenAI、Gemini、Bedrock 或本地 Ollama 模型之间自由切换同时保留会话上下文。它解决什么问题大多数 AI 编程工具要么把上下文锁在网页 IDE 里要么绑定某一家模型 API。Crush 的思路是反过来终端本身是宿主环境模型只是可替换的大脑。具体来说模型与工具解耦同一个项目里上午用推理型大模型做架构讨论下午切到便宜模型做批量重命名上下文不丢。代码智能来自 LSPCrush 和你共用同一套语言服务器gopls、typescript-language-server 等拿到的跳转、符号、诊断信息与 IDE 一致。会话按项目持久化每个项目维护多路工作会话存在本地 SQLite 中重启终端后可以从会话管理器里继续。能力可插拔通过 MCP 服务器stdio/http/sse三种传输、hooks 脚本和 Agent Skills 扩展行为而不需要改代码。核心能力速览多模型接入预置 Anthropic、OpenAI、Gemini、OpenRouter、Bedrock 等厂商也支持通过 OpenAI 兼容或 Anthropic 兼容 API 挂任意服务商。会话内切换模型按ctrll打开模型选择器切换 LLM 的同时保留当前对话。内置工具集view、ls、grep、glob、edit、bash、sourcegraph等覆盖文件浏览、检索、编辑与命令执行。权限管控工具调用默认先征求许可可按工具白名单放行或整体禁用支持完全跳过提示的--yolo模式慎用。多平台一等公民macOS、Linux、WindowsPowerShell 与 WSL、FreeBSD、OpenBSD、NetBSD、Android 均可直接运行。如何在终端安装并启动 Crush主流安装方式三选一# HomebrewmacOS / Linux brew install charmbracelet/tap/crush # NPM跨平台 npm install -g charmland/crush # 或用 Go 直接安装 go install github.com/charmbracelet/crushlatestWindows 用户可用winget install charmbracelet.crush。启动很简单进入项目目录运行crush。首次启动时最快的路径是在模型选择器里选一个 Hyper 模型Charm 官方提供的订阅制服务商零数据留存按提示完成认证即可开工。如果用自己的 API key按ctrll打开模型选择器选择厂商后粘贴 key也可以直接设置环境变量例如OPENAI_API_KEY、ANTHROPIC_API_KEY、GEMINI_API_KEY、OPENROUTER_API_KEYCrush 启动时会自动识别。最小配置认识 crushrcCrush 不做任何配置也能跑但一旦要定制核心就是crushrc文件。它不是 JSON而是一段带 Crush 内置命令的 Bash 脚本可以写条件、source其他文件、从密码管理器取密钥。配置查找优先级数字小者优先优先级Unix 系Windows1./.crushrc项目级隐藏文件.\.crushrc2./crushrc项目级.\crushrc3~/.config/crush/crushrc全局%USERPROFILE%\.config\crush\crushrc旧版crush.json仍受支持但已标记为弃用新功能只会落在crushrc上。详见 配置文档。挂一个自定义模型例如 DeepseekOpenAI 兼容 APIprovider add deepseek --type openai-compat \ --base-url https://api.deepseek.com/v1 \ --api-key $DEEPSEEK_API_KEY model add deepseek/deepseek-chat \ --name Deepseek V3 \ --context-window 64000 \ --price-input 0.27 --price-output 1.1接本地模型则更省事ollama、llamacpp、lmstudio、litellm、omlx五种类型支持自动发现模型列表不用手写 modelsprovider add ollama --name Ollama --type ollama \ --base-url http://localhost:11434/v1配置完成后ctrll的选择器里就能看到新模型。注意crushrc会以完整 shell 身份执行属于可信代码不要在没审查过的项目目录里启动 Crush。关键工作流LSP、权限与 MCPLSP 增强。什么时候需要当你希望模型改代码时能感知跳转和诊断。怎么配lsp add go --command gopls --env GOTOOLCHAIN go1.24.5 lsp add typescript --command typescript-language-server --args --stdio效果模型决策时能拿到与你相同的符号、定义与调用关系信息跨文件修改更准确。工具权限。什么时候需要日常高频使用、不想每条命令都点确认。怎么配permissions allow view ls grep edit # 白名单放行 permissions deny bash sourcegraph # 或直接对模型隐藏效果放行的工具静默执行被 deny 的工具从模型的工具列表中消失。极端情况下可用--yolo跳过所有权限提示适合沙箱环境生产代码库慎用。MCP 扩展。什么时候需要要把外部系统API、内部工具暴露给模型。怎么配支持stdio、http、ssemcp add github --type http \ --url https://api.githubcopilot.com/mcp/ \ --header Authorization Bearer $GITHUB_PAT需要 OAuth 的 HTTP/SSE 服务器可加oauth: true走内置授权码流程还可以用--disabled-tools屏蔽个别危险工具。实用技巧与排障切换模型会话中随时按ctrll更换 provider/模型上下文保留。忽略文件默认遵守.gitignore想把某些文件排除在上下文外但仍纳入版本控制在仓库根目录加.crushignore语法与.gitignore相同。项目初始化让 Crush 初始化项目它会分析代码库并生成AGENTS.md上下文文件记录构建命令与代码约定后续会话直接受益。跨项目的个人规则可写进~/.config/crush/CRUSH.md。Hooks以 shell 脚本拦截 agent 生命周期事件如PreToolUse可以阻断危险命令、改写工具输入、在模型上下文里注入提醒。示例与完整协议见 hooks 文档。查看日志日志写在项目下的./.crush/logs/crush.log。crush logs输出最后 1000 行crush logs --tail 500自定义行数crush logs --follow实时跟踪排障时加--debug启动或在 crushrc 里option debug true。提供商模型列表Crush 默认从开源数据库 Catwalk 自动更新模型列表。受限网络下用option provider-auto-update false关闭或手动执行crush update-providers拉取。复制粘贴失效Linux/BSD 上 Wayland 需要wl-copy/wl-pasteX11 需要xclip或xsel装上即好。会话管理crush sessions可列出、查看、重命名、删除会话crush run执行单次非交互提示适合脚本化场景。想深入理解实现可以看 内置工具源码 和 配置加载逻辑。适合谁下一步做什么Crush 适合这样一批人长期待在终端里、希望把多家 LLM含本地模型纳入日常编码流程、并且在意会话持久化与权限可控的开发者。下一步建议按顺序做三件事安装后用ctrll接好第一个模型在项目里写一个crushrc加上当前语言的 LSP 和常用工具的permissions allow让 Crush 初始化项目生成AGENTS.md然后开始正常结对编程。【免费下载链接】crushGlamourous agentic coding for all 项目地址: https://gitcode.com/gh_mirrors/crush3/crush创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考