Установите CLI
npm install -g @google/gemini-cli
Быстрый старт
Для командной работы проще всего начать с Gemini CLI. Ключ храните как пароль и не вставляйте его в публичные файлы.
Выберите auth type
В ~/.gemini/settings.json укажите gemini-api-key.
Задайте ключ
Используйте GEMINI_API_KEY и корневой URL bridge.
Запустите модель
Начните с gemini-3.5-flash, затем выберите другую модель из таблицы.
Модели bridge
Это точные идентификаторы, которые сейчас принимает Gemini-группа bridge. Доступность зависит от вашего ключа.
| Model ID | Когда выбрать | CLI пример |
|---|---|---|
gemini-3.5-flash | Быстрые обычные задачи, чат и код. | gemini -m gemini-3.5-flash |
gemini-3.1-pro-preview | Сложные рассуждения и большой контекст. | gemini -m gemini-3.1-pro-preview |
gemini-3.1-flash-lite | Лёгкие запросы и экономичный режим. | gemini -m gemini-3.1-flash-lite |
Проверка списка: GET https://bridge.gptclaudegemini.xyz/v1beta/models с вашим ключом.
Протоколы и адреса
Gemini CLI / native
Нативный формат Google. CLI получает корень, а прямой REST-запрос использует путь /v1beta.
https://bridge.gptclaudegemini.xyz/v1betaOpenAI-compatible
Подходит для Cursor, OpenCode, Roo Code, Cline, Kilo Code, Aider и OpenHands.
https://bridge.gptclaudegemini.xyz/v1Anthropic Messages
Подходит для Claude Code и клиентов с Anthropic provider. Клиент сам добавляет /v1/messages.
https://bridge.gptclaudegemini.xyzResponses / Codex
Используется Codex CLI, приложением Codex и IDE-интеграциями с Responses API.
https://bridge.gptclaudegemini.xyz/responsesGemini CLI
Настройка Windows PowerShell
Установите пакет, затем сохраните настройку auth в %USERPROFILE%\\.gemini\\settings.json. Если файл уже есть, не удаляйте остальные параметры.
PowerShell
npm install -g @google/gemini-cli $env:GEMINI_API_KEY="ВАШ_КЛЮЧ" $env:GOOGLE_GEMINI_BASE_URL="https://bridge.gptclaudegemini.xyz" gemini -m gemini-3.5-flash
Фрагмент settings.json
~/.gemini/settings.json
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}Режим yolo
Это аналог запуска Claude с пропуском подтверждений. Используйте его только в каталоге, которому доверяете.
PowerShell / macOS / Linux
gemini -m gemini-3.5-flash --approval-mode yolo
macOS / Linux / WSL
shell
export GEMINI_API_KEY='ВАШ_КЛЮЧ' export GOOGLE_GEMINI_BASE_URL='https://bridge.gptclaudegemini.xyz' gemini -m gemini-3.5-flash
Ошибка Invalid auth method selected означает, что CLI выбрал внутренний gateway. Оставьте selectedType: gemini-api-key.
Готовые API-проверки
Native Gemini
generateContent
curl "https://bridge.gptclaudegemini.xyz/v1beta/models/gemini-3.5-flash:generateContent" `
-H "x-goog-api-key: ВАШ_КЛЮЧ" `
-H "Content-Type: application/json" `
-d '{"contents":[{"role":"user","parts":[{"text":"Reply with exactly: hi"}]}]}'OpenAI-compatible
chat/completions
curl https://bridge.gptclaudegemini.xyz/v1/chat/completions `
-H "Authorization: Bearer ВАШ_КЛЮЧ" `
-H "Content-Type: application/json" `
-d '{"model":"gemini-3.5-flash","messages":[{"role":"user","content":"Reply with exactly: hi"}],"max_tokens":32}'Anthropic Messages
Claude Code / Anthropic client
curl https://bridge.gptclaudegemini.xyz/v1/messages `
-H "x-api-key: ВАШ_КЛЮЧ" `
-H "anthropic-version: 2023-06-01" `
-H "Content-Type: application/json" `
-d '{"model":"gemini-3.5-flash","max_tokens":32,"messages":[{"role":"user","content":"Reply with exactly: hi"}]}'Другие клиенты
Cursor / OpenCode
Выберите OpenAI-compatible provider, Base URL https://bridge.gptclaudegemini.xyz/v1 и точный Model ID.
Roo Code / Cline / Kilo
Можно выбрать OpenAI Compatible. Anthropic provider тоже работает, если Base URL задан как корень bridge.
Aider / OpenHands
Используйте OpenAI base /v1; в Aider модель обычно записывают как openai/gemini-3.5-flash.
Codex
Выберите Responses provider, wire_api = "responses" и base URL bridge с завершающим слэшем.
Если что-то не работает
401 UnauthorizedКлюч неверный, истёк или не передан. Скопируйте его целиком, без пробелов.
404 /v1/v1/...В Base URL уже был /v1, а клиент добавил его ещё раз.
Model not foundИспользуйте один из точных ID: gemini-3.5-flash, gemini-3.1-pro-preview или gemini-3.1-flash-lite.
Статистика ключа: statistics.gptclaudegemini.xyz