配置档

配置档用于表达一组可复用的默认行为。但 Jarvis 不把所有默认值塞进一个全局配置档，因为主聊天、后端和运行时的生命周期不同。

三类配置档

1. Jarvis 本地配置：端口、数据库、API 密钥、运行模式等基础设施设置。
2. 模型池配置：主聊天可用模型提供商、模型选择和显示名称。
3. 运行时本地配置档：Claude Code、Codex、OpenCode、Kimi Code 自己维护的默认模型、登录状态和权限策略。

Jarvis 本地配置

本地配置主要来自 .env。它决定 Jarvis 后端如何启动、监听哪个端口、使用哪个数据库，以及哪些内置模型提供商凭证可用。

这类配置属于本机运行环境，不应提交到公开仓库。

模型池配置

模型池是主聊天的首选配置入口。它适合管理：

• 主聊天默认模型；
• 自定义模型提供商；
• base URL；
• 用户可见名称；
• 临时切换。

运行时本地配置档

运行时 CLI 保留自己的配置档：

• Claude Code 的登录和 CLI 默认值；
• Codex 的模型提供商与配置文件；
• OpenCode 的模型提供商、边车服务和本地会话设置。
• Kimi Code 的账号、模型和全局默认值。

Jarvis 启动工作会话时可以注入会话级参数，但不应把运行时的全局配置档改写成 Jarvis 私有格式。

Agent Profile

Agent Profile 是 Jarvis 面向 coding agent 的可复用行为配置。它不属于 .env 基础设施配置，也不等同运行时 CLI 的全局账号配置。

当你想复用模型、系统指令、工具面、权限、skills 或 hooks 时，使用 Agent Profile。它可以应用到单次会话、项目绑定和 Workflow 节点。

选择原则

想配置什么	放哪里
Jarvis 端口、数据库、API 密钥	.env
主聊天默认模型	模型池 UI
Claude Code / Codex / OpenCode / Kimi Code 登录状态	运行时官方 CLI
coding agent 的模型、指令、工具和权限组合	Agent Profile
单次工作会话启动的会话参数	Jarvis 启动链路

相关页面

• 配置总览
• Agent Profile
• 创建 Agent Profile
• 配置模型提供商
• 配置参考