常见问题 | VibeAPI

VibeCLI 配置后不生效、证书报错、Codex 401、旧会话不见了、桌面端不走 VibeAPI、工具版本过旧等问题的处理办法

遇到问题先运行 vibecli doctor，它会检查网络、证书、令牌、工具版本和配置是否生效，并给出下一步。

一键安装

PowerShell 报「标记“&&”不是此版本中的有效语句分隔符」，或 cmd 报「'sh' 不是内部或外部命令」：复制了 macOS 的命令，请换成 Windows 标签页里的命令。
Mac 弹出「命令行开发者工具」安装窗口：点击「安装」，它会安装 Git；在后台下载，不影响其它步骤。
令牌粘贴错了：会提示重新粘贴，最多三次。
不要在命令前加 sudo：工具都安装在你自己的用户目录里。
Claude Desktop 还没有安装：配置已经先写好，安装后打开即可使用。

vibecli.cn 无法打开：把命令里的 https://vibecli.cn 换成 https://cnb.cool/vibeapi/install/-/git/raw/main/vibecli.sh（Windows 换成 …/vibecli.ps1），单个工具同理换成同目录下的同名文件。

提示 `command not found: npx`，或安装后找不到 `node`、`claude`

command not found: npx：电脑上还没有 Node.js，用一键安装命令从头安装。

安装后找不到命令：

在当前窗口运行一次（页面上的安装命令末尾已经带了这一句）：

exec "$SHELL" -l

Windows 上安装后当前窗口即可使用，之前打开的其它窗口要重新打开。

配置后，Claude Code 仍没有使用 VibeAPI

常见原因是 shell 配置里 export 过 ANTHROPIC_API_KEY、ANTHROPIC_BASE_URL，它们会盖过配置文件。VibeCLI 配置 Claude Code 时会自动删掉这些行，删完要新开一个终端，并重开 Claude Code 会话。企业电脑上还可能有托管配置覆盖了地址或令牌，vibecli doctor 会指出来。

这不是令牌的问题：当前网络（常见于校园网、酒店网络）把 www.vibeapi.cn 解析到了别的服务器。运行 vibecli base auto 换到能用的备用地址，已配置的工具会一起换过去；网络恢复后运行 vibecli base default 回到主站。也可以换一个网络，或把 DNS 改成公共 DNS（如 119.29.29.29）。用 Clash 这类代理时，确认它的 DNS 设置已生效（配置里应写 dns: enable: true，写成 enabled 不生效）。

Codex 报 401，同一个令牌在 Claude Code 里能用

常见原因有两种：~/.codex/config.toml 里有 cc-switch 等工具留下的 experimental_bearer_token，Codex 会优先发送它，而不是你的令牌；或者 Codex 用 ChatGPT 账号登录过。运行 vibecli setup --codexkey <你的令牌>（或 --key）重新配置即可修复，然后完全退出 Codex 再打开。

换了登录方式，Codex 里以前的会话不见了

会话还在本地，只是 Codex 只显示和当前服务商一致的会话。完全退出 Codex（包括桌面版）后运行 vibecli codex sessions，可以用 --undo <备份目录> 撤销。换电脑后怎么把会话搬过去，见导出与迁移聊天记录。

Windows 上配置了 Claude Desktop，重开后仍没有使用 VibeAPI

多半是以前从网关页面下载的 .reg 写进了注册表 HKCU\SOFTWARE\Policies\Claude：这一层存在时，桌面端不读本地配置，普通权限也改不了它。运行 vibecli setup --desktopkey <你的令牌>，按提示确认，在系统弹窗里点击「是」；仍不生效就运行 vibecli setup --desktop-registry on。修改后要完全退出桌面端再打开。

Windows 提示「禁止运行脚本」

PowerShell 默认不允许运行脚本，一键安装命令、npm、npx 都会被拦截。运行一次下面的命令（只改当前用户，不需要管理员权限），再重新运行原来的命令：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

提示工具版本过旧，或 `claude update` 无法连接

运行 vibecli upgrade（或 vibecli upgrade claude-code）。官方渠道无法连接时，它改用国内镜像下载同一个官方程序；电脑上有多份安装时，询问后只保留最新的一份。还没有安装的，用安装命令。

Claude Code 的 `/model` 菜单里看不到某个模型

菜单只列这个令牌能调用的模型，先在控制台确认令牌的分组。网关新上架的模型，VibeCLI 最多一小时后同步进菜单；想立即更新，运行 vibecli refresh，或重新运行 vibecli setup --key <你的令牌>。

指定过模型，想恢复工具自己的默认

vibecli config claude-code clear-model

只删掉指定的模型，令牌、hooks、MCP、插件都保留。其它工具把 claude-code 换成对应的名字即可。

工具的配置改坏了

命令	作用
`vibecli config <工具> restore`	回到上一次 VibeCLI 修改前
`vibecli config <工具> --force`	先备份，再整份重写为推荐配置

Antigravity CLI 提示没有设置 GEMINI_API_KEY

这是旧版 VibeCLI 留下的配置。升级 VibeCLI 后重新运行 vibecli setup --key <你的令牌>（或 vibecli config agy），配置会改为写进 agy 自己的设置文件，任何终端都能直接使用；同时确认 agy 在 1.3.5 及以上（vibecli upgrade agy）。

命令失败时怎么看退出码

脚本或 CI 可以按退出码处理失败：2 是用法错误，3 是认证失败，4 是网络问题，1 是其它操作失败，完整列表见配置、备份与安全。需要程序读取时加 --json，错误对象只写到 stderr。