From 70334b8b631c5440c950ff9a1fd275d42aae590a Mon Sep 17 00:00:00 2001
From: chiyv-bot <chiyv-bot@users.noreply.github.com>
Date: Mon, 6 Apr 2026 14:14:38 +0800
Subject: [PATCH] docs: add warning about environmentVariables causing
 activation failure in Antigravity IDE

Even with correct object format {}, configuring claudeCode.environmentVariables
in Antigravity IDE settings triggers 'V is not iterable' TypeError at YB/hQ
constructor, preventing the extension from activating (no commands registered).

Recommended: configure all API settings in ~/.claude/settings.json only.
---
 README.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/README.md b/README.md
index 19eaada..a1ce431 100644
--- a/README.md
+++ b/README.md
@@ -546,6 +546,11 @@ claude
 > }
 > ```
 
+> [!WARNING]
+> **Antigravity IDE 用户注意：** 即使使用了正确的对象格式 `{}`，在 Antigravity 的 IDE 设置中配置 `claudeCode.environmentVariables` 仍可能触发 `V is not iterable` 错误（`TypeError` at `YB` / `hQ` constructor），导致扩展完全无法激活（命令未注册）。
+>
+> **推荐做法：** 不要在 Antigravity IDE 设置中配置 `environmentVariables`。所有 API 相关配置（`apiKeyHelper`、`ANTHROPIC_BASE_URL`）只需放在 `~/.claude/settings.json` 中即可。
+
 ### 关键设置：Disable Login Prompt
 
 > [!IMPORTANT]