如何在终端跑通 CrushAI 编程助手从安装到定制的完整路线【免费下载链接】crushGlamourous agentic coding for all 项目地址: https://gitcode.com/gh_mirrors/crush3/crushCrush 是一款跑在终端里的 AI 编程助手它把 LLM大语言模型接入你手头的代码仓库负责读文件、改代码、执行命令全程不离开 shell。本文按实际使用路径展开——先让它在你的机器上跑起来再看日常怎么用最后讲如何按自己的环境定制模型、LSP 和 MCP以及出了问题去哪查日志。Crush 怎么安装各平台的现成渠道不用自己编译。macOS 与 Linux 上 Homebrew 和 npm 最省事Windows 可以走 winget装了 Go 环境的也可直接 go install# macOS / Linux brew install charmbracelet/tap/crush npm install -g charmland/crush # Arch Linux yay -S crush-bin # Nix nix run github:numtide/nix-ai-tools#crush # Windows winget install charmbracelet.crush # 有 Go 环境 go install github.com/charmbracelet/crushlatest挑一条顺手的执行即可装完终端里敲出 crush 命令能识别就算就绪。第一次运行接上模型再开始对话安装后直接运行 crush。启动时从内置模型列表里挑一个提供方按提示填入 API 密钥就能开聊。两个特性值得提前知道同一项目里可以开多路会话、各带各的上下文对话进行到一半切换模型上下文也照样保留不用重新交代背景。日常怎么用内置工具、初始化与权限能直接调用的工具分两类。文件类view 查看文件内容ls 列出目录grep 按模式检索内容edit 修改文件glob 按通配符定位文件系统类bash 执行 shell 命令sourcegraph 做跨仓库的代码搜索。场景对应做法上想让它更快理解项目就对项目做一次初始化它会通读代码库并落盘一份上下文文件之后的会话直接受益有些文件要留在版本库里、却不想被当作上下文就把规则写进 .crushignore它默认已经遵循 .gitignore权限方面默认偏保守每次调用工具前都会先征求许可确认信任后可以配置成部分工具免提示执行减少打断。为 Crush 定制配置文件、LSP、MCP 与自定义模型不写任何配置也能跑。需要定制时配置文件按三级顺序查找项目根目录的 .crush.json、同级的 crush.json再到全局的 $HOME/.config/crush/crush.json排在前面的优先级更高。给 Crush 配置 LSPLSP语言服务器协议提供语法级的代码理解能力挂上之后它能拿到和你 IDE 类似的结构信息。在 lsp 键下按语言声明启动命令即可Go 指向 gopls可用 env 追加 GOTOOLCHAIN 这类环境变量TypeScript 指向 typescript-language-server 并带 --stdio 参数Nix 用 nil。接入 MCP 服务器MCP模型上下文协议用来给助手挂载外部服务能力。传输方式共三种stdio 跑本地进程http 对接 HTTP 端点sse 走服务端推送事件。自定义接入与本地模型providers 键支持 OpenAI 兼容type 填 openai-compat与 Anthropic 兼容两种接口。以 DeepSeek 为例base_url 指向 https://api.deepseek.com/v1api_key 引用环境变量 $DEEPSEEK_API_KEY模型侧的字段包括 id、name、cost_per_1m_in 与 cost_per_1m_out每百万 token 的输入/输出价格、context_window 和 default_max_tokens。本地推理服务同样走 OpenAI 兼容通道Ollama 的最小配置长这样{ providers: { ollama: { name: Ollama, base_url: http://localhost:11434/v1/, type: openai-compat, models: [ { name: Qwen 3 30B, id: qwen3:30b, context_window: 256000, default_max_tokens: 20000 } ] } } }排查问题Crush 日志怎么看运行日志写在项目目录下的 ./.crush/logs/crush.logCLI 自带三个顺手命令crush logs # 回看最近 1000 行 crush logs --tail 500 # 只看最后 500 行 crush logs --follow # 实时跟踪下一步建议跑通后先做一次项目初始化让上下文文件先生成出来熟悉流程后把 view、ls、grep 这类只读工具设为免提示执行明显减少打断配置不生效或模型报错时先看 crush logs 的输出再逐步排查想深入细节配置文件逐项说明见 docs/config/README.mdhooks 的示例脚本在 docs/hooks/ 里可以照着改成自己的。【免费下载链接】crushGlamourous agentic coding for all 项目地址: https://gitcode.com/gh_mirrors/crush3/crush创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
