Claude 账号受限时，如何通过 Google Antigravity Proxy 继续使用 Claude Code

来源：https://syntackle.com/blog/claude-code-free-using-antigravity-proxy/

本文是操作整理版（README 风格）。请先确认你所在地法规、Anthropic/Google/工具条款允许该用法。仅建议用于学习与开发测试，不建议作为生产依赖。

---

1. 背景与思路

核心思路是使用 antigravity-claude-proxy：

• 对外暴露 Anthropic 兼容接口（给 Claude Code 用）
• 对内把请求转到 Google Antigravity / Cloud Code
• 再把返回结果转换回 Claude Code 可识别格式（含流式）

这样 Claude Code CLI 仍可工作，但后端实际走的是 Google 侧可用账号/配额。

---

2. 前置条件

• Node.js 18+
• macOS/Linux 建议有 Homebrew
• 可用 Google 账号(支持多账号轮转，解决限额问题)

---

3. 安装与配置步骤

3.1 安装代理

npm install -g antigravity-claude-proxy

3.2 登录/添加 Google 账号

单账号：确保你已在 Antigravity 相关环境登录 Google。

多账号（可用于配额轮换）：

antigravity-claude-proxy accounts add

常用账号管理命令：

# 查看账号
antigravity-claude-proxy accounts list

# 验证账号可用性
antigravity-claude-proxy accounts verify

# 交互式管理
antigravity-claude-proxy accounts

3.3 启动代理

antigravity-claude-proxy start

默认监听：http://localhost:8080

健康检查：

curl http://localhost:8080/health

查看账号限额：

curl http://localhost:8080/account-limits?format=table

---

4. 配置 Claude Code 指向本地代理

如果你之前用过 Claude 官方账号登录，先在 Claude Code 里 /logout，避免旧鉴权干扰。

4.1 安装 Claude Code

macOS/Linux：

brew install --cask claude-code

4.2 编辑 ~/.claude/settings.json

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",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6-thinking",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-opus-4-6-thinking"
  }
}

4.3 配置环境变量

macOS / Linux（bash示例）：

echo 'export ANTHROPIC_BASE_URL="<http://localhost:8080>"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="test"' >> ~/.bashrc
source ~/.bashrc

4.4（可选）设置 ~/.claude.json

按文章说明可加入：

{
  "hasCompletedOnboarding": true
}

---

5. 运行顺序（关键）

先启动代理，再启动 Claude Code：

antigravity-claude-proxy start &
claude

在 Claude Code 内可通过 /model 切换模型。

---

6. 常见问题排查

1. Claude Code 连不上
   • 先 curl <http://localhost:8080/health>
   • 确认代理在运行
   • 确认 ANTHROPIC_BASE_URL 已生效
2. 仍走官方账号/旧鉴权
   • 在 Claude Code 里先 /logout
   • 重启终端会话
3. 配额/限流
   • 查看 account-limits
   • 用多账号模式验证并轮换
4. 模型名不生效
   • 确认代理支持的模型标识
   • 在 Claude Code 中用 /model 再确认

---

7. 风险与合规提醒（务必看）

• 该方案可能涉及平台条款边界，请自行评估风险。
• 不建议用于企业生产关键链路。
• 不要把真实敏感密钥写入公开仓库。
• 建议仅在本机回环地址（localhost）运行代理，避免外网暴露。

---

8. 总结

这个方案本质上是：让 Claude Code 前端不变，后端改走 Google Antigravity 提供的可用模型通道。配置正确后，即使原 Claude 账号不可用，也能继续在 Claude Code 工作流里编码。