Claude Code vs Gemini CLI: Which to Use in 2026

Claude Code vs Gemini CLI compared for client builds: install, plans and quotas, models, config files, MCP, hooks, skills, sandboxing and which one to choose.

Josh Pocock8 min read

Claude vs Gemini cover

AI Coding

Claude vs Gemini

Stride AI Academy

Claude Code vs Gemini CLI comes down to who you are and which plan you're on. Claude Code is Anthropic's coding agent, included with paid Claude plans. Gemini CLI is Google's open-source terminal agent, which Google now aims at organizations with Gemini Code Assist Standard or Enterprise licenses. Free and Google AI Pro or Ultra users were moved to Google's Antigravity CLI on June 18, 2026.

This comparison (people also search it as Gemini CLI vs Claude Code) is for people building tools and apps for clients. It covers install, pricing and quotas, models, instruction files, MCP, hooks, skills, permissions, sandboxing and IDE support. Everything here was checked against the Gemini CLI repository, the Gemini CLI docs, the Claude Code overview and the other Anthropic pages linked below on November 18, 2026. Stride AI Academy isn't affiliated with Anthropic or Google.

Quick comparison

Claude Code Gemini CLI
Made by Anthropic Google
Who it's for now Paid Claude plans and API users Gemini Code Assist Standard and Enterprise orgs
Terminal CLI Yes Yes
IDE VS Code (and Cursor), JetBrains VS Code companion, JetBrains and Zed via ACP
Desktop app and web Yes Not in the docs
Instructions file CLAUDE.md (can read AGENTS.md) GEMINI.md (file name configurable)
Settings file .claude/settings.json .gemini/settings.json
MCP Yes Yes
Skills Yes Yes
Hooks Yes Yes
Bundles Plugins Extensions
Built-in sandbox Shell commands, macOS, Linux, WSL 2 Seatbelt, Docker or Podman, Windows, gVisor, LXC

The Antigravity change you need to know about

Before comparing features, check whether Gemini CLI is the right Google tool for you at all. The Gemini CLI README says free individual access and Google AI Pro and Ultra moved to Antigravity CLI on June 18, 2026. It describes Gemini CLI as designed for Gemini Code Assist Standard and Enterprise licenses and Code Assist for GitHub on Google Cloud. Existing paid Gemini API and Vertex AI keys still work.

The README also says Gemini CLI isn't tuned for the Gemini 4 series, such as Gemini 4 Argon, and the docs point anyone who wants Gemini 4 Argon to Antigravity. So if you're a solo builder on a free or Google One plan, the honest comparison today is Claude Code vs Antigravity CLI, not Gemini CLI. The rest of this guide compares Claude Code with Gemini CLI as Google documents it.

How to install each one

Claude Code has a native installer (Claude Code overview):

Terminal
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash
PowerShell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

You can also use brew install --cask claude-code or winget install Anthropic.ClaudeCode. Full steps are in how to install Claude Code.

Gemini CLI installs through npm, Homebrew or MacPorts (Gemini CLI README):

Terminal
npx @google/gemini-cli            # run without installing
npm install -g @google/gemini-cli
brew install gemini-cli

Gemini CLI signs in with a Google account, a Gemini API key (GEMINI_API_KEY) or Vertex AI. Organization accounts need GOOGLE_CLOUD_PROJECT set to a Google Cloud project (authentication docs).

How you pay

Claude Code is included in Claude's Pro, Max, Ultra, Team and Enterprise plans. Anthropic's pricing page lists Pro at $20 a month billed monthly ($17 a month billed annually), Max at $100 a month and Ultra at $200 a month. The Free plan doesn't include Claude Code. You can also pay per token with an Anthropic Console account. See how much Claude Code costs for the detail.

Gemini CLI is measured in model requests per user per day. Google's quota and pricing page lists:

Gemini CLI access Daily limit
Gemini Code Assist Standard 1,500 requests per user
Gemini Code Assist Enterprise 2,000 requests per user
Gemini API key, unpaid 250 requests per user, Flash model only
Gemini API key, pay as you go Varies by pricing tier
Vertex AI Shared quota or provisioned throughput, billed by token

The same page still lists free and Google AI Pro or Ultra limits for individuals, but carries a banner saying unpaid tier and Google One users were moved to Antigravity CLI. Check the page before you plan a client project around free requests.

Models and context window

Claude Code runs Claude models. Anthropic's models overview lists a 1M token context window for every current model: Claude Fable 5.2, Opus 5.5, Sonnet 5.5 and Haiku 5.5. You switch with /model.

Gemini CLI runs Gemini models. On Code Assist tiers, Google says requests go "across the Gemini model family as determined by Gemini CLI". You can pick one with -m, for example gemini -m gemini-2.5-flash. Gemini CLI's own docs don't state a context window size, so check the model's page before relying on a number.

Instruction and config files

Both tools read a markdown file of project rules at the start of a session.

  • Claude Code reads CLAUDE.md, and can read an existing AGENTS.md instead (memory docs). See CLAUDE.md file examples.
  • Gemini CLI reads GEMINI.md from ~/.gemini/GEMINI.md, your workspace and its parent folders, and loads more from subfolders as it touches files there (GEMINI.md docs). /memory show prints what it loaded, and @file.md imports other files.

If you use both, Gemini CLI can load AGENTS.md too. Set context.fileName in .gemini/settings.json:

JSON
{
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}

Settings live in ~/.claude/settings.json and .claude/settings.json for Claude Code, and ~/.gemini/settings.json and .gemini/settings.json for Gemini CLI (Gemini CLI configuration).

Extensibility: MCP, skills, hooks and bundles

MCP servers connect the agent to outside tools. Both add them with one command:

Terminal
# Claude Code
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Gemini CLI
gemini mcp add --transport http http-server https://api.example.com/mcp/

Both examples come from each tool's docs (Claude Code MCP, Gemini CLI MCP). For more on the Claude side, see how to add an MCP server to Claude Code.

Skills package a repeatable workflow. In Claude Code, a skill saved in ~/.claude/skills/ is available in every project on your machine (Claude Code plugins docs). Gemini CLI reads .gemini/skills/ or .agents/skills/ and asks you to confirm before it activates one (Gemini CLI skills).

Hooks run your own scripts at fixed points. Claude Code hooks run shell commands before or after its actions, such as formatting after every edit (Claude Code overview). Gemini CLI has events such as BeforeTool, AfterTool, BeforeModel and SessionStart, and a hook can block a tool call by exiting with code 2 or returning a deny decision (Gemini CLI hooks).

Bundles. A Claude Code plugin packages skills, agents, hooks and MCP servers as one install. A Gemini CLI extension packages prompts, MCP servers, custom commands, themes, hooks, subagents and skills, and installs from a GitHub URL with gemini extensions install <url>.

Permissions and sandboxing

Claude Code has six permission modes: Manual (default), acceptEdits, plan, auto, dontAsk and bypassPermissions. Press Shift+Tab to cycle. Its sandbox, turned on with /sandbox, limits the files and network domains shell commands can reach. It works on macOS, Linux and WSL 2, not native Windows, and covers shell commands only. See Claude Code permissions.

Gemini CLI has approval modes default, auto_edit and plan in settings. YOLO mode, which approves everything, can only be turned on from the command line with --yolo or --approval-mode=yolo. Its sandbox starts with -s or --sandbox and can use macOS Seatbelt, Docker or Podman, a native Windows sandbox, gVisor or LXC.

The practical difference: Gemini CLI offers a container sandbox and a Windows option out of the box, while Claude Code's built-in sandbox needs WSL 2 on Windows.

IDE integration

Claude Code has a VS Code extension (which also installs in Cursor), a JetBrains plugin, a desktop app and a web version at claude.ai/code.

Gemini CLI pairs with the Gemini CLI Companion extension for VS Code and compatible editors. Run /ide install, then /ide enable. The companion shares your recent files and selection, and shows proposed changes in the editor's diff view. JetBrains IDEs and Zed connect through the Agent Client Protocol (IDE integration docs).

Which to choose

  • Your organization has Gemini Code Assist Standard or Enterprise. Gemini CLI is built for you, with daily request limits included in the licence.
  • You're a solo builder on a free or Google One plan. Google points you to Antigravity CLI, not Gemini CLI.
  • You want Claude models or more places to work. Claude Code runs in the terminal, IDEs, a desktop app, the web and Slack on one paid plan.
  • You need a Docker sandbox or native Windows sandboxing. Gemini CLI has both built in.
  • You want to read or change the agent's source. Gemini CLI is Apache 2.0 open source.
  • Try both on the same task. Give each the same spec on a copy of the repo, with a shared AGENTS.md, and compare the result and the corrections you made.

Comparing other agents too? See Claude Code vs Codex.

Learn to build with Claude Code

The Stride AI Coding course teaches Claude Code and Codex for building client tools, written for non-programmers, with weekly live calls to review your builds. Many of the free guides cover Claude Code setups, and the Claude Code community is where members compare theirs.

FAQ

Is Gemini CLI still free?

Google's Gemini CLI README says free individual access and Google AI Pro and Ultra moved to Antigravity CLI on June 18, 2026. An unpaid Gemini API key is still listed at 250 requests a day on the Flash model. Check Google's quota page before you rely on it.

Is Claude Code better than Gemini CLI?

Neither is better for every task. Results depend on the model, the task and how clearly you describe the work. Run both on the same spec in your own project and compare what you had to fix.

Can Gemini CLI read CLAUDE.md or AGENTS.md?

Yes, if you set context.fileName in .gemini/settings.json to include those names. Claude Code reads CLAUDE.md and can read AGENTS.md, so a shared AGENTS.md keeps both agents on the same rules.

Do both support MCP servers?

Yes. Claude Code uses claude mcp add and Gemini CLI uses gemini mcp add. Gemini CLI supports stdio, SSE and streamable HTTP servers.

Which one works better on Windows?

Claude Code has native Windows installers for PowerShell and WinGet, but its sandbox needs WSL 2 and commands run unsandboxed on native Windows. Gemini CLI installs through npm and documents a native Windows sandbox.

Build it with us in Stride AI Academy

Four courses, weekly live calls and a community of people building and selling AI. Or start with 310+ free guides.

Keep reading

Free AI Coding guides