Gemini CLI 中使用 Gemini 3 Pro 与 Gemini 3 Flash模型选择、路由与配额回退实战指南【免费下载链接】gemini-cliAn open-source AI agent that brings the power of Gemini directly into your terminal.项目地址: https://gitcode.com/GitHub_Trending/gemi/gemini-cli本篇基于 gemini-cli 官方文档 Gemini 3 Pro and Gemini 3 Flash on Gemini CLI 展开系统讲解如何在 Gemini CLI 中升级启用 Gemini 3 系列模型、通过/model命令与-m标志完成选择、理解 Auto/Pro 路由类型的工作原理以及触达配额上限和容量错误时的回退与重试机制。读完本文你将能够独立完成 Gemini 3 的启用配置并结合仓库源码理解其底层的模型解析、可用性判定与退避重试实现。快速上手升级并切换到 Gemini 3要开始使用 Gemini 3Pro 与 Flash首先将 Gemini CLI 升级到最新版本npm install -g google/gemini-clilatest如果你的版本在 0.21.1 及以上只需两步即可启用在 Gemini CLI 中运行/model。选择Auto (Gemini 3)。此外官方文档特别提示Gemini 3.1 Pro Preview 正在灰度发布。你可以通过/model命令选择Manual来判断自己是否已有访问权限——如果能在下拉列表中看到gemini-3.1-pro-preview说明你的账号已开通。若有访问权限选择Auto (Gemini 3)时3.1 模型也会被纳入模型路由你也可以直接用-m标志启动该模型gemini -m gemini-3.1-pro-preview从源码看模型标识的定义集中在 packages/core/src/config/models.ts 中。例如PREVIEW_GEMINI_MODEL gemini-3-pro-preview、PREVIEW_GEMINI_3_1_MODEL gemini-3.1-pro-preview以及 Flash 系列的PREVIEW_GEMINI_FLASH_MODEL gemini-3-flash-preview该常量在 3.5 Flash 灰度实验期间是模块级变量可通过setFlashModels()动态调整。这也印证了文档中“版本能力取决于后端与账号权限”的说法模型可用集合由常量表VALID_GEMINI_MODELS统一约束。/model命令的选项与生效方式/model命令会打开一个选择对话框当前仓库文档 Gemini CLI model selection 给出的完整选项表如下选项说明涉及模型Auto (Gemini 3)让系统为你的任务选择最合适的 Gemini 3 模型gemini-3-pro-preview、gemini-3-flash-previewAuto (Gemini 2.5)让系统选择最合适的 Gemini 2.5 模型gemini-2.5-pro、gemini-2.5-flashManual手动选择具体模型任意可用模型官方建议大多数用户选择Auto系列选项只有在需要固定某个具体模型时才使用Manual。两点实现细节值得注意变更作用范围/model的修改会作用于当前及后续所有交互。此外/model命令以及--model标志不会覆盖子代理sub-agent所使用的模型因此即使指定了/model模型用量报告中仍可能出现其他模型。别名解析在 resolveModel() 中auto、pro、flash、flash-lite等别名会被解析为具体模型。例如pro在无预览权限时降级为gemini-2.5-proflash在 3.5 Flash 实验开启时解析为gemini-3-flash对应SECONDARY_GEMINI_3_5_FLASH_MODEL否则解析为gemini-3-flash-preview。此外代码中定义了DEFAULT_THINKING_MODE 8192的上限注释说明其目的是“防止思考thinking失控循环”从源码结构看这是 Gemini 3 思考型模型在 CLI 侧的一个重要安全约束。用量限额与自动回退Gemini CLI 会在你触达 Gemini 3 Pro 的每日用量上限时明确告知。此时系统会提供三类选项切换到Gemini 2.5 Pro升级以获得更高限额可参考订阅计划Plans页面对比档位停止当前操作。同时系统还会告诉你用量限额的重置时间即 Gemini 3 Pro 何时可以再次使用。类似地当 Gemini 2.5 Pro 触达每日上限时你会看到提示引导回退到Gemini 2.5 Flash。在源码层面这类配额对话框由 ProQuotaDialog 组件实现可以确认文档描述的选项与代码一致配额终止错误isTerminalQuotaError或模型不存在时选项为“切换到回退模型 / 升级获得更高限额 / Stop”其中Upgrade for higher limits仅当认证方式为 Google 登录AuthType.LOGIN_WITH_GOOGLE且非 Ultra 档位时才会出现见组件第 82-90 行的条件判断当失败模型与回退模型相同时只保留Keep trying与Stop两个选项。容量错误过载、退避重试与人工决策Gemini 3 Pro 在高峰期可能出现过载overloaded。此时 Gemini CLI 会询问你是继续尝试 Gemini 3 Pro 还是回退到 Gemini 2.5 Pro。Keep trying继续尝试选项采用指数退避exponential backoff系统繁忙时CLI 会拉大每次重试之间的等待间隔。如果请求没有立即发生请等待几分钟让请求处理完成。仓库源码印证了这一机制packages/core/src/utils/retry.ts 中的retryWithBackoff()函数默认初始延迟initialDelayMs: 50005 秒并在重试过程中动态调整currentDelay。另外从 ModelAvailabilityService 的结构可以看出CLI 会对每个模型维护健康状态terminal或sticky_retry失败原因分为quota配额与capacity容量两类。值得关注的实现细节是capacity 类的 terminal 状态带有 30 秒 TTLgetHealth()中ttlMs 30000过期后自动清除——这意味着模型容量错误被视为短期状态CLI 会在短暂标记后重新尝试该模型与文档中“Keep trying 会持续重试”的行为相呼应。模型选择与路由类型Auto 与 Pro在使用 Gemini CLI 时你可能希望控制请求如何在各模型之间路由。默认情况下Gemini CLI 使用Auto路由。当你使用 Gemini 3 Pro 时可以用 Auto 路由或 Pro 路由来管理用量限额Auto 路由先判断 prompt 属于复杂操作还是简单操作。简单 prompt 自动使用Gemini 2.5 Flash复杂 prompt 若已启用 Gemini 3 Pro 则使用Gemini 3 Pro否则使用Gemini 2.5 Pro。Pro 路由如果希望任务一定由最强模型处理通过/model选择Pro。Gemini CLI 会优先使用当前可用的最强模型包括已启用的 Gemini 3 Pro。关于模型失败后的整体路由fallback行为仓库文档 Model routing 给出了更完整的说明值得结合阅读模型失败当前选定的模型因配额或服务端错误失败时CLI 启动回退流程用户同意根据失败类型与模型策略CLI 可能提示你切换到回退模型默认总是提示。部分内部工具调用如 prompt 补全、分类使用gemini-2.5-flash-lite的静默回退链会依次尝试gemini-2.5-flash与gemini-2.5-pro不提示也不改变已配置模型模型切换经批准或策略允许静默回退后CLI 会在当前轮次或整个会话内使用可用的回退模型。从源码结构看具体的路由策略由 packages/core/src/routing/strategies/ 目录下的一组策略实现classifierStrategy基于分类器判断复杂度对应 Auto 路由的“简单/复杂”判定、overrideStrategy、fallbackStrategy、approvalModeStrategy等由modelRouterService.ts组合调度。文档中“Auto 路由先判断 prompt 复杂度”的描述可以推断正是由分类器策略完成的。在 Gemini Code Assist 中启用 Gemini 3如果你使用的是Gemini Code Assist Standard 或 Enterprise在 Gemini CLI 上启用 Gemini 3 Pro 需要配置发布渠道release channels分为两步管理员启用 用户启用。管理员操作拥有Google Cloud Settings Admin权限的管理员需要打开 Gemini CLI for Code Assist 所使用的 Google Cloud 项目进入Admin for GeminiSettings在Release channels for Gemini Code Assist in local IDEs中选择Preview点击Save changes。用户操作管理员启用Preview后等待 23 分钟然后打开 Gemini CLI使用/settings命令将Preview Features设置为true。重启 Gemini CLI 后你就应该可以访问 Gemini 3 了。模型选择的优先级顺序当多个来源都指定了模型时实际使用哪一个由 Model routing 文档 定义的优先级顺序决定--model命令行标志启动时通过--model或其短形式-m指定的模型始终优先生效GEMINI_MODEL环境变量未使用--model时使用环境变量指定的模型settings.json中的model.name以上都未设置时使用配置文件中的model.name属性本地模型路由实验性若settings.json中启用了 Gemma 本地模型路由CLI 会使用本地 Gemma 模型来做出路由决策而非托管模型。该特性可通过自动化的gemini gemma setup命令配置有助于降低托管模型调用成本默认模型以上均未设置时使用默认模型默认为auto。这也解释了文档开头的示例gemini -m gemini-3.1-pro-preview为何能直接启动 3.1 模型命令行标志优先级最高会覆盖其余所有配置来源。小结与延伸阅读启用 Gemini 3 的核心路径升级到最新版 →/model→ 选择Auto (Gemini 3)需要精确控制时用-m指定具体模型如gemini-3.1-pro-preview。触达每日限额时按提示切换 2.5 系列或升级容量错误时Keep trying走指数退避重试也可以主动回退到 2.5 Pro。Code Assist 用户需管理员切换 Preview 发布渠道 用户侧将Preview Features置为true。遇到问题时建议在项目仓库的 issue 区先检索是否已有同类问题没有匹配项时再新建 issue或在讨论区discussions留言反馈。可进一步深入阅读的相关文档与源码Gemini CLI model selection/model 命令Model routing回退路由与优先级模型常量与解析逻辑配额/容量对话框实现模型可用性服务重试与指数退避工具【免费下载链接】gemini-cliAn open-source AI agent that brings the power of Gemini directly into your terminal.项目地址: https://gitcode.com/GitHub_Trending/gemi/gemini-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Gemini CLI 中使用 Gemini 3 Pro 与 Gemini 3 Flash：模型选择、路由与配额回退实战指南
Gemini CLI 中使用 Gemini 3 Pro 与 Gemini 3 Flash模型选择、路由与配额回退实战指南【免费下载链接】gemini-cliAn open-source AI agent that brings the power of Gemini directly into your terminal.项目地址: https://gitcode.com/GitHub_Trending/gemi/gemini-cli本篇基于 gemini-cli 官方文档 Gemini 3 Pro and Gemini 3 Flash on Gemini CLI 展开系统讲解如何在 Gemini CLI 中升级启用 Gemini 3 系列模型、通过/model命令与-m标志完成选择、理解 Auto/Pro 路由类型的工作原理以及触达配额上限和容量错误时的回退与重试机制。读完本文你将能够独立完成 Gemini 3 的启用配置并结合仓库源码理解其底层的模型解析、可用性判定与退避重试实现。快速上手升级并切换到 Gemini 3要开始使用 Gemini 3Pro 与 Flash首先将 Gemini CLI 升级到最新版本npm install -g google/gemini-clilatest如果你的版本在 0.21.1 及以上只需两步即可启用在 Gemini CLI 中运行/model。选择Auto (Gemini 3)。此外官方文档特别提示Gemini 3.1 Pro Preview 正在灰度发布。你可以通过/model命令选择Manual来判断自己是否已有访问权限——如果能在下拉列表中看到gemini-3.1-pro-preview说明你的账号已开通。若有访问权限选择Auto (Gemini 3)时3.1 模型也会被纳入模型路由你也可以直接用-m标志启动该模型gemini -m gemini-3.1-pro-preview从源码看模型标识的定义集中在 packages/core/src/config/models.ts 中。例如PREVIEW_GEMINI_MODEL gemini-3-pro-preview、PREVIEW_GEMINI_3_1_MODEL gemini-3.1-pro-preview以及 Flash 系列的PREVIEW_GEMINI_FLASH_MODEL gemini-3-flash-preview该常量在 3.5 Flash 灰度实验期间是模块级变量可通过setFlashModels()动态调整。这也印证了文档中“版本能力取决于后端与账号权限”的说法模型可用集合由常量表VALID_GEMINI_MODELS统一约束。/model命令的选项与生效方式/model命令会打开一个选择对话框当前仓库文档 Gemini CLI model selection 给出的完整选项表如下选项说明涉及模型Auto (Gemini 3)让系统为你的任务选择最合适的 Gemini 3 模型gemini-3-pro-preview、gemini-3-flash-previewAuto (Gemini 2.5)让系统选择最合适的 Gemini 2.5 模型gemini-2.5-pro、gemini-2.5-flashManual手动选择具体模型任意可用模型官方建议大多数用户选择Auto系列选项只有在需要固定某个具体模型时才使用Manual。两点实现细节值得注意变更作用范围/model的修改会作用于当前及后续所有交互。此外/model命令以及--model标志不会覆盖子代理sub-agent所使用的模型因此即使指定了/model模型用量报告中仍可能出现其他模型。别名解析在 resolveModel() 中auto、pro、flash、flash-lite等别名会被解析为具体模型。例如pro在无预览权限时降级为gemini-2.5-proflash在 3.5 Flash 实验开启时解析为gemini-3-flash对应SECONDARY_GEMINI_3_5_FLASH_MODEL否则解析为gemini-3-flash-preview。此外代码中定义了DEFAULT_THINKING_MODE 8192的上限注释说明其目的是“防止思考thinking失控循环”从源码结构看这是 Gemini 3 思考型模型在 CLI 侧的一个重要安全约束。用量限额与自动回退Gemini CLI 会在你触达 Gemini 3 Pro 的每日用量上限时明确告知。此时系统会提供三类选项切换到Gemini 2.5 Pro升级以获得更高限额可参考订阅计划Plans页面对比档位停止当前操作。同时系统还会告诉你用量限额的重置时间即 Gemini 3 Pro 何时可以再次使用。类似地当 Gemini 2.5 Pro 触达每日上限时你会看到提示引导回退到Gemini 2.5 Flash。在源码层面这类配额对话框由 ProQuotaDialog 组件实现可以确认文档描述的选项与代码一致配额终止错误isTerminalQuotaError或模型不存在时选项为“切换到回退模型 / 升级获得更高限额 / Stop”其中Upgrade for higher limits仅当认证方式为 Google 登录AuthType.LOGIN_WITH_GOOGLE且非 Ultra 档位时才会出现见组件第 82-90 行的条件判断当失败模型与回退模型相同时只保留Keep trying与Stop两个选项。容量错误过载、退避重试与人工决策Gemini 3 Pro 在高峰期可能出现过载overloaded。此时 Gemini CLI 会询问你是继续尝试 Gemini 3 Pro 还是回退到 Gemini 2.5 Pro。Keep trying继续尝试选项采用指数退避exponential backoff系统繁忙时CLI 会拉大每次重试之间的等待间隔。如果请求没有立即发生请等待几分钟让请求处理完成。仓库源码印证了这一机制packages/core/src/utils/retry.ts 中的retryWithBackoff()函数默认初始延迟initialDelayMs: 50005 秒并在重试过程中动态调整currentDelay。另外从 ModelAvailabilityService 的结构可以看出CLI 会对每个模型维护健康状态terminal或sticky_retry失败原因分为quota配额与capacity容量两类。值得关注的实现细节是capacity 类的 terminal 状态带有 30 秒 TTLgetHealth()中ttlMs 30000过期后自动清除——这意味着模型容量错误被视为短期状态CLI 会在短暂标记后重新尝试该模型与文档中“Keep trying 会持续重试”的行为相呼应。模型选择与路由类型Auto 与 Pro在使用 Gemini CLI 时你可能希望控制请求如何在各模型之间路由。默认情况下Gemini CLI 使用Auto路由。当你使用 Gemini 3 Pro 时可以用 Auto 路由或 Pro 路由来管理用量限额Auto 路由先判断 prompt 属于复杂操作还是简单操作。简单 prompt 自动使用Gemini 2.5 Flash复杂 prompt 若已启用 Gemini 3 Pro 则使用Gemini 3 Pro否则使用Gemini 2.5 Pro。Pro 路由如果希望任务一定由最强模型处理通过/model选择Pro。Gemini CLI 会优先使用当前可用的最强模型包括已启用的 Gemini 3 Pro。关于模型失败后的整体路由fallback行为仓库文档 Model routing 给出了更完整的说明值得结合阅读模型失败当前选定的模型因配额或服务端错误失败时CLI 启动回退流程用户同意根据失败类型与模型策略CLI 可能提示你切换到回退模型默认总是提示。部分内部工具调用如 prompt 补全、分类使用gemini-2.5-flash-lite的静默回退链会依次尝试gemini-2.5-flash与gemini-2.5-pro不提示也不改变已配置模型模型切换经批准或策略允许静默回退后CLI 会在当前轮次或整个会话内使用可用的回退模型。从源码结构看具体的路由策略由 packages/core/src/routing/strategies/ 目录下的一组策略实现classifierStrategy基于分类器判断复杂度对应 Auto 路由的“简单/复杂”判定、overrideStrategy、fallbackStrategy、approvalModeStrategy等由modelRouterService.ts组合调度。文档中“Auto 路由先判断 prompt 复杂度”的描述可以推断正是由分类器策略完成的。在 Gemini Code Assist 中启用 Gemini 3如果你使用的是Gemini Code Assist Standard 或 Enterprise在 Gemini CLI 上启用 Gemini 3 Pro 需要配置发布渠道release channels分为两步管理员启用 用户启用。管理员操作拥有Google Cloud Settings Admin权限的管理员需要打开 Gemini CLI for Code Assist 所使用的 Google Cloud 项目进入Admin for GeminiSettings在Release channels for Gemini Code Assist in local IDEs中选择Preview点击Save changes。用户操作管理员启用Preview后等待 23 分钟然后打开 Gemini CLI使用/settings命令将Preview Features设置为true。重启 Gemini CLI 后你就应该可以访问 Gemini 3 了。模型选择的优先级顺序当多个来源都指定了模型时实际使用哪一个由 Model routing 文档 定义的优先级顺序决定--model命令行标志启动时通过--model或其短形式-m指定的模型始终优先生效GEMINI_MODEL环境变量未使用--model时使用环境变量指定的模型settings.json中的model.name以上都未设置时使用配置文件中的model.name属性本地模型路由实验性若settings.json中启用了 Gemma 本地模型路由CLI 会使用本地 Gemma 模型来做出路由决策而非托管模型。该特性可通过自动化的gemini gemma setup命令配置有助于降低托管模型调用成本默认模型以上均未设置时使用默认模型默认为auto。这也解释了文档开头的示例gemini -m gemini-3.1-pro-preview为何能直接启动 3.1 模型命令行标志优先级最高会覆盖其余所有配置来源。小结与延伸阅读启用 Gemini 3 的核心路径升级到最新版 →/model→ 选择Auto (Gemini 3)需要精确控制时用-m指定具体模型如gemini-3.1-pro-preview。触达每日限额时按提示切换 2.5 系列或升级容量错误时Keep trying走指数退避重试也可以主动回退到 2.5 Pro。Code Assist 用户需管理员切换 Preview 发布渠道 用户侧将Preview Features置为true。遇到问题时建议在项目仓库的 issue 区先检索是否已有同类问题没有匹配项时再新建 issue或在讨论区discussions留言反馈。可进一步深入阅读的相关文档与源码Gemini CLI model selection/model 命令Model routing回退路由与优先级模型常量与解析逻辑配额/容量对话框实现模型可用性服务重试与指数退避工具【免费下载链接】gemini-cliAn open-source AI agent that brings the power of Gemini directly into your terminal.项目地址: https://gitcode.com/GitHub_Trending/gemi/gemini-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考