diff --git a/README.md b/README.md index b9becd60..d92a2127 100644 --- a/README.md +++ b/README.md @@ -67,6 +67,8 @@ | Zhipu AI | API Key | GLM-4.5, GLM-4.6, GLM-4.7 | | Custom | API Key | Any OpenAI-compatible endpoint | +> **Account risk warning:** Claude/Anthropic OAuth, Google/Gemini OAuth, Gemini CLI OAuth, and Antigravity OAuth are unofficial compatibility paths. Providers may treat proxy, automation, shared-token, or third-party OAuth traffic as a policy violation or abnormal usage. Using these login flows can risk quota loss, account restriction, or account suspension. Prefer official API-key or officially supported developer access for important accounts. + --- ## Installation @@ -122,6 +124,8 @@ Run OAuth login for your provider: OAuth tokens are stored locally and auto-refreshed before expiry. +**High-risk OAuth providers:** `--claude-login`, `--login` / Gemini, Gemini CLI OAuth, and `--antigravity-login` may violate provider expectations or trigger anti-abuse/account-protection systems. Do not use production, billing-critical, school/work, or irreplaceable personal accounts with these flows unless you accept the account-risk tradeoff. Prefer official API keys where available. + Kiro Google/GitHub OAuth is not currently supported because AWS Cognito rejects third-party localhost callbacks. Use AWS Builder ID (`--kiro-login` / `--kiro-aws-login`) or import from the official Kiro IDE. ### Security Defaults (Auth + CORS) diff --git a/docs/claude-code-local-proxy.md b/docs/claude-code-local-proxy.md index a17286cb..f57158c9 100644 --- a/docs/claude-code-local-proxy.md +++ b/docs/claude-code-local-proxy.md @@ -32,6 +32,12 @@ Important: - Avoid Claude Code “Auth conflict”: do **not** set both `ANTHROPIC_AUTH_TOKEN` and `ANTHROPIC_API_KEY` at the same time. - Restart Claude Code after editing settings so the new env vars take effect. +## Account risk warning + +Claude/Anthropic OAuth, Google/Gemini OAuth, Gemini CLI OAuth, and Antigravity OAuth are unofficial compatibility paths. Providers may treat proxy, automation, shared-token, or third-party OAuth traffic as abnormal usage or a policy violation. These flows can risk quota loss, account restriction, or account suspension. + +Do not use production, billing-critical, school/work, or irreplaceable personal accounts with these OAuth paths unless you accept that risk. Prefer official API keys or officially supported developer access for important accounts. + ## Claude OAuth quota limitation Anthropic currently treats third-party app traffic differently from regular Claude.ai or Claude Code subscription usage. If a Claude OAuth request fails with: diff --git a/docs/cli.md b/docs/cli.md index 1e2badb9..af10bced 100644 --- a/docs/cli.md +++ b/docs/cli.md @@ -63,6 +63,8 @@ proxypilot --minimax-login # Add MiniMax API key proxypilot --zhipu-login # Add Zhipu AI API key ``` +Account risk warning: `--claude-login`, `--login` / Gemini, Gemini CLI OAuth, and `--antigravity-login` are unofficial compatibility login paths. Providers may treat proxy, automation, shared-token, or third-party OAuth traffic as abnormal usage or a policy violation. These flows can risk quota loss, account restriction, or account suspension. Prefer official API-key or officially supported developer access for accounts you cannot afford to lose. + Kiro Google/GitHub OAuth is not currently supported because AWS Cognito rejects third-party localhost callbacks. Use AWS Builder ID or import a token from the official Kiro IDE instead. ### Login Options diff --git a/docs/proxypilot.md b/docs/proxypilot.md index eb71017c..80864382 100644 --- a/docs/proxypilot.md +++ b/docs/proxypilot.md @@ -61,6 +61,8 @@ ProxyPilot tray app includes: - One-click login launchers: Antigravity, Gemini CLI, Codex, Claude, Qwen - `Open Auth Folder` shortcut +Account risk warning: Antigravity, Gemini/Gemini CLI, and Claude login launchers use unofficial compatibility OAuth paths. Providers may treat proxy, automation, shared-token, or third-party OAuth traffic as abnormal usage or a policy violation. These flows can risk quota loss, account restriction, or account suspension. Use disposable or non-critical accounts only if you accept that risk; prefer official API keys or officially supported developer access for important accounts. + ## Logs / diagnostics Useful paths: