配置总览

Jarvis 的配置刻意分层。把基础设施、主聊天模型和运行时 CLI 配置分开，系统才容易排障和迁移。

配置放在哪里

层级	用途	示例
.env 与 JARVIS_* 变量	Jarvis 服务基础设施和可选内置模型提供商凭证	JARVIS_PORT、JARVIS_DATABASE_PATH、JARVIS_API_KEY
模型池 UI	主聊天模型选择和用户管理的模型提供商	默认聊天模型、自定义模型提供商、模型切换
运行时 CLI 配置	Claude Code、Codex、OpenCode 的本地认证和默认值	CLI 登录状态、默认模型、运行时特有行为
工作会话工具与权限	编码会话运行时能汇报、请求或检查什么	进展汇报、阻塞状态、人工问题、可选 search_kb

核心原则

.env 管基础设施；模型池管主聊天模型；运行时 CLI 保留自己的本地配置。只有明确启动某个会话时，Jarvis 才应注入会话级覆盖。

主聊天模型与运行时模型

• 主聊天 从模型池读取配置。
• Claude Code、Codex、OpenCode 通常读取各自 CLI 的本地配置。
• Jarvis 可以为一次运行时启动注入模型覆盖，但这不是默认行为。

这种分离避免运行时配置变更意外影响主聊天体验。

常见环境变量

变量	含义	默认值
JARVIS_PORT	Jarvis HTTP 服务端口	8888
JARVIS_DATABASE_PATH	SQLite 数据库路径	data/jarvis.db
JARVIS_API_KEY	访问 Jarvis API 的认证密钥	无；需要本地生成

Jarvis 还提供一些内置模型提供商的可选凭证槽位。真实密钥只应存在于本地环境或用户设置中。

模型提供商凭证

• 内置模型提供商：在本地 .env 中填写对应 JARVIS_*_API_KEY。
• 自定义模型提供商：通过模型池 UI 添加。

公共文档只写变量名和用法，不写真实密钥。

运行时 CLI

Jarvis 不要求用户把 Claude Code、Codex 或 OpenCode 的配置搬进 Jarvis。推荐做法是：

1. 安装运行时 CLI；
2. 用运行时官方方式登录；
3. 让 Jarvis 基于该本地环境启动或发现会话。

因此主聊天正常，不代表运行时一定正常；两者需要分别验证。

权限与隐私

编码会话可能读取本地仓库、运行命令并汇报结果。配置时应始终明确：哪些凭证只在本地、哪些日志可以公开、哪些工具默认禁用或可选。

相关页面

• 配置模型提供商
• 配置参考
• 权限
• 工具