常见问题

启动就闪退

先看日志目录里最新那个文件（位置见安装与升级）。常见原因：

• 显卡驱动太旧：升级驱动，或用 --disable-gpu 启动试试。
• 配置文件损坏：把 config.json 改名后重启，应用会重建默认配置。
• 杀软拦截：把安装目录加进白名单。

提示找不到 Claude Code

Vibern 靠 PATH 找 CLI。终端里能跑但应用里找不到，通常是 GUI 进程没继承你的 shell 环境。

解决办法：在 设置 → 高级 → Claude Code 路径 里手填绝对路径。

# 先查出路径
which claude    # Linux
where claude    # Windows

模型请求一直转圈

按这个顺序排：

1. 会话右上角的状态点是不是红的，红的说明连接就没建上。
2. 换一个供应商配置试，能通就是原配置的问题。
3. 关掉代理再试一次。
4. 看日志里有没有 401 或 429，前者是 Key 问题，后者是限流。

打开大文件卡住

编辑器对超大文件走分片加载，但有两种情况仍会慢：

• 单行超长：比如整个 JSON 压成一行，换行后再打开。
• 文件在网络盘上：先拷到本地。

配置里可以调阈值：设置 → 编辑器 → 大文件阈值，默认 50 MB 以上启用分片模式。

时光机占空间太大

快照存在项目的 .vibern/snapshots 下。清理办法：

• 设置 → 时光机 → 清理 按时间批量删。
• 调低保留份数，默认留最近 50 次改动。

远程 SSH 连不上

flowchart TD
    A[连接失败] --> B{终端里 ssh 能连吗}
    B -->|不能| C[先修好 ssh 配置和密钥]
    B -->|能| D{用的是密钥还是密码}
    D -->|密钥| E[确认私钥路径和 passphrase]
    D -->|密码| F[确认服务端允许密码登录]
    E --> G[看日志里的握手错误]
    F --> G

跳板机场景需要在配置里显式写 ProxyJump，Vibern 会读你的 ~/.ssh/config。

Web 远程控制打不开

• 确认主机防火墙放开了配置里的端口。
• 局域网访问用主机 IP，不要用 localhost。
• 手机和电脑得在同一网段，或者自己做端口转发。

还没解决

带上日志片段到 GitHub Issues 提一个，写清系统版本和复现步骤。