free-claude-code  by Alishahryar1

Proxy for Claude Code enabling free access

Created 2 months ago
1,805 stars

Top 23.4% on SourcePulse

GitHubView on GitHub
Project Summary

<2-3 sentences summarising what the project addresses and solves, the target audience, and the benefit.> This project provides a free proxy for Claude Code's CLI and VSCode extension, eliminating the need for an Anthropic API key. It routes requests through NVIDIA NIM's free tier, OpenRouter's extensive model catalog, or local LM Studio instances, offering cost-effective AI coding assistance.

How It Works

The proxy transparently translates Claude Code's Anthropic API calls into an OpenAI-compatible format for various LLM providers. It optimizes common, low-value API requests locally to conserve quota and reduce latency. The system supports parsing Claude's <think> tags and reasoning content, and heuristically parses tool calls from model text outputs for seamless integration.

Quick Start & Requirements

  • Prerequisites: API key for NVIDIA NIM (build.nvidia.com/settings/api-keys) or OpenRouter (openrouter.ai/keys), or LM Studio (lmstudio.ai) running locally. Python 3.14 is indicated.
  • Installation: Clone repo, cd into it, copy .env.example to .env, and configure provider details (e.g., PROVIDER_TYPE, NVIDIA_NIM_API_KEY, MODEL).
  • Running: Start proxy: uv run uvicorn server:app --host 0.0.0.0 --port 8082. Run CLI: `ANTHROPIC_AUTH_TOKEN=freecc
Health Check
Last Commit

1 week ago

Responsiveness

Inactive

Pull Requests (30d)
7
Issues (30d)
26
Star History
926 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.