配置模型提供商
Jarvis 有两类模型配置：主聊天使用 Jarvis 的模型池；编码运行时通常使用自己的 CLI 配置。不要把两者混在一起。
配置边界
标题为“配置边界”的章节| 配置面 | 用途 | 常见位置 |
|---|---|---|
.env |
Jarvis 后端基础设施和内置模型提供商凭证 | 仓库根目录本地文件 |
| 模型池 UI | 主聊天模型选择、自定义模型提供商 | Jarvis 设置页 |
| 运行时 CLI | Claude Code、Codex、OpenCode 自己的登录和默认模型 | 各运行时的本地配置 |
配置主聊天模型
标题为“配置主聊天模型”的章节- 启动 Jarvis。
- 打开设置或模型池页面。
- 添加模型提供商、base URL、模型名和凭证。
- 选择主聊天默认模型。
- 发送一条短消息，确认主聊天能正常响应。
主聊天模型应优先通过模型池管理。这样切换模型提供商时不需要修改仓库文件。
配置内置模型提供商凭证
标题为“配置内置模型提供商凭证”的章节如果你使用 .env.example 中已有的内置模型提供商字段，可以在本地 .env 中填入对应值。例如：
JARVIS_API_KEY=<local-api-key>JARVIS_PORT=8888不要把真实 .env 提交到仓库，也不要把它粘贴进公开 issue。
配置运行时 CLI
标题为“配置运行时 CLI”的章节编码运行时的认证通常在 Jarvis 外完成：
- Claude Code 使用自己的 CLI 登录状态。
- Codex 使用自己的 CLI 配置和模型提供商默认值。
- OpenCode 使用自己的本地模型提供商与边车服务设置。
Jarvis 可以在启动托管工作会话时注入会话级 MCP 配置或 prompt，但不应该成为这些 CLI 的全局凭证仓库。
验证顺序
标题为“验证顺序”的章节- 先验证主聊天能响应。
- 再在普通终端验证运行时 CLI 自己能运行。
- 最后从 Jarvis 启动一个小编码会话。
这样可以快速判断问题属于主聊天模型提供商、运行时 CLI，还是 Jarvis 启动链路。
安全规则
标题为“安全规则”的章节- 不公开 API 密钥、token、cookie 或完整
.env。 - 不在文档或截图中暴露真实本机路径和私有服务地址。
- 模型提供商报错时，只贴脱敏后的错误摘要。
- 怀疑泄漏时立即轮换密钥。