命令参考

和终端里的 vibecli --help、vibecli <命令> --help 内容一致。

VibeCLI：在 Claude Code、Codex、Grok Build 等编码工具里统一配置 VibeAPI 的令牌和模型。

不带命令运行 vibecli 会打开主菜单。

全局选项

全局选项可以与任何命令一起使用。

命令

配置

诊断

维护

示例

vibecli setup

不进入向导，一条命令写好配置。

--key 先用令牌获取模型列表，按能用的模型配置对应工具（见下表）。

不同分组的令牌用 --claudekey、--codexkey、--grokkey、--desktopkey、--agykey 分别提供。

再次运行即可更换令牌，其他配置保留。

用法

vibecli setup [options]

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

--key 能用的模型和自动配置的工具

何时使用

拿到令牌后第一次配置，或更换令牌、修复改坏的配置时。

前提

• 一个 VibeAPI 令牌（在控制台的「令牌」页新建）
• 工具可以之后再安装：未安装的命令行工具会先写好配置，再询问是否从国内镜像安装（加 --install 直接安装）；Claude Desktop 在 macOS、Windows 上未安装也会提前写好配置，安装后打开即可使用；Linux 版只配置已安装的

替代方式

示例

另见: vibecli setup --help · 命令列表

vibecli init

一步步引导你填写令牌、选择工具并写好配置。

直接运行 vibecli（不带命令）会打开主菜单。

用法

vibecli init [options]

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

何时使用

第一次使用，想一步步回答问题完成配置时。

前提

• 一个 VibeAPI 令牌

替代方式

示例

另见: vibecli init --help · 命令列表

vibecli auth

不带参数：提示你输入令牌。

带令牌：验证后保存到 ~/.vibecli/config.yaml。

用法

vibecli auth [options] [command] [token]

参数

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

命令

何时使用

只想保存、更换或删除令牌，不改动工具配置时。

替代方式

示例

另见: vibecli auth --help · 命令列表

vibecli auth revoke

删除已保存的令牌

用法

vibecli auth revoke [options]

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

示例

另见: vibecli auth revoke --help · vibecli auth · 命令列表

vibecli auth reload

把已保存的令牌重新写入 Claude Code（claude / claude-code）

用法

vibecli auth reload [options] <tool>

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

示例

另见: vibecli auth reload --help · vibecli auth · 命令列表

vibecli config

不带参数：选择一个工具，打开它的配置菜单。

子命令和工具名见下表。

用法

vibecli config [options] [args...]

参数

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

子命令

工具名

何时使用

调整单个工具（更换模型、重写或还原配置），或管理 Profile、模型预设和备份时。

前提

• 写入工具配置前，需要先保存令牌：vibecli auth <你的令牌> 或 vibecli setup --key <你的令牌>

替代方式

示例

另见: vibecli config --help · 命令列表

vibecli base

主域名无法连接或证书报错时，切换到另一个接入地址。

切换后，用 VibeCLI 保存的令牌配置过的工具会一起改到新地址。

用法

vibecli base [options] [target]

参数

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

目标写法

何时使用

工具报告无法连接、超时或证书错误时。

前提

• 保存过令牌时，内置地址和当前地址会用它确认地址确实可用；其他地址，或没有保存令牌时，只测试网关是否在线

替代方式

示例

另见: vibecli base --help · 命令列表

vibecli status

显示当前的令牌和它的余额、接入地址、语言、模型，以及各工具是否已配置。

用法

vibecli status [options]

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

何时使用

想确认现在使用的是哪个令牌、地址和模型时。

替代方式

示例

另见: vibecli status --help · 命令列表

vibecli doctor

检查令牌、余额、网络、代理、已安装的工具和它们的配置，并给出处理办法。

用法

vibecli doctor [options]

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

何时使用

工具报错（401、无法连接、找不到模型）又不清楚原因时。

替代方式

示例

另见: vibecli doctor --help · 命令列表

vibecli bench

用已保存的令牌向当前接入地址请求几次模型列表，统计耗时；加上 --stream 会再发送一条真实的流式请求，查看首字时间和流能否正常结束。

用法

vibecli bench [options]

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

何时使用

感觉变慢，或想查看当前地址的延迟时。

前提

• 已保存令牌（vibecli auth <你的令牌>）

替代方式

示例

另见: vibecli bench --help · 命令列表

vibecli logs

日志按天保存在 ~/.vibecli 目录。出现问题时，可以把 tail 的输出发给客服。

用法

vibecli logs [options] [action] [file]

参数

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

操作

何时使用

命令出错需要查看细节，或客服需要日志时。

替代方式

示例

另见: vibecli logs --help · 命令列表

vibecli list

列出 Node.js、Git、uv、Claude Code、Codex、Grok Build、Antigravity CLI、Claude Desktop、ChatGPT：装了没有、当前版本、最新版本、用什么方式装的、从哪下载。最新版本缓存一小时，加 --refresh 立即重新查。

用法

vibecli list [options]

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

何时使用

想知道这台电脑上装了哪些工具、哪些可以升级时。

替代方式

示例

另见: vibecli list --help · 命令列表

vibecli install

从国内镜像安装缺少的组件，下载后核对校验值（桌面应用还核对厂商签名）。已经装过的不覆盖：只显示当前版本，落后时给出升级命令；加 --force 重新安装。

Node.js、Git、uv 用 VibeAPI 的安装脚本装进当前用户目录，不需要管理员权限；不要加 sudo。可以写多个组件，有依赖的先装依赖。

用法

vibecli install [options] <components...>

参数

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

何时使用

要在这台电脑上补装某个工具时；别的应用的安装脚本也可以调用它（npx @vibeapi/api-helper install …）。

前提

• 这台电脑已有 Node.js（vibecli 本身要 Node）；还没有 Node 时先用一键安装脚本

替代方式

示例

另见: vibecli install --help · 命令列表

vibecli upgrade

按每份工具当初的安装方式升级：原生安装用工具自带的更新，npm 安装从国内镜像（npmmirror）重新安装，Homebrew 安装用 brew upgrade；原生或 Homebrew 方式无法升级时，改用 VibeAPI 一键安装脚本（程序取自国内镜像）。指定了但还没有安装的工具，也用这个脚本安装。

Claude Desktop 和 ChatGPT（内含 Codex；macOS / Windows）比高速下载站上的版本旧时，从高速下载站下载官方安装包，核对校验值和厂商（Anthropic / OpenAI）的签名后安装；它们自带的自动更新照常开着，vibecli 只在没跟上时补上。应用正在运行时，在终端里问过才关掉它升级，带 --yes 或没有终端时只提示、不关。已是最新时加 --force 重新安装。ChatGPT 的 Mac 版只支持 Apple 芯片。

Node.js、Git、uv 只升级由 VibeAPI 安装脚本管理的那一份（fnm 装的 Node、~/.local/bin 里的 uv、装在当前用户下的 Git for Windows）；用 Homebrew、nvm、系统包管理器等装的，给出对应的升级命令、不改动它，加 --force 另装一份由 vibecli 管理的。fnm 的 Node 升级后，原来全局安装的 npm 包会按原版本装到新版里。

不填名字则升级已安装的全部编码工具和桌面应用，并提示可以升级的运行环境。

升级 VibeCLI 本身请用 vibecli update。

用法

vibecli upgrade [options] [tools...]

参数

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

何时使用

vibecli doctor 提示版本过低，或工具自带的更新无法完成时。

前提

• 不填工具名时，只升级已经安装的工具

替代方式

示例

另见: vibecli upgrade --help · 命令列表

vibecli refresh

按网关当前的模型配置和令牌现在能用的模型，重写各工具的模型菜单，不必等待每小时一次的自动同步。

用法

vibecli refresh [options]

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

何时使用

令牌换了分组、能用的模型有变化，或网关刚上架、下架模型时。

替代方式

示例

另见: vibecli refresh --help · 命令列表

vibecli update

依次查询这些来源：高速下载站、npmjs、npmmirror、Yarn。有新版本时给出安装命令。

全局安装的 VibeCLI 每次启动时也会检查，有新版本时自动安装并重新运行当前命令。

用法

vibecli update [options]

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

何时使用

想确认 VibeCLI 是否为最新版本时。

替代方式

示例

另见: vibecli update --help · 命令列表

vibecli codex

Codex 相关的辅助命令。

用法

vibecli codex [options] [command]

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

命令

何时使用

Codex 出现 VibeCLI 能处理的问题时（目前是会话列表变空）。

示例

另见: vibecli codex --help · 命令列表

vibecli codex sessions

Codex 按服务商筛选会话，更换登录方式或服务商后，旧会话会被隐藏。

这个命令把本地会话改到当前服务商；会先备份，可以用 --undo 撤销。

运行前请先退出 Codex。

用法

vibecli codex sessions [options]

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

何时使用

Codex 的历史会话列表变空或缺少会话时。

前提

• 先退出 Codex（运行时会拒绝修改）

替代方式

示例

另见: vibecli codex sessions --help · vibecli codex · 命令列表

vibecli sessions

列出 Claude Code、Codex 和 Claude Desktop（Cowork、Code）保存在本机的会话，按最后更新时间排序。

可以查看会话内容、打印或直接运行继续对话的命令、导出为 Markdown。只读，不修改任何会话文件。

用法

vibecli sessions [options] [command]

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

命令

何时使用

想找回以前的对话、继续对话，或保存对话时。

替代方式

示例

另见: vibecli sessions --help · 命令列表

vibecli sessions list

列出会话（默认）

用法

vibecli sessions list [options]

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

示例

另见: vibecli sessions list --help · vibecli sessions · 命令列表

vibecli sessions show

显示一个会话的信息和前几条消息

用法

vibecli sessions show [options] <id>

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

示例

另见: vibecli sessions show --help · vibecli sessions · 命令列表

vibecli sessions resume

打印或运行继续对话的命令

用法

vibecli sessions resume [options] <id>

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

示例

另见: vibecli sessions resume --help · vibecli sessions · 命令列表

vibecli sessions export

把会话导出为 Markdown

用法

vibecli sessions export [options] <ids...>

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

示例

另见: vibecli sessions export --help · vibecli sessions · 命令列表

vibecli lang

查看或设置 VibeCLI 的界面语言（zh_CN、en_US）。

用法

vibecli lang [options] [command]

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

命令

何时使用

界面语言不对时。

替代方式

示例

另见: vibecli lang --help · 命令列表

vibecli lang show

显示当前语言

用法

vibecli lang show [options]

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

示例

另见: vibecli lang show --help · vibecli lang · 命令列表

vibecli lang set

设置语言：zh_CN 或 en_US

用法

vibecli lang set [options] <locale>

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

示例

另见: vibecli lang set --help · vibecli lang · 命令列表

vibecli completion

输出 bash、zsh、fish 的补全脚本。保存到文件后，在 shell 配置里 source 它（fish 放进补全目录即可）。

用法

vibecli completion [options] <shell>

参数

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

何时使用

想用 Tab 键补全 VibeCLI 的命令时。

前提

• 使用 bash、zsh 或 fish

示例

另见: vibecli completion --help · 命令列表

vibecli enter

不经过主菜单，直接打开指定的配置菜单。

用法

vibecli enter [options] [option]

参数

选项

另可使用全局选项：-v, --version --base <url> --non-interactive --json -y, --yes --dry-run --no-color

菜单

何时使用

知道要修改哪一项，想跳过主菜单时。

替代方式

示例

另见: vibecli enter --help · 命令列表