Crush

Crush 既是一款在终端中运行的 CLI + TUI AI 编程工具，也支持多种模型接入，能够在命令行环境下完成代码生成、调试、对话、文件操作与多任务处理等工作。

使用 WisGate 时，配置 API 端点 https://api.wisgate.cn/v1 即可。

一、安装 Crush

根据您的系统选择对应的安装方式：

Homebrew（macOS 推荐）：

brew install charmbracelet/tap/crush

NPM（跨平台）：

npm install -g @charmland/crush

二、配置 WisGate 模型

1. 获取 API 密钥

在 WisGate 控制台中创建并获取您的 API Key。

2. 启动 Crush 并选择模型

crush

在模型选择界面中，选择您需要的模型（如：gpt-5.5）

3. 输入 API 密钥

在提示界面中输入您的 WisGate API Key。

4. 修改 Crush 配置

配置文件位置：

• macOS/Linux：~/.config/crush/crush.json
• Windows：%USERPROFILE%\.config\crush\crush.json

{
  "providers": {
    "wisgate": {
      "id": "wisgate",
      "name": "WisGate Provider",
      "base_url": "https://api.wisgate.cn/v1",
      "api_key": "your_wisgate_api_key"
    }
  }
}

配置完成后，重启 Crush 应用，通过 /models 命令选择指定模型。

三、使用场景

• 终端内编码：在项目目录中通过 TUI 直接处理代码生成和修改。
• 文件操作：让 Crush 读取项目上下文并辅助编辑文件。
• 调试排错：结合命令行输出、日志和测试结果生成修复建议。
• 多任务处理：把复杂开发需求拆分成多个终端内任务逐步完成。

常见问题

/models 中没有看到配置的模型

请确认配置文件路径正确、JSON 格式有效，并重启 Crush。

API 调用失败

请确认 base_url 为 https://api.wisgate.cn/v1，api_key 已替换为 WisGate 控制台创建的 API Key。