OpenCode + Antigravity Auth 插件完整使用教程

OpenCode + Antigravity Auth 插件完整使用教程

本教程将详细介绍如何安装和配置opencode-antigravity-auth插件,使 OpenCode 能够通过 OAuth 认证访问 Google 的Antigravity(Google 内部 IDE) 配额,从而使用gemini-3-proclaude-sonnet-4-5-thinking等顶级模型。


1. 简介

OpenCode是一款开源的 AI 编程助手,而opencode-antigravity-auth是为其开发的强力插件。通过该插件,你可以:

  • OAuth 登录:直接使用 Google 账号认证,无需手动管理复杂的 API Key。
  • 双重配额系统:同时使用 Antigravity 配额(支持 Claude 和 Gemini 3)和 Gemini CLI 配额。
  • 多账号轮询:支持添加多个 Google 账号,当一个账号达到频率限制(Rate Limit)时自动切换。
  • 深度思考模式:完美支持 Claude 的thinking_budget和 Gemini 3 的thinkingLevel


2. 功能特性

  • 实时流式传输:支持 SSE 流式输出,包括思考过程(Thinking Blocks)。
  • 模型变体 (Variants):通过 OpenCode 的变体系统动态配置思考预算。
  • 自动恢复:针对 Claude 的tool_result_missing等错误提供自动会话恢复机制。
  • 插件兼容性:可与opencodesync等其他插件协同工作。

3. 环境要求

在开始之前,请确保你的系统已安装以下组件:

  • Node.js:建议使用 v18 或更高版本。
  • OpenCode CLI:通过npm i -g opencode-ai@latest安装。
  • Google 账号:具有访问相关模型权限的 Google 账号。

4. 安装步骤

第一步:修改配置文件

你需要将插件添加到 OpenCode 的主配置文件opencode.json中。

配置文件路径:

  • Linux/Mac:~/.config/opencode/opencode.json
  • Windows:%APPDATA%\opencode\opencode.json

plugin数组中添加插件名称:

{"$schema":"https://opencode.ai/config.json","plugin":["opencode-antigravity-auth@beta"]}

第二步:进行身份验证

在终端运行以下命令启动 OAuth 认证流程:

opencode auth login

该命令会打开浏览器请求 Google 授权。授权成功后,认证信息将加密保存。

提示:授权完成后,浏览器会显示成功页面,终端也会提示认证成功。


5. 配置说明

完整的 opencode.json 示例

你可以直接将以下配置复制到你的opencode.json中,它包含了推荐的模型定义和变体配置。

{"$schema":"https://opencode.ai/config.json","plugin":["opencode-antigravity-auth@beta"],"provider":{"google":{"models":{"antigravity-gemini-3-pro":{"name":"Gemini 3 Pro (Antigravity)","limit":{"context":1048576,"output":65535},"modalities":{"input":["text","image","pdf"],"output":["text"]},"variants":{"low":{"thinkingLevel":"low"},"high":{"thinkingLevel":"high"}}},"antigravity-gemini-3-flash":{"name":"Gemini 3 Flash (Antigravity)","limit":{"context":1048576,"output":65536},"modalities":{"input":["text","image","pdf"],"output":["text"]},"variants":{"minimal":{"thinkingLevel":"minimal"},"low":{"thinkingLevel":"low"},"medium":{"thinkingLevel":"medium"},"high":{"thinkingLevel":"high"}}},"antigravity-claude-sonnet-4-5-thinking":{"name":"Claude Sonnet 4.5 Thinking (Antigravity)","limit":{"context":200000,"output":64000},"modalities":{"input":["text","image","pdf"],"output":["text"]},"variants":{"low":{"thinkingConfig":{"thinkingBudget":8192}},"max":{"thinkingConfig":{"thinkingBudget":32768}}}},"antigravity-claude-sonnet-4-5":{"name":"Claude Sonnet 4.5 (Antigravity)","limit":{"context":200000,"output":64000},"modalities":{"input":["text","image","pdf"],"output":["text"]}},"antigravity-claude-opus-4-5-thinking":{"name":"Claude Opus 4.5 Thinking (Antigravity)","limit":{"context":200000,"output":64000},"modalities":{"input":["text","image","pdf"],"output":["text"]},"variants":{"low":{"thinkingConfig":{"thinkingBudget":8192}},"max":{"thinkingConfig":{"thinkingBudget":32768}}}},"gemini-2.5-flash":{"name":"Gemini 2.5 Flash (Gemini CLI)","limit":{"context":1048576,"output":65536},"modalities":{"input":["text","image","pdf"],"output":["text"]}},"gemini-2.5-pro":{"name":"Gemini 2.5 Pro (Gemini CLI)","limit":{"context":1048576,"output":65536},"modalities":{"input":["text","image","pdf"],"output":["text"]}},"gemini-3-flash-preview":{"name":"Gemini 3 Flash Preview (Gemini CLI)","limit":{"context":1048576,"output":65536},"modalities":{"input":["text","image","pdf"],"output":["text"]}},"gemini-3-pro-preview":{"name":"Gemini 3 Pro Preview (Gemini CLI)","limit":{"context":1048576,"output":65535},"modalities":{"input":["text","image","pdf"],"output":["text"]}}}}}}

6. 使用方法

配置完成后,你可以通过命令行指定模型和变体来运行任务。

运行任务示例

使用 Claude Sonnet 4.5 思考模式(最大预算):

opencode run"帮我重构这段复杂的 JavaScript 代码"--model=google/antigravity-claude-sonnet-4-5-thinking --variant=max

使用 Gemini 3 Pro(高思考等级):

opencode run"分析这个架构设计的优缺点"--model=google/antigravity-gemini-3-pro --variant=high

7. 可用模型

Antigravity 配额模型

这些模型使用 Google 内部 IDE 的配额,支持变体配置。

模型 ID支持的变体说明
antigravity-gemini-3-prolow,highGemini 3 Pro,支持思考等级配置
antigravity-gemini-3-flashminimal,low,medium,highGemini 3 Flash,极速且支持思考
antigravity-claude-sonnet-4-5-Claude Sonnet 4.5 (标准版)
antigravity-claude-sonnet-4-5-thinkinglow,maxClaude Sonnet 4.5 (带思考预算)
antigravity-claude-opus-4-5-thinkinglow,maxClaude Opus 4.5 (顶级推理)

Gemini CLI 配额模型

这些模型通常使用标准的 Gemini API 预览版配额。

模型 ID说明
gemini-2.5-flashGemini 2.5 Flash
gemini-2.5-proGemini 2.5 Pro
gemini-3-flash-previewGemini 3 Flash (Preview)
gemini-3-pro-previewGemini 3 Pro (Preview)

8. 多账户设置

如果你有多个 Google 账号,可以叠加配额并实现自动轮询。

  1. 添加账号:再次运行opencode auth login
  2. 选择操作:系统会提示检测到已有账号,选择(a)dd new account(s)即可添加新账号。
  3. 自动轮询:插件会根据账号的健康状态自动切换。默认采用sticky策略(保持同一账号直到受限,以利用 Prompt 缓存)。

账号信息存储位置~/.config/opencode/antigravity-accounts.json,包含 OAuth refresh token,请妥善保管。


9. 高级配置 (antigravity.json)

你可以创建~/.config/opencode/antigravity.json文件来精细控制插件行为。

完整参数表

参数名默认值说明
quiet_modefalse静默模式,减少通知推送
debugfalse开启调试模式,日志保存在antigravity-logs/
keep_thinkingfalse实验性:保留 Claude 的思考过程以维持对话连贯性
session_recoverytrue会话自动恢复机制
account_selection_strategy"sticky"账号切换策略:sticky(粘性),round-robin(轮询),hybrid(混合)
quota_fallbackfalseGemini 专用:当 Antigravity 配额耗尽时自动尝试 CLI 配额
max_rate_limit_wait_seconds300遇到频率限制时的最大等待秒数

antigravity.json 示例

{"$schema":"https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json","quiet_mode":false,"debug":false,"keep_thinking":true,"account_selection_strategy":"sticky","quota_fallback":true}

10. 常见问题

Q: 登录时提示 “fail to authorize” 或 Safari 报错?

A: Safari 的 “HTTPS-Only Mode” 可能会干扰回调。建议:

  1. 使用 Chrome 或 Firefox 浏览器完成认证。
  2. 或者暂时关闭 Safari 的 HTTPS 强制跳转功能。

Q: 提示 “Permission denied” 或项目 ID 不存在?

A: 这通常发生在使用 Gemini CLI 模型时。

  1. 前往 Google Cloud Console。
  2. 创建一个项目并启用 “Gemini for Google Cloud API”。
  3. ~/.config/opencode/antigravity-accounts.json中为对应账号手动添加projectId字段。

Q: 插件没有加载?

A: 确保opencode.json中的plugin数组包含"opencode-antigravity-auth@beta"且拼写正确。重启 OpenCode。


11. 参考链接

  • OpenCode GitHub: anomalyco/opencode
  • 插件 GitHub: NoeFabris/opencode-antigravity-auth
  • NPM 页面: opencode-antigravity-auth

本教程由 AI 助手 Antigravity 生成,人工审核,旨在提供最准确的技术指导。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/1168418.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

基于django框架和python的全国面食文化交流平台

目录 全国面食文化交流平台摘要 关于博主开发技术路线相关技术介绍核心代码参考示例结论源码lw获取/同行可拿货,招校园代理 :文章底部获取博主联系方式! 全国面食文化交流平台摘要 该平台基于Django框架与Python技术栈开发,旨在构建一个集文…

2026必备!MBA毕业论文必备的8个AI论文平台深度测评

2026必备!MBA毕业论文必备的8个AI论文平台深度测评 2026年MBA论文写作工具测评:如何选择高效可靠的AI平台 随着人工智能技术的不断进步,越来越多的MBA学生开始借助AI工具提升论文写作效率。然而,面对市场上琳琅满目的AI论文平台&a…

7.4 API集成实战:连接不同平台实现数据互通

7.4 API集成实战:连接不同平台实现数据互通 在当今的数字化时代,企业和个人使用的应用程序和服务越来越多,从项目管理工具到社交媒体平台,从云存储服务到数据分析工具。这些系统各自存储着有价值的数据和功能,但往往相互独立,形成信息孤岛。API(Application Programmin…

企业如何构建兼容数据中心?核心架构与硬件选择指南

在当今企业数字化转型的浪潮中,构建一个兼容的数据中心(Compatible Data Center)已成为支撑业务灵活性与长期发展的基石。它不仅仅意味着硬件和软件的简单堆叠,更是一个系统性工程,旨在确保异构系统、新旧设备以及多样…

一文带搞懂大模型相关优化技术

前言 大模型优化技术的核心目标是在保证模型效果(精度、能力)的前提下,降低算力/存储成本、提升训练/推理效率、实现规模化落地。以下从7个核心维度,按从模型设计到落地部署的逻辑顺序展开分析,覆盖全生命周期关键优化…

7.2 私有AI助手部署指南:Dify打造企业级知识问答平台

7.2 私有AI助手部署指南:Dify打造企业级知识问答平台 在企业数字化转型过程中,知识管理和智能问答系统已成为提升组织效率和竞争力的关键工具。然而,许多企业对于将敏感数据和内部知识上传到第三方平台存在安全顾虑,同时也有定制化和控制权方面的需求。私有化部署的AI助手…

6.7 AI教练效果评估与优化:如何让AI教练更懂你,学习更高效

6.7 AI教练效果评估与优化:如何让AI教练更懂你,学习更高效 引言 在前面的章节中,我们学习了如何使用AI作为语言学习助手、专业技能导师、学习路径规划师等。但仅仅使用AI还不够,更重要的是如何评估AI教练的效果,并持续优化,让AI教练更懂你,学习更高效。本节将为你提供…

一文读懂SCI、SSCI、SCIE、ESCI的区别

很多刚接触SCI的人可能会混淆SCI、SSCI、SCIE、ESCI这几个词。其实他们都是Web of Science(WOS)收录的子集。收录在这几个索引工具下的期刊会被视为科技领域的权威期刊。 那如果想要发表论文,是不是可以每一个索引工具下的期刊都可以选呢 其…

7.1 无代码开发入门:用Coze搭建专属智能客服系统

7.1 无代码开发入门:用Coze搭建专属智能客服系统 在数字化转型的浪潮中,企业对智能化客服系统的需求日益增长。传统的客服系统开发需要专业的编程技能和大量的开发时间,这对于中小企业和非技术背景的业务人员来说是一个巨大的门槛。随着无代码/低代码开发平台的兴起,现在任…

关于大模型部署:看这篇就对了

前言 大模型从训练完成到真正对外提供服务,部署是中间的关键桥梁。部署的核心目标很明确:让模型在特定硬件环境下,以低延迟、高吞吐量、高稳定性的状态,响应各类输入请求。这不是简单的“加载模型运行”,而是一个涉及环…

7.3 自动化工作流设计:构建个人专属的AI助理

7.3 自动化工作流设计:构建个人专属的AI助理 在日常工作和生活中,我们经常需要执行重复性的任务,如数据整理、信息收集、邮件处理、日程安排等。这些任务虽然不复杂,但耗时且容易出错。随着AI技术的发展,我们可以通过设计自动化工作流,让AI助理帮助我们完成这些重复性工…

蛋白质N端和C端的序列测定

蛋白质N端和C端的序列测定蛋白质的N端和C端序列测定,是指确定蛋白质链两端的氨基酸排列顺序。这两端的氨基酸序列对于蛋白质的功能及其在细胞内的定位与修饰有影响。蛋白质的结构和功能密切相关,而其序列则是理解其结构和功能的基础。在蛋白质功能研究中…

导师严选!MBA必用AI论文软件TOP10:开题报告神器测评

导师严选!MBA必用AI论文软件TOP10:开题报告神器测评 2026年MBA论文写作工具测评:选对工具,效率翻倍 在MBA学习过程中,论文写作是绕不开的重要环节。无论是开题报告、案例分析还是毕业论文,都需要高效的工具…

仅凭文本就能劫持AI:无点击、无恶意软件,仅靠文字

仅凭文本就能劫持AI —— 无需点击,无需恶意软件,仅靠文字英国国家网络安全中心警告称,该漏洞可能永远无法被完全修复——因为它与语言模型读取文本的方式紧密相连。一位银行客户要求ChatGPT查询其账户余额。AI却返回了其他十七位客户的账户详…

7.5 个性化插件开发:扩展AI工具的功能边界

7.5 个性化插件开发:扩展AI工具的功能边界 在AI工具日益普及的今天,大多数现成的AI平台和应用都提供了丰富的基础功能,但往往无法完全满足特定用户或企业的个性化需求。通过插件开发,我们可以扩展AI工具的功能边界,为其添加特定领域的专业能力、集成企业内部系统、实现定…

AI工具全景:从智能编码到模型训练的技术实践与架构解析

人工智能工具链已形成覆盖开发全生命周期的完整生态,从代码生成到模型部署,从数据处理到系统监控,各类AI工具正深刻改变技术研发范式。本文将系统剖析智能编码工具、数据标注平台、模型训练框架三类核心AI工具的技术原理、架构设计与实战应用…

王阳明:清除人生的三种“土匪”

《心学攻略:王阳明给现代人的“人生重构”系统》 2/24第02讲 | 核心隐喻:我们要打的三种“土匪”——人生阻力拆解:为什么你总在“打地鼠”,却永远清不完问题?三重围城:现代人的“土匪”阻力地图你有没有觉…

全方位解析AI工具链:从智能编码、数据标注到模型训练的实战指南

引言在当今的软件开发与人工智能领域,工具的演进速度正在重塑我们构建产品的方式。从早期的“纯手工”敲击代码,到如今基于大模型(LLM)的辅助编程,再到专门化的数据标注流水线与分布式模型训练平台,AI工具链…

Synaptics触摸板代码39错误怎么办?快速解决驱动问题

当笔记本电脑的Synaptics触摸板突然失效,并在设备管理器中显示带有黄色感叹号的“代码39”错误时,很多用户会感到困惑。这个错误意味着Windows系统无法正确加载触摸板驱动程序,导致触摸板功能完全瘫痪。根据我多年的维修经验,这通…

前沿安全框架更新,强化AI模型安全协议

前沿安全框架更新 AI是一种强大的工具,正在帮助实现新的突破,并在从气候变化到药物发现等我们时代面临的一些最大挑战上取得重大进展。但随着其发展,先进的能力可能会带来新的风险。 这就是为何在去年引入了第一版前沿安全框架——一套旨在帮…