Setup guide - Documented by Kilo Code
Use Gemini in Kilo Code
Kilo Code has a built-in google provider: add the key in the VS Code Providers tab, or set GOOGLE_GENERATIVE_AI_API_KEY and a google/<model> default in kilo.json for the CLI.
Last verified 5 steps2 official sources
Steps
- Step 1.
Get an API key from Google AI Studio (https://ai.google.dev/): sign in, click "Create API key", copy it.
- Step 2.
VS Code: Open Settings (gear icon) and go to the Providers tab to add Google Gemini and enter your API key. The extension stores this in your kilo.json config file.
- Step 3.
CLI: set the API key as an environment variable.
Terminalexport GOOGLE_GENERATIVE_AI_API_KEY="your-api-key" - Step 4.
Or configure it in your config file (~/.config/kilo/kilo.json or ./kilo.json).
JSON{ "provider": { "google": { "env": ["GOOGLE_GENERATIVE_AI_API_KEY"], }, }, } - Step 5.
Then set your default model (Kilo's documented example uses google/gemini-2.5-pro; swap in a current id such as google/gemini-3.8-flash).
JSON{ "model": "google/gemini-2.5-pro", }
Caveats
- Kilo documents only google/gemini-2.5-pro as an example; the other ids come from Google's models page with the google/ prefix taken from Kilo's documented format.
- Kilo docs, verbatim: "Google began rejecting unrestricted Standard keys on June 19, 2026. If Gemini returns
Request had invalid authentication credentials, open the key in Google AI Studio and check its type and status. Replace a Standard key with a new auth key." - Kilo docs: "Google will reject all Standard keys in September 2026."
- The gemini-embedding-001 model is supported for Kilo codebase indexing.
More setup guides
Same tool, other providers
Related reading
- Do Your Agent Hooks Fail Open? Claude Code vs Codex vs Cursor vs Gemini CLIA guard hook that crashes, times out or points at a missing script lets the tool call through by default in Claude Code. v2.1.295 adds onFailure: block. Here is what each coding agent does when your policy hook breaks, with real test runs.
- Google AI Pro vs Gemini API: What Developers Actually GetGoogle AI Pro costs $19.99 a month and has no API key, but includes $10 of monthly Cloud credits. When the subscription wins and when to pay per token.
- How to Keep API Keys Away From Your AI Coding Agent: Claude Code vs Codex vs Cursor vs Gemini CLIA deny rule on .env stops cat but not a Python one-liner. Here are the three layers that actually keep secrets out of a coding agent's context - file rules, environment scrubbing and credential masking - and what Claude Code, Codex, Cursor and Gemini CLI give you for each, with real test runs.
- Google Gemini Agent: Coworker Agents With Their Own EmailGoogle's Gemini agent can create coworker agents with their own Workspace account, email and audit trail. What Google announced and what builders should copy.
- Gemini 4 Argon: What Developers Can Actually UseGemini 4 Argon for developers: what Google shipped, what is verified, why access starts narrow, and what to watch before planning a migration around it.
- Gemini 3.8 Live and 3.8 Live Extended Thinking: Google's Audio-to-Audio Voice Models, Benchmarked and PricedGemini 3.8 Live and 3.8 Live Extended Thinking are Google's audio-to-audio voice models with background tool calls. Benchmarks, pricing and how to build.
FAQ
How do I use Gemini in Kilo Code?
Kilo Code has a built-in google provider: add the key in the VS Code Providers tab, or set GOOGLE_GENERATIVE_AI_API_KEY and a google/<model> default in kilo.json for the CLI.
Which Gemini model ids work in Kilo Code?
The official docs read for this guide list gemini-4-argon, gemini-3.8-flash, gemini-3.6-flash, gemini-3.5-flash-lite, gemini-3.1-pro-preview, gemini-2.5-pro and gemini-2.5-flash.
Is this an official Gemini and Kilo Code setup?
Kilo Code documents this setup in its own docs. It was last checked against 2 official pages on October 17, 2026.
Sources
Last verified against 2 official pages.
- raw.githubusercontent.comhttps://raw.githubusercontent.com/Kilo-Org/kilocode/main/packages/kilo-docs/pages/ai-providers/gemini.md
- ai.google.devhttps://ai.google.dev/gemini-api/docs/models
Newsletter
New models, set up the day they ship
One email per week. New model releases, the coding tools that support them and how to wire them up.