Gemini Cli配置教程

Gemini Cli 是 Google 官方推出的命令行工具，为开发者提供强大的 AI 辅助编程体验。支持智能代码生成、代码分析、调试助手等功能。

:rocket: 主要功能

智能代码生成 - 快速生成高质量代码
代码分析 - 深度理解和分析代码结构
调试助手 - 智能发现和修复代码问题
文档生成 - 自动生成代码文档
命令行集成 - 无缝集成到开发流程

:star: 哪些模型可以使用Gemini Cli

本站所有Gemini 模型均支持在 Gemini Cli 中使用

:package: 安装步骤

一、安装Gemini Cli

npm install -g @google/gemini-cli  # macOS/Linux需sudo权限

二、Mac & Liunx配置方式

Terminal 设置方法

在 Terminal 中运行以下命令：

export GOOGLE_GEMINI_BASE_URL="https://api.4allapi.com"
export GEMINI_API_KEY="你的API密钥"
export GEMINI_MODEL="gemini-3-pro"

永久设置方法

添加到你的 shell 配置文件：

对于 zsh (默认)

echo 'export GOOGLE_GEMINI_BASE_URL="https://api.4allapi.com"' >> ~/.zshrc
echo 'export GEMINI_API_KEY="你的API密钥"' >> ~/.zshrc
echo 'export GEMINI_MODEL="gemini-2.5-pro"' >> ~/.zshrc
source ~/.zshrc

对于 bash

echo 'export GOOGLE_GEMINI_BASE_URL="https://api.4allapi.com"' >> ~/.bash_profile
echo 'export GEMINI_API_KEY="你的API密钥"' >> ~/.bash_profile
echo 'export GEMINI_MODEL="gemini-2.5-pro"' >> ~/.bash_profile
source ~/.bash_profile

验证 Gemini CLI 环境变量

在 Terminal 中验证：

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

三、Windows配置方式

PowerShell 设置方法

在 PowerShell 中运行以下命令：

$env:GOOGLE_GEMINI_BASE_URL = "https://api.4allapi.com"
$env:GEMINI_API_KEY = "你的API密钥"
$env:GEMINI_MODEL = "gemini-3-pro"

PowerShell 永久设置（用户级）

在 PowerShell 中运行以下命令：

# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.4allapi.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的API密钥", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-2.5-pro", [System.EnvironmentVariableTarget]::User)

:bulb: 设置后需要重新打开 PowerShell 窗口才能生效。

验证 Gemini CLI 环境变量

在 PowerShell 中验证：

echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL

核心命令详解

基础交互

gemini  # 进入交互模式
gemini -p "解释这段代码" @./src/utils.js  # 文件分析
gemini --media wireframe.png "转换为React组件"  # 多模态处理

会话管理

# 查看命令帮助
/quit  # 退出并显示会话统计
/chat save feature_dev  # 保存当前会话
/chat resume feature_dev  # 恢复会话

工具集成

!ls -la  # 执行系统命令
/tools  # 显示可用工具
gemini review --staged-files --format=checklist  # Git集成

代码库操作

gemini -p "@./ 总结项目架构"  # 全目录分析
gemini -p "@src/components/Button.jsx 生成单元测试"  # 指定文件
gemini "迁移Django项目到Python3.12"  # 复杂任务分解

高级内存管理(/memory命令)

命令对比

命令	功能	使用场景
/memory add	添加新指令	gemini /memory add "总是用中文回复"
/memory show	显示当前记忆	验证AI上下文
/memory refresh	重载配置文件	更新 GEMINI.md 之后

配置文件实践

1. 创建 GEMINI.md 定义项目规则：

# 项目规范
- 使用TypeScript严格模式
- 函数命名：camelCase
- API响应格式：{ data, error }

2. 刷新配置：

/memory refresh  # 重载所有配置
/memory show  # 验证加载内容

支持多级目录自动扫描，企业项目可定义团队统一标准

状态恢复(/restore命令)

操作流程

# 启动时启用检查点
gemini --checkpointing

# 执行可能修改文件的操作后
/restore  # 查看可恢复点

# 恢复到指定状态
/restore checkpoint_42

适用场景：

代码生成实验失败后回滚
文件编辑错误时恢复
批量操作前的安全快照

错误处理指南

常见错误解决方案

错误类型	现象	解决方案
认证失败	API key not found	检查环境变量或重设config.json
配额超限	429 Too Many Requests	切换其他模型或等待
上下文溢出	无明确错误码(性能下降)	精简输入/分块处理
文件创建失败	权限不足	管理员权限运行或检查目录权限
网络异常	连接超时	1. 验证代理2. 使用curl测试API可达性

调试工具

gemini -d  # 启用详细调试模式
/stats  # 查看资源使用情况

4All API 页脚

4All API · 一站式AI大模型API聚合平台 | 价格 | 联系我们