Google Antigravity CLI 接入

用 QCode.cc API 密钥配置 Google Antigravity CLI：编辑 ~/.config/antigravity/config.toml，设置 OpenAI 兼容 base_url 与模型

Google Antigravity CLI 接入 ¶

⚠️ 从 Gemini CLI 迁移到 Antigravity CLI：Google Antigravity 已于 2026-05-19 上线，Gemini CLI 已于 2026-06-18 对 Pro / 免费用户停止维护（EOL）；企业付费密钥不受影响，在 EOL 后仍可继续使用 Gemini CLI。如果你之前按 Gemini CLI 集成配置过，建议改用本页的 Antigravity CLI 接入方式。

Google Antigravity 是 Google 推出的新一代 AI 编程命令行工具，用来取代已停止维护的 Gemini CLI。它支持自定义 / OpenAI 兼容的模型端点，因此可以把 QCode.cc 配置为上游，用同一把 QCode 密钥调用 Claude、GPT、Gemini 等多家模型。

🚧 工具仍在快速演进：Antigravity 是新工具，配置项与行为仍在变化中。本页给出的是当前已知的可行做法；确切的配置键名、默认路径与字段含义请以官方文档为准：https://antigravity.google/docs。下文凡是不确定的地方都会显式标注。

为什么把 QCode 配成 Antigravity 的上游 ¶

一把密钥，多家模型：QCode 的同一个 cr_ 密钥同时覆盖 Claude、GPT、Gemini、图像等模型
OpenAI 兼容：Antigravity 支持自定义 / OpenAI 兼容模型，直接指向 QCode 的 OpenAI Chat 端点即可
共享配额：和 Claude Code、OpenAI Codex 等工具共用同一套餐配额，灵活切换
国内可用域名：除 api.qcode.cc 外还提供 asia / us / eu 多入口，国内用户优先用 asia.qcode.cc

前置条件 ¶

已安装 Google Antigravity（安装方式以官方文档为准）
拥有 QCode.cc API Key（cr_ 开头），在控制台获取
了解 QCode 的接入点与 API 格式

可用模型 ¶

Antigravity 通过 OpenAI 兼容端点接入，下面是 QCode 上常用的几个模型（填到配置里的 model 字段）：

模型	说明	上下文
`claude-opus-4-8`	旗舰，能力最强	1M
`claude-sonnet-4-6`	均衡，日常首选	1M
`claude-haiku-4-5`	轻量快速、便宜	200K
`gpt-5.5`	OpenAI 旗舰	1M
`gpt-5.4`	OpenAI 均衡款	1M
`gemini-3.5-flash`	Gemini 快速版（计费 ×2）	—

完整模型与价格见模型选择。Gemini 系列计费按 ×2 计算。

配置步骤 ¶

Antigravity 的配置文件位于 ~/.config/antigravity/config.toml（确切路径以官方文档为准）。核心是把 base_url 指向 QCode 的 OpenAI Chat 端点，并提供 QCode 密钥与一个模型。

第 1 步：准备 base_url 与密钥 ¶

QCode 的 OpenAI Chat 端点是：

https://api.qcode.cc/openai/v1

国内用户优先用 https://asia.qcode.cc/openai/v1（us / eu 同理）。base_url 末尾不要带斜杠 /。Antigravity 会在此基础上自动追加 /chat/completions。

第 2 步：编辑 config.toml ¶

打开（不存在则新建）~/.config/antigravity/config.toml，写入类似下面的内容：

# ~/.config/antigravity/config.toml
# 注意：以下键名为当前已知用法，确切字段请以 https://antigravity.google/docs 为准

# QCode 上游（OpenAI 兼容端点）
base_url = "https://api.qcode.cc/openai/v1"   # 国内可换成 https://asia.qcode.cc/openai/v1

# 选用的模型（见上文表格）
model = "claude-opus-4-8"

# API 密钥：推荐用环境变量注入，避免写进明文配置
# 例如读取 OPENAI_API_KEY 环境变量
api_key_env = "OPENAI_API_KEY"

把密钥放到环境变量里（写进 ~/.zshrc / ~/.bashrc 持久化）：

export OPENAI_API_KEY="cr_xxxxxxxxxxxxxxxx"

🚧 字段名以官方文档为准：上面的 base_url / model / api_key_env 是 OpenAI 兼容工具的常见写法，Antigravity 的确切键名（例如是否叫 api_key、apiKey、provider 嵌套段等）可能不同，请以官方文档为准。如果某个键不被识别，优先按官方示例调整，而不是照搬本页。

第 3 步：验证连通性 ¶

最直接的验证方式是绕开工具、直接打 QCode 端点。下面这条 curl 用你的密钥发一条最小请求：

curl -s https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "messages": [{"role": "user", "content": "ping"}]
  }'

返回正常的聊天补全 JSON → 端点与密钥都没问题
返回 401 → 路径是对的，只是密钥缺失或写错（这是预期的自检信号，把 Authorization 填对即可）

确认端点可用后，再回到 Antigravity 里跑一次简单对话，验证它确实走到了 QCode 上游。

视觉输入（看图）与图像生成的区别 ¶

Antigravity / Claude Code 这类工具能读图——把界面截图、报错截图、架构图喂给具备视觉能力的模型，让它据此写代码或排错。这和生成图像是两回事：

看图（视觉输入）：直接在提示里引用图片文件路径，或粘贴 / 拖拽图片。支持视觉的模型有 Claude Opus 4.8 / Sonnet 4.6 与 GPT-5.x。典型用途：照着设计稿还原 UI、根据报错截图定位 bug、读架构图 / 图表。
生成图像：这要用专门的图像模型 gpt-image-2，走 QCode 的图像端点，详见 gpt-image-2 图像生成。

不要把这两件事混为一谈：要让模型“看懂一张图”用视觉输入；要让模型“画一张图”用 gpt-image-2。

常见问题排查 ¶

现象	可能原因	处理
自检 curl 返回 401	密钥未注入或写错	检查 `OPENAI_API_KEY`，确认 `cr_` 开头
404 / 路径错误	`base_url` 写法不对或多了斜杠	末尾不要带 `/`，确认是 `/openai/v1`
国内连接慢 / 超时	用了 `api` 主域	改用 `https://asia.qcode.cc/openai/v1`
模型名报错	模型名拼写或大小写不对	对照模型选择表格
某个配置键不生效	Antigravity 字段名与本页不一致	以官方文档为准调整

进一步 ¶

接入点与 API 格式 — 四个接入域与各协议路径全表
Gemini CLI 集成 — 迁移前的旧工具（企业密钥仍可用）
子代理 — 编排多个后台 agent
自动化与 CI/CD — 无头模式与脚本化

还没有 QCode 密钥？同一把 cr_ 密钥覆盖 Claude、GPT、Gemini 与图像模型。查看价格方案开始使用。

← 上一篇

Gemini 集成配置

Trae 集成

Google Antigravity CLI 接入

相关文档