Claude Desktop
用 VibeCLI 把 VibeAPI 配置进 Claude 桌面端的第三方推理模式：模型列表与 1M、官方登录入口、Windows 注册表、怎么验证、为什么这样设计
前提：Claude Desktop 2.2553.0 及以上；令牌能用 Claude 模型。
配置
下面的命令里，把 sk-xxx 换成你的令牌。令牌能用 Claude 模型时，setup 在 macOS 和 Windows 上会一起配置桌面端；桌面端还没安装也会先写好配置，安装后打开即可使用：
vibecli setup --key sk-xxx只让桌面端使用这个令牌：
vibecli setup --desktopkey sk-xxx保留 Claude.ai 账号登录入口：
vibecli setup --desktopkey sk-xxx --claude-official on打开菜单配置：
vibecli config claude-desktop配置完成后要完全退出 Claude Desktop 再打开，只关窗口不够。VibeCLI 检测到桌面端正在运行时，会问你是否由它来重启。
写了什么
VibeCLI 在桌面端「第三方推理」的本地配置库里，新建并选中一条名为 VibeAPI 的配置：
| 内容 | 写入 |
|---|---|
| 推理方式 | 网关（gateway），地址是 VibeAPI 根地址，凭据是你的令牌 |
| 模型列表 | 这个令牌能用的 Claude 模型，第一个是默认模型；支持 1M 的标上 1M |
| 官方登录入口 | 默认隐藏 Claude.ai 登录（--claude-official on 保留） |
| 功能开关 | 网页抓取、工具搜索、内置浏览器、扩展、SSH 远程会话、导入导出、MCP 超时等，默认打开；只在你没设置过时写入 |
你自己在桌面端保存的其它配置都保留。移除时，选中项会交还给你原来的配置。
配置库位置：macOS ~/Library/Application Support/Claude-3p/，Windows %LOCALAPPDATA%\Claude-3p\，Linux ~/.config/Claude-3p/。
验证
- 完全退出并重新打开 Claude Desktop。
- 设置里的推理方式显示为第三方网关，选中的是
VibeAPI。 - 模型菜单里是这个令牌能用的 Claude 模型，支持 1M 的显示 1M。
- 发一句话，能正常回复即配置完成。
聊天记录
第三方推理模式下，聊天记录只存在这台电脑上。VibeCLI 默认打开了导入导出：在 Settings → Import & export → Export… 导出成 zip，换电脑后在 Import… 里选它导回去；claude.ai 网页上的历史也能从这里导入。步骤见导出与迁移聊天记录。
为什么这样设计
写本地配置，不用托管配置不需要管理员，不锁设置
托管配置要管理员或 root 权限才能安装，安装后设置窗口会被锁住；本地配置在三个平台上都不需要额外操作。
模型列表按令牌生成不是固定三个
写入这个令牌能用的 Claude 模型，数量随令牌的分组变化，不是固定的三个。
不写国产模型桌面端会拦截桌面端会剔除非 Anthropic 厂商的模型名，并弹出「配置需要注意」，所以国产模型只写进 Claude Code。
默认隐藏官方登录避免误登官方账号登录官方账号后，请求不再经过 VibeAPI。需要在两边切换的，用
--claude-official on。功能开关默认打开你改过的不动只在你没设置过时打开；关闭遥测的设置保持不变。打开 SSH 远程会话后，令牌会被带到你选的远程主机上。
Windows 的注册表兼容老用户
注册表策略存在时，桌面端不读本地配置，普通权限也改不了它（以前从网关页面下载 .reg 的用户就有这一层）。需要删除旧值时，VibeCLI 会问你一次，再弹一次管理员确认。「不能确定」包括还没安装桌面端、应用商店版还没启动过。仍然不生效，用
vibecli setup --desktop-registry on固定写注册表。
排障
| 现象 | 原因 | 处理 |
|---|---|---|
| 重开后仍不是 VibeAPI | 只关了窗口，没有完全退出；或有托管配置 | 从托盘 / 菜单栏完全退出再打开；运行 vibecli doctor 检查托管配置 |
| Windows 上始终不生效 | 注册表里有旧的 .reg 配置 | 运行 vibecli setup --desktopkey <你的令牌>，按提示确认，在系统弹窗里点击「是」；仍不生效用 --desktop-registry on |
报 ERR_CERT_AUTHORITY_INVALID | 当前网络把域名解析到了别的服务器 | 运行 vibecli base auto 换到备用地址；或换网络、改用公共 DNS |
| 提示「配置需要注意」 | 配置里有桌面端不接受的模型名 | 重新运行 vibecli setup --desktopkey <你的令牌>，VibeCLI 不写国产模型 |
| 模型菜单里没有 1M | 你的分组没有给这个模型开启 1M | 在控制台查看分组说明 |
setup --key 跳过了桌面端 | 在 Linux 上且没有安装桌面端（Linux 上只配置已安装的），或令牌不能用 Claude 模型 | 在 macOS / Windows 上运行，或换一个能用 Claude 模型的令牌 |
移除
运行 vibecli config claude-desktop remove，或在 vibecli config claude-desktop 的菜单里选「移除」：删掉 VibeAPI 这条配置，并把选中项交还给你原来的配置；Windows 上同时清掉 VibeCLI 写过的注册表值。
只删模型列表、让桌面端自动发现模型：
vibecli config claude-desktop clear-model最后更新于