配置覆盖
Mirri Code 有三个地方可以影响运行参数：配置文件、命令行选项、环境变量。它们不是简单的"谁优先级高谁赢"——三者面向不同场景，作用范围互不相同：
- 配置文件 保存长期偏好（模型、密钥、循环控制等），每次启动都生效
- 命令行选项 做本次启动的临时切换，退出后失效
- 环境变量 主要负责数据目录定位、OAuth 端点切换，以及少数运行时开关——不是配置字段的通用后备来源
这个区别很关键：很多人会在 shell 里 export MIRRI_API_KEY=xxx，以为 CLI 会自动取到——并不会。供应商凭证永远不会从 shell 环境读取；如何迁移到显式配置见下文供应商凭证。
环境变量的三类作用
环境变量按作用分三类，不能合并成一条线性优先级：
- 定位配置文件：
MIRRICODE_HOME决定数据根目录，配置文件路径因此变为$MIRRICODE_HOME/config.toml。这一步先于其他所有解析，不是普通参数的后备来源。 - 运行时开关：
MIRRICODE_DISABLE_TELEMETRY等少量变量直接关闭对应子系统——即使config.toml里telemetry = true，只要这个变量是真值，遥测就会被禁用。语义是"额外禁用"，不是"普通覆盖"。 - 运行端点与诊断：
MIRRICODE_OAUTH_HOST、MIRRICODE_BASE_URL、MIRRICODE_LOG_LEVEL等在 OAuth 或日志子系统初始化时读取。完整列表见环境变量。
普通运行参数的优先级
对模型别名、Plan 模式、yolo 模式、Skills 目录等普通运行参数，优先级从高到低：
- 命令行选项（
-m、--plan、--yolo等）：仅对本次启动生效 - 用户配置文件（
~/.mirri-code/config.toml）：保存长期偏好
少数环境变量明确覆盖特定配置字段，例如 MIRRICODE_BACKGROUND_KEEP_ALIVE_ON_EXIT 的优先级高于 [background].keep_alive_on_exit。这类例外在环境变量和配置文件对应字段里都有标注。
注意
普通运行参数不会从 shell 环境变量取后备值——供应商凭证也不会。 api_key / base_url 只从显式配置解析：凭证存储、[providers.<name>.env] 子表——详见供应商凭证。唯一的 shell 通道是显式的 MIRRICODE_MODEL_* 系列——详见用环境变量定义模型。
目前 CLI 只读取一份用户级配置文件，没有项目级配置文件机制。需要在不同项目间隔离配置时，用 MIRRICODE_HOME 指向不同的数据目录——见下文典型场景。
供应商凭证
供应商凭证（api_key、base_url）有独立的解析规则，不走普通参数的优先级链。
对单个供应商，凭证按以下顺序解析：
- 该供应商在凭证存储里的活跃条目（由 UI 管理——设置 → 供应商，或 TUI 里的
/provider），优先级最高 [providers.<name>.env]子表里的对应键——type = "anthropic"读ANTHROPIC_API_KEY，openai/openai_responses读OPENAI_API_KEY，google/google-genai读GOOGLE_API_KEY，kimi读MIRRI_API_KEY- 两者都没有 → 启动报错，给出明确的配置错误并指明补救方式
base_url 的解析方式相同：先读 [providers.<name>].base_url，再读 [providers.<name>.env] 里的 *_BASE_URL 键（ANTHROPIC_BASE_URL、OPENAI_BASE_URL、GOOGLE_GEMINI_BASE_URL、MIRRI_BASE_URL），最后用该供应商类型的内置默认 URL——仅限一方供应商；其他供应商必须显式配置 base URL。
[providers.<name>.env]子表只是配置文件里的一段 TOML，不会真正写入 shell 环境变量；shell 环境也不会作为凭证来源被读取——引擎只使用显式配置的凭证。详见配置文件的 providers 节的env子表说明。
完整的凭证键名列表见环境变量：供应商凭证键。
命令行选项
启动时传入的选项优先级最高，只对本次启动生效：
| 选项 | 作用 |
|---|---|
-S, --session [id] | 恢复指定会话；不带 id 时进入交互式选择 |
-c, --continue | 续上当前目录的上一次会话 |
-y, --yolo | 自动批准所有工具调用 |
--plan | 以 Plan 模式启动 |
-m, --model <model> | 指定本次使用的模型别名 |
-p, --prompt <prompt> | 非交互模式：执行单条提示词后退出 |
--output-format <format> | -p 模式的输出格式：text 或 stream-json |
--skills-dir <dir> | 替换自动发现的 Skills 目录（可重复，仅本次生效） |
互斥规则（违反时启动报错）：
--output-format只能配合-p使用--prompt不能同时用--yolo或--plan--continue和--session不能同时用- 非 prompt 模式下，
--yolo和--plan不能配合--continue或--session
TIP
--skills-dir 是一次性替换，只影响本次启动。如需长期追加搜索目录，在 config.toml 里写 extra_skill_dirs（详见 Agent Skills）。
典型场景
隔离测试环境——用单独的数据目录，避免污染主配置和会话：
MIRRICODE_HOME="$PWD/.mirricode-sandbox" mirri一次性使用测试密钥——把测试密钥写进 env 子表（凭证永远不会从 shell 环境读取）：
[providers.kimi.env]
MIRRI_API_KEY = "sk-test"跳过审批运行批处理任务：
mirri --yolo -p "批量重命名以下文件..."临时进入 Plan 模式（若想永久生效，在配置文件设 default_plan_mode = true）：
mirri --plan