Google Antigravity CLI (agy) 安装与使用教程Google Antigravity是一个 AI 优先的开发平台提供 CLI、IDE、桌面应用和 Python SDK 等多种交互方式。本文聚焦于Antigravity CLI (agy)的安装、配置与日常使用。目录1. 概述2. 安装3. 首次启动与认证4. 网络环境要求5. 配置使用国内模型6. TUI 界面导航7. 斜杠命令速查表8. 配置文件详解9. 实用技巧10. Antigravity 生态一览11. Python SDK 快速上手12. 常用资源与链接1. 概述Antigravity CLI命令为agy是一个轻量级的终端 AI Agent 交互界面。你可以在终端中直接与 AI Agent 进行对话、编写代码、执行命令、管理项目一切都在终端内完成。官网地址https://antigravity.google核心优势 轻量快速无需打开 IDE 强大的 Agent 能力读写文件、执行命令、搜索代码、浏览网页 高度可定制Skills、Rules、MCP、Hooks 等扩展机制 安全可控沙箱模式、权限审批、受信工作区2. 安装2.1 前提条件操作系统macOS / Linux / Windows终端支持 UTF-8 编码的现代终端如 iTerm2、Warp、GNOME Terminal、Windows Terminal、PowerShell 等Google 账号用于 OAuth 认证网络环境需要能够访问 Google 服务详见 第 4 章 网络环境要求2.2 安装方式方式一通过官方安装脚本推荐macOS / Linuxcurl-fsSLhttps://antigravity.google/cli/install.sh|bashWindowsPowerShell以管理员身份运行irmhttps://antigravity.google/cli/install.ps1|iex安装完成后确认agy已加入 PATHagy--version方式二通过 npm 安装全平台通用npminstall-ggoogle/antigravity-cli方式三通过 winget 安装仅 Windowswinget install Google.AntigravityCLI方式四手动下载前往 Antigravity 官方下载页面 选择对应平台的安装包手动安装。Windows 用户提示安装后可能需要重启终端或手动将安装路径添加到系统环境变量PATH中。默认安装路径为%LOCALAPPDATA%\AntigravityCLI\。3. 首次启动与认证3.1 启动 CLI在终端中执行agy3.2 OAuth 认证流程首次运行时CLI 会提示你进行 Google 账号认证按下Enter键打开浏览器 OAuth 页面在浏览器中登录你的 Google 账号并授权复制授权码粘贴回终端中认证成功后即可开始使用提示认证信息会被缓存后续启动无需重复登录。使用/logout命令可退出当前账号。4. 网络环境要求⚠️重要提示Antigravity CLI 需要访问外网Google 服务才能正常使用和 Claude Code 一样。每次你输入 “agy” 启动工具时客户端在加载本地配置之前都会在后台向 Google 的中心服务器发起一次合规性握手和鉴权状态检查类似于软件的联网激活验证。如果此时完全断网或无法触达外网CLI 会在初始化阶段直接报错退出你甚至无法进入终端交互界面。5. 配置使用国内模型Antigravity CLI 默认使用 Google Gemini 系列模型但也支持通过多种方式接入国内或第三方模型。5.1 通过/model命令切换内置模型在 CLI 中直接输入/model会列出所有可用的内置 Gemini 模型如gemini-3.5-flash、gemini-pro等选择后立即生效。5.2 通过 Vertex AI 接入 GCP 上的模型如果你的企业在 GCP 上部署了模型包括 Gemini 或通过 Model Garden 部署的第三方模型可以通过配置gcp字段来使用// ~/.gemini/antigravity-cli/settings.json{model:gemini-3.5-flash,gcp:{project:your-gcp-project-id,location:asia-east1}}可选的亚太区域区域代码位置asia-east1台湾彰化asia-east2香港asia-northeast1东京asia-southeast1新加坡提示使用距离较近的 GCP 区域可以降低延迟。asia-east1和asia-east2通常对国内用户延迟最低。5.3 通过 MCP 桥接国内大模型Antigravity 支持 Model Context Protocol (MCP)你可以通过 MCP 服务器将国内大模型如通义千问、文心一言、DeepSeek、智谱 GLM 等的能力接入到 Agent 工作流中。步骤 1创建 MCP 配置文件在项目根目录下创建.agents/mcp.json{servers:{domestic-llm:{command:node,args:[path/to/your/mcp-bridge-server.js],env:{API_KEY:your-api-key,API_BASE_URL:https://api.deepseek.com/v1}}}}步骤 2验证 MCP 服务器在 CLI 中执行/mcp查看是否成功连接/mcp5.4 通过 OpenAI 兼容 API 代理许多国内大模型提供了 OpenAI 兼容的 API 接口你可以搭配社区 MCP 工具使用。常见的国内模型 API 端点模型提供商API 基础地址说明DeepSeekhttps://api.deepseek.com/v1兼容 OpenAI 格式通义千问阿里https://dashscope.aliyuncs.com/compatible-mode/v1兼容 OpenAI 格式智谱 GLMhttps://open.bigmodel.cn/api/paas/v4兼容 OpenAI 格式月之暗面 Kimihttps://api.moonshot.cn/v1兼容 OpenAI 格式百川https://api.baichuan-ai.com/v1兼容 OpenAI 格式5.5 配置优先级说明模型的选择遵循以下优先级从高到低/model命令在当前会话中的临时切换settings.json中的model字段Antigravity 2.0 / IDE 中 Settings 页面的模型选择系统默认值gemini-3.5-flash6. TUI 界面导航4.1 基本快捷键快捷键功能Enter发送消息ESC关闭活动菜单如/skills、/settingsCtrlD CtrlD退出 CLI等同于/exit或/quit↑/↓浏览历史命令4.2 交互方式直接输入文字与 AI Agent 对话提出问题或下达任务输入/开头的命令执行特定操作见下方命令表输入引用上下文附加文件、目录、历史会话等上下文信息7. 斜杠命令速查表以下命令仅在 CLI 终端中可用5.1 会话管理命令说明/clear或/new清屏并重置滚动缓冲区/fork或/branch将当前会话分叉为新线程保留历史/resume、/switch或/conversation恢复历史会话/rename重命名当前会话/rewind或/undo回退到之前的检查点/exit或/quit退出 CLI5.2 上下文与信息命令说明/context查看当前 Agent 上下文中的所有文件和符号/diff查看 Agent 对代码库所做的变更 diff/copy将 Agent 最近一次回复复制到剪贴板/artifact打开 TUI 产物查看器/usage或/quota查看 Token 使用量和会话费用统计5.3 配置与扩展命令说明/config或/settings打开配置面板/model切换当前使用的 Gemini 模型/skills查看所有已激活的 Skills/agents查看所有活跃的子代理/hooks查看所有注册的生命周期钩子/mcp查看活跃的 MCP 服务器及其工具/permissions管理工具执行权限5.4 工作区与其他命令说明/add-dir添加新目录到工作区/open在本地编辑器中打开文件/btw快速提问不启动完整 Agent 运行/tasks查看活跃任务列表和进度/planning打开交互式图形化规划编辑器/help显示帮助菜单/changelog查看产品更新日志/feedback提交反馈或 Bug 报告/fast切换快速模式控制输出速度/keybindings查看/配置快捷键/statusline切换状态栏显示/title切换/配置终端标题/credits查看第三方软件许可/logout退出当前 Google 账号8. 配置文件详解6.1 配置文件路径~/.gemini/antigravity-cli/settings.json6.2 完整配置项配置键类型说明默认值modelstring当前使用的模型gemini-3.5-flashcolorSchemestring配色方案terminal、dark、lightterminaltoolPermissionstring工具确认模式always-proceed、request-review、strict、proceed-in-sandboxrequest-reviewenableTerminalSandboxbool是否在沙箱中运行命令falseallowNonWorkspaceAccessbool是否允许读写工作区外文件falseeditorstring首选编辑器命令如vim、nano、autoautohistorySizeint持久化的历史记录条数-1为无限2000notificationsbool任务完成时是否发送系统通知falseenableTelemetrybool是否开启匿名使用统计truerunningLightSpeedstring打字延迟速度off、fast、medium、slowmediumverbositystringAgent 追踪渲染详细度high、lowhighartifactReviewPolicystring产物审查策略always-proceed、agent-decides、asks-for-reviewasks-for-reviewaltScreenModestring备用屏幕缓冲区default、always、neverdefaultshowTipsbool是否显示使用提示trueshowFeedbackSurveybool是否显示反馈调查trueuseG1Creditsbool是否使用 Google One AI 高级配额falsegcpobjectGCP 项目和区域配置nilpermissionsobject全局允许/拒绝规则nilstatusLineobject状态栏配置niltitleobject终端标题配置niltrustedWorkspacesarray受信任工作区路径列表[]6.3 配置示例{model:gemini-3.5-flash,colorScheme:dark,toolPermission:request-review,enableTerminalSandbox:true,allowNonWorkspaceAccess:false,editor:vim,historySize:5000,notifications:true,runningLightSpeed:fast,verbosity:high,trustedWorkspaces:[/Users/you/projects/my-app,/Users/you/projects/my-lib]}9. 实用技巧7.1 快速提问不启动完整 Agent使用/btw命令可以快速问一个小问题Agent 不会进入完整的多步骤工作流程/btw Java 中 HashMap 和 TreeMap 的区别是什么7.2 查看和回滚变更/diff # 查看 Agent 做了哪些代码变更 /rewind # 回退到之前的状态7.3 管理多个会话/fork # 从当前会话分叉一个新线程 /resume # 恢复之前的会话 /rename # 给当前会话取一个易记的名字7.4 自定义扩展在项目根目录下创建.agents/文件夹可以定义Rules规则在.agents/AGENTS.md中编写行为约束和风格指南Skills技能在.agents/skills/skill_name/SKILL.md中定义专用技能MCP 服务器通过配置接入外部 MCP 工具服务7.5 Agent 内置斜杠命令在与 Agent 对话时还可以使用以下内置命令来触发特定行为命令说明/goal执行长时间运行的目标任务Agent 会更加彻底/schedule设置定时任务或一次性计时器/grill-me通过互动访谈对齐方案设计/learn让 Agent 记住某个行为模式以备后用10. Antigravity 生态一览Google Antigravity 不仅仅是一个 CLI 工具而是一整个 AI 开发生态系统8.1 Antigravity CLI (agy)轻量级终端交互界面适合快速任务和命令行爱好者。8.2 Antigravity IDE基于 VS Code 的独立 AI 优先 IDE提供三种 AI 交互模式模式说明快捷键Tab 补全上下文感知的智能代码补全和导航Tab接受内联命令选中代码后进行局部重构或生成⌘I(macOS) /CtrlI(Linux)侧边栏 Agent多步骤协作编程支持读写文件、运行命令等侧边栏面板8.3 Antigravity 2.0桌面应用基于 Electron 的桌面应用提供统一的 Agent 管理平台项目管理多工作区切换定时任务Cron 定时和一次性延迟任务Skills 自定义可视化管理技能、规则、插件和 MCP 服务器聊天画布支持斜杠命令、提及上下文、拖拽上传媒体文件权限设置全局和项目级的细粒度权限控制8.4 Python SDK用于在 Python 脚本、自动化流水线或测试套件中以编程方式操作 Agent。11. Python SDK 快速上手9.1 安装pipinstallgoogle-antigravity⚠️ SDK 依赖平台特定的编译运行时二进制文件请务必通过pip安装以获取正确的二进制。9.2 基本示例importasyncioimportsysfromgoogle.antigravityimportAgent,LocalAgentConfig,CapabilitiesConfigasyncdefmain():# 配置 Agent默认只读模式传入 CapabilitiesConfig() 可启用写工具configLocalAgentConfig(system_instructions你是一个代码库导航专家。,capabilitiesCapabilitiesConfig(),)# 通过异步上下文管理器创建 AgentasyncwithAgent(config)asagent:# 发送提示词并获取响应responseawaitagent.chat(写一个简单的 Python 脚本来列出文件。)# 流式输出响应 Tokenasyncfortokeninresponse:sys.stdout.write(token)sys.stdout.flush()print()if__name____main__:asyncio.run(main())9.3 高级功能监控 Agent 思考过程asyncforthoughtinresponse.thoughts:print(f[思考中]{thought})拦截工具调用asyncforcallinresponse.tool_calls:print(f[执行工具]{call.name}参数:{call.args})交互式对话循环fromgoogle.antigravityimportAgent,LocalAgentConfig,CapabilitiesConfigfromgoogle.antigravity.utils.interactiveimportrun_interactive_loop configLocalAgentConfig(capabilitiesCapabilitiesConfig())asyncwithAgent(config)asagent:awaitrun_interactive_loop(agent)12. 常用资源与链接资源链接 官方文档首页https://antigravity.google/docs Skills 文档https://antigravity.google/docs/skills Rules 文档https://antigravity.google/docs/rules Hooks 文档https://antigravity.google/docs/hooks Plugins 文档https://antigravity.google/docs/plugins Sidecars 文档https://antigravity.google/docs/sidecars MCP 文档https://antigravity.google/docs/mcp 浏览器自动化https://antigravity.google/docs/browser 权限与安全https://antigravity.google/docs/agent-permissions 更新日志https://antigravity.google/changelog 故障排除与支持https://antigravity.google/support Python SDK (GitHub)https://github.com/google-antigravity/antigravity-sdk-python