Skip to content

Conversation

@MuhammadHamidRaza
Copy link

Free Claude Code Setup with Google Gemini

This PR adds a new lesson that provides a completely free alternative to use Claude Code via Google's Gemini API.

All features of Claude Code CLI (Subagents, Skills, MCP servers, Hooks, etc.) work identically, with only the backend AI model and setup process changed.


✅ Key Features

  • Free alternative to official Claude subscription using Google Gemini
  • Step-by-step setup for Windows (CMD & PowerShell), macOS, and Linux
  • Router-based configuration instead of direct authentication
  • Fully tested and verified setup commands
  • Environment variable management for secure API key storage
  • Daily workflow instructions included

🔗 Video Tutorial

Full step-by-step guide (with voice): YouTube Link


📌 Setup Overview

  1. Install Node.js 18+
  2. Get a free Google API key
  3. Install Claude Code CLI and router tools
  4. Create required directories and config file
  5. Set environment variable with API key
  6. Verify installation
  7. Daily workflow: start router → activate Claude → code!

⚠️ Troubleshooting

  • mkdir errors → Use -Force (Windows) or -p (macOS/Linux)
  • API key not found → Restart terminal
  • ccr: command not found → Restart terminal
  • Port 3456 already in use → Kill conflicting process

This lesson is Lesson 3 in the Free Setup Extension and ensures students can continue with all Claude Code functionality using a free backend.


Branch: free-claude-gemini-setup
PR Title: Add Free Claude Code Setup with Google Gemini API

@MuhammadHamidRaza
Copy link
Author

@mjunaidca , @ziaukhan kindly check it every one face this issue by this pr every thing will be easy and seprete for Powershall ,Cmd ,Bash ,macOS / Linux

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants