Crush 快速上手：安装、选择模型和基本配置

各系统安装 Crush 的命令、用模型选择器或环境变量接入服务商、crushrc 配置文件的位置和写法，以及安全方面要注意的事。

安装

用包管理器：

# Homebrew
brew install charmbracelet/tap/crush

# npm
npm install -g @charmland/crush

# Arch Linux
yay -S crush-bin

# FreeBSD
pkg install crush

Windows：

# Winget
winget install charmbracelet.crush

# Scoop
scoop bucket add charm https://github.com/charmbracelet/scoop-bucket.git
scoop install crush

Debian / Ubuntu：

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.charm.sh/apt/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg
echo "deb [signed-by=/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/ * *" | sudo tee /etc/apt/sources.list.d/charm.list
sudo apt update && sudo apt install crush

也可以到 GitHub Releases 下载二进制，或者用 Go 安装：

go install github.com/charmbracelet/crush@latest

启动并选择模型

crush

首次启动会让你选模型：

最快的方式：选一个 Hyper 模型，按步骤完成认证。Hyper 是 Charm 官方的订阅服务，有免费档
用自己的 Key：按 ctrl+l 打开模型选择器，选择服务商，粘贴 API Key

也可以提前设置环境变量，Crush 会自动识别。常用的几个：

环境变量	服务商
`ANTHROPIC_API_KEY`	Anthropic
`OPENAI_API_KEY`	OpenAI
`GEMINI_API_KEY`	Google Gemini
`OPENROUTER_API_KEY`	OpenRouter
`ZAI_API_KEY`	Z.ai
`MINIMAX_API_KEY`	MiniMax
`MOONSHOT_API_KEY`	Moonshot
`CEREBRAS_API_KEY`	Cerebras
`GROQ_API_KEY`	Groq
`VERCEL_API_KEY`	Vercel AI Gateway

完整列表见仓库的 README。

常用按键

按键	作用
`ctrl+l`	打开模型选择器
`ctrl+p`	打开命令面板（切换模型、主题等）

配置文件

Crush 不配置也能用。需要定制时，写一个 crushrc。它就是一段 Bash，外加一些 Crush 专用的内置命令；Crush 自带 Bash 解释器，所以在 Windows 上写法也一样。

~/.config/crush/crushrc

# 自动批准一些工具
permissions allow view edit

# 添加一个 MCP 服务器
mcp add github \
  --type http \
  --url "https://api.github.com/mcp/"

按以下优先级查找：

优先级	Unix	Windows
1	`./.crushrc`	`.\.crushrc`
2	`./crushrc`	`.\crushrc`
3	`~/.config/crush/crushrc`	`%USERPROFILE%\.config\crush\crushrc`

旧的 JSON 格式（crush.json）仍然支持，但官方已视为过时。

小技巧：Crush 自带一个「配置自己」的技能，很多时候直接告诉它你想怎么配，它就能改好。

安全提醒

crushrc 和 crush.json 都是受信任的代码：crushrc 在完整的 shell 里运行，crush.json 里的 $(...) 会在加载时执行。

不要在没检查过配置的目录里启动 Crush
不要把网上随便找来的文件 source 进自己的配置

接下来

想接入列表之外的服务商或本地模型，看官方文档。