配置、备份与安全

VibeCLI 把令牌存在哪、怎么备份和还原、profile 结构、自动更新与模型菜单同步、可用的环境变量

文件在哪

各工具自己的配置文件位置见各工具一览。

config.yaml 的大致结构：

active_profile: default
profiles:
  default:
    api_key: sk-...
    tool_api_keys:          # 可选：工具专属令牌，优先于 api_key
      codex: sk-...
    base_url: https://www.vibeapi.cn
    models:
      opus: claude-opus-5-5[1m]
      sonnet: claude-sonnet-5[1m]
    tool_models:            # 可选：按工具覆盖模型
      codex: { opus: gpt-6-astra }

令牌怎么保存

令牌明文保存，文件权限 0600，换电脑不会因为加密绑定了机器而失效。请把用户目录和备份当作敏感数据。vibecli status 只显示令牌的指纹。

备份与还原

原文件已损坏（不是合法的 JSON / TOML）时，VibeCLI 拒绝写入；加 --force 才会先备份、再整份重写。还原前也会先备份当前状态，所以还原本身也能撤销。

命令	作用
`vibecli config <工具> restore`	回到上一次修改前
`vibecli config <工具> backups`	列出所有备份

自动更新与模型同步

只有全局安装时才自动更新（每次启动都检查新版本，更新失败不影响原命令）。用 npx 运行，或带 --json、--non-interactive、--dry-run 时不更新。模型菜单同步只改菜单，不动令牌和你选中的模型。

环境变量

变量	作用
`VIBECLI_DISABLE_AUTO_UPDATE=1`	关闭启动时的自动更新
`VIBECLI_DISABLE_MODEL_REFRESH=1`	关闭模型菜单的自动同步
`VIBECLI_CONFIG_DIR`	把 VibeCLI 的配置目录改到别处
`NO_COLOR` / `FORCE_COLOR=0`	不输出颜色

退出码与错误输出

命令成功返回 0。失败时按原因返回固定退出码：

退出码	含义
1	操作失败
2	用法或输入错误
3	认证失败，令牌无效或被拒绝
4	网络问题，例如 DNS、证书、超时或无法连接网关
5	内部错误
10	需要确认；非交互模式下加 `--yes`
130	已取消

普通模式下，错误写到 stderr，下一行给出完整的下一条 vibecli 命令。带 --json 时，失败只在 stderr 输出一个 JSON 对象，stdout 不输出内容；成功时 stdout 的 JSON 格式不变。失败时的输出示例：

{"ok":false,"error":{"type":"authentication","message":"网关拒绝了这个令牌，它可能已被删除、停用或已过期","hint":"vibecli setup --key <你的令牌>","subtype":"invalid_api_key"}}