# alishahryar1/free-claude-code

> free-claude-code is a local server and launcher that lets coding agents such as Claude Code, Codex, Pi, OpenCode, and Aider use models from a range of providers in the terminal, a browser, an IDE, or a phone. It runs a local API server that receives each agent's requests, adapts them to the API of the provider the user has configured, and returns the streamed responses to the agent. The project is written mainly in Python and uses FastAPI for its API layer.

Source: https://github.com/alishahryar1/free-claude-code
Indexed: commit f277730 on 2026-09-19 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: App
- Language: Python
- Stars: 70,510 at index time
- Code health: 5.7/10, Fair
- Last commit: 2026-09-19
- Contributors: 25

## How it works

Requests enter through src/free_claude_code/api/app.py, the FastAPI entry point for the local server. The src/free_claude_code/cli directory owns the command surface, including entrypoints.py and launchers such as launchers/aider.py, which connect a chosen coding agent to that server. The src/free_claude_code/application directory coordinates execution by selecting a provider, handling connected-account access, and running requests through the runtime execution ports. Provider-specific request and response handling lives under src/free_claude_code/providers, for example src/free_claude_code/providers/openai_chat/provider.py. Retries and fallback to the next configured model happen during execution, and optional terminal-output reduction is applied before results go back to the client. The Admin UI is served from src/free_claude_code/api/admin_static, where admin.js is one of the static files.

- smoke/lib/server.py: entry point
- src/free_claude_code/api/app.py: entry point
- src/free_claude_code/cli/desktop_entrypoint.py: entry point
- src/free_claude_code/cli/entrypoints.py: entry point
- src/free_claude_code/cli/launchers/aider.py: entry point
Modules: src, tests, smoke, e2e, scripts. 744 files, 167,940 lines, 9,370 symbols.

## Code health

- Score: 5.7/10 (Fair)
- Rank: #228 of 4,000+ indexed repos
- Hotspots: src/free_claude_code/providers/openai_chat/provider.py, src/free_claude_code/api/admin_static/admin.js, scripts/install.sh, src/free_claude_code/providers/openai_responses/transport.py, src/free_claude_code/providers/openai_codex/provider.py
- Lowest file: src/free_claude_code/api/admin_static/admin.js
- Dead code: 15 findings

## Maintenance

- Last commit 2026-09-19, first commit 2026-05-10, 501 commits
- 25 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/alishahryar1/free-claude-code/security

## More

- Page: https://repowise.dev/repo/alishahryar1/free-claude-code
- Ask this codebase: https://repowise.dev/repo/alishahryar1/free-claude-code/chat
- Docs: https://repowise.dev/repo/alishahryar1/free-claude-code/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/alishahryar1/free-claude-code
