Knowledge Base updated: 2026-11-19
Free Claude Code knowledge base
Free Claude Code is a Python gateway that connects compatible API and interactive clients to multiple upstream AI providers. Its main parts are the HTTP API, application execution and provider layers, messaging integrations, protocol adapters, runtime configuration, and client launchers.
Critical runtime state includes loaded settings and provider catalogs, connected-account/model selection, request and stream recovery state, and messaging conversation-tree/session state.
flowchart TD
Clients[API and external clients] --> API[HTTP API gateway]
API --> Exec[Execution routing]
Exec --> Providers[Provider integrations]
Providers --> Upstreams[AI provider APIs]
API --> Protocols[Protocol adapters]
Messaging[Discord and Telegram] --> Turns[Messaging turn workflows]
Turns --> Exec
Turns --> Trees[Conversation trees and transcripts]
Config[Configuration lifecycle] --> Runtime[Runtime startup]
Runtime --> API
Runtime --> Providers
CLI[CLI and desktop runtime] --> API
Harnesses[Client integration harnesses] --> CLI
Glossary
- Connected account: Configured provider identity used when selecting an upstream model and request credentials.
- Conversation tree: Durable, branching coordination model for concurrent messaging turns.
- Protocol adapter: Translation layer between gateway request/stream semantics and an upstream provider protocol.
- Provider manager: Runtime component that constructs, discovers, and maintains the available provider set.
- Fallback decision: Recorded selection of another model or runner after an execution failure.
Routing table
src/free_claude_code/api/**→ docs/api-gateway.mdsrc/free_claude_code/api/anthropic/**→ docs/api-anthropic-endpoints.mdsrc/free_claude_code/api/admin/**→ docs/api-admin-and-web-tools.mdsrc/free_claude_code/application/**→ docs/execution-routing.mdsrc/free_claude_code/application/execution/**→ docs/execution-orchestration.mdsrc/free_claude_code/application/accounts/**→ docs/accounts-models-and-reasoning.mdsrc/free_claude_code/application/fallback/**→ docs/model-fallback-decisioning.mdsrc/free_claude_code/providers/**→ docs/provider-integrations.mdsrc/free_claude_code/providers/runtime/**→ docs/provider-runtime-and-discovery.mdsrc/free_claude_code/providers/adapters/**→ docs/provider-adapter-catalog.mdsrc/free_claude_code/messaging/**→ docs/messaging-platforms.mdsrc/free_claude_code/messaging/workflows/**→ docs/messaging-turn-workflows.mdsrc/free_claude_code/messaging/conversation/**→ docs/messaging-conversation-trees.mdsrc/free_claude_code/messaging/transcripts/**→ docs/messaging-transcripts-rendering-and-voice.mdsrc/free_claude_code/config/**→ docs/configuration-and-runtime.mdsrc/free_claude_code/config/settings/**→ docs/configuration-lifecycle.mdsrc/free_claude_code/runtime/**→ docs/runtime-startup-and-provider-management.mdsrc/free_claude_code/protocols/**→ docs/protocol-adapters.mdsrc/free_claude_code/protocols/anthropic/**→ docs/anthropic-protocol-adapter.mdsrc/free_claude_code/protocols/gemini/**→ docs/gemini-protocol-adapter.mdsrc/free_claude_code/protocols/chat_completions/**→ docs/chat-completions-protocol-adapter.mdsrc/free_claude_code/history/**→ docs/history-replay-and-correction.mdsrc/free_claude_code/cli/**→ docs/cli-and-desktop-runtime.mdsrc/free_claude_code/cli/launchers/**→ docs/cli-launchers-and-managed-processes.mdsrc/free_claude_code/integrations/**→ docs/client-integration-harnesses.mdsrc/free_claude_code/integrations/adapters/**→ docs/client-integration-adapters.mdsrc/free_claude_code/core/**→ docs/core-request-and-stream-resilience.md