在 Gemini CLI 上使用 Gemini 3 Pro 和 Gemini 3 Flash

Gemini 3 Pro 和 Gemini 3 Flash 现已在 Gemini CLI 上可用！目前，大多数 Gemini CLI 的付费客户都可以访问 Gemini 3 Pro 和 Gemini 3 Flash，包括以下订阅者：

• Google AI Pro 和 Google AI Ultra（不包括企业客户）。
• Gemini Code Assist 标准版和企业版（需要管理员启用）。
• 付费 Gemini API 和 Vertex API 密钥持有者。

对于免费层用户：

• 如果你注册了等待名单，请查看你的电子邮件了解详情。我们已经为之前可用等待名单上的所有人开通了访问权限。
• 如果你不在我们的等待名单上，我们正在逐步推出额外的访问权限，以确保体验保持快速和可靠。请继续关注更多详情。

如何在 Gemini CLI 上开始使用 Gemini 3

首先将 Gemini CLI 升级到最新版本（0.21.1）：

npm install -g @google/gemini-cli@latest

确认你的版本是 0.21.1 或更高版本后：

1. 在 Gemini CLI 中使用 /settings 命令。
2. 将 Preview Features 切换为 true。
3. 运行 /model 并选择 Auto (Gemini 3)。

有关更多信息，请参阅 Gemini CLI 模型选择。

使用限制和回退

当你达到 Gemini 3 Pro 每日使用限制时，Gemini CLI 会告诉你。当你遇到该限制时，你将有选项切换到 Gemini 2.5 Pro、升级以获得更高限制或停止。你还会被告知使用限制何时重置，届时可以再次使用 Gemini 3 Pro。

同样，当你达到 Gemini 2.5 Pro 的每日使用限制时，你会看到提示回退到 Gemini 2.5 Flash 的消息。

容量错误

有时 Gemini 3 Pro 模型可能会过载。发生这种情况时，Gemini CLI 会询问你是否要继续尝试 Gemini 3 Pro 或回退到 Gemini 2.5 Pro。

注意： Keep trying 选项使用指数退避，当系统繁忙时，Gemini CLI 在每次重试之间等待更长时间。如果重试没有立即发生，请等待几分钟让请求处理。

模型选择和路由类型

使用 Gemini CLI 时，你可能想要控制请求如何在模型之间路由。默认情况下，Gemini CLI 使用 Auto 路由。

使用 Gemini 3 Pro 时，你可能想要使用 Auto 路由或 Pro 路由来管理使用限制：

• Auto 路由： Auto 路由首先确定提示是否涉及复杂或简单的操作。对于简单的提示，它会自动使用 Gemini 2.5 Flash。对于复杂的提示，如果启用了 Gemini 3 Pro，它将使用 Gemini 3 Pro；否则，它将使用 Gemini 2.5 Pro。
• Pro 路由： 如果你想确保任务由最强大的模型处理，使用 /model 并选择 Pro。Gemini CLI 将优先使用最强大的可用模型，包括 Gemini 3 Pro（如果已启用）。

要了解更多关于选择模型和路由的信息，请参阅 Gemini CLI 模型选择。

如何在 Gemini Code Assist 上启用 Gemini 3 与 Gemini CLI

如果你使用的是 Gemini Code Assist 标准版或 Gemini Code Assist 企业版，在 Gemini CLI 上启用 Gemini 3 Pro 需要配置你的发布渠道。使用 Gemini 3 Pro 需要两个步骤：管理员启用和用户启用。

要了解更多关于这些设置的信息，请参阅 配置 Gemini Code Assist 发布渠道。

管理员说明

具有 Google Cloud Settings Admin 权限的管理员必须按照以下说明操作：

• 导航到你与 Gemini CLI for Code Assist 一起使用的 Google Cloud 项目。
• 转到 Admin for Gemini > Settings。
• 在 Release channels for Gemini Code Assist in local IDEs 下选择 Preview。
• 点击 Save changes。

用户说明

在管理员启用 Preview 后等待两到三分钟，然后：

• 打开 Gemini CLI。
• 使用 /settings 命令。
• 将 Preview Features 设置为 true。

重启 Gemini CLI，你应该可以访问 Gemini 3。

需要帮助？

如果你需要帮助，我们建议搜索现有的 GitHub issue。如果找不到与你问题匹配的 GitHub issue，你可以创建新 issue。对于评论和反馈，请考虑开启 GitHub 讨论。