mirror of
https://github.com/google-gemini/gemini-cli.git
synced 2026-03-10 22:21:22 -07:00
120 lines
4.4 KiB
Markdown
120 lines
4.4 KiB
Markdown
# Gemini 3 Pro and Gemini 3 Flash on Gemini CLI
|
||
|
||
Gemini 3 Pro and Gemini 3 Flash are available on Gemini CLI for all users!
|
||
|
||
> **Note:** Gemini 3.1 Pro Preview is rolling out. To determine whether you have
|
||
> access to Gemini 3.1, use the `/model` command and select **Manual**. If you
|
||
> have access, you will see `gemini-3.1-pro-preview`.
|
||
>
|
||
> If you have access to Gemini 3.1, it will be included in model routing when
|
||
> you select **Auto (Gemini 3)**. You can also launch the Gemini 3.1 model
|
||
> directly using the `-m` flag:
|
||
>
|
||
> ```
|
||
> gemini -m gemini-3.1-pro-preview
|
||
> ```
|
||
>
|
||
> Learn more about [models](../cli/model.md) and
|
||
> [model routing](../cli/model-routing.md).
|
||
|
||
## How to get started with Gemini 3 on Gemini CLI
|
||
|
||
Get started by upgrading Gemini CLI to the latest version:
|
||
|
||
```bash
|
||
npm install -g @google/gemini-cli@latest
|
||
```
|
||
|
||
After you’ve confirmed your version is 0.21.1 or later:
|
||
|
||
1. Run `/model`.
|
||
2. Select **Auto (Gemini 3)**.
|
||
|
||
For more information, see [Gemini CLI model selection](../cli/model.md).
|
||
|
||
### Usage limits and fallback
|
||
|
||
Gemini CLI will tell you when you reach your Gemini 3 Pro daily usage limit.
|
||
When you encounter that limit, you’ll be given the option to switch to Gemini
|
||
2.5 Pro, upgrade for higher limits, or stop. You’ll also be told when your usage
|
||
limit resets and Gemini 3 Pro can be used again.
|
||
|
||
> **Note:** Looking to upgrade for higher limits? To compare subscription
|
||
> options and find the right quota for your needs, see our
|
||
> [Plans page](/plans/).
|
||
|
||
Similarly, when you reach your daily usage limit for Gemini 2.5 Pro, you’ll see
|
||
a message prompting fallback to Gemini 2.5 Flash.
|
||
|
||
### Capacity errors
|
||
|
||
There may be times when the Gemini 3 Pro model is overloaded. When that happens,
|
||
Gemini CLI will ask you to decide whether you want to keep trying Gemini 3 Pro
|
||
or fallback to Gemini 2.5 Pro.
|
||
|
||
> **Note:** The **Keep trying** option uses exponential backoff, in which Gemini
|
||
> CLI waits longer between each retry, when the system is busy. If the retry
|
||
> doesn't happen immediately, please wait a few minutes for the request to
|
||
> process.
|
||
|
||
### Model selection and routing types
|
||
|
||
When using Gemini CLI, you may want to control how your requests are routed
|
||
between models. By default, Gemini CLI uses **Auto** routing.
|
||
|
||
When using Gemini 3 Pro, you may want to use Auto routing or Pro routing to
|
||
manage your usage limits:
|
||
|
||
- **Auto routing:** Auto routing first determines whether a prompt involves a
|
||
complex or simple operation. For simple prompts, it will automatically use
|
||
Gemini 2.5 Flash. For complex prompts, if Gemini 3 Pro is enabled, it will use
|
||
Gemini 3 Pro; otherwise, it will use Gemini 2.5 Pro.
|
||
- **Pro routing:** If you want to ensure your task is processed by the most
|
||
capable model, use `/model` and select **Pro**. Gemini CLI will prioritize the
|
||
most capable model available, including Gemini 3 Pro if it has been enabled.
|
||
|
||
To learn more about selecting a model and routing, refer to
|
||
[Gemini CLI Model Selection](../cli/model.md).
|
||
|
||
## How to enable Gemini 3 with Gemini CLI on Gemini Code Assist
|
||
|
||
If you're using Gemini Code Assist Standard or Gemini Code Assist Enterprise,
|
||
enabling Gemini 3 Pro on Gemini CLI requires configuring your release channels.
|
||
Using Gemini 3 Pro will require two steps: administrative enablement and user
|
||
enablement.
|
||
|
||
To learn more about these settings, refer to
|
||
[Configure Gemini Code Assist release channels](https://developers.google.com/gemini-code-assist/docs/configure-release-channels).
|
||
|
||
### Administrator instructions
|
||
|
||
An administrator with **Google Cloud Settings Admin** permissions must follow
|
||
these directions:
|
||
|
||
- Navigate to the Google Cloud Project you're using with Gemini CLI for Code
|
||
Assist.
|
||
- Go to **Admin for Gemini** > **Settings**.
|
||
- Under **Release channels for Gemini Code Assist in local IDEs** select
|
||
**Preview**.
|
||
- Click **Save changes**.
|
||
|
||
### User instructions
|
||
|
||
Wait for two to three minutes after your administrator has enabled **Preview**,
|
||
then:
|
||
|
||
- Open Gemini CLI.
|
||
- Use the `/settings` command.
|
||
- Set **Preview Features** to `true`.
|
||
|
||
Restart Gemini CLI and you should have access to Gemini 3.
|
||
|
||
## Need help?
|
||
|
||
If you need help, we recommend searching for an existing
|
||
[GitHub issue](https://github.com/google-gemini/gemini-cli/issues). If you
|
||
cannot find a GitHub issue that matches your concern, you can
|
||
[create a new issue](https://github.com/google-gemini/gemini-cli/issues/new/choose).
|
||
For comments and feedback, consider opening a
|
||
[GitHub discussion](https://github.com/google-gemini/gemini-cli/discussions).
|