Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)
Python
Feature Add Tokenrouter Provider (#1376)
Tanishq-133b5e1b6f719
diff --git a/.env.example b/.env.exampleindex d1957c48..4e551687 100644--- a/.env.example+++ b/.env.example@@ -68,6 +68,11 @@ GITHUB_MODELS_TOKEN=""ZAI_API_KEY=""+# TokenRouter Config (OpenAI-compatible Chat Completions gateway at api.tokenrouter.com/v1)+TOKENROUTER_API_KEY=""+TOKENROUTER_BASE_URL="https://api.tokenrouter.com/v1"++# Fireworks AI Config (OpenAI-compatible Chat Completions at api.fireworks.ai/inference/v1)FIREWORKS_API_KEY=""@@ -121,7 +126,7 @@ OLLAMA_BASE_URL="http://localhost:11434"# All Claude model requests are mapped to these models, plain model is fallback# Format: provider_type/model/name-# Valid providers: "nvidia_nim" | "openai" | "azure_openai" | "open_router" | "gemini" | "vertex" | "deepseek" | "mistral" | "mistral_codestral" | "opencode_zen" | "opencode_go" | "vercel" | "bedrock" | "huggingface" | "cohere" | "github_models" | "wafer" | "kimi" | "kimi_code" | "minimax" | "cerebras" | "groq" | "sambanova" | "kilo" | "fireworks" | "cloudflare" | "zai" | "ollama_cloud" | "lmstudio" | "llamacpp" | "ollama"+# Valid providers: "nvidia_nim" | "openai" | "azure_openai" | "open_router" | "gemini" | "vertex" | "deepseek" | "mistral" | "mistral_codestral" | "opencode_zen" | "opencode_go" | "vercel" | "bedrock" | "huggingface" | "cohere" | "github_models" | "wafer" | "kimi" | "kimi_code" | "minimax" | "cerebras" | "groq" | "sambanova" | "kilo" | "fireworks" | "cloudflare" | "zai" | "ollama_cloud" | "lmstudio" | "llamacpp" | "ollama" | "tokenrouter"MODEL_FABLE=MODEL_OPUS=MODEL_SONNET=@@ -155,6 +160,7 @@ FCC_SMOKE_MODEL_HUGGINGFACE=FCC_SMOKE_MODEL_COHERE=FCC_SMOKE_MODEL_GITHUB_MODELS=FCC_SMOKE_MODEL_ZAI=+FCC_SMOKE_MODEL_TOKENROUTER=FCC_SMOKE_MODEL_FIREWORKS=FCC_SMOKE_MODEL_CLOUDFLARE=FCC_SMOKE_MODEL_GEMINI=@@ -202,6 +208,7 @@ HUGGINGFACE_PROXY=""COHERE_PROXY=""GITHUB_MODELS_PROXY=""ZAI_PROXY=""+TOKENROUTER_PROXY=""FIREWORKS_PROXY=""CLOUDFLARE_PROXY=""GEMINI_PROXY=""diff --git a/README.md b/README.mdindex 11353274..fa08375b 100644--- a/README.md+++ b/README.md@@ -179,6 +179,7 @@ fcc-codex exec "hello"| [Fireworks AI](https://fireworks.ai/account/api-keys) | `FIREWORKS_API_KEY` | `fireworks/accounts/fireworks/models/llama-v3p3-70b-instruct` || [Cloudflare Workers AI](https://developers.cloudflare.com/workers-ai/) | `CLOUDFLARE_API_TOKEN` and `CLOUDFLARE_ACCOUNT_ID` | `cloudflare/@cf/moonshotai/kimi-k2.6` || [Z.ai](https://z.ai/manage-apikey/apikey-list) | `ZAI_API_KEY` | `zai/glm-5.2` |+| [TokenRouter](https://www.tokenrouter.com/) | `TOKENROUTER_API_KEY` | `tokenrouter/moonshotai/kimi-k3-free` || [Ollama Cloud](https://ollama.com/settings/keys) | `OLLAMA_API_KEY` | `ollama_cloud/qwen3-coder:480b` || [LM Studio](https://lmstudio.ai/) | `LM_STUDIO_BASE_URL` | `lmstudio/<model-id>` || [llama.cpp](https://github.com/ggml-org/llama.cpp) | `LLAMACPP_BASE_URL` | `llamacpp/<model-id>` |diff --git a/pyproject.toml b/pyproject.tomlindex be986994..0ffe772d 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -4,7 +4,7 @@ build-backend = "hatchling.build"[project]name = "free-claude-code"-version = "4.17.8"+version = "4.18.0"description = "Local proxy connecting coding agents to OpenAI-compatible AI providers"readme = "README.md"requires-python = ">=3.14.0"diff --git a/smoke/lib/config.py b/smoke/lib/config.pyindex e5fab30b..1faf9db8 100644--- a/smoke/lib/config.py+++ b/smoke/lib/config.py@@ -74,6 +74,7 @@ PROVIDER_SMOKE_DEFAULT_MODELS: dict[str, str] = {"kilo": "kilo/kilo-auto/free","cerebras": "cerebras/llama3.1-8b","cloudflare": "cloudflare/@cf/moonshotai/kimi-k2.6",+ "tokenrouter": "tokenrouter/moonshotai/kimi-k3-free",}MISTRAL_REASONING_SMOKE_DEFAULT_MODEL = "mistral/mistral-medium-3-5"diff --git a/src/free_claude_code/config/admin/manifest.py b/src/free_claude_code/config/admin/manifest.pyindex 34089bd5..4ebb4ca1 100644--- a/src/free_claude_code/config/admin/manifest.py+++ b/src/free_claude_code/config/admin/manifest.py@@ -723,6 +723,12 @@ _NON_PROVIDER_FIELDS: tuple[ConfigFieldSpec, ...] = ("smoke",advanced=True,),+ ConfigFieldSpec(+ "FCC_SMOKE_MODEL_TOKENROUTER",+ "Smoke TokenRouter Model",+ "smoke",+ advanced=True,+ ),ConfigFieldSpec("FCC_SMOKE_NIM_MODELS","Smoke NIM Models",diff --git a/src/free_claude_code/config/admin/provider_manifest.py b/src/free_claude_code/config/admin/provider_manifest.pyindex 5052271f..f6e43303 100644--- a/src/free_claude_code/config/admin/provider_manifest.py+++ b/src/free_claude_code/config/admin/provider_manifest.py@@ -150,6 +150,18 @@ _PROVIDER_FIELD_OVERRIDES: dict[str, dict[str, Any]] = {"Ollama API key for direct OpenAI-compatible Cloud access at ollama.com/v1."),},+ "TOKENROUTER_API_KEY": {+ "label": "TokenRouter API Key",+ "description": (+ "TokenRouter OpenAI-compatible gateway API key for api.tokenrouter.com/v1."+ ),+ },+ "TOKENROUTER_BASE_URL": {+ "description": (+ "TokenRouter OpenAI-compatible Chat Completions base URL. "+ "Defaults to https://api.tokenrouter.com/v1."+ ),+ },}diff --git a/src/free_claude_code/config/provider_catalog.py b/src/free_claude_code/config/provider_catalog.pyindex 7c38c1b3..c1ce4b3a 100644--- a/src/free_claude_code/config/provider_catalog.py+++ b/src/free_claude_code/config/provider_catalog.py@@ -49,6 +49,8 @@ SAMBANOVA_DEFAULT_BASE = "https://api.sambanova.ai/v1"# Kilo.ai gateway OpenAI-compatible Chat Completions API.KILO_DEFAULT_BASE = "https://api.kilo.ai/api/gateway"OPENAI_CODEX_DEFAULT_BASE = "https://chatgpt.com/backend-api/codex"+# TokenRouter OpenAI-compatible Chat Completions gateway.+TOKENROUTER_DEFAULT_BASE = "https://api.tokenrouter.com/v1"class ProviderAuthKind(StrEnum):@@ -337,6 +339,16 @@ PROVIDER_CATALOG: dict[str, ProviderDescriptor] = {default_base_url=ZAI_DEFAULT_BASE,proxy_attr="zai_proxy",),+ "tokenrouter": ProviderDescriptor(+ provider_id="tokenrouter",+ display_name="TokenRouter",+ credential_env="TOKENROUTER_API_KEY",+ credential_url="https://www.tokenrouter.com/",+ credential_attr="tokenrouter_api_key",+ default_base_url=TOKENROUTER_DEFAULT_BASE,+ base_url_attr="tokenrouter_base_url",+ proxy_attr="tokenrouter_proxy",+ ),"ollama_cloud": ProviderDescriptor(provider_id="ollama_cloud",display_name="Ollama Cloud",diff --git a/src/free_claude_code/config/settings.py b/src/free_claude_code/config/settings.pyindex 82384ad2..7c9182d8 100644--- a/src/free_claude_code/config/settings.py+++ b/src/free_claude_code/config/settings.py@@ -13,7 +13,11 @@ from .env_files import (settings_env_files,)from .nim import NimSettings-from .provider_catalog import BEDROCK_DEFAULT_BASE, SUPPORTED_PROVIDER_IDS+from .provider_catalog import (+ BEDROCK_DEFAULT_BASE,+ SUPPORTED_PROVIDER_IDS,+ TOKENROUTER_DEFAULT_BASE,+)from .reasoning import ReasoningPreference@@ -88,6 +92,13 @@ class Settings(BaseSettings):# ==================== Z.ai Config ====================zai_api_key: str = Field(default="", validation_alias="ZAI_API_KEY")+ # ==================== TokenRouter Config ====================+ tokenrouter_api_key: str = Field(default="", validation_alias="TOKENROUTER_API_KEY")+ tokenrouter_base_url: str = Field(+ default=TOKENROUTER_DEFAULT_BASE,+ validation_alias="TOKENROUTER_BASE_URL",+ )+# ==================== Fireworks AI Config ====================fireworks_api_key: str = Field(default="", validation_alias="FIREWORKS_API_KEY")@@ -185,6 +196,7 @@ class Settings(BaseSettings):sambanova_proxy: str = Field(default="", validation_alias="SAMBANOVA_PROXY")kilo_proxy: str = Field(default="", validation_alias="KILO_PROXY")zai_proxy: str = Field(default="", validation_alias="ZAI_PROXY")+ tokenrouter_proxy: str = Field(default="", validation_alias="TOKENROUTER_PROXY")fireworks_proxy: str = Field(default="", validation_alias="FIREWORKS_PROXY")cloudflare_proxy: str = Field(default="", validation_alias="CLOUDFLARE_PROXY")gemini_proxy: str = Field(default="", validation_alias="GEMINI_PROXY")diff --git a/src/free_claude_code/providers/openai_chat/profiles.py b/src/free_claude_code/providers/openai_chat/profiles.pyindex 6f7c91c4..3fb6e2ab 100644--- a/src/free_claude_code/providers/openai_chat/profiles.py+++ b/src/free_claude_code/providers/openai_chat/profiles.py@@ -342,6 +342,13 @@ OPENAI_CHAT_PROFILES: dict[str, OpenAIChatProfile] = {),reasoning_delta_field="reasoning",),+ "tokenrouter": OpenAIChatProfile(+ _policy(+ "TOKENROUTER",+ ReasoningReplayMode.DISABLED,+ ),+ NO_REASONING,+ ),"llamacpp": OpenAIChatProfile(_policy("LLAMACPP",diff --git a/tests/contracts/test_provider_catalog_order.py b/tests/contracts/test_provider_catalog_order.pyindex 1c80b1ca..50dda708 100644--- a/tests/contracts/test_provider_catalog_order.py+++ b/tests/contracts/test_provider_catalog_order.py@@ -33,6 +33,7 @@ _EXPECTED_PROVIDER_ORDER: tuple[str, ...] = ("fireworks","cloudflare","zai",+ "tokenrouter","ollama_cloud","lmstudio","llamacpp",diff --git a/tests/providers/test_provider_runtime.py b/tests/providers/test_provider_runtime.pyindex 75a5b334..4b9a5506 100644--- a/tests/providers/test_provider_runtime.py+++ b/tests/providers/test_provider_runtime.py@@ -20,6 +20,7 @@ from free_claude_code.config.provider_catalog import (OLLAMA_CLOUD_DEFAULT_BASE,PROVIDER_CATALOG,SUPPORTED_PROVIDER_IDS,+ TOKENROUTER_DEFAULT_BASE,VERCEL_AI_GATEWAY_DEFAULT_BASE,ZAI_DEFAULT_BASE,)@@ -71,6 +72,8 @@ def _make_settings(**overrides):mock.cohere_api_key = "test_cohere_key"mock.github_models_token = "test_github_models_token"mock.zai_api_key = "test_zai_key"+ mock.tokenrouter_api_key = "test_tokenrouter_key"+ mock.tokenrouter_base_url = TOKENROUTER_DEFAULT_BASEmock.lm_studio_base_url = "http://localhost:1234/v1"mock.llamacpp_base_url = "http://localhost:8080/v1"mock.ollama_base_url = "http://localhost:11434"@@ -95,6 +98,7 @@ def _make_settings(**overrides):mock.cohere_proxy = ""mock.github_models_proxy = ""mock.zai_proxy = ""+ mock.tokenrouter_proxy = ""mock.fireworks_proxy = ""mock.fireworks_api_key = "test_fireworks_key"mock.cloudflare_api_token = "test_cloudflare_token"@@ -495,6 +499,7 @@ def test_create_provider_instantiates_each_builtin():"cohere": OpenAIChatProvider,"github_models": GitHubModelsProvider,"zai": OpenAIChatProvider,+ "tokenrouter": OpenAIChatProvider,"gemini": GeminiProvider,"vertex": VertexProvider,"groq": GroqProvider,diff --git a/uv.lock b/uv.lockindex c300eeda..f7f06514 100644--- a/uv.lock+++ b/uv.lock@@ -620,7 +620,7 @@ wheels = [[[package]]name = "free-claude-code"-version = "4.17.8"+version = "4.18.0"source = { editable = "." }dependencies = [{ name = "aiohttp" },