Junie CLI

Junie CLI 在 $JUNIE_HOME/models/ 中通过 JSON 配置文件接收自定义端点，其中 baseUrl 是完整端点 URL，fasterModel 决定辅助流量的去向。

{
  "id": "claude-sonnet-5",
  "baseUrl": "https://api.kunavo.com/v1/chat/completions",
  "displayName": "Kunavo",
  "providerName": "Kunavo",
  "apiType": "OpenAICompletion",
  "apiKey": "${KUNAVO_API_KEY}",
  "fasterModel": {
    "id": "claude-haiku-4-5"
  }
}

分步操作

1. 在 /app/keys 创建密钥并复制——它只会显示一次。在启动 Junie 的 shell 中将其导出为 KUNAVO_API_KEY，也可以在文件中直接填写密钥；JetBrains 指出，“不含任何 $${...} 引用的值会按原样使用”。
2. 将上面的 JSON 保存为你账户的 $JUNIE_HOME/models/kunavo.json，或保存为可与仓库共享的 .junie/models/kunavo.json。去掉 .json 的文件名就是配置文件 ID，因此下方的选择器会显示 custom:kunavo。
3. 将 id 设为你实际需要的模型 ID。它被描述为“API 端点所需的模型标识符”，因此可直接填写下表中的 Kunavo slug；ID 由端点解析，而不是由 Junie 解析。
4. 启动 Junie 并选择配置：junie --model custom:kunavo，或在交互式会话中使用 /model 命令。自定义模型会“显示在内置服务商之后的模型选择列表中”。
5. 给它一个需要编辑文件的任务，而不是只发问候语。Junie 是代理式客户端，几乎所有操作都依赖工具调用，因此首次运行时让它读写内容，比只收到一条回复能提供更多信息。

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

调试客户端前先验证

一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON，则相同的基础 URL 和密钥可以在 Junie 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 的美元，格式为输入 / 输出。

Kunavo 支持的另外两种 apiType

apiType 指的是请求格式，而不是供应商；Junie 接受四种值：OpenAICompletion、OpenAIResponses、Google 和 Anthropic。Kunavo 提供三种路由，因此其余三种值中有两种在此有对应的 baseUrl。由于 Junie 不会追加路径，更改格式时必须同时修改 URL：

1. "apiType": "OpenAICompletion" 搭配 https://api.kunavo.com/v1/chat/completions——即上方的配置文件，也是本页推荐的选项，因为这是三种路由中使用最广泛的一种。
2. "apiType": "Anthropic" 搭配 https://api.kunavo.com/v1/messages——Kunavo 会在该路径上响应 Messages 格式。
3. "apiType": "OpenAIResponses" 搭配 https://api.kunavo.com/v1/responses。

对于给定模型，哪种 Junie 驱动方式最好，这正是需要通过运行时测试来回答、无法仅凭阅读文档回答的问题，因此除了首行所述之外，本页不对它们进行排序。请选择一种方式，确保 URL 与 apiType 相匹配；如果设置了密钥的配置返回 401，请明确填写凭证，而不要猜测 Junie 使用的请求头：JetBrains 仅以否定方式说明了 apiKey：“如果省略，请求将不带 Authorization 请求头发送”，但从未说明设置该值时使用什么方案。extraHeaders 被描述为“每个请求都要包含的额外 HTTP 请求头”，并使用相同的 $${VAR} 引用，因此 "extraHeaders": {"Authorization": "Bearer $${KUNAVO_API_KEY}"} 是无歧义的格式。