Gemini CLI 中转站配置使用教程适用读者:想在国内使用Gemini CLI 的用户阅读时长:约 12 分钟测试时间:2026 年 7 月(基于 炻光 AI 接入管理平台 公开文档)基本介绍Gemini CLI 是谷歌提供的开源命令行 AI 工具将 Gemini 的强大功能直接带入您的终端。它提供轻量级的 Gemini 访问方式为您提供从提示到模型的最直接路径。通过设置中转站代理您可以在网络受限的情况下正常使用 Gemini CLI 服务。 为什么选择 Gemini CLI 强大的 Gemini 2.5 Pro访问 100 万 token 上下文窗口 内置工具Google 搜索基础功能、文件操作、Shell 命令、网页抓取 可扩展支持 MCP模型上下文协议进行自定义集成 终端优先专为在命令行中工作的开发者设计️ 开源Apache 2.0 许可证 安装方式快速安装使用 npx 即时运行无需安装# 使用官方仓库npx https://github.com/google-gemini/gemini-cli使用 npm 全局安装npminstall-ggoogle/gemini-cli使用 Homebrew 安装macOS/Linuxbrewinstallgemini-cli系统要求Node.js 版本 20 或更高macOS、Linux 或 Windows配置中转站代理使用1. 设置环境变量在使用中转站之前您需要配置以下环境变量# 设置 API 密钥exportGEMINI_API_KEYsk-xxxxx# 设置 API 中转站地址exportGOOGLE_GEMINI_BASE_URLhttps://selltoken.top#cmd 使用下面这个setGEMINI_API_KEYsk-xxxxxsetGOOGLE_GEMINI_BASE_URLhttps://selltoken.top注意您也可以将这些环境变量添加到.bashrc、.zshrc或其他 shell 配置文件中这样每次启动终端时都会自动设置这些变量。 快速开始基本使用在当前目录启动gemini包含多个目录gemini --include-directories../lib,../docs使用特定模型gemini-mgemini-2.5-flash脚本非交互模式获取简单文本响应gemini-p解释这个代码库的架构获取结构化 JSON 输出gemini-p解释这个代码库的架构--output-format json快速示例启动新项目cdnew-project/ gemini为我编写一个 Discord 机器人使用我提供的 FAQ.md 文件回答问题分析现有代码gitclone https://github.com/google-gemini/gemini-clicdgemini-cli gemini给我一个昨天所有更改的摘要 主要功能代码理解与生成查询和编辑大型代码库使用多模态能力从 PDF、图片或草图生成新应用使用自然语言调试问题和故障排除自动化与集成自动化操作任务如查询拉取请求或处理复杂的变基操作使用 MCP 服务器连接新功能在脚本中非交互式运行以实现工作流自动化高级功能使用内置 Google 搜索获取实时信息对话检查点以保存和恢复复杂会话自定义上下文文件GEMINI.md为您的项目定制行为常用命令和功能示例探索代码库 描述这个系统架构的主要组成部分 有哪些安全机制 为新开发者提供一份分步骤的入门文档处理现有代码 为 GitHub issue #123 实现一个初稿 帮我将这个代码库迁移到最新版本的 Java。先制定一个计划自动化工作流程 制作一个幻灯片展示过去 7 天的 git 历史按功能和团队成员分组 制作一个全屏 Web 应用用于墙上显示展示我们互动最多的 GitHub issues系统交互 将此目录中的所有图像转换为 png并使用 exif 数据中的日期重命名它们 按支出月份整理我的 PDF 发票GitHub 集成使用Gemini CLI GitHub Action将 Gemini CLI 直接集成到您的 GitHub 工作流中拉取请求审查自动代码审查提供上下文反馈和建议Issue 分类基于内容分析自动标记和优先级排序 GitHub issues按需帮助在 issues 和拉取请求中提及gemini-cli获取调试、解释或任务委派的帮助自定义工作流构建适合您团队需求的自动化、定时和按需工作流故障排除如果您在使用过程中遇到问题可以参考以下几点检查环境变量是否正确设置echo$GEMINI_API_KEYecho$GOOGLE_GEMINI_BASE_URL检查网络连接是否稳定中转站是否可访问curl-Ihttps://selltoken.top查看是否有错误信息输出这些信息通常会指示问题所在如果使用 SOCKS 代理确保代理格式正确例如socks5://user:passproxy:port使用内置命令报告问题# 在 CLI 中直接报告 bug/bug发布版本说明预览版Preview每周二 UTC 23:59 发布新的预览版本。使用preview标签安装npminstall-ggoogle/gemini-clipreview稳定版Stable每周二 UTC 20:00 发布新的稳定版本。使用latest标签安装npminstall-ggoogle/gemini-clilatest每夜版Nightly每天 UTC 00:00 发布每夜版本。使用nightly标签安装npminstall-ggoogle/gemini-clinightlyMCP 服务器使用在~/.gemini/settings.json中配置 MCP 服务器以扩展 Gemini CLI 的自定义工具 github 列出我的开放拉取请求 slack 向 #dev 频道发送今天提交的摘要 database 运行查询查找不活跃用户 相关资源官方路线图查看即将推出的功能NPM 包包注册表GitHub Issues报告 bug 或请求功能安全建议安全更新卸载如果您需要卸载 Gemini CLI请参考官方的卸载指南。
