Skip to content

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

Use fixed endpoints for four cloud providers (#1891)

Ali Khokhar2baadb861997
diff --git a/pyproject.toml b/pyproject.toml
index f015635b..84477521 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "free-claude-code"
-version = "6.2.60"
+version = "6.2.61"
description = "Local proxy connecting coding agents to OpenAI-compatible AI providers"
readme = "README.md"
license = "AGPL-3.0-only"
diff --git a/src/free_claude_code/config/admin/provider_manifest.py b/src/free_claude_code/config/admin/provider_manifest.py
index 40259fb5..f79999bd 100644
--- a/src/free_claude_code/config/admin/provider_manifest.py
+++ b/src/free_claude_code/config/admin/provider_manifest.py
@@ -255,12 +255,6 @@ _PROVIDER_FIELD_OVERRIDES: dict[str, ProviderFieldOverride] = {
"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."
- ),
- },
"NARAROUTE_API_KEY": {
"label": "NaraRoute API Key",
"description": (
@@ -268,12 +262,6 @@ _PROVIDER_FIELD_OVERRIDES: dict[str, ProviderFieldOverride] = {
"Keys begin with sk-nry-; create one at router.bynara.id/keys."
),
},
- "NARAROUTE_BASE_URL": {
- "description": (
- "NaraRoute OpenAI-compatible Chat Completions base URL. "
- "Defaults to https://router.bynara.id/v1."
- ),
- },
"LIGHTNING_API_KEY": {
"label": "Lightning AI API Key",
"description": (
@@ -281,12 +269,6 @@ _PROVIDER_FIELD_OVERRIDES: dict[str, ProviderFieldOverride] = {
"lightning.ai/api/v1. Create one on lightning.ai under Model APIs."
),
},
- "LIGHTNING_BASE_URL": {
- "description": (
- "Lightning AI OpenAI-compatible Chat Completions base URL. "
- "Defaults to https://lightning.ai/api/v1."
- ),
- },
"AGNES_API_KEY": {
"label": "Agnes AI API Key",
"description": (
@@ -315,12 +297,6 @@ _PROVIDER_FIELD_OVERRIDES: dict[str, ProviderFieldOverride] = {
"hex characters; mint one at platform.experientiallabs.ai/settings/api-keys."
),
},
- "EXPLABS_BASE_URL": {
- "description": (
- "Experiential Labs OpenAI-compatible Chat Completions base URL. "
- "Defaults to https://api.experientiallabs.ai/v1."
- ),
- },
}
diff --git a/src/free_claude_code/config/provider_catalog.py b/src/free_claude_code/config/provider_catalog.py
index 9aa76770..90f7aef9 100644
--- a/src/free_claude_code/config/provider_catalog.py
+++ b/src/free_claude_code/config/provider_catalog.py
@@ -619,7 +619,6 @@ PROVIDER_CATALOG: dict[str, ProviderDescriptor] = {
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",
),
"nararoute": ProviderDescriptor(
@@ -631,7 +630,6 @@ PROVIDER_CATALOG: dict[str, ProviderDescriptor] = {
credential_url="https://router.bynara.id/keys",
credential_attr="nararoute_api_key",
default_base_url=NARAROUTE_DEFAULT_BASE,
- base_url_attr="nararoute_base_url",
proxy_attr="nararoute_proxy",
),
"poolside": ProviderDescriptor(
@@ -676,7 +674,6 @@ PROVIDER_CATALOG: dict[str, ProviderDescriptor] = {
credential_url="https://lightning.ai/lightning-ai/model-apis/models",
credential_attr="lightning_api_key",
default_base_url=LIGHTNING_DEFAULT_BASE,
- base_url_attr="lightning_base_url",
proxy_attr="lightning_proxy",
),
"experiential": ProviderDescriptor(
@@ -688,7 +685,6 @@ PROVIDER_CATALOG: dict[str, ProviderDescriptor] = {
credential_url="https://platform.experientiallabs.ai/settings/api-keys",
credential_attr="experiential_api_key",
default_base_url=EXPERIENTIAL_DEFAULT_BASE,
- base_url_attr="experiential_base_url",
proxy_attr="experiential_proxy",
),
"ollama_cloud": ProviderDescriptor(
diff --git a/src/free_claude_code/config/settings.py b/src/free_claude_code/config/settings.py
index 6f02c2d8..6e70fc4e 100644
--- a/src/free_claude_code/config/settings.py
+++ b/src/free_claude_code/config/settings.py
@@ -17,11 +17,7 @@ from .model_refs import parse_model_fallbacks
from .nim import NimSettings
from .provider_catalog import (
BEDROCK_DEFAULT_BASE,
- EXPERIENTIAL_DEFAULT_BASE,
- LIGHTNING_DEFAULT_BASE,
- NARAROUTE_DEFAULT_BASE,
SUPPORTED_PROVIDER_IDS,
- TOKENROUTER_DEFAULT_BASE,
)
from .reasoning import ReasoningPreference
@@ -173,19 +169,11 @@ class Settings(BaseModel):
tokenrouter_api_key: OptionalNonEmptyString = Field(
default=None, validation_alias="TOKENROUTER_API_KEY"
)
- tokenrouter_base_url: NonEmptyString = Field(
- default=TOKENROUTER_DEFAULT_BASE,
- validation_alias="TOKENROUTER_BASE_URL",
- )
# ==================== NaraRoute Config ====================
nararoute_api_key: OptionalNonEmptyString = Field(
default=None, validation_alias="NARAROUTE_API_KEY"
)
- nararoute_base_url: NonEmptyString = Field(
- default=NARAROUTE_DEFAULT_BASE,
- validation_alias="NARAROUTE_BASE_URL",
- )
# ==================== Poolside AI (OpenAI-compatible) ====================
poolside_api_key: OptionalNonEmptyString = Field(
@@ -201,19 +189,11 @@ class Settings(BaseModel):
lightning_api_key: OptionalNonEmptyString = Field(
default=None, validation_alias="LIGHTNING_API_KEY"
)
- lightning_base_url: NonEmptyString = Field(
- default=LIGHTNING_DEFAULT_BASE,
- validation_alias="LIGHTNING_BASE_URL",
- )
# ==================== Experiential Labs (OpenAI-compatible) ====================
experiential_api_key: OptionalNonEmptyString = Field(
default=None, validation_alias="EXPLABS_API_KEY"
)
- experiential_base_url: NonEmptyString = Field(
- default=EXPERIENTIAL_DEFAULT_BASE,
- validation_alias="EXPLABS_BASE_URL",
- )
# ==================== Fireworks AI Config ====================
fireworks_api_key: OptionalNonEmptyString = Field(
diff --git a/tests/config/test_fixed_cloud_endpoints.py b/tests/config/test_fixed_cloud_endpoints.py
new file mode 100644
index 00000000..ebb44e57
--- /dev/null
+++ b/tests/config/test_fixed_cloud_endpoints.py
@@ -0,0 +1,56 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from free_claude_code.config.loader import compose_settings_snapshot
+from free_claude_code.config.provider_catalog import PROVIDER_CATALOG
+from free_claude_code.providers.runtime.config import build_provider_config
+from tests.api.support import create_test_app
+
+
+ "provider_id, retired_key",
+ [
+ ("tokenrouter", "TOKENROUTER_BASE_URL"),
+ ("nararoute", "NARAROUTE_BASE_URL"),
+ ("lightning", "LIGHTNING_BASE_URL"),
+ ("experiential", "EXPLABS_BASE_URL"),
+ ],
+)
[email protected]("source", ["managed", "process", "both"])
+def test_retired_url_cannot_override_cloud_endpoint(provider_id, retired_key, source):
+ descriptor = PROVIDER_CATALOG[provider_id]
+ assert descriptor.credential_env is not None
+ managed = {descriptor.credential_env: "test-key"}
+ process = {}
+ if source in {"managed", "both"}:
+ managed[retired_key] = "https://saved-custom.example/v1"
+ if source in {"process", "both"}:
+ process[retired_key] = "https://process-custom.example/v1"
+ settings = compose_settings_snapshot(managed, process).settings
+ config = build_provider_config(descriptor, settings)
+ assert config.base_url == descriptor.default_base_url
+ assert config.api_key == "test-key"
+
+
+def test_admin_exposes_only_resource_region_and_local_base_urls():
+ with TestClient(
+ create_test_app(), base_url="http://127.0.0.1", client=("127.0.0.1", 50000)
+ ) as client:
+ response = client.get("/admin/api/config")
+ assert response.status_code == 200
+ keys = {field["key"] for field in response.json()["fields"]}
+ assert not keys.intersection(
+ {
+ "TOKENROUTER_BASE_URL",
+ "NARAROUTE_BASE_URL",
+ "LIGHTNING_BASE_URL",
+ "EXPLABS_BASE_URL",
+ }
+ )
+ assert {
+ "AZURE_OPENAI_BASE_URL",
+ "BEDROCK_BASE_URL",
+ "LM_STUDIO_BASE_URL",
+ "LLAMACPP_BASE_URL",
+ "OLLAMA_BASE_URL",
+ } <= keys
diff --git a/tests/providers/test_provider_runtime.py b/tests/providers/test_provider_runtime.py
index 19ab851d..fb443fa4 100644
--- a/tests/providers/test_provider_runtime.py
+++ b/tests/providers/test_provider_runtime.py
@@ -22,10 +22,8 @@ from free_claude_code.config.provider_catalog import (
FEATHERLESS_DEFAULT_BASE,
HUGGINGFACE_DEFAULT_BASE,
KIMI_CODE_DEFAULT_BASE,
- LIGHTNING_DEFAULT_BASE,
LLM7_DEFAULT_BASE,
MINIMAX_DEFAULT_BASE,
- NARAROUTE_DEFAULT_BASE,
NEBIUS_DEFAULT_BASE,
OLLAMA_CLOUD_DEFAULT_BASE,
POOLSIDE_DEFAULT_BASE,
@@ -36,7 +34,6 @@ from free_claude_code.config.provider_catalog import (
SILICONFLOW_DEFAULT_BASE,
SUPPORTED_PROVIDER_IDS,
TOGETHER_DEFAULT_BASE,
- TOKENROUTER_DEFAULT_BASE,
VERCEL_AI_GATEWAY_DEFAULT_BASE,
WANDB_INFERENCE_DEFAULT_BASE,
XAI_DEFAULT_BASE,
@@ -105,9 +102,7 @@ def _make_settings(**overrides):
mock.cohere_api_key = "test_cohere_key"
mock.zai_api_key = "test_zai_key"
mock.tokenrouter_api_key = "test_tokenrouter_key"
- mock.tokenrouter_base_url = TOKENROUTER_DEFAULT_BASE
mock.nararoute_api_key = "test_nararoute_key"
- mock.nararoute_base_url = NARAROUTE_DEFAULT_BASE
mock.agnes_api_key = "test_agnes_key"
mock.zenmux_api_key = "test_zenmux_key"
mock.wandb_api_key = "test_wandb_key"
@@ -118,9 +113,7 @@ def _make_settings(**overrides):
mock.poolside_api_key = "test_poolside_key"
mock.llm7_api_key = "test_llm7_key"
mock.lightning_api_key = "test_lightning_key"
- mock.lightning_base_url = LIGHTNING_DEFAULT_BASE
mock.experiential_api_key = "test_experiential_key"
- mock.experiential_base_url = EXPERIENTIAL_DEFAULT_BASE
mock.nvidia_nim_proxy = None
mock.open_router_proxy = None
mock.lmstudio_proxy = None
@@ -307,7 +300,6 @@ async def test_experiential_provider_config_uses_key_base_and_proxy() -> None:
descriptor = PROVIDER_CATALOG["experiential"]
settings = _make_settings(
experiential_api_key="experiential-token",
- experiential_base_url="https://custom.experientiallabs.example/v1",
experiential_proxy="http://proxy.test:8080",
)
@@ -323,10 +315,10 @@ async def test_experiential_provider_config_uses_key_base_and_proxy() -> None:
== "https://platform.experientiallabs.ai/settings/api-keys"
)
assert descriptor.default_base_url == EXPERIENTIAL_DEFAULT_BASE
- assert descriptor.base_url_attr == "experiential_base_url"
+ assert descriptor.base_url_attr is None
assert descriptor.proxy_attr == "experiential_proxy"
assert config.api_key == "experiential-token"
- assert config.base_url == "https://custom.experientiallabs.example/v1"
+ assert config.base_url == EXPERIENTIAL_DEFAULT_BASE
assert config.proxy == "http://proxy.test:8080"
assert isinstance(provider, OpenAIChatProvider)
diff --git a/uv.lock b/uv.lock
index a4f67a87..4d80ea81 100644
--- a/uv.lock
+++ b/uv.lock
@@ -599,7 +599,7 @@ wheels = [
[[package]]
name = "free-claude-code"
-version = "6.2.60"
+version = "6.2.61"
source = { editable = "." }
dependencies = [
{ name = "aiohttp" },