一、Gemini CLI 简介
Gemini CLI 是 Google 推出的一款强大的命令行工具，它将 Gemini 大模型的能力直接带入终端，为开发者提供了一种高效、直接的方式与 AI 进行交互。这款工具不仅可以帮助开发者快速获取代码示例、解决编程问题，还能处理本地文件、执行系统命令等，极大地提升了开发效率。
核心优势
1. **免费且强大**：基于 Google 的 Gemini 2.5 Pro 模型，拥有高达 100 万 Token 的上下文窗口，能够处理大型文件甚至多个目录的深度架构分析。个人 Google 账号可获得每分钟 60 次请求和每天 1,000 次请求的免费配额。
2. **与本地环境深度集成**：可以读取本地文件、执行命令、访问互联网，并帮用户完成复杂的自动化任务。
3. **多模态支持**：支持文本、图片等多种输入形式，能够处理更复杂的任务。
二、安装前的准备工作
1. 安装 Node.js
Gemini CLI 是一个基于 Node.js 的工具，因此必须首先确保系统中安装了 Node.js 及其包管理器 npm。
检查是否已安装
打开终端，输入以下命令检查是否已安装 Node.js：
node -v
如果显示的版本号低于 v18.0.0 或显示 “command not found”，则需要安装或更新 Node.js。
安装 Node.js
在 Kali Linux 中，可以使用以下命令安装 Node.js：
添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
安装 Node.js
sudo apt-get install -y nodejs
安装完成后，再次运行 `node -v` 确认安装成功。
2. 获取 Google AI API 密钥
Gemini CLI 需要使用 Google AI API 密钥才能正常工作。可以按照以下步骤获取 API 密钥：
1. 访问 [Google AI Studio](https://aistudio.google.com/)。
2. 使用您的 Google 账户登录。
3. 点击 “创建 API 密钥” 并复制密钥。
三、安装 Gemini CLI
Gemini CLI 提供了多种安装方式，以下是两种常见的安装方法：
1. 使用 apt 安装（推荐）
在 Kali Linux 中，可以直接使用 apt 包管理器安装 Gemini CLI：
sudo apt install gemini-cli
2. 使用 npm 全局安装
也可以使用 npm 进行全局安装：
npm install -g @google/generative-ai-cli
安装完成后，运行以下命令检查是否安装成功：
gemini --version
如果显示版本号，则说明安装成功。
四、配置 Gemini CLI
1. 设置 API 密钥
安装完成后，需要配置 Google AI API 密钥。可以使用以下命令进行配置：
gemini config set api-key YOUR_API_KEY
将 `YOUR_API_KEY` 替换为您之前获取的 API 密钥。
2. 验证配置
配置完成后，可以运行以下命令验证配置是否成功：
gemini ask "你好，你能听到我吗？"
如果能收到 Gemini 的响应，则说明配置成功。
五、基本使用方法
1. 启动交互模式
在终端中输入以下命令即可启动 Gemini CLI 的交互模式：
gemini
启动后，会提示选择颜色主题，使用方向键选择喜欢的主题，然后按 Enter 确认。
2. 基本交互命令
Gemini CLI 支持多种交互方式，以下是一些常用的命令：
斜杠命令（/）：控制 CLI 本身的行为
/help # 显示帮助信息
/clear # 清空屏幕
/theme # 更改主题
/settings # 打开设置界面
/quit # 退出 CLI
At 命令（@）：引入文件内容作为上下文
@package.json # 将 package.json 内容添加到上下文
@src/ # 添加整个 src 目录作为上下文
感叹号命令（!）：执行系统命令
!ls -la # 列出当前目录文件
!git status # 查看 Git 状态
3. 非交互式使用
除了交互式会话，Gemini CLI 还支持非交互式使用，这对于自动化脚本非常有用：
直接获取问题答案
gemini --prompt "解释什么是异步编程"
将输出格式化为 JSON
gemini --prompt "列出 10 个 Linux 命令" --output-format json
从文件读取输入
gemini --prompt "$(cat prompt.txt)"
六、高级功能
1. 自定义命令
Gemini CLI 允许您创建自定义命令，将常用的复杂提示保存为简单的命令。自定义命令存储在 `~/.gemini/commands` 目录下，采用 TOML 格式。
例如，创建一个代码审查命令：
name = "code-review"
description = "对代码进行审查"
prompt = "请对以下代码进行审查：@file"
在 Gemini CLI 中使用：
@src/utils/parser.ts /code-review
2. 管理 MCP 服务器
Model Context Protocol (MCP) 服务器允许您为 Gemini CLI 添加自定义工具和功能。通过 MCP 服务器，您可以将 Gemini 2.5 Pro 与数据库、API 或其他服务集成。
可以使用以下命令管理 MCP 服务器：
gemini mcp # 管理 MCP 服务器
3. 保存和恢复会话
Gemini CLI 允许您保存当前对话状态，并在以后恢复，这对于处理复杂问题或中断后继续工作非常有用：
```bash
保存当前会话
/chat save project-refactor
列出所有保存的会话
/chat list
恢复之前的会话
/chat resume project-refactor
分享会话为 Markdown 文件
/chat share session-log.md
```
七、常见问题与解决方案
1. 启动时提示认证失败
**解决方案**：
- 检查 API 密钥是否正确设置。
- 确保您的 API 密钥具有访问 Gemini API 的权限。
- 尝试重新生成 API 密钥并更新环境变量。
2. 无法调用 Gemini 2.5 Pro 模型，提示“模型不存在”或类似错误
**解决方案**：
- 检查模型名称是否正确。可以使用以下命令查看当前使用的模型：
echo $GEMINI_MODEL
- 确保使用的模型名称是 Gemini API 支持的，可参考官方文档。
- 检查网络连接是否正常。
3. Gemini CLI 响应缓慢或占用过多资源
**解决方案**：
- 尝试减少上下文大小，只提供必要的文件。
- 使用 `/compress` 命令压缩对话历史，减少令牌使用：
/compress
- 检查是否有其他工具或 MCP 服务器占用资源：
/mcp
4. 无法执行 shell 命令或文件操作
**解决方案**：
- 检查沙箱设置，确保没有限制相关操作：
"tools": {
"sandbox": false
}
- 确认您在可信目录中运行 Gemini CLI，或配置可信文件夹：
/directory add ~/projects/my-trusted-project
- 检查工具权限设置，确保允许相关工具：
"tools": {
"allowed": ["run_shell_command", "write_file"]
}
八、总结
Ge# Kali Linux 下使用 Gemini CLI 全攻略
一、Gemini CLI 简介
Gemini CLI 是 Google 推出的一款强大的命令行工具，它将 Gemini 大模型的能力直接带入终端，为开发者提供了一种高效、直接的方式与 AI 进行交互。这款工具不仅可以帮助开发者快速获取代码示例、解决编程问题，还能处理本地文件、执行系统命令等，极大地提升了开发效率。
核心优势
1. **免费且强大**：基于 Google 的 Gemini 2.5 Pro 模型，拥有高达 100 万 Token 的上下文窗口，能够处理大型文件甚至多个目录的深度架构分析。个人 Google 账号可获得每分钟 60 次请求和每天 1,000 次请求的免费配额。
2. **与本地环境深度集成**：可以读取本地文件、执行命令、访问互联网，并帮用户完成复杂的自动化任务。
3. **多模态支持**：支持文本、图片等多种输入形式，能够处理更复杂的任务。
二、安装前的准备工作
1. 安装 Node.js
Gemini CLI 是一个基于 Node.js 的工具，因此必须首先确保系统中安装了 Node.js 及其包管理器 npm。
检查是否已安装
打开终端，输入以下命令检查是否已安装 Node.js：
node -v
如果显示的版本号低于 v18.0.0 或显示 “command not found”，则需要安装或更新 Node.js。
安装 Node.js
在 Kali Linux 中，可以使用以下命令安装 Node.js：
添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
安装 Node.js
sudo apt-get install -y nodejs
安装完成后，再次运行 `node -v` 确认安装成功。
2. 获取 Google AI API 密钥
Gemini CLI 需要使用 Google AI API 密钥才能正常工作。可以按照以下步骤获取 API 密钥：
1. 访问 [Google AI Studio](https://aistudio.google.com/)。
2. 使用您的 Google 账户登录。
3. 点击 “创建 API 密钥” 并复制密钥。
三、安装 Gemini CLI
Gemini CLI 提供了多种安装方式，以下是两种常见的安装方法：
1. 使用 apt 安装（推荐）
在 Kali Linux 中，可以直接使用 apt 包管理器安装 Gemini CLI：
sudo apt install gemini-cli
2. 使用 npm 全局安装
也可以使用 npm 进行全局安装：
npm install -g @google/generative-ai-cli
安装完成后，运行以下命令检查是否安装成功：
gemini --version
如果显示版本号，则说明安装成功。
四、配置 Gemini CLI
1. 设置 API 密钥
安装完成后，需要配置 Google AI API 密钥。可以使用以下命令进行配置：
gemini config set api-key YOUR_API_KEY
将 `YOUR_API_KEY` 替换为您之前获取的 API 密钥。
2. 验证配置
配置完成后，可以运行以下命令验证配置是否成功：
gemini ask "你好，你能听到我吗？"
如果能收到 Gemini 的响应，则说明配置成功。
五、基本使用方法
1. 启动交互模式
在终端中输入以下命令即可启动 Gemini CLI 的交互模式：
gemini
启动后，会提示选择颜色主题，使用方向键选择喜欢的主题，然后按 Enter 确认。
2. 基本交互命令
Gemini CLI 支持多种交互方式，以下是一些常用的命令：
斜杠命令（/）：控制 CLI 本身的行为
/help 显示帮助信息
/clear 清空屏幕
/theme 更改主题
/settings 打开设置界面
/quit 退出 CLI
At 命令（@）：引入文件内容作为上下文
@package.json 将 package.json 内容添加到上下文
@src/ # 添加整个 src 目录作为上下文
感叹号命令（!）：执行系统命令
!ls -la # 列出当前目录文件
!git status # 查看 Git 状态
3. 非交互式使用
除了交互式会话，Gemini CLI 还支持非交互式使用，这对于自动化脚本非常有用：
直接获取问题答案
gemini --prompt "解释什么是异步编程"
将输出格式化为 JSON
gemini --prompt "列出 10 个 Linux 命令" --output-format json
从文件读取输入
gemini --prompt "$(cat prompt.txt)"
六、高级功能
1. 自定义命令
Gemini CLI 允许您创建自定义命令，将常用的复杂提示保存为简单的命令。自定义命令存储在 `~/.gemini/commands` 目录下，采用 TOML 格式。
例如，创建一个代码审查命令：
name = "code-review"
description = "对代码进行审查"
prompt = "请对以下代码进行审查：@file"
在 Gemini CLI 中使用：
@src/utils/parser.ts /code-review
2. 管理 MCP 服务器
Model Context Protocol (MCP) 服务器允许您为 Gemini CLI 添加自定义工具和功能。通过 MCP 服务器，您可以将 Gemini 2.5 Pro 与数据库、API 或其他服务集成。
可以使用以下命令管理 MCP 服务器：
gemini mcp 管理 MCP 服务器
3. 保存和恢复会话
Gemini CLI 允许您保存当前对话状态，并在以后恢复，这对于处理复杂问题或中断后继续工作非常有用：
保存当前会话
/chat save project-refactor
列出所有保存的会话
/chat list
恢复之前的会话
/chat resume project-refactor
分享会话为 Markdown 文件
/chat share session-log.md
七、常见问题与解决方案
1. 启动时提示认证失败
**解决方案**：
- 检查 API 密钥是否正确设置。
- 确保您的 API 密钥具有访问 Gemini API 的权限。
- 尝试重新生成 API 密钥并更新环境变量。
2. 无法调用 Gemini 2.5 Pro 模型，提示“模型不存在”或类似错误
**解决方案**：
- 检查模型名称是否正确。可以使用以下命令查看当前使用的模型：
echo $GEMINI_MODEL
- 确保使用的模型名称是 Gemini API 支持的，可参考官方文档。
- 检查网络连接是否正常。
3. Gemini CLI 响应缓慢或占用过多资源
**解决方案**：
- 尝试减少上下文大小，只提供必要的文件。
- 使用 `/compress` 命令压缩对话历史，减少令牌使用：
/compress
- 检查是否有其他工具或 MCP 服务器占用资源：
/mcp
4. 无法执行 shell 命令或文件操作
**解决方案**：
- 检查沙箱设置，确保没有限制相关操作：
"tools": {
"sandbox": false
}
- 确认您在可信目录中运行 Gemini CLI，或配置可信文件夹：
/directory add ~/projects/my-trusted-project
- 检查工具权限设置，确保允许相关工具：
"tools": {
"allowed": ["run_shell_command", "write_file"]
}
八、总结
Gemini CLI 是一款功能强大的命令行工具，它将 Gemini 大模型的能力直接带入终端，为开发者提供了一种高效、直接的方式与 AI 进行交互。通过本教程，您可以快速掌握在 Kali Linux 下安装、配置和使用 Gemini CLI 的方法，提升开发效率。
希望本教程对您有所帮助，如果您在使用过程中遇到任何问题，欢迎在评论区留言交流。mini CLI 是一款功能强大的命令行工具，它将 Gemini 大模型的能力直接带入终端，为开发者提供了一种高效、直接的方式与 AI 进行交互。通过本教程，您可以快速掌握在 Kali Linux 下安装、配置和使用 Gemini CLI 的方法，提升开发效率。
希望本教程对您有所帮助，如果您在使用过程中遇到任何问题，欢迎在评论区留言交流。
