@hrcli/gemini-cli

v1.0.5

Published

3 months ago

基于 Google Gemini CLI 的增强版本，专为国内开发者优化，支持国产大模型。

0High
0Medium
0Low

hrcli

HRCLI Gemini CLI

基于 Google Gemini CLI 的增强版本，专为国内开发者优化，支持国产大模型。

特性

国产大模型支持：内置支持百炼、Kimi、智谱等国产大模型，无需 VPN
免费额度：使用个人 Google 账号可享受每分钟 60 次请求和每天 1,000 次请求
强大模型：支持 Gemini 2.5 系列模型，具有 1M token 上下文窗口
内置工具：Google 搜索增强、文件操作、Shell 命令、网页抓取
可扩展：支持 MCP（模型上下文协议）用于自定义集成
终端优先：专为命令行开发者设计
开源：Apache 2.0 许可证

安装

使用 npx 直接运行（推荐）

npx @hrcli/gemini-cli

全局安装

npm install -g @hrcli/gemini-cli

安装后直接运行：

gemini

认证方式

方式 1：使用 Google 登录（OAuth）

适合：个人开发者，免费使用 Gemini API

gemini
# 选择 "Sign in with Google" 完成浏览器认证

免费额度：每分钟 60 次请求，每天 1,000 次请求。

方式 2：Gemini API Key

适合：需要特定模型控制或付费额度

# 从 https://aistudio.google.com/apikey 获取
export GEMINI_API_KEY="YOUR_API_KEY"
gemini

方式 3：Vertex AI

适合：企业团队和生产环境

export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini

方式 4：国产大模型（OpenAI 兼容协议）

适合：国内开发者，无需 VPN

支持百炼、Kimi、智谱等国产模型：

# 百炼（阿里云）
export GEMINI_OPENAI_API_KEY="your-api-key"
export GEMINI_OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
export GEMINI_OPENAI_MODEL="qwen-plus"
gemini

# Kimi（月之暗面）
export GEMINI_OPENAI_API_KEY="your-api-key"
export GEMINI_OPENAI_BASE_URL="https://api.moonshot.cn/v1"
export GEMINI_OPENAI_MODEL="moonshot-v1-8k"
gemini

# 智谱 AI
export GEMINI_OPENAI_API_KEY="your-api-key"
export GEMINI_OPENAI_BASE_URL="https://open.bigmodel.cn/api/paas/v4"
export GEMINI_OPENAI_MODEL="glm-4"
gemini

快速开始

基本用法

# 在当前目录启动
gemini

# 包含多个目录
gemini --include-directories ../lib,../docs

# 使用特定模型
gemini -m gemini-2.5-flash

# 非交互模式（脚本使用）
gemini -p "解释这个代码库的架构"

# JSON 输出
gemini -p "分析代码" --output-format json

示例

cd new-project/
gemini
> 写一个 Discord 机器人，使用 FAQ.md 文件回答问题

git clone https://github.com/your-repo/project
cd project
gemini
> 给我一个昨天所有更改的摘要

核心功能

代码理解与生成

查询和编辑大型代码库
使用多模态能力从 PDF、图片或草图生成新应用
使用自然语言调试问题

自动化与集成

自动化运维任务
使用 MCP 服务器连接新能力
在脚本中非交互运行

高级能力

内置 Google 搜索增强
对话检查点保存和恢复
自定义上下文文件（GEMINI.md）

文档

与原版区别

本项目 fork 自 google-gemini/gemini-cli，主要增强：

国产模型支持：内置 OpenAI 兼容协议适配，支持百炼、Kimi、智谱等国产大模型
国内优化：针对国内网络环境优化，无需 VPN 即可使用国产模型

贡献

欢迎贡献！请查看贡献指南。

许可证

Apache License 2.0

致谢

感谢 Google 和开源社区构建的 Gemini CLI 项目。