Zasoby dla deweloperów

Gemini CLI

Skonfiguruj Gemini CLI z natywnym API Gemini RunAPI, sprawdź żądania i przywróć poprzednie ustawienia.

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. Utwórz osobny standardowy klucz API według instrukcji uwierzytelniania, a następnie skopiuj identyfikator modelu natywnego Gemini z katalogu modeli. Nigdy nie zapisuj klucza w commicie.

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.

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, Gemini generateContent, streamGenerateContent, katalogu modeli lub Local MCP.