终极AI认证解决方案：opencode-antigravity-auth完全指南与核心功能解析-CSDN博客

终极AI认证解决方案：opencode-antigravity-auth完全指南与核心功能解析

【免费下载链接】opencode-antigravity-auth 项目地址: https://gitcode.com/gh_mirrors/op/opencode-antigravity-auth

opencode-antigravity-auth是一款强大的AI认证插件，专为Opencode平台设计，能够通过OAuth协议实现与Google Antigravity（Google的IDE）的认证连接，让用户可以使用自己的Google凭据访问Antigravity的速率限制，并使用如gemini-3-pro和claude-opus-4-5-thinking等模型。

核心功能一览 🚀

opencode-antigravity-auth为用户带来了丰富而实用的功能，让AI使用体验更上一层楼：

多模型支持：可访问Claude Opus 4.5、Sonnet 4.5以及Gemini 3 Pro/Flash等多种先进模型，满足不同场景的AI需求。
多账户管理：支持添加多个Google账户，当一个账户达到速率限制时，插件会自动切换到其他账户，确保AI服务的持续可用。
双配额系统：将Antigravity和Gemini CLI的配额整合在一起，用户可从一个插件便捷地访问两种配额资源。
思维模型：为Claude和Gemini 3提供扩展思维能力，并可配置思维预算，让AI的思考过程更加深入和灵活。
谷歌搜索支持：能够为Gemini模型启用网络搜索功能，可设置为自动或始终开启模式，增强模型的信息获取能力。
自动恢复机制：当出现会话错误或工具故障时，插件能够自动处理并恢复，减少用户的操作困扰。
插件兼容性：可与其他OpenCode插件（如oh-my-opencode、dcp等）协同工作，扩展功能边界。

快速安装指南 🔧

手动安装步骤

添加插件：编辑~/.config/opencode/opencode.json文件，在其中添加插件配置：
```
{
  "plugin": ["opencode-antigravity-auth@latest"]
}
```
若想体验前沿功能，可将opencode-antigravity-auth@latest替换为opencode-antigravity-auth@beta。
账户登录：在终端中运行以下命令，使用Google账户进行登录：
```
opencode auth login
```
添加模型配置：将完整的模型配置复制到opencode.json文件中。

开始使用：通过以下命令即可使用插件：

opencode run "Hello" --model=google/antigravity-claude-sonnet-4-5-thinking --variant=max

模型配置详情 🧠

模型参考

Antigravity配额模型（Claude + Gemini 3）

模型	变体	说明
`antigravity-gemini-3-pro`	low, high	具有思维能力的Gemini 3 Pro
`antigravity-gemini-3-flash`	minimal, low, medium, high	具有思维能力的Gemini 3 Flash
`antigravity-claude-sonnet-4-5`	—	Claude Sonnet 4.5
`antigravity-claude-sonnet-4-5-thinking`	low, max	具有扩展思维能力的Claude Sonnet
`antigravity-claude-opus-4-5-thinking`	low, max	具有扩展思维能力的Claude Opus

Gemini CLI配额模型（独立于Antigravity）

模型	说明
`gemini-2.5-flash`	Gemini 2.5 Flash
`gemini-2.5-pro`	Gemini 2.5 Pro
`gemini-3-flash-preview`	Gemini 3 Flash（预览版）
`gemini-3-pro-preview`	Gemini 3 Pro（预览版）

使用变体示例

opencode run "Hello" --model=google/antigravity-claude-sonnet-4-5-thinking --variant=max

关于变体配置和思维级别的详细信息，可参考docs/MODEL-VARIANTS.md。

完整模型配置（可直接复制粘贴）

将以下内容添加到~/.config/opencode/opencode.json文件中：

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-antigravity-auth@latest"],
  "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": {
          "name": "Claude Sonnet 4.5 (Antigravity)",
          "limit": { "context": 200000, "output": 64000 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
        },
        "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-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"] }
        }
      }
    }
  }
}

多账户设置指南 👥

添加多个Google账户可以获得更高的综合配额，当一个账户达到速率限制时，插件会自动在账户之间进行切换。

添加账户

opencode auth login  # 再次运行此命令可添加更多账户

账户管理选项（通过`opencode auth login`）

查看配额：查看每个账户的剩余API配额
管理账户：启用/禁用特定账户进行轮换

有关负载均衡、双配额池和账户存储的详细信息，请参阅docs/MULTI-ACCOUNT.md。

常见问题解决 🛠️

快速重置

大多数问题可以通过删除~/.config/opencode/antigravity-accounts.json文件并重新运行opencode auth login命令来解决。

配置文件路径（所有平台）

OpenCode在包括Windows在内的所有平台上都使用~/.config/opencode/目录。

文件	路径
主配置文件	`~/.config/opencode/opencode.json`
账户文件	`~/.config/opencode/antigravity-accounts.json`
插件配置	`~/.config/opencode/antigravity.json`
调试日志	`~/.config/opencode/antigravity-logs/`

Windows用户注意：~解析为用户主目录（例如，C:\Users\YourName），不要使用%APPDATA%。

多账户认证问题

如果在使用多个账户时遇到认证问题：

删除账户文件：

rm ~/.config/opencode/antigravity-accounts.json

重新认证：
```
opencode auth login
```

403权限被拒绝（`rising-fact-p41fc`）

错误信息：

Permission 'cloudaicompanion.companions.generateChat' denied on resource
'//cloudaicompanion.googleapis.com/projects/rising-fact-p41fc/locations/global'

原因：当未找到有效的项目时，插件会回退到默认项目ID。这对于Antigravity有效，但对于Gemini CLI模型会失败。

解决方案：

访问Google Cloud Console
创建或选择一个项目
启用Gemini for Google Cloud API（cloudaicompanion.googleapis.com）

在账户文件中添加projectId：

{
  "accounts": [
    {
      "email": "your@email.com",
      "refreshToken": "...",
      "projectId": "your-project-id"
    }
  ]
}

注意：在多账户设置中，每个账户都需要进行此操作。

插件配置选项 ⚙️

创建~/.config/opencode/antigravity.json文件可进行可选设置：

{
  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json"
}

大多数用户无需进行额外配置，默认设置即可正常工作。

模型行为

选项	默认值	功能描述
`keep_thinking`	`false`	保留Claude在对话轮次中的思维过程。警告：启用可能会降低模型稳定性。
`session_recovery`	`true`	自动从工具错误中恢复
`web_search.default_mode`	`"off"`	Gemini谷歌搜索模式：`"auto"`或`"off"`

账户轮换

你的设置	推荐配置
1个账户	`"account_selection_strategy": "sticky"`
2-5个账户	默认（`"hybrid"`）效果良好
5个以上账户	`"account_selection_strategy": "round-robin"`
并行代理	添加`"pid_offset_enabled": true`

速率限制调度

控制插件处理速率限制的方式：

选项	默认值	功能描述
`scheduling_mode`	`"cache_first"`	`"cache_first"` = 等待同一账户（保留提示缓存），`"balance"` = 立即切换，`"performance_first"` = 轮询
`max_cache_first_wait_seconds`	`60`	在cache_first模式下等待切换账户的最大秒数
`failure_ttl_seconds`	`3600`	在此秒数后重置失败计数（防止旧失败永久影响账户）

各种模式的适用场景：

cache_first（默认）：适合长对话。等待同一账户恢复，保留提示缓存。
balance：适合快速任务。速率受限时立即切换账户，以获得最大可用性。
performance_first：适合许多短请求。在所有账户间均匀分配负载。

应用行为

选项	默认值	功能描述
`quiet_mode`	`false`	隐藏通知提示
`debug`	`false`	启用调试日志
`auto_update`	`true`	自动更新插件

所有选项的详细信息，请参见docs/CONFIGURATION.md。

环境变量：

OPENCODE_ANTIGRAVITY_DEBUG=1 opencode   # 启用调试日志
OPENCODE_ANTIGRAVITY_DEBUG=2 opencode   # 详细日志

完整文档资源 📚

配置 — 所有配置选项
多账户 — 负载均衡、双配额池、账户存储
模型变体 — 思维预算和变体系统
故障排除 — 常见问题和修复方法
架构 — 插件工作原理
API规范 — Antigravity API参考

开始使用opencode-antigravity-auth

要开始使用opencode-antigravity-auth，首先需要克隆仓库：

git clone https://gitcode.com/gh_mirrors/op/opencode-antigravity-auth

然后按照上述安装和配置指南进行操作，即可体验这款强大的AI认证解决方案带来的便捷与高效。

【免费下载链接】opencode-antigravity-auth 项目地址: https://gitcode.com/gh_mirrors/op/opencode-antigravity-auth

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

终极AI认证解决方案：opencode-antigravity-auth完全指南与核心功能解析