Antigravity Claude Proxy常见问题解决：从安装到使用的10个实用技巧

【免费下载链接】antigravity-claude-proxy Proxy that exposes Antigravity provided claude / gemini models, so we can use them in Claude Code 项目地址: https://gitcode.com/gh_mirrors/an/antigravity-claude-proxy

Antigravity Claude Proxy是一款能够将Antigravity提供的Claude和Gemini模型通过类Anthropic API格式暴露出来的代理工具，让用户可以在Claude Code中使用这些模型。本文将为新手和普通用户提供从安装到使用过程中的10个实用技巧，帮助大家轻松解决使用中遇到的各种问题。

一、快速安装与启动技巧

Antigravity Claude Proxy提供了多种安装方式，用户可以根据自己的需求选择最适合的方法。

1. npm快速安装（推荐）

如果你已经安装了Node.js 18或更高版本，可以直接使用npx命令运行，无需提前安装：

npx antigravity-claude-proxy@latest start

或者也可以选择全局安装：

npm install -g antigravity-claude-proxy@latest
antigravity-claude-proxy start

2. 源码克隆安装

如果你需要获取最新的开发版本，可以通过克隆仓库的方式安装：

git clone https://gitcode.com/gh_mirrors/an/antigravity-claude-proxy
cd antigravity-claude-proxy
npm install
npm start

启动后，代理服务器默认会在后台运行在http://localhost:8080。你可以使用以下命令管理服务器状态：

• acc start：启动代理
• acc stop：停止代理
• acc restart：重启代理
• acc status：检查代理状态

Antigravity Claude Proxy启动界面展示，包含主要功能介绍和安装命令

二、账户链接与管理技巧

成功安装后，需要链接Google账户才能使用代理服务。

3. 通过Web界面添加账户（推荐）

1. 确保代理服务器已启动
2. 在浏览器中访问http://localhost:8080
3. 导航到"Accounts"选项卡，点击"Add Account"
4. 在弹出窗口中完成Google OAuth授权

对于无图形界面的服务器，Web界面还支持"Manual Authorization"模式，只需复制OAuth URL在本地浏览器完成授权，然后将授权码粘贴回来即可。

4. 通过命令行添加账户

如果你更喜欢使用终端或者在远程服务器上操作，可以通过CLI添加账户：

# 桌面环境（会打开浏览器）
antigravity-claude-proxy accounts add

# 无图形界面环境（Docker/SSH）
antigravity-claude-proxy accounts add --no-browser

三、常见错误解决技巧

在使用过程中，可能会遇到各种错误，以下是一些常见问题的解决方法。

5. Windows系统OAuth端口错误（EACCES）

Windows系统中，默认的OAuth回调端口（51121）可能被Hyper-V、WSL2或Docker占用，导致启动失败。解决方法：

方法1：使用自定义端口（推荐）

# Windows PowerShell
$env:OAUTH_CALLBACK_PORT = "3456"
antigravity-claude-proxy start

# Windows CMD
set OAUTH_CALLBACK_PORT=3456
antigravity-claude-proxy start

方法2：重置Windows NAT 以管理员身份运行：

net stop winnat
net start winnat

6. "Could not extract token from Antigravity"错误

如果你使用单账户模式并遇到此错误，请确保：

1. Antigravity应用已安装并正在运行
2. 你已登录Antigravity

或者可以通过OAuth添加账户替代：antigravity-claude-proxy accounts add

7. 401身份验证错误

令牌可能已过期，可以尝试刷新令牌：

curl -X POST http://localhost:8080/refresh-token

或者重新验证账户：

antigravity-claude-proxy accounts

四、使用与监控技巧

成功配置后，合理使用和监控代理服务可以提高使用体验。

8. 利用Web控制台监控代理状态

Antigravity Claude Proxy提供了直观的Web管理界面，通过http://localhost:8080访问。在仪表盘中，你可以查看账户状态、请求量统计和配额使用情况。

Antigravity Claude Proxy Web控制台界面，展示账户状态和请求量统计图表

你可以通过以下命令快速打开Web控制台：

antigravity-claude-proxy ui

9. 处理429速率限制错误

当遇到429错误时，如果你配置了多个账户，代理会自动切换到下一个可用账户。如果只有一个账户，则需要等待速率限制重置。

建议配置多个账户以提高可用性和避免速率限制问题，具体可参考多账户负载均衡文档。

10. 解决403权限被拒绝错误

如果看到"403 VALIDATION_REQUIRED"错误，说明Google要求账户完成验证（电话号码、验证码或接受条款）。解决方法：

1. 打开WebUI（http://localhost:8080）
2. 找到标记错误的账户
3. 点击"FIX"按钮，直接打开Google验证页面
4. 完成验证后，点击账户上的"↻ Refresh"按钮重新启用账户

如果没有提供验证URL，可以通过命令行重新验证账户：

antigravity-claude-proxy accounts
# 选择需要重新验证的账户

五、Claude Code配置技巧

要在Claude Code中使用Antigravity Claude Proxy，需要进行简单配置。

11. 通过Web控制台配置（推荐）

1. 打开WebUI，进入"Settings" → "Claude CLI"
2. 使用"Connection Mode"切换"Proxy Mode"
3. 配置模型、基础URL和预设
4. 点击"Apply to Claude CLI"保存更改

12. 手动配置Claude Code

创建或编辑Claude Code设置文件：

• macOS/Linux: ~/.claude/settings.json
• Windows: %USERPROFILE%\.claude\settings.json

添加以下配置：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "test",
    "ANTHROPIC_BASE_URL": "http://localhost:8080",
    "ANTHROPIC_MODEL": "claude-opus-4-6-thinking"
  }
}

总结

Antigravity Claude Proxy是一个功能强大的工具，可以帮助用户在Claude Code中使用Antigravity提供的Claude和Gemini模型。通过本文介绍的10个实用技巧，你应该能够轻松解决从安装到使用过程中遇到的大多数问题。如果需要更多帮助，可以查阅官方文档或故障排除指南。

使用过程中请记住，这是一个非官方工具，可能存在一定风险。建议使用专用账户而非主账户，并了解相关服务条款。

【免费下载链接】antigravity-claude-proxy Proxy that exposes Antigravity provided claude / gemini models, so we can use them in Claude Code 项目地址: https://gitcode.com/gh_mirrors/an/antigravity-claude-proxy