diff --git a/README.md b/README.md
index 5b0b69b..e5aea5d 100644
--- a/README.md
+++ b/README.md
@@ -207,6 +207,8 @@ antigravity-claude-proxy start
 claude
 ```
 
+> **Note:** If Claude Code asks you to select a login method, add `"hasCompletedOnboarding": true` to `~/.claude.json` (macOS/Linux) or `%USERPROFILE%\.claude.json` (Windows), then restart your terminal and try again.
+
 ---
 
 ## Available Models