vibecli 操作指南 · 2026-09-14

用 vibecli 一条命令， 让 Claude Desktop 走 VibeAPI

不用下载配置文件、不用安装描述文件、不用管理员权限。vibecli 0.0.46 起直接写入 Claude 桌面端的本地配置， 把这把 Key 能使用的全部 Claude 模型一并列进模型选择器，重启桌面端即生效。

macOS / Windows 全部 Claude 模型 1M 上下文自动标记 --force 一键重置
查看操作
01

平台令牌管理 · 生成 Claude 分组 Key

先在 vibeapi.cn 建一把令牌。 分组要选带 Claude 模型的分组——桌面端只认 Claude 模型，选到 GPT 等其他分组，vibecli 会提示该 Key 没有 Claude 模型并跳过。 已经在用 Claude Code 的用户，同一把 Key 可以直接复用。

01
进 vibeapi 控制台 · 令牌管理 · 添加令牌

登录 vibeapi.cn，导航到 控制台 → 令牌管理，点右上角「添加令牌」，令牌分组选一个包含 Claude 模型的分组，其他参数默认即可。

vibeapi 控制台 · 令牌管理
vibeapi 控制台 · 令牌管理 · 点右上角「添加令牌」
02
令牌创建成功 · 复制 sk-xxx

回到令牌列表复制这条令牌的 sk-xxx——下面命令里的「你的Key」都填它。

令牌创建成功 · 复制 key
令牌创建成功 · 复制这条令牌

分组决定模型清单：vibecli 会按这把 Key 实际能访问的 Claude 模型生成桌面端的模型列表。分组里有 Fable 5.1 / Opus 5 就会出现，没有就不出现；哪些型号支持 1M 上下文也按您所在分组的配置自动标记，不需要手工维护。

02

安装 Claude Desktop，升级 vibecli

1
安装 Claude Desktop 桌面端从 下载中心 取 macOS / Windows 安装包（国内高速镜像），安装后先打开一次再关掉，让它生成自己的数据目录。
2
确认 Node.js 版本不低于 20已经正常使用 vibecli 的用户直接升级即可。
3
之前装过桌面助手页面下载的描述文件 / .reg？macOS 请先在「系统设置 → 隐私与安全性 → 描述文件」里移除 Claude Desktop 那条；否则桌面端会优先使用描述文件、忽略 vibecli 写入的配置。Windows 不需要处理，vibecli 会直接更新同一处注册表。
升级到最新版 vibecli 0.0.46+
npm i -g @vibeapi/cli@latest
03

一条命令配置 Claude Desktop

只配置桌面端，运行这一条（请先完全退出 Claude Desktop）：

Claude Desktop 专用 Key 推荐
vibecli setup --desktopkey 你的Key
同一把 Key 配置全部工具vibecli 探测到 Key 有 Claude 模型、且这台电脑装了 Claude Desktop，会把桌面端和 Claude Code 一起配好。
vibecli setup --key 你的Key
保留 Claude.ai 官方账号登录入口默认隐藏官方登录、只走 VibeAPI 网关；加上这个参数可以在网关与自己的 Claude.ai 账号之间切换。
vibecli setup --desktopkey 你的Key --claude-official on
已配置过，只想切换官方登录开关复用已保存的 Key 原地重新应用，不用再输入。off = 隐藏，on = 显示。
vibecli setup --claude-official off

命令执行完会打印实际写入的模型清单，例如 Opus 4.8 (1M), Opus 5 (1M), Fable 5.1 (1M), Sonnet 5 (1M), Haiku 4.5 …，括号里的 (1M) 表示该型号在您的分组里开放 1M 上下文。看到这行就说明写入成功。

04

重启桌面端，检查生效

Claude Desktop 只在启动时读取配置：请完全退出（macOS 按 ⌘Q，Windows 右下角托盘图标右键退出）再重新打开。打开后不需要登录，直接进入对话界面，模型选择器里就是您分组里的全部 Claude 模型。

查看配置状态确认 Claude Desktop 已检测到并已写入。
vibecli status
模型更新了，重新拉一次清单分组新增了型号时重跑即可，Key 不用重输。
vibecli config claude-desktop --non-interactive
05

配置改坏了？一键重置为推荐配置

自行编辑过配置文件、桌面端打不开或提示配置无效时，不用手工找文件——--force 会先把原文件快照，再整份删掉并用推荐配置重写。适用于 vibecli 支持的全部工具，不只是桌面端。

强制重置 Claude Desktop 原文件自动快照
vibecli config claude-desktop --force
连同 Key 一起重新配置换 Key 的同时重置，一步到位。
vibecli setup --desktopkey 你的Key --force
重置搞错了？撤销退回到重置前的那份文件（快照保留最近 10 份）。
vibecli config claude-desktop restore

不加 --force 时是安全合并：只改 VibeAPI 相关字段，您在桌面端里保存的其他配置原样保留；遇到已经不是合法 JSON 的文件会拒绝写入并提示。--force 是给「已经坏了、只想恢复可用」的情况准备的，重置后您自行添加的字段会丢失，但可以随时 restore。

06 · 常见问题与边界

写的是桌面端自己的本地配置，不是描述文件

vibecli 写入 Claude Desktop 的「第三方推理」本地配置库（macOS ~/Library/Application Support/Claude-3p/，Windows %LOCALAPPDATA%\Claude-3p\），Windows 上同时写入用户注册表 HKCU\SOFTWARE\Policies\Claude 作为兜底。

✓ 不需要管理员权限，不用安装描述文件 ✓ 只维护一条名为 VibeAPI 的配置，您自己保存的其他配置不受影响 ✓ 每次写入前自动快照，restore 可撤销 ✓ 移除配置：向导里选「移除配置」，桌面端恢复原状
Claude Desktop 官方配置参考

重启后仍是旧配置？请确认已完全退出桌面端（不是关窗口），以及 macOS 上没有残留的 Claude Desktop 描述文件；vibecli 检测到描述文件时会在命令输出里明确提示。

命令已复制