Google 侧的终端 Agent 在 2026 年做过一次换代：个人计划上的 Gemini CLI 由 Antigravity CLI 接替，企业 Code Assist 另有安排。具体停服时间与可用计划请以 Google 官方公告为准——第三方文章的日期彼此矛盾，不适合当决策依据。对国内用户来说更实际的是：换了工具，网络问题一个没少，登录回调和终端不走代理依然是失败的前两名。
同类文章：Gemini 国内访问、Claude Code 代理、Codex CLI 代理、Tun 与 AI 工具。
迁移前先确认三件事
- 账号与计划：你用的是个人账号还是企业 Code Assist？两条线的可用工具和额度不同，别照搬别人的截图。
- 命令名与配置文件：换代后命令名、配置目录、扩展/MCP 的注册方式都可能变。以官方文档当前页为准，不要沿用旧笔记里的路径。
- 旧配置残留：旧 CLI 留下的凭证缓存与环境变量可能干扰新工具登录。迁移失败时，先在干净的新终端里试一次。
两种代理打法，选一种别叠加
| 方式 | 适合 | 注意 |
|---|---|---|
| Tun 模式 | 不想给每个终端设变量；工具本身不读系统代理 | 需服务模式/管理员权限，见 Tun 启动失败 |
| 环境变量 | 公司电脑禁装虚拟网卡 | 只对当前终端生效，新开窗口要重设 |
排错阶段两种只留一种。同时开着，一旦不通你会分不清是变量没生效还是隧道没接管。端口以 Clash Verge 界面显示的混合端口为准，别照抄文章里的数字（混合端口说明）。
登录环节：回环必须放行
这类 CLI 的 OAuth 通常是：终端拉起浏览器 → 你在网页里授权 → 浏览器把结果回调到本机的一个临时端口。如果你导出了 HTTP_PROXY/HTTPS_PROXY 却没设 NO_PROXY，回调会被推给代理，表现就是「网页显示成功，终端永远在等」。
做法：登录前把 127.0.0.1,localhost 写进 NO_PROXY，或者干脆用 Tun 模式登录。远程 SSH、无图形界面的机器上，按官方文档改用设备码/粘贴授权码的登录方式，不要在服务器上死等浏览器。
export HTTPS_PROXY=http://127.0.0.1:7897
export HTTP_PROXY=http://127.0.0.1:7897
export NO_PROXY=127.0.0.1,localhost变量要在启动 CLI 的那个终端里设好再拉起工具；端口换成客户端显示的混合端口，别照抄。
失败现象分流
| 现象 | 先看 | 下一步 |
|---|---|---|
| 连接超时、长时间无响应 | 连接页有没有出站记录 | 没记录=终端没走代理；开 Tun 或设变量后新开终端 |
| 登录网页成功、终端不动 | NO_PROXY 是否放行回环 | 补变量或换设备码登录 |
| 提示地区/国家不支持 | 出口节点与账号区域 | 换更干净的节点，用测速筛，别狂重试 |
| 429 / 配额提示 | 计划与当日额度 | 属于账号侧，和代理无关 |
| 能聊天但工具调用失败 | 扩展或 MCP 的连接方式 | 远程 MCP 走网络，见 MCP 连不上排查 |
迁移后的第一天怎么用
别急着让它重构半个仓库。先在 Git 仓库根目录下一个只读任务确认它看得见项目，再给一个能验收的小改动（改一个函数、跑一条你熟悉的测试）。这样一旦出问题，你能立刻分清是网络、是权限，还是模型本身没做好——这套节奏和Claude Code、Codex CLI 是一样的。
同时装多个 Agent 的人越来越多。共用一个 Clash Verge 完全没问题，但验收要分开：今天测 Antigravity，就只打它的最小请求。想统一管理多个上游与额度，可以再看 9Router 的用法。
验收清单
- Clash Verge 连上可用节点，浏览器能开海外站点。
- 新开终端，确认代理方式只启用了一种。
- 完成登录（回环已放行）。
- 在仓库里跑通一个只读任务。
- 连接页能看到对应出站记录——这是「真的走通了」的唯一硬证据。
客户端从下载中心获取。终端变量细节见PowerShell / Git / npm 代理；WSL2 用户另见 WSL2 代理。