Mistral Vibe CLI

在 .vibe/config.toml 中添加五行 [[providers]] 配置块 — api_base、api_key_env_var、api_style — 将 Vibe CLI 指向 Kunavo，密钥保存在环境变量而非文件中。

# ./.vibe/config.toml (project) or ~/.vibe/config.toml (user).
# "Project-level configuration takes precedence over user-level
# configuration", and the project file loads only in a trusted folder.
active_model = "sonnet-kunavo"

[[providers]]
name = "kunavo"
api_base = "https://api.kunavo.com/v1"
api_key_env_var = "KUNAVO_API_KEY"
api_style = "openai"
backend = "generic"

[[models]]
name = "claude-sonnet-5"
provider = "kunavo"
alias = "sonnet-kunavo"
# Optional, and documented on the api-keys-profiles page:
#   temperature   sampling temperature
#   input_price   indicative per-input cost, fed to --max-price
#   output_price  indicative per-output cost, fed to --max-price
# Take the two prices from the table further down this page if you want
# --max-price to mean anything.

# The key never goes in config.toml. api_key_env_var names the variable:
#   export KUNAVO_API_KEY="sk-kn-..."

分步操作

1. 在 /app/keys 创建密钥并复制——它只会显示一次。
2. 打开 ~/.vibe/config.toml（或在你希望应用此配置的代码库中创建 ./.vibe/config.toml），然后粘贴上面的配置块。没有可供点击的服务商添加流程：Mistral 文档说明此文件需要手动编辑，而 /config 和 /model 只能在已有预设之间切换。
3. 导出你在 api_key_env_var 中指定的变量——export KUNAVO_API_KEY="sk-kn-..."。Mistral 的凭据页面说明，CLI 启动时会从 ~/.vibe/.env 文件加载凭据；其第三方服务商示例则通过 shell export 提供非 Mistral 密钥。
4. 为你需要的每个 ID 添加一个 [[models]] 预设，并为每个预设配置独立的 alias，然后将 active_model 指向其中一个别名。别名仅在本地使用——/model 会列出该别名，而实际发送到端点的是 name 中的 ID。
5. 在受信任的文件夹中运行 vibe，并交给它一个会操作文件的任务，而不是打个招呼。首次运行时读取并编辑文件，可以验证工具调用是否正常；服务商配置错误通常会在这一步显现。

已于 2026年9月21日 对照 Mistral 的 Vibe Code CLI 配置页面 检查。第三方设置会发生变化；如果这里的字段名称不再与你看到的内容一致，应以该页面为准，而不是本页。

调试客户端前先验证

一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON，则相同的基础 URL 和密钥可以在 Mistral Vibe CLI 中使用。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

字段中应填写哪个模型 ID

每个文本模型都可通过模型 ID 访问——实时列表见 GET /v1/models，包含价格的目录见模型页面。费率单位为每 1M token 的美元，格式为输入 / 输出。

并非所有流量都会发往此服务商

这是配置块无法说明的部分，而且它与 Vibe 有关，并非 Kunavo 特有。在 v2.25.5 中，只要 Mistral 服务商可用，CLI 就会将后台“utility”补全请求——用于命名对话和工作树的小型调用——发送给 Mistral 自己的 mistral-vibe-cli-fast 模型；随附的默认配置始终会配置该模型，即使会话当前使用的是你的活动模型。源码明确说明了优先选择方式和回退行为：如果没有可用的 Mistral 服务商，utility 调用就会转而使用会话的活动模型。

因此，如果你希望会话中的每个请求都发往你配置的服务商，则必须满足以下条件之一：

• 未设置 MISTRAL_API_KEY，因此无法解析快速模型的凭据，实用程序调用便会回退；或者
• 通过 allowed_models 将快速模型的别名排除在外，从而通过允许列表而非密钥产生相同效果。

Smart Approve 分类器的行为更进一步——其 2.25.1 版变更日志指出，无论会话的活动模型是什么，它都会使用快速 Mistral 模型运行——因此，实际上仅使用 Kunavo 的会话应使用 accept-edits 或 plan，而不是 Smart Approve。这些情况不会影响上面的配置；只是说明服务商配置块控制的是模型轮次，而非二进制程序发送的每个数据包。

其他 api_style 值

文档列出 api_style 的一个值，并将其作为示例介绍："openai"。v2.25.5 源代码还包含另外四个值——"anthropic"、"openai-responses"、"reasoning" 和 "vertex-anthropic"——它们位于一个普通字典中，没有验证机制，因此拼写错误只会在发出请求时出现，而不会在加载文件时提示。请将这些值视为已通过源代码确认、但未记载于文档中的选项；如果尝试 Anthropic 风格，还要注意一个陷阱：其适配器的端点为 /v1/messages，因此这里的 api_base 必须是无后缀的源站地址 https://api.kunavo.com，不能带 /v1——这与上面的配置块恰好相反。对于以 claude- 开头的 ID，Kunavo 确实会响应 /v1/messages。本页展示 openai 风格，因为这是 Mistral 文档中介绍的选项。