How sivanesh-murugasamy/free-claude-code works
Free Claude Code is a local model gateway and coding-agent launcher, with an Admin UI for provider setup and optional Discord/Telegram agent workflows. The main path is client or launcher → API → model routing → provider adapter → streamed Anthropic-compatible response. Runtime wiring and API routing are supported by the source index; additional capabilities such as desktop launch and messaging are documented in the README, but their detailed internal links are not inferred from unsampled code.
Main entry points: routes.py HTTP API routes · application.py Application runtime · client.py Provider adapters · routing.py Model routing
Components 23
Client entrypoints
- Agent launchers
src/free_claude_code/cli/launchers/claude.py - Desktop controls
src/free_claude_code/cli/desktop.py
Configuration and runtime
- Admin UI
src/free_claude_code/api/admin_routes.py - Settings and catalog
src/free_claude_code/config/settings.py - Application runtime
src/free_claude_code/runtime/application.py - Provider catalog
src/free_claude_code/config/provider_catalog.py
Gateway and protocols
- HTTP API routes
src/free_claude_code/api/routes.py - Messages handler
src/free_claude_code/api/handlers/messages.py - Responses handler
src/free_claude_code/api/handlers/responses.py - Anthropic protocol
src/free_claude_code/core/anthropic/models.py - Reasoning policy
src/free_claude_code/core/reasoning.py - Model routing
src/free_claude_code/application/routing.py
Provider execution
- Provider manager
src/free_claude_code/runtime/provider_manager.py - Provider construction
src/free_claude_code/providers/runtime/factory.py - Provider discovery
src/free_claude_code/providers/runtime/discovery.py - Provider interface
src/free_claude_code/providers/base.py - Admission and retry
src/free_claude_code/providers/admission.py - Provider adapters
src/free_claude_code/providers/nvidia_nim/client.py
Messaging agents
- Messaging workflow
src/free_claude_code/messaging/workflow.py - Chat platforms
src/free_claude_code/messaging/platforms/factory.py - Conversation trees
src/free_claude_code/messaging/trees/manager.py
Other components
- Coding agent
- Model services
Connections 25
- Coding agent → Agent launchers: launches
README.md - Agent launchers → Application runtime: uses settings
README.md - Desktop controls → Application runtime: controls
README.md - Coding agent → HTTP API routes: sends requests
README.md - HTTP API routes → Messages handler: routes requests
src/free_claude_code/api/routes.py - HTTP API routes → Responses handler: routes requests
src/free_claude_code/api/routes.py - HTTP API routes → Model routing: uses model routing
src/free_claude_code/api/routes.py - Messages handler → Anthropic protocol: handles protocol
- Responses handler → Anthropic protocol: adapts protocol
- Model routing → Reasoning policy: resolves policy
src/free_claude_code/application/routing.py - Model routing → Provider catalog: resolves provider
src/free_claude_code/application/routing.py - Application runtime → Provider manager: configures
src/free_claude_code/runtime/application.py - Application runtime → Settings and catalog: loads configuration
src/free_claude_code/runtime/application.py - Provider manager → Provider discovery: discovers models
src/free_claude_code/runtime/provider_manager.py - Provider manager → Provider catalog: uses metadata
src/free_claude_code/runtime/provider_manager.py - Provider discovery → Provider construction: builds providers
- Provider construction → Provider interface: constructs adapters
- Provider adapters → Provider interface: implements
src/free_claude_code/providers/nvidia_nim/client.py - Provider adapters → Admission and retry: coordinates attempts
src/free_claude_code/providers/nvidia_nim/client.py - Provider adapters → Model services: calls model service
- Admin UI → Settings and catalog: manages configuration
src/free_claude_code/api/admin_routes.py - Admin UI → Provider catalog: browses providers
src/free_claude_code/api/admin_routes.py - Messaging workflow → Chat platforms: uses platform adapters
- Messaging workflow → Conversation trees: coordinates conversations
- Coding agent → Messaging workflow: uses optional bots
README.md