Gemini CLI 中使用最新的 Gemini 3 Pro 模型（含实用技巧）

**见字如面，与大家分享实践中的经验与思考。**

在持续使用 Gemini CLI 三个多月后，作为一款免费的 CLI 工具，尽管它在编程领域不如 Claude Code 和 Codex 强大，但在其他方面仍有不少优势。下面分享我选择它的原因以及它的价值。

## 为什么选择 Gemini CLI

选择 Gemini CLI 很大原因在于它免费。每天提供 1000 次免费请求额度，如果你有 2 个及以上的 Google 账号，额度用尽后切换账号即可继续使用。

此外，Gemini Pro 模型拥有超长上下文和强大的推理能力，非常适合分析项目需求和撰写各类文档。

<img width="668" height="194" src=":/b6e96f940ca5471c9d3035ff9e3dd3f6"/>

## 安装 Gemini CLI

使用以下命令进行安装：

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

在终端切换到你的项目目录后，执行：

`cd  your-project/gemini`

## 启用 Gemini 3 模型

升级到最新版本 `0.16.0`，输入 `/settings`，将预览功能 `Preview Features` 设置为开启，如下图。

<img width="668" height="545" src=":/b6396ea2448142d6b8f0c927229b0a87"/>

按照提示按 `r` 退出设置界面，重新运行 `gemini`，即可使用最新的 `gemini-3-pro` 模型。

![images-20251120-18.20.16@2x](data:image/svg+xml,%3C%3Fxml%20version='1.0'%20encoding='UTF-8'%3F%3E%3Csvg%20width='1px'%20height='1px'%20viewBox='0%200%201%201'%20version='1.1'%20xmlns='http://www.w3.org/2000/svg'%20xmlns:xlink='http://www.w3.org/1999/xlink'%3E%3Ctitle%3E%3C/title%3E%3Cg%20stroke='none'%20stroke-width='1'%20fill='none'%20fill-rule='evenodd'%20fill-opacity='0'%3E%3Cg%20transform='translate%28-249.000000,%20-126.000000%29'%20fill='%23FFFFFF'%3E%3Crect%20x='249'%20y='126'%20width='1'%20height='1'%3E%3C/rect%3E%3C/g%3E%3C/g%3E%3C/svg%3E)

如果你是免费用户，需要先获取到使用权限，访问`https://goo.gle/geminicli-waitlist-signup`，填写邮箱并加入候补名单，审核通过后才可使用。

![images-20251120-19.14.38@2x](data:image/svg+xml,%3C%3Fxml%20version='1.0'%20encoding='UTF-8'%3F%3E%3Csvg%20width='1px'%20height='1px'%20viewBox='0%200%201%201'%20version='1.1'%20xmlns='http://www.w3.org/2000/svg'%20xmlns:xlink='http://www.w3.org/1999/xlink'%3E%3Ctitle%3E%3C/title%3E%3Cg%20stroke='none'%20stroke-width='1'%20fill='none'%20fill-rule='evenodd'%20fill-opacity='0'%3E%3Cg%20transform='translate%28-249.000000,%20-126.000000%29'%20fill='%23FFFFFF'%3E%3Crect%20x='249'%20y='126'%20width='1'%20height='1'%3E%3C/rect%3E%3C/g%3E%3C/g%3E%3C/svg%3E)

## Gemini CLI 实用技巧

### 01 重置每日额度

使用 `/auth` 命令，选择 `Login with Google`，会自动跳转到浏览器，可快速切换个人 Gmail 账户，用于重置每日额度。

![images-20251120-18.42.47@2x](data:image/svg+xml,%3C%3Fxml%20version='1.0'%20encoding='UTF-8'%3F%3E%3Csvg%20width='1px'%20height='1px'%20viewBox='0%200%201%201'%20version='1.1'%20xmlns='http://www.w3.org/2000/svg'%20xmlns:xlink='http://www.w3.org/1999/xlink'%3E%3Ctitle%3E%3C/title%3E%3Cg%20stroke='none'%20stroke-width='1'%20fill='none'%20fill-rule='evenodd'%20fill-opacity='0'%3E%3Cg%20transform='translate%28-249.000000,%20-126.000000%29'%20fill='%23FFFFFF'%3E%3Crect%20x='249'%20y='126'%20width='1'%20height='1'%3E%3C/rect%3E%3C/g%3E%3C/g%3E%3C/svg%3E)

### 02 切换模型

随着版本更新，进入 CLI 后默认使用 `auto` 模式进行模型自动选择。若任务复杂且需要推理，使用 `/model` 切换到 `pro` 模型。

![images-20251120-18.44.41@2x](data:image/svg+xml,%3C%3Fxml%20version='1.0'%20encoding='UTF-8'%3F%3E%3Csvg%20width='1px'%20height='1px'%20viewBox='0%200%201%201'%20version='1.1'%20xmlns='http://www.w3.org/2000/svg'%20xmlns:xlink='http://www.w3.org/1999/xlink'%3E%3Ctitle%3E%3C/title%3E%3Cg%20stroke='none'%20stroke-width='1'%20fill='none'%20fill-rule='evenodd'%20fill-opacity='0'%3E%3Cg%20transform='translate%28-249.000000,%20-126.000000%29'%20fill='%23FFFFFF'%3E%3Crect%20x='249'%20y='126'%20width='1'%20height='1'%3E%3C/rect%3E%3C/g%3E%3C/g%3E%3C/svg%3E)

如果你的任务较为复杂且需要推理，直接选择 `Pro` 模型。不要使用 `Auto` 和 `Flash`，效果通常不佳。

### 03 规则和记忆

Gemini CLI 使用 `GEMINI.md` 文件来自定义规则。你可以在项目根目录放置本地规则文件；另有全局规则文件，位置为 `~/.gemini/GEMINI.md`。当使用 `/memory` 功能时，条目会加入到全局规则中。

![images-20251120-18.51.59@2x](data:image/svg+xml,%3C%3Fxml%20version='1.0'%20encoding='UTF-8'%3F%3E%3Csvg%20width='1px'%20height='1px'%20viewBox='0%200%201%201'%20version='1.1'%20xmlns='http://www.w3.org/2000/svg'%20xmlns:xlink='http://www.w3.org/1999/xlink'%3E%3Ctitle%3E%3C/title%3E%3Cg%20stroke='none'%20stroke-width='1'%20fill='none'%20fill-rule='evenodd'%20fill-opacity='0'%3E%3Cg%20transform='translate%28-249.000000,%20-126.000000%29'%20fill='%23FFFFFF'%3E%3Crect%20x='249'%20y='126'%20width='1'%20height='1'%3E%3C/rect%3E%3C/g%3E%3C/g%3E%3C/svg%3E)

使用过程中，CLI 可能会自动将一些 Memory 加入全局规则。建议通过 `/memory show` 查看并清理，避免不必要的规则影响你的项目。

![images-20251120-18.55.20@2x](data:image/svg+xml,%3C%3Fxml%20version='1.0'%20encoding='UTF-8'%3F%3E%3Csvg%20width='1px'%20height='1px'%20viewBox='0%200%201%201'%20version='1.1'%20xmlns='http://www.w3.org/2000/svg'%20xmlns:xlink='http://www.w3.org/1999/xlink'%3E%3Ctitle%3E%3C/title%3E%3Cg%20stroke='none'%20stroke-width='1'%20fill='none'%20fill-rule='evenodd'%20fill-opacity='0'%3E%3Cg%20transform='translate%28-249.000000,%20-126.000000%29'%20fill='%23FFFFFF'%3E%3Crect%20x='249'%20y='126'%20width='1'%20height='1'%3E%3C/rect%3E%3C/g%3E%3C/g%3E%3C/svg%3E)

在项目中的 `GEMINI.md` 中可以定义整个项目的核心上下文，包括但不限于：

- 开发命令（Development Commands）
    
- 操作约束（Operation Constraints）
    
- 项目架构（Project Architecture）
    
- 认证与权限（Authentication and Authorization）
    
- 开发流程（Development Process）
    
- 注意事项（Important Notes）
    

按照上述方式定义的核心上下文规则，也可以复用于 Claude Code 的 `CLAUDE.md`、Codex 和 Cursor 的 `AGENTS.md`。

### 04 添加上下文

可以使用 `@` 符号添加目录或文件，但这种方式效率较低。复杂项目的目录结构往往庞杂，人工选择非常耗时。建议结合 IDE（如 Cursor 等），直接从 IDE 将目录或文件拖入 CLI。

如下图，如此冗长的路径若靠手动使用 `@` 添加，效率很低。

![images-20251120-19.04.53@2x](data:image/svg+xml,%3C%3Fxml%20version='1.0'%20encoding='UTF-8'%3F%3E%3Csvg%20width='1px'%20height='1px'%20viewBox='0%200%201%201'%20version='1.1'%20xmlns='http://www.w3.org/2000/svg'%20xmlns:xlink='http://www.w3.org/1999/xlink'%3E%3Ctitle%3E%3C/title%3E%3Cg%20stroke='none'%20stroke-width='1'%20fill='none'%20fill-rule='evenodd'%20fill-opacity='0'%3E%3Cg%20transform='translate%28-249.000000,%20-126.000000%29'%20fill='%23FFFFFF'%3E%3Crect%20x='249'%20y='126'%20width='1'%20height='1'%3E%3C/rect%3E%3C/g%3E%3C/g%3E%3C/svg%3E)

### 05 添加 MCP 工具

可以在 `~/.gemini/settings.json` 中添加你想使用的 MCP 工具：

![images-20251120-19.09.50@2x](data:image/svg+xml,%3C%3Fxml%20version='1.0'%20encoding='UTF-8'%3F%3E%3Csvg%20width='1px'%20height='1px'%20viewBox='0%200%201%201'%20version='1.1'%20xmlns='http://www.w3.org/2000/svg'%20xmlns:xlink='http://www.w3.org/1999/xlink'%3E%3Ctitle%3E%3C/title%3E%3Cg%20stroke='none'%20stroke-width='1'%20fill='none'%20fill-rule='evenodd'%20fill-opacity='0'%3E%3Cg%20transform='translate%28-249.000000,%20-126.000000%29'%20fill='%23FFFFFF'%3E%3Crect%20x='249'%20y='126'%20width='1'%20height='1'%3E%3C/rect%3E%3C/g%3E%3C/g%3E%3C/svg%3E)

举个简单的例子，参考如下图示：

![images-20251120-19.19.44@2x](data:image/svg+xml,%3C%3Fxml%20version='1.0'%20encoding='UTF-8'%3F%3E%3Csvg%20width='1px'%20height='1px'%20viewBox='0%200%201%201'%20version='1.1'%20xmlns='http://www.w3.org/2000/svg'%20xmlns:xlink='http://www.w3.org/1999/xlink'%3E%3Ctitle%3E%3C/title%3E%3Cg%20stroke='none'%20stroke-width='1'%20fill='none'%20fill-rule='evenodd'%20fill-opacity='0'%3E%3Cg%20transform='translate%28-249.000000,%20-126.000000%29'%20fill='%23FFFFFF'%3E%3Crect%20x='249'%20y='126'%20width='1'%20height='1'%3E%3C/rect%3E%3C/g%3E%3C/g%3E%3C/svg%3E)

中间省略工具查询的过程，下面是最终结果：

![images-20251120-19.20.38@2x](data:image/svg+xml,%3C%3Fxml%20version='1.0'%20encoding='UTF-8'%3F%3E%3Csvg%20width='1px'%20height='1px'%20viewBox='0%200%201%201'%20version='1.1'%20xmlns='http://www.w3.org/2000/svg'%20xmlns:xlink='http://www.w3.org/1999/xlink'%3E%3Ctitle%3E%3C/title%3E%3Cg%20stroke='none'%20stroke-width='1'%20fill='none'%20fill-rule='evenodd'%20fill-opacity='0'%3E%3Cg%20transform='translate%28-249.000000,%20-126.000000%29'%20fill='%23FFFFFF'%3E%3Crect%20x='249'%20y='126'%20width='1'%20height='1'%3E%3C/rect%3E%3C/g%3E%3C/g%3E%3C/svg%3E)

## 最后

Gemini CLI 的免费额度充足，建议结合自身情况合理利用。我几乎不使用 Gemini CLI 直接编写代码，因为较难控制生成与修改；如果你确实需要用它写代码，务必配合 Git。

Gemini CLI 的一大优势是强大的推理能力和超长上下文。我认为它非常适合撰写各类文档，如项目中的 SQL、需求分析、开发任务清单等。可以先与它讨论需求或方案，确认无误后生成对应的 Markdown 文档，再让 Cursor、Codex 或 Claude Code 等 AI 工具完成代码编写。

## 参考

- Gemini 3 Pro On Gemini CLI <sup>\[1\]</sup>
    

* * *

欢迎关注公众号"**Eric技术圈**"，原创技术文章第一时间推送。

#### 引用链接

`[1]` Gemini 3 Pro On Gemini CLI: *https://github.com/google-gemini/gemini-cli/blob/main/docs/get-started/gemini-3.md*

id: f94b82cc242c4f4b92d58f7de06a0f46
parent_id: c4b5bbe706394f1a919a418c1f48165a
created_time: 2025-12-04T14:10:10.718Z
updated_time: 2025-12-04T14:10:10.718Z
is_conflict: 0
latitude: 0.00000000
longitude: 0.00000000
altitude: 0.0000
author: 
source_url: https://mp.weixin.qq.com/s/nxYr_alZfklC9AXCWciztQ
is_todo: 0
todo_due: 0
todo_completed: 0
source: joplin-desktop
source_application: net.cozic.joplin-desktop
application_data: 
order: 1764857410718
user_created_time: 2025-12-04T14:10:10.718Z
user_updated_time: 2025-12-04T14:10:10.718Z
encryption_cipher_text: 
encryption_applied: 0
markup_language: 1
is_shared: 0
share_id: 
conflict_original_id: 
master_key_id: 
user_data: 
deleted_time: 0
type_: 1