配置文件与覆盖

长期偏好都写在 ~/.kimi-code/ 下的 TOML 文件里：运行时设置放 config.toml（首次运行自动创建），TUI 设置放 tui.toml；数据目录可用环境变量 KIMI_CODE_HOME 改变。kimi doctor 校验这两个文件（不启动 TUI、不修改文件，可在替换正式配置前先检查候选文件）。顶层与嵌套表：顶层标量控制默认行为（如 default_model）；嵌套表包括 providers（每项定义一个 API 供应商）、models（每项定义一个模型别名）、secondary_model（subagent 的默认模型与模型池，subagent 默认继承 main agent 正在运行的模型）、thinking、loop_control（执行循环的步数上限、单步尝试上限、上下文自动压缩）、token_counting、background（后台任务）、subagent、swarm、mcp、identity、tools（全局工具开关）、read、image（图片发送前的压缩）、hooks。可以用 /settings（别名 /config）在 TUI 里改常用设置。

覆盖与优先级：有三个地方影响运行参数——配置文件（长期偏好，每次启动生效）、命令行选项（本次启动的临时切换）、环境变量（主要负责数据目录定位、OAuth 端点切换和少数运行时开关，不是配置字段的通用后备来源）。环境变量按作用分三类：定位配置文件（KIMI_CODE_HOME，先于一切解析）；运行时开关（如 KIMI_DISABLE_TELEMETRY，真值就关闭对应子系统，即使配置里 telemetry = true）；运行端点与诊断（KIMI_CODE_OAUTH_HOST、KIMI_CODE_BASE_URL、KIMI_LOG_LEVEL 等）。普通运行参数（模型别名、Plan 模式、yolo 模式、Skills 目录等）优先级：命令行选项 > 用户配置文件，不会从 shell 环境变量取后备值；供应商凭证（api_key、base_url）有独立规则，只从 config.toml（包括 [providers.<name>.env] 子表）读取，不回退到 shell 里 export 的变量。目前 CLI 只读取一份用户级配置，没有项目级配置文件机制；需要在项目间隔离时用 KIMI_CODE_HOME 指向不同数据目录。