模型解析与运行时快照

区分 provider 模型与 runtime 模型，理解凭据来源、生成设置和保存范围。

This page has not been translated into English yet. The original Chinese version is shown below.

Qwen Code 区分从目录选择的 Provider Model 与临时解析出的 Runtime Model。确定属于哪类后，再判断 CLI、环境和全局设置是否参与。

Provider Model

通过 /model 选择 modelProviders 中的模型时，条目提供模型 ID、envKey、baseUrl 和整套 generationConfig。生成配置层不允许较低层补齐缺失字段。

例如 provider 只给出 timeout 和 temperature，全局的 max_tokens、modalities 或自定义 header 不会再补入。需要的字段应全部放在该 provider 条目。

Runtime Model

使用目录外的原始模型 ID 时，解析器按 CLI、环境、settings 和默认值逐字段组装。此时顶层 model.generationConfig 才参与。

官方用以下命令展示临时模型：

qwen --auth-type openai --model my-custom-model --openai-api-key "$KEY" --openai-base-url https://api.example.com/v1

其中 KEY、模型与域名都是需提供的值。--auth-type 和 --model 也可以定位一个已有 provider 条目，因此“使用了 --model”本身不等于一定创建 Runtime Model。

认证与连接字段

Model Providers 页的解析表按顺序列出程序覆盖、模型 provider 选择、CLI、环境、settings 与默认/计算值，且不同字段在各层可用性不同。

CLI 的 Key/baseUrl 参数只有 --openai-api-key、--openai-base-url，用于当前 OpenAI 兼容 provider；没有对应 --anthropic-* 或 --gemini-* 凭据参数。

Authentication 页概括 CLI Key 优先，而模型解析表把选中的 provider 放在 CLI 之前。不要把它们归纳成“任何 CLI 参数始终覆盖目录模型的全部字段”；需要精确行为时，显式配置目标条目并核对当前版本解析结果。

security.auth.apiKey 和 security.auth.baseUrl 已弃用，推荐迁移到 modelProviders 的 envKey/baseUrl。security.auth.selectedType 仍用于选择认证类型，不要将这三个键一并删除。

运行时快照

完整运行配置可捕获为 RuntimeModelSnapshot，包含模型、实际 Key、baseUrl 和生成配置，并在 /model 出现运行时选项。官方示例 ID 为 $runtime|openai|my-custom-model；这应作为会话命令选择值，不应未经引用直接粘贴到 shell。

官方同时写“跨会话保留”和“运行时保存在内存”，没有在此清楚说明进程重启后的持久化保证。本页不承诺可依靠快照代替长期配置，也不将可能捕获实际 Key 的快照当作适合团队共享的配置。