WorkBuddy 接入 Crazyrouter 自定义模型：一条 PowerShell 命令搞定配置

最近不少人开始用 WorkBuddy 做日常开发辅助，比如让它帮忙看代码、解释报错、整理文档、写脚本。WorkBuddy 本身支持自定义模型，但第一次配置时，很多人会卡在 models.json 上。

典型问题是：

• 不知道配置文件在哪；
• 不知道 url 要不要写 /v1；
• 不知道模型 ID 怎么填；
• API Key 写进去后怕泄漏；
• 手动改 JSON 容易少逗号；
• 改坏了不知道怎么恢复。

如果只是试一次，手动改也能凑合。但如果要批量写入多个模型，或者以后经常更新配置，用脚本会稳很多。

这篇文章就用一个开源 PowerShell 脚本演示：如何把 WorkBuddy 一键配置到 Crazyrouter 自定义模型。

脚本地址：

https://github.com/xujfcn/workbuddy-crazyrouter

---

一、最终效果是什么？

执行脚本后，它会自动写入 WorkBuddy 实际读取的配置文件：

%USERPROFILE%\.workbuddy\models.json

写入完成后，重启 WorkBuddy，就可以在模型列表里看到 Custom / 自定义模型。

默认会配置下面几个模型：

claude-opus-4-8
claude-opus-4-7
claude-sonnet-4-6
gpt-5.5
gpt-5.4

接口地址会使用：

https://cn.crazyrouter.com/v1

注意：如果你传给脚本的是：

https://cn.crazyrouter.com

脚本会自动补成：

https://cn.crazyrouter.com/v1

这样可以减少很多因为少写 /v1 导致的连接失败。

---

二、最快使用方式

打开 Windows PowerShell，执行：

iwr https://raw.githubusercontent.com/xujfcn/workbuddy-crazyrouter/main/setup-workbuddy-crazyrouter.ps1 -UseB | iex

执行后，脚本会提示你输入 Crazyrouter API Key。

API Key 只会写入本机的 WorkBuddy 配置文件：

%USERPROFILE%\.workbuddy\models.json

不会上传到其它地方。

执行完成后，记得：

1. 完全退出 WorkBuddy；
2. 重新打开 WorkBuddy；
3. 在模型列表中选择 Custom / 自定义模型。

很多人配置完没生效，原因就是没有完全重启 WorkBuddy。

---

三、不想交互输入 API Key 怎么办？

如果你不想在脚本运行时手动输入，可以先设置环境变量：

$env:CRAZYROUTER_API_KEY="sk-你的CrazyrouterKey"

然后再执行：

iwr https://raw.githubusercontent.com/xujfcn/workbuddy-crazyrouter/main/setup-workbuddy-crazyrouter.ps1 -UseB | iex

脚本会自动读取当前 PowerShell 会话里的 CRAZYROUTER_API_KEY。

这里要注意：这个环境变量只在当前 PowerShell 窗口中有效。关闭窗口后就没了。

---

四、不放心远程执行？可以下载后本地运行

很多人看到 | iex 会担心安全问题，这个担心是正常的。

更稳妥的做法是先下载脚本：

iwr https://raw.githubusercontent.com/xujfcn/workbuddy-crazyrouter/main/setup-workbuddy-crazyrouter.ps1 -OutFile setup-workbuddy-crazyrouter.ps1

然后用编辑器打开 setup-workbuddy-crazyrouter.ps1，确认脚本内容。

确认没问题后，再本地执行：

.\setup-workbuddy-crazyrouter.ps1 -BaseUrl "https://cn.crazyrouter.com"

如果你已经设置了环境变量：

$env:CRAZYROUTER_API_KEY="sk-你的CrazyrouterKey"
.\setup-workbuddy-crazyrouter.ps1 -BaseUrl "https://cn.crazyrouter.com"

脚本会把 Base URL 规范成：

https://cn.crazyrouter.com/v1

---

五、脚本到底改了什么？

脚本主要做 6 件事。

1. 找到 WorkBuddy 配置文件

路径是：

%USERPROFILE%\.workbuddy\models.json

PowerShell 里对应：

$HOME\.workbuddy\models.json

如果 .workbuddy 目录不存在，脚本会自动创建。

---

2. 修改前自动备份

如果原来已经有 models.json，脚本会先生成备份：

models.json.bak.20260605-140000

这样即使新配置不合适，也可以恢复。

恢复方式也很简单：

1. 关闭 WorkBuddy；
2. 删除当前 models.json；
3. 把备份文件改名为 models.json；
4. 重新打开 WorkBuddy。

---

3. 读取原有自定义模型

脚本不是粗暴覆盖配置，而是会先读取已有模型。

默认情况下，它会保留原来的其它自定义模型，只更新本次要写入的模型。

这样做的好处是：你之前配置的其它模型不会被误删。

---

4. 自动补 /v1

很多 OpenAI 兼容接口都要求地址带 /v1。

所以脚本会做这件事：

$normalized = $Url.Trim().TrimEnd("/")
if ($normalized -notmatch "/v1$") {
    $normalized = "$normalized/v1"
}

也就是说：

https://cn.crazyrouter.com

会变成：

https://cn.crazyrouter.com/v1

---

5. 按模型 ID 去重

如果你重复执行脚本，或者模型列表里重复写了同一个 ID，脚本会去重。

这比手动复制 JSON 安全很多。

手动复制很容易出现：

claude-opus-4-8
claude-opus-4-8
claude-opus-4-8

脚本会避免这种重复写入。

---

6. 写入新的模型配置

最终写入的模型结构类似这样：

{
  "id": "claude-opus-4-8",
  "name": "claude-opus-4-8",
  "vendor": "Custom",
  "url": "https://cn.crazyrouter.com/v1",
  "apiKey": "sk-xxx",
  "supportsToolCall": true,
  "supportsImages": false,
  "supportsReasoning": false,
  "useCustomProtocol": false
}

这里的 apiKey 是你自己的 Key，不要截图发到公开平台。

---

六、想清理旧配置怎么办？

如果你之前已经配置过很多 Crazyrouter 相关模型，想重新整理一遍，可以用：

.\setup-workbuddy-crazyrouter.ps1 -BaseUrl "https://cn.crazyrouter.com" -ReplaceCrazyrouter

-ReplaceCrazyrouter 的作用是：删除旧的同类配置，只保留本次写入的模型。

适合这些情况：

• 模型重复太多；
• 之前接口地址写错；
• 想重新整理模型列表；
• 想统一切到 https://cn.crazyrouter.com/v1。

---

七、想改默认模型列表怎么办？

默认模型列表是：

claude-opus-4-8
claude-opus-4-7
claude-sonnet-4-6
gpt-5.5
gpt-5.4

如果你想改成自己的模型，可以这样执行：

.\setup-workbuddy-crazyrouter.ps1 `
  -BaseUrl "https://cn.crazyrouter.com" `
  -Models "claude-sonnet-4-6", "gpt-5.5"

这样只会写入你指定的模型。

---

八、常见问题排查

1. 执行完脚本，WorkBuddy 没有显示模型

优先检查有没有完全退出 WorkBuddy。

建议打开任务管理器，看是否还有 WorkBuddy 进程。

---

2. 调用时报 401

通常是 API Key 错了。

检查：

$env:CRAZYROUTER_API_KEY

或者打开 models.json 看 apiKey 是否写入正确。

不要把真实 Key 发到公开平台。

---

3. 调用时报 404

优先检查 URL。

正确应该是：

https://cn.crazyrouter.com/v1

不要写成：

https://cn.crazyrouter.com/v1/v1

也不要少写 /v1。

---

4. 配置文件被改坏了

找到备份文件：

models.json.bak.20260605-140000

改名回：

models.json

然后重启 WorkBuddy。

---

九、完整命令汇总

一键执行

iwr https://raw.githubusercontent.com/xujfcn/workbuddy-crazyrouter/main/setup-workbuddy-crazyrouter.ps1 -UseB | iex

设置环境变量后执行

$env:CRAZYROUTER_API_KEY="sk-你的CrazyrouterKey"
iwr https://raw.githubusercontent.com/xujfcn/workbuddy-crazyrouter/main/setup-workbuddy-crazyrouter.ps1 -UseB | iex

下载后本地执行

iwr https://raw.githubusercontent.com/xujfcn/workbuddy-crazyrouter/main/setup-workbuddy-crazyrouter.ps1 -OutFile setup-workbuddy-crazyrouter.ps1
.\setup-workbuddy-crazyrouter.ps1 -BaseUrl "https://cn.crazyrouter.com"

替换旧配置

.\setup-workbuddy-crazyrouter.ps1 -BaseUrl "https://cn.crazyrouter.com" -ReplaceCrazyrouter

自定义模型列表

.\setup-workbuddy-crazyrouter.ps1 `
  -BaseUrl "https://cn.crazyrouter.com" `
  -Models "claude-sonnet-4-6", "gpt-5.5"

---

总结

WorkBuddy 自定义模型的核心，其实就是维护好本地的：

%USERPROFILE%\.workbuddy\models.json

手动改可以，但容易出错。

用 PowerShell 脚本的好处是：

• 自动创建配置文件；
• 自动备份旧配置；
• 自动补 /v1；
• 自动去重；
• 保留旧模型；
• 支持恢复；
• 支持批量写入模型。

如果你只是想快速把 WorkBuddy 接到 Crazyrouter，可以直接用这个开源脚本：

https://github.com/xujfcn/workbuddy-crazyrouter

实际接入地址：

https://cn.crazyrouter.com/v1

建议第一次使用时先下载脚本看一遍，再执行。这样既方便，也更放心。