---
title: Gemini CLI | RunAPI
description: Skonfiguruj Gemini CLI z natywnym API Gemini RunAPI, sprawdź żądania
  i przywróć poprzednie ustawienia.
url: https://runapi.ai/pl/docs/resources/tool-integrations/gemini-cli.md
canonical: https://runapi.ai/pl/docs/resources/tool-integrations/gemini-cli
locale: pl
---

> Wersja HTML: https://runapi.ai/pl/docs/resources/tool-integrations/gemini-cli
> Indeks witryny dla agentów: https://runapi.ai/llms.txt

# Gemini CLI

## Omówienie

Gemini CLI to agent terminalowy. Ten poradnik zmienia dostawcę modeli na natywne API Gemini RunAPI; dodawanie narzędzi RunAPI przez MCP to osobny krok.

## Zanim zaczniesz

Postępuj zgodnie z [oficjalną instrukcją instalacji][1]. Utwórz osobny standardowy klucz API według [instrukcji uwierzytelniania](https://runapi.ai/pl/docs/guides/authentication.md), a następnie skopiuj identyfikator modelu natywnego Gemini z [katalogu modeli](https://runapi.ai/pl/models). Nigdy nie zapisuj klucza w commicie.

[1]: https://geminicli.com/docs/get-started/installation/

```shell
npm install -g @google/gemini-cli
```

## Konfiguracja RunAPI

Zacznij od tych zmiennych w bieżącej powłoce. Bazowy URL to główny adres API HTTPS bez `/v1beta`; SDK dodaje `POST
/v1beta/models/{model}:streamGenerateContent?alt=sse`. HTTP jest dozwolone tylko dla localhost.

```shell
export GOOGLE_GEMINI_BASE_URL=https://runapi.ai
export GEMINI_API_KEY=YOUR_RUNAPI_API_KEY
export GEMINI_MODEL=YOUR_RUNAPI_MODEL_ID
```

Aby zachować ustawienia, zapisz te same trzy zmienne w `~/.gemini/.env` poza repozytoriami. Ogranicz dostęp przez `chmod 600
~/.gemini/.env`. Gemini CLI szuka `.env` od bieżącego katalogu w kierunku katalogów nadrzędnych, a potem sprawdza `~/.gemini/.env` i `~/.env`; sprawdź sprzeczne pliki.

Połącz te dwa ustawienia w `~/.gemini/settings.json`, zachowując pozostałe. Użyj `gemini-api-key` do uwierzytelniania kluczem API; nie używaj zapisanego logowania Google. Domyślnie klucz jest wysyłany w `x-goog-api-key`.

```json
{
  "security": {
    "auth": {"selectedType": "gemini-api-key"}
  },
  "model": {"name": "YOUR_RUNAPI_MODEL_ID"}
}
```

## Wybierz model

Użyj `GEMINI_MODEL`, `--model YOUR_RUNAPI_MODEL_ID` lub `/model` w sesji interaktywnej. Unikaj `auto`, `pro` i `flash`: te aliasy mogą wskazywać identyfikatory modeli Google niedostępnych w RunAPI. Wewnętrzny wybór, klasyfikacja i wykrywanie pętli mogą też żądać modeli pomocniczych flash lub flash-lite; sprawdź ich dostępność osobno.

## Weryfikuj

Uruchom to w zaufanym repozytorium. Sprawdź model przez `/about` lub `/stats` w sesji interaktywnej, a następnie potwierdź odpowiadające żądanie `streamGenerateContent` w rejestrach użycia RunAPI. Sama poprawna odpowiedź CLI nie dowodzi, który endpoint je otrzymał.

```shell
gemini --version
gemini -p "Describe this repository in one sentence."
```

## Dodaj narzędzia RunAPI

MCP dodaje narzędzia, a nie dostawcę modeli. To polecenie rejestruje lokalny serwer; instrukcje osobnego uwierzytelniania i weryfikacji znajdziesz w [Local MCP](https://runapi.ai/pl/docs/resources/mcp/local.md).

```shell
gemini mcp add runapi npx -y @runapi.ai/mcp
```

## Rozwiązywanie problemów

Jeśli żądania nadal trafiają do Google, sprawdź sprzeczne pliki `.env`, `security.auth.selectedType`, zapisane logowanie oraz zmienne uwierzytelniania Google/Vertex. Przy `Invalid auth method
selected` wybierz w ustawieniach `gemini-api-key` zamiast `gateway` i uruchom ponownie.

Przy `401` sprawdź klucz i ewentualne nadpisanie `GEMINI_API_KEY_AUTH_MECHANISM`; domyślnie używane jest `x-goog-api-key`. Przy `404` usuń `/v1beta` z bazowego URL i ponownie skopiuj obsługiwany identyfikator modelu natywnego Gemini. Jeśli model pomocniczy jest niedostępny, sprawdź żądany identyfikator; wybranie głównego modelu nie gwarantuje wszystkich funkcji CLI.

RunAPI nie udostępnia `countTokens` ani `embedContent`. Gemini CLI może szacować tokeny lokalnie, gdy `countTokens` zawiedzie; szacunki mogą różnić się od rejestrów użycia. Poza localhost używaj HTTPS i nie wyłączaj weryfikacji certyfikatów.

## Usuń RunAPI

Usuń trzy zmienne z powłoki i zapisanych plików `.env`, przywróć poprzednie `security.auth.selectedType` oraz model i unieważnij osobny klucz w RunAPI. Usuń osobno dodany serwer MCP tylko wtedy, gdy nie potrzebujesz już jego narzędzi.

```shell
unset GOOGLE_GEMINI_BASE_URL GEMINI_API_KEY GEMINI_MODEL
```

## Kolejne kroki

Przejdź do [szybkiego startu API LLM](https://runapi.ai/pl/docs/guides/llm-api/quickstart.md), [Gemini generateContent](https://runapi.ai/pl/docs/api/gemini/generate-content.md), [streamGenerateContent](https://runapi.ai/pl/docs/api/gemini/stream-generate-content.md), [katalogu modeli](https://runapi.ai/pl/models) lub [Local MCP](https://runapi.ai/pl/docs/resources/mcp/local.md).

---

## Więcej od RunAPI

- [Strona główna](https://runapi.ai/pl/.md)
- [Katalog modeli](https://runapi.ai/pl/models.md)
- [Cennik](https://runapi.ai/pl/pricing.md)
- [Dostawcy](https://runapi.ai/pl/models)
- [Dokumentacja](https://runapi.ai/pl/docs/guides)
- [SDK](https://runapi.ai/pl/sdk.md)
- [CLI](https://runapi.ai/pl/cli.md)
- [Serwer MCP](https://runapi.ai/pl/mcp.md)
- [x402](https://runapi.ai/pl/x402.md)
- [Claude Code vs Cursor](https://runapi.ai/pl/claude-code-vs-cursor.md)
- [Konfiguracja Cursor API](https://runapi.ai/pl/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/pl/openrouter-alternative.md)
- [Enterprise](https://runapi.ai/pl/contact.md)
- [Kontakt](https://runapi.ai/pl/contact.md)
- [Regulamin](https://runapi.ai/pl/terms.md)
- [Prywatność](https://runapi.ai/pl/privacy.md)
- [Indeks witryny dla agentów](https://runapi.ai/llms.txt)

Kontakt: contact@runapi.ai

## Dane strukturalne

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "pl",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/pl",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/pl/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "pl",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/pl",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/plicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "pl",
    "@type": "TechArticle",
    "headline": "Gemini CLI",
    "description": "Skonfiguruj Gemini CLI z natywnym API Gemini RunAPI, sprawdź żądania i przywróć poprzednie ustawienia.",
    "url": "https://runapi.ai/pl/docs/resources/tool-integrations/gemini-cli",
    "mainEntityOfPage": "https://runapi.ai/pl/docs/resources/tool-integrations/gemini-cli"
  }
]
```
