Junie 接入指南：CLI 自定义模型与 IDE 能力核对

已确认的是 CLI，不是所有 IDE 插件

Junie 官方 Custom LLMs 页面明确描述 Junie CLI 的 JSON Profile；BYOK 页也以 CLI 为范围。 这些是可引用的接入依据，但不能据此声称任何 JetBrains IDE 内的 Junie 插件都允许任意端点。本篇因此标为部分核验，IDE 入口仍需按插件版本和组织政策确认。

先分清使用的是 JetBrains AI 订阅、供应商 BYOK，还是自定义 Profile。官方说明 BYOK 用量由相应供应商结算，不能把另一服务的 Key 当作 JetBrains 账号凭证。

用 Profile 指定完整请求地址

CLI 从用户或项目的 models 目录发现 JSON Profile，文件名决定 Profile 标识；项目入口为 .junie/models/*.json。 下方为原创最小示例，假定文件名为 gateway.json。全部地址、Key、模型为占位，并无真实接口，不代表本站提供 API：

{
  "displayName": "项目模型",
  "id": "YOUR_MODEL_ID",
  "apiType": "OpenAICompletion",
  "baseUrl": "https://80321.cn/v1/chat/completions",
  "apiKey": "YOUR_API_KEY"
}

官方强调 baseUrl 是完整接口 URL，Junie 不再追加路径。 这里不能只写到 /v1，也不能把 Chat Completions 地址配成 Responses 类型。

API 类型与模型角色一起核对

当前 Profile 文档列出 OpenAICompletion、OpenAIResponses、Google 和 Anthropic 类型。 这些名称是请求格式，不保证任意服务都具备对应兼容性。先向服务商确认模型 ID、工具调用与流式行为，真实凭证按官方支持的环境变量引用机制管理，不提交实际值到项目。

Profile 可区分 primaryModel 和 fasterModel，主模型负责主要任务，辅助角色用于摘要等工作；省略角色配置时继承顶层字段。 两条路由都须核对权限和数据接收方，不能只审核主模型。

选择 Profile 后做有限验证

官方选择方式是 /model 或 --model，自定义标识使用 custom: 加 Profile 名。 只在已安装且版本匹配的 CLI 中，核对 custom:gateway 是否被加载。先用无敏感文本完成问答，再验证只读工具，最后才审核编辑权限。

模型选择文档提醒，辅助任务可能调用另一模型，即便使用 BYOK 也是如此。 测试报告要分别记录主、辅助请求，不能只凭主模型回答正常就宣称全部接入完成。

排错与 IDE 升级核对

Profile 未加载时，检查目录、JSON 语法和环境变量是否存在；路径或 API 类型错误应先修正接口格式，不使用不明代理“修复”登录。持续循环或工具格式错误还可能与模型的指令遵循能力有关。

若目标是 IDE 插件，请先确认插件版本、账号许可、自定义端点入口及其允许协议，CLI Profile 不应未经说明复制过去。日志只共享脱敏字段，实际仓库在独立副本测试；本文仅核验官方文档，没有登录或发起真实接口请求。