配置 AI 供应商

Vibern 自己不托管模型，所有请求都由本机的 Claude Code 发出。你可以用官方账号，也可以指向任意兼容协议的服务。

官方 Claude 账号

装好 Claude Code CLI 并登录后，Vibern 会自动读到凭据，不需要额外配置。验证一下：

claude --version

能输出版本号就说明通了。

用 API Key

在 设置 → AI 供应商 → 新建配置 里填：

字段	说明
名称	自己认得就行，会显示在标签栏
协议	anthropic 或 openai
Base URL	服务地址，例如 https://api.anthropic.com
API Key	你的密钥，本地加密存储
默认模型	例如 claude-opus-4

API Key 只存在本机配置里，Vibern 不上传，也不会写进日志。

兼容 OpenAI 协议的服务

选 openai 协议后，Vibern 会在两种协议之间做转换：请求发出前转成目标格式，响应回来再转回 Claude Code 认识的结构。

sequenceDiagram
    participant U as 你
    participant V as Vibern
    participant B as 协议转换层
    participant S as 模型服务
    U->>V: 提问
    V->>B: Anthropic 格式请求
    B->>S: 转成 OpenAI 格式
    S-->>B: OpenAI 格式响应
    B-->>V: 转回 Anthropic 格式
    V-->>U: 流式输出

这样换供应商只改配置，不用动项目里的任何代码。

多套配置切换

配置可以存多份，每个会话标签单独选用。常见分法：

• 日常改代码用一套便宜快的。
• 处理复杂重构切到能力更强的。
• 内部项目走公司自建网关。

在标签栏右侧的模型名上点一下就能切，切换只影响当前标签。

连不上的排查顺序

1. 先在终端里 curl 一下 Base URL，确认网络能通。
2. 检查 Key 有没有多余空格或换行。
3. 看 设置 → 日志，里面有完整的请求错误。
4. 走代理的话，确认代理环境变量对 Vibern 生效。

还搞不定就看常见问题。