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
from dataclasses import FrozenInstanceError
import pytest
from free_claude_code.config.provider_catalog import (
PROVIDER_CATALOG,
ProviderAuthKind,
ProviderDescriptor,
)
def test_provider_descriptors_are_immutable_values() -> None:
descriptor = ProviderDescriptor(
provider_id="local",
display_name="Local",
website_url="https://example.test/",
logo_filename="local.svg",
local=True,
)
assert descriptor.local is True
assert not hasattr(descriptor, "__dict__")
with pytest.raises(FrozenInstanceError):
descriptor.__setattr__("local", False)
def test_catalog_has_no_transport_metadata() -> None:
assert "transport_type" not in ProviderDescriptor.__slots__
assert "capabilities" not in ProviderDescriptor.__slots__
def test_catalog_local_assignments_are_exact() -> None:
assert {
provider_id
for provider_id, descriptor in PROVIDER_CATALOG.items()
if descriptor.local
} == {"lmstudio", "llamacpp", "ollama"}
def test_ollama_cloud_is_remote_and_distinct_from_local_ollama() -> None:
cloud = PROVIDER_CATALOG["ollama_cloud"]
local = PROVIDER_CATALOG["ollama"]
assert cloud.local is False
assert cloud.credential_env == "OLLAMA_API_KEY"
assert local.local is True
assert local.credential_env is None
def test_provider_configuration_attrs_cover_multi_field_and_adc_providers() -> None:
assert PROVIDER_CATALOG["azure_openai"].configuration_attrs() == (
"azure_openai_api_keys",
"azure_openai_base_url",
)
assert PROVIDER_CATALOG["cloudflare"].configuration_attrs() == (
"cloudflare_api_tokens",
"cloudflare_account_id",
)
assert PROVIDER_CATALOG["vertex"].configuration_attrs() == ("vertex_project_id",)
def test_every_provider_declares_its_configuration_boundary() -> None:
assert all(
descriptor.configuration_attrs()
or descriptor.static_credential is not None
or descriptor.auth_kind is ProviderAuthKind.CONNECTED_ACCOUNT
for descriptor in PROVIDER_CATALOG.values()
)
def test_openai_is_a_connected_account_without_api_key_configuration() -> None:
descriptor = PROVIDER_CATALOG["openai"]
assert descriptor.auth_kind is ProviderAuthKind.CONNECTED_ACCOUNT
assert descriptor.credential_env is None
assert descriptor.configuration_attrs() == ()
assert descriptor.default_base_url == "https://chatgpt.com/backend-api/codex"
def test_openai_api_is_a_separate_key_configured_provider() -> None:
api = PROVIDER_CATALOG["openai_api"]
subscription = PROVIDER_CATALOG["openai"]
assert api.auth_kind is ProviderAuthKind.CONFIGURATION
assert api.credential_env == "OPENAI_API_KEY"
assert api.configuration_attrs() == ("openai_api_keys",)
assert api.proxy_attr == "openai_api_proxy"
assert api.default_base_url == "https://api.openai.com/v1"
assert subscription.auth_kind is ProviderAuthKind.CONNECTED_ACCOUNT
assert subscription.credential_env is None
def test_copilot_is_connected_without_credential_configuration() -> None:
descriptor = PROVIDER_CATALOG["github_copilot"]
assert descriptor.auth_kind is ProviderAuthKind.CONNECTED_ACCOUNT
assert descriptor.credential_env is None
assert descriptor.configuration_attrs() == ()
assert descriptor.default_base_url == "https://api.githubcopilot.com"