Crush

Crush 是 Charm 团队的终端 AI 助手，TUI 体验非常顺滑。

在配置前请先准备好 PrimeRouter API Key（参考 通用准备）。

安装

macOS（Homebrew）

brew install charmbracelet/tap/crush

Linux / Windows（Go）

go install github.com/charmbracelet/crush/cmd/crush@latest
# 确保 $GOPATH/bin 在 PATH 里

Windows（Scoop）

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

验证：

crush --version

配置文件位置

系统	配置文件路径
macOS	~/.config/crush/crush.json
Linux	~/.config/crush/crush.json
Windows	%APPDATA%\crush\crush.json

编辑配置

macOS / Linux

mkdir -p ~/.config/crush
vim ~/.config/crush/crush.json

Windows PowerShell

New-Item -ItemType Directory -Force -Path "$env:APPDATA\crush" | Out-Null
notepad "$env:APPDATA\crush\crush.json"

写入：

{
  "$schema": "https://charm.land/crush.json",
  "providers": {
    "primerouter": {
      "type": "openai",
      "base_url": "https://primerouter.ai/v1",
      "api_key": "sk-你的primerouter-key",
      "models": [
        {
          "id": "claude-sonnet-4-6",
          "name": "Claude Sonnet 4.6",
          "context_window": 200000,
          "default_max_tokens": 8192
        },
        {
          "id": "claude-opus-4-6",
          "name": "Claude Opus 4.6",
          "context_window": 200000,
          "default_max_tokens": 8192
        },
        {
          "id": "claude-opus-4-7",
          "name": "Claude Opus 4.7",
          "context_window": 200000,
          "default_max_tokens": 8192
        }
      ]
    }
  }
}

启动

crush
# 进入 TUI 后按 Ctrl+P 选模型 → primerouter/claude-sonnet-4-6

优化建议

• Crush 支持多模型同时挂载，可以同时把 Claude 系列 + DeepSeek / Qwen 都接进来，按任务切换
• default_max_tokens 不要设太低，否则长响应被截断
• 终端窗口建议 100x30 以上，TUI 才有展开空间