Gemini CLI 国内怎么用:官方现状与安装方式
先看现状:软件能装,服务不一定开放
Gemini CLI 是开源的命令行程序,下载和安装本身没有地区门槛。真正决定能不能用的,是它登录后要调用的那项谷歌服务。以中国大陆的个人用户为例,目前的官方情况可以归纳成两句:
- 走 Gemini API 这条路,可用地区页里找不到中国大陆,香港和澳门也不在,台湾在。
- 走网页版 Gemini 那套个人账号,中国大陆仅限 Workspace 工作账号。
换句话说,在中国大陆用个人账号,眼下没有一条官方支持的使用途径。在这之前装好软件,也只是把程序放在了电脑上。
README 给出的几种装法
如果你所在的地区和账号都符合条件,可以按 google-gemini/gemini-cli 仓库首页的写法任选一种:
- 临时试用、不留安装:用 npx 直接运行官方包;
- 用 npm 装到全局;
- Homebrew(macOS、Linux)或 MacPorts(macOS);
- Anaconda 用户:新建带 nodejs 的 conda 环境,激活后再用 npm 全局安装。
具体命令和包名以官方 README 页面为准。Node.js 要几版,首页没有直接写数字,而是让读者去看安装文档里的推荐配置,以那里写的版本为准。
个人、开发者、企业各该准备什么
首页写明这个工具现在主要面向 Code Assist 的企业类许可,个人免费用户和个人订阅用户的适用情况有过调整,以官方 GitHub 仓库页面为准。按身份大致是:
- 公司买了 Code Assist:用公司分配的谷歌账号登录,并指定云项目。
- 只想调模型的开发者:自己申请 API 密钥,先确认所在地在 API 名单里。
- 个人订阅者:先读仓库首页对个人用户的说明,再决定用哪个工具。
建议的顺序
身份 → 登录方式 → 对应服务的地区页 → 安装。最后一步才是敲命令,前三步不符合,装好也用不了。
本站只整理官方写明的条件,不教借助代理或修改账户地区来绕开限制。
以上按 Google 官方页面 2026-11-16 的版本整理,以官方页面为准。