free-claude-code  by Alishahryar1

Proxy for Claude Code enabling free access

Created 4 weeks ago

New!

597 stars

Top 54.6% 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

2 days ago

Responsiveness

Inactive

Pull Requests (30d)
37
Issues (30d)
16
Star History
604 stars in the last 28 days

Explore Similar Projects

Feedback? Help us improve.