Gemini 专项：antigravityCli 安装、原生接入与 MCP 配置

前言

聊大模型的时候，Gemini 是个挺尴尬的存在：前端和审美是真好，但兼容性是硬伤——没法原生接进通用客户端，就算通过网关塞进去了，工具调用、MCP 也各种别扭，还带个 thinking 标签的毛病。

那它到底该怎么用才顺？我的答案是：别硬塞，用它自己的 CLI。

这篇就把 antigravityCli 这套东西一次讲清楚：怎么装、怎么接入、环境变量怎么配、常用配置有哪些、MCP 怎么挂。文中配置都是我本机正在跑的，直接抄就能用。

版本说明：我本机跑的是 Antigravity CLI 1.1.28（截图里能看到），而写这篇时官网下载页已经是 v1.2.0。新版界面细节可能和我截图略有差别，但下面要讲的配置项是一致的。

一、下载安装与首次运行

下载页在 antigravity.google/download，官网直接给了各终端的安装命令，不用自己找包。

Windows PowerShell（我用的是这个，一行搞定）：

irm https://antigravity.google/cli/install.ps1 | iex

Windows CMD：

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

装完之后，直接在终端敲 antigravity 就能起来。启动那几行信息很有用，别跳过：

从图里可以看到它自报家门的四项：

• Antigravity CLI 1.1.28 —— 版本号

• Gemini API key —— key 是从环境变量读到的（说明环境变量配对了）

• Gemini 3.8 Flash (High) —— 当前用的模型和思考档

• E:\selfWork\temp —— 当前工作区

二、先把配置目录认清楚

这类工具最好用的地方在于：所有东西都是明文的配置文件。知道去哪儿找，基本就不用看文档了。它的家目录在：

C:\Users\<用户名>\.gemini\antigravity-cli\

三、原生协议接入：settings.json

这是最关键的一步。我的 settings.json 全文如下，就这么几行：

{
  "artifactReviewPolicy": "always-proceed",
  "model": "Gemini 3.8 Flash (High)",
  "modelProvider": "gemini",
  "runningLightSpeed": "fast",
  "toolPermission": "always-proceed",
  "trustedWorkspaces": [
  ]
}

逐项说明：

四、环境变量：把请求指向第三方地址

CLI 默认连官方，但我们实际都会走中转。要改的就两个环境变量：

表格里的地址是我自己在用的中转服务（也就是本站域名下的 api.zjh336.cn），你照着换成自己的中转地址就行，关键是这个变量名别写错。

Windows 上两种加法，选一个：

• 图形界面：设置 → 系统 → 系统信息 → 高级系统设置 → 环境变量 → 用户变量，新建上面两条（我就是这么加的，直观）。

• 命令行（永久生效）：setx GEMINI_API_KEY "sk-你的key"、setx GOOGLE_GEMINI_BASE_URL "https://api.zjh336.cn/"。

中转分组一定要选对

还有一步很容易被忽略：中转平台里要选对分组。同一个平台往往有好几组，走的协议和倍率都不一样：

从图里能看出几个规律，照着选基本不会错：

• 认准写着“反重力 cli 接入”的那一组——它才是按原生协议给这个 CLI 用的；

• 标着 “chat 协议接入”的分组是给另一种调用方式的，用在这里可能就跑不通；

• 有些组会注明“便宜、速度快、有缓存”，有的注明“较慢且无缓存”——同样是 Gemini，走不同分组体验差别很大；

• 倍率直接等于你的花费：2.5x 和 1x 差了 2.5 倍，选之前先看清。

五、MCP 配置：mcp_config.json

MCP 是让 CLI 能调用外部能力的机制（连数据库、操作浏览器等）。配置就写在一个文件里，我的全文如下：

{
  "mcpServers": {
    "playwright": {
      "command": "cmd.exe",
      "args": ["/c", "npx", "-y", "@playwright/mcp@latest"],
      "disabled": false
    },
    "dbhub-mysql": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "pnpm",
        "dlx",
        "--package", "@bytebase/dbhub@latest",
        "--package", "zod@3.25.76",
        "dbhub",
        "--config", "C:/Users/Administrator/.codex/temp-mysql-config.toml",
        "--transport", "stdio"
      ],
      "disabled": false
    },
    "redis-mcp": {
      "command": "cmd.exe",
      "args": ["/c", "npx", "-y", "@modelcontextprotocol/server-redis", "redis://localhost:6379"],
      "disabled": false
    }
  }
}

我配的三个各有用途：

六、跑起来是什么样

配置弄好之后，用起来是这种感觉——下面是我实际的一次会话（图有点长，看结构就行）：

拆开看，它干活的链路大概是：

1. Thought Process —— 先想清楚要干什么；

2. ReadURL / WebSearch —— 去读网页、搜索；

3. Bash(Resolve-DnsName ...) —— 需要验证的时候就自己跑系统命令；

4. Read(~/.gemini/.../steps/N/content.md) —— 读取自己之前记下来的步骤产物。

有一次还挺有意思：我让它访问一个网址，结果我自己少打了一个字母（把 .com 打成了 .cm）。它先读了 URL，又跑去查 DNS，发现解析不了，然后自己判断出“域名后缀写错了”，改成正确地址打开，还顺手把网站信息总结给我了。

还有一次我说“用 playwright 的 mcp”，它没有瞎猜，而是先去翻了 builtin/skills/agy-customizations/docs/mcp_servers.md——先查文档再动手，这个习惯挺加分。

七、顺带说清：Gemini CLI 和 antigravityCli 到底啥区别

Gemini 官方其实还有个更早、更出名的命令行工具 Gemini CLI（就是敲 gemini 那个）。很多人第一次接触 Gemini 就是用它，ccswitch 这类切换工具里也把它列成一个可选项。所以经常有人问：这俩到底有什么区别，我该用哪个？

它的模型候选就是这几个：

• gemini-3.1-pro-preview

• gemini-3-flash-preview

• gemini-2.5-pro

• gemini-3.1-flash-lite

• gemini-3.5-flash

• gemma-4-31b-it / gemma-4-26b-a4b-it（开源小模型）

两者的区别

官方为什么这么分？我的推测

1. 产品分层。把最新最强的模型留给新的 agent 产品，等于给 Antigravity 一个“非用不可”的理由；老工具卡在上一代，两边定位不打架。

2. 成本控制。Gemini CLI 是开源、额度相对友好的工具，如果放开最新最贵的型号，额度和成本都不好控。

3. 形态要求不同。Antigravity 是 agent 形态，要连续跑长任务、反复调工具，对模型的指令遵循和上下文要求更高；CLI 更像是问答加轻量工具调用，用中档模型也够。

对我们的实际影响

1. 想用最新模型，基本没得选——得走 antigravity 这条线；

2. ccswitch 能切 ≠ 能用：切过去之后模型清单是对方限定的，换之前先确认目标模型在不在列表里；

3. 两边配置不通用：MCP、权限、信任目录都要各配一套，别想着复制过去就能跑；

4. 中转倍率可能不一样：两套工具走的分组和计费倍率未必相同，换之前先看清；

5. 我的建议：要前端、要审美、要跑 agent 类的活，上 antigravity；只是快速问一句、跑个轻量任务，用简单的那个就够了。

八、踩坑记录

九、小结

1. Gemini 别硬塞进通用客户端，用它自己的 CLI 才顺；

2. 配置全在 ~/.gemini/antigravity-cli/ 下，两个文件搞定：settings.json 和 mcp_config.json；

3. 原生接入的关键是 modelProvider: "gemini"，别写成兼容层；

4. 走中转要改 GEMINI_API_KEY + GOOGLE_GEMINI_BASE_URL 两个环境变量，记得重开终端；

5. 中转分组要选对，协议不匹配跑不通，倍率选错白花钱；

6. MCP 在 Windows 上记得用 cmd.exe /c 起；

7. 不会配就问它本人——它会去读本地的 SKILL.md 文档；

8. 另一个 Gemini CLI（gemini）是另一套东西：更轻，但模型最高只到 gemini-3.5-flash，想要 3.8 Flash 就得用 antigravity。