模型选择
用 /model 命令或 --model 标志选择 Gemini 模型:Auto、Pro、Flash 的使用建议与注意事项。
/model 命令让你配置 Gemini CLI 使用的模型,对结果有更多控制:Pro 模型用于复杂任务和推理,Flash 模型用于追求速度的结果,或者用(推荐的)Auto 设置为你的任务选择最合适的模型。注意:/model 命令(以及 --model 标志)不会覆盖子智能体使用的模型,所以即使你用了 --model,在模型用量报告里仍可能看到其他模型。
怎么用
在 Gemini CLI 里输入 /model 会打开选项对话框:
| 选项 | 说明 | 模型 |
|---|---|---|
| Auto (Gemini 3) | 让系统为你的任务选择最合适的 Gemini 3 模型 | gemini-3-pro-preview、gemini-3-flash-preview |
| Auto (Gemini 2.5) | 让系统为你的任务选择最合适的 Gemini 2.5 模型 | gemini-2.5-pro、gemini-2.5-flash |
| Manual | 选择特定模型 | 任何可用模型 |
官方推荐选择上面的 Auto 选项之一,也可以选 Manual 从可用模型里选一个特定的。这些设置的更改应用于之后与 Gemini CLI 的所有交互。也可以在启动时用 --model 标志指定特定的 Gemini 模型,如 gemini -m flash(别名见「CLI 速查表」)。
模型名称、预览模型和可用性随版本变化很快,以官方 Model selection 页和
/model对话框里实际列出的为准。
最佳实践
- 默认用 Auto:对多数用户,Auto 选项在速度和性能之间取得平衡,根据任务复杂度自动选对模型。例如开发一个 Web 应用会混合复杂任务(构建架构和脚手架)与简单任务(生成 CSS)
- 得不到想要的结果时切到 Pro:如果你觉得需要模型更「聪明」一点,可以手动选 Pro,它提供最高水平的推理和创造力。例如复杂或多阶段的调试任务
- 需要更快的结果时切到 Flash 或 Flash-Lite:需要快速得到简单回复时,Flash 或 Flash-Lite 是最佳选择。例如把 JSON 对象转换成 YAML 字符串
模型路由
官方「Model routing」页描述自动回退(fallback)机制,提供遇到问题时的弹性。计划模式下可以用 general.plan.modelRouting 在计划阶段用 Pro、实现阶段用 Flash。模型生成参数(如 temperature 和思考预算)的微调见官方 Model configuration 页。