Claude Code vs Gemini CLI

Google Brought a Terminal Agent to the Fight

Gemini CLI landed in mid-2025 and instantly got attention for one reason: it's free. Google's giving you Gemini 2.5 Pro in your terminal, open source, no credit card required. That's a big deal.

But "free" and "better" aren't the same word. Let's break down what actually matters when you're shipping code.

Where Claude Code Wins

Configuration depth. CLAUDE.md is genuinely unmatched. You write your project rules once — stack preferences, coding style, file conventions — and every session respects them. Gemini CLI has no equivalent. Every session starts from zero context about your preferences.

Persistent memory. Claude Code remembers things across sessions. Your team's naming conventions, that weird deployment quirk, the API you told it never to use. Gemini CLI doesn't have cross-session memory.

Hooks and extensibility. Pre-tool hooks, post-tool hooks, custom skills, MCP servers — Claude Code's extension surface is massive. You can make it format code before every commit, run linters after edits, or connect to any API through MCP. Gemini CLI is much more barebones here.

Sub-agents. Claude Code can spin up parallel sub-agents to divide work. Research in one thread, implementation in another, tests in a third. Gemini CLI runs single-threaded.

Tool use reliability. Claude Code's tool calling — file edits, terminal commands, search — is battle-tested across millions of sessions. It rarely botches a file edit. Gemini CLI is newer and rougher around the edges.

Where Gemini CLI Wins

Price: literally free. 60 requests per minute, 1,000 per day on the free tier. For hobby projects or learning, that's hard to beat. Claude Code costs $20/month minimum (Pro plan).

Context window. Gemini 2.5 Pro handles up to 1M tokens natively. If you need to dump an entire codebase into context and ask questions, Gemini has raw capacity on its side.

Google ecosystem. If you're deep in Google Cloud, Firebase, or Vertex AI, Gemini CLI integrates more naturally with those services.

Open source. Gemini CLI is fully open source on GitHub. Claude Code's CLI is source-available but not open source in the traditional sense.

The Honest Take

Here's my actual opinion: Gemini CLI is great for exploration and one-off tasks. It's free, it's capable, and for simple stuff it gets the job done.

But for daily professional use — where you're working on the same codebase day after day, where project conventions matter, where you need the AI to learn your patterns — Claude Code's configuration system pulls away hard. The combination of CLAUDE.md, persistent memory, hooks, and MCP extensibility creates something Gemini CLI simply doesn't have yet: compounding context.

When to Use Which

Use Gemini CLI when you're exploring a new repo, doing quick one-off tasks, learning to code, or don't want to pay for anything yet. It's a solid free tool.

Use Claude Code when you're working professionally on a codebase you'll touch every day. When conventions matter. When you want the AI to get smarter about your project over time instead of starting fresh every session.

The best move? Try both. Gemini CLI costs nothing to test. But once you've experienced a well-configured CLAUDE.md with memory and hooks, you'll understand why practitioners pay for Claude Code.