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

patch: preserve Claude Desktop model overrides (#2088)

Ali Khokharbd984e28d321
diff --git a/src/free_claude_code/harnesses/claude_desktop_integration.py b/src/free_claude_code/harnesses/claude_desktop_integration.py
index 3977cc17..0cfc5210 100644
--- a/src/free_claude_code/harnesses/claude_desktop_integration.py
+++ b/src/free_claude_code/harnesses/claude_desktop_integration.py
@@ -279,7 +279,6 @@ def _current(library: _Library, values: JsonObject) -> bool:
profile.get("inferenceGatewayBaseUrl"),
str(values["inferenceGatewayBaseUrl"]),
)
- and "inferenceModels" not in profile
)
@@ -293,7 +292,6 @@ def _update_profile(library: _Library, values: JsonObject) -> bool:
# Desktop otherwise restricts tool network access to the inference gateway.
profile.setdefault("coworkEgressAllowedHosts", ["*"])
profile["inferenceCustomHeaders"] = headers
- profile.pop("inferenceModels", None)
return _write(library.profile_path, profile)
diff --git a/tests/api/test_claude_desktop_integration.py b/tests/api/test_claude_desktop_integration.py
index 4436da1b..9d411d43 100644
--- a/tests/api/test_claude_desktop_integration.py
+++ b/tests/api/test_claude_desktop_integration.py
@@ -80,8 +80,15 @@ def test_desktop_routes_connect_disconnect_and_hide_credentials(client):
json.loads(profile.read_text())["inferenceGatewayBaseUrl"]
== "http://127.0.0.1:4321"
)
+ config = json.loads(profile.read_text())
+ models = [desktop_model_id("nvidia_nim/one")]
+ config["inferenceModels"] = models
+ profile.write_text(json.dumps(config))
before = {path: path.stat().st_mtime_ns for path in root.rglob("*.json")}
- assert client.get(ROOT).json()["connected"] is True
+ response = client.get(ROOT)
+ assert response.json()["connected"] is True
+ assert "desktop-secret" not in response.text
+ assert json.loads(profile.read_text())["inferenceModels"] == models
assert before == {path: path.stat().st_mtime_ns for path in root.rglob("*.json")}
assert client.post(ROOT + "/disconnect").json()["connected"] is False
assert not profile.exists()
diff --git a/tests/harnesses/test_claude_desktop_integration.py b/tests/harnesses/test_claude_desktop_integration.py
index 5f58a393..f17adcd4 100644
--- a/tests/harnesses/test_claude_desktop_integration.py
+++ b/tests/harnesses/test_claude_desktop_integration.py
@@ -6,6 +6,7 @@ from types import SimpleNamespace
import pytest
from free_claude_code.config.paths import claude_desktop_disconnect_path
+from free_claude_code.core.gateway_model_ids import desktop_model_id
from free_claude_code.harnesses import claude_desktop_integration as desktop
from free_claude_code.harnesses.claude_desktop_integration import (
check_unmanaged,
@@ -170,6 +171,8 @@ def test_fresh_connection_and_disconnect_preserve_native_library(tmp_path):
assert read(meta(root))["appliedId"] == desktop.FCC_ID
assert read(mode(root))["deploymentMode"] == "3p"
assert read(profile(root))["inferenceGatewayApiKey"] == TOKEN
+ assert read(profile(root))["modelDiscoveryEnabled"] is True
+ assert "inferenceModels" not in read(profile(root))
assert read(profile(root))["coworkEgressAllowedHosts"] == ["*"]
before = {p: p.read_bytes() for p in root.rglob("*.json")}
assert (
@@ -237,16 +240,71 @@ def test_connection_defaults_missing_egress_and_preserves_explicit_policy(
assert not desktop.refresh_connected(tmp_path, URL, TOKEN, disconnect_path=record)
[email protected]("reconnect", [False, True])
+ "models",
+ [
+ [desktop_model_id("nvidia_nim/one"), desktop_model_id("nvidia_nim/two")],
+ [
+ {
+ "name": desktop_model_id("nvidia_nim/two"),
+ "labelOverride": "Preferred model",
+ "maxEffort": "high",
+ },
+ {"name": desktop_model_id("nvidia_nim/one")},
+ ],
+ ],
+)
+def test_model_override_survives_refresh_and_connect(tmp_path, reconnect, models):
+ record = claude_desktop_disconnect_path()
+ desktop.configure(tmp_path, URL, TOKEN, True, disconnect_path=record)
+ config = read(profile(tmp_path))
+ config["inferenceModels"] = models
+ write(profile(tmp_path), config)
+ before = profile(tmp_path).read_bytes(), profile(tmp_path).stat().st_mtime_ns
+
+ assert desktop.configure(tmp_path, URL, TOKEN, disconnect_path=record)["connected"]
+ if reconnect:
+ assert desktop.configure(tmp_path, URL, TOKEN, True, disconnect_path=record)[
+ "connected"
+ ]
+ else:
+ assert not desktop.refresh_connected(
+ tmp_path, URL, TOKEN, disconnect_path=record
+ )
+
+ assert read(profile(tmp_path))["inferenceModels"] == models
+ assert (
+ profile(tmp_path).read_bytes(),
+ profile(tmp_path).stat().st_mtime_ns,
+ ) == before
+ config.pop("inferenceModels")
+ write(profile(tmp_path), config)
+ assert not desktop.refresh_connected(tmp_path, URL, TOKEN, disconnect_path=record)
+ assert "inferenceModels" not in read(profile(tmp_path))
+
+
def test_refresh_rotates_credentials_without_reactivating(tmp_path):
desktop.configure(
tmp_path, URL, TOKEN, True, disconnect_path=claude_desktop_disconnect_path()
)
+ config = read(profile(tmp_path))
+ models = [
+ {"name": desktop_model_id("nvidia_nim/two"), "labelOverride": "Preferred"},
+ {"name": desktop_model_id("nvidia_nim/one"), "maxEffort": "high"},
+ ]
+ config["inferenceModels"] = models
+ write(profile(tmp_path), config)
assert desktop.refresh_connected(
tmp_path,
"http://localhost:9000",
"new-token",
disconnect_path=claude_desktop_disconnect_path(),
)
+ refreshed = read(profile(tmp_path))
+ assert refreshed["inferenceModels"] == models
+ assert refreshed["inferenceGatewayBaseUrl"] == "http://localhost:9000"
+ assert refreshed["inferenceGatewayApiKey"] == "new-token"
assert desktop.configure(
tmp_path,
"http://localhost:9000",
@@ -382,7 +440,7 @@ def test_other_profiles_and_unknown_settings_are_preserved(tmp_path):
)
assert read(profile(tmp_path))["keep"] is True
assert read(profile(tmp_path))["inferenceCustomHeaders"]["X-Other"] == "value"
- assert "inferenceModels" not in read(profile(tmp_path))
+ assert read(profile(tmp_path))["inferenceModels"] == config["inferenceModels"]
metadata = read(meta(tmp_path))
metadata["appliedId"] = other
metadata["hybridPointer"] = {"bootstrapUrl": "https://example.test"}
diff --git a/tests/runtime/test_integration_startup.py b/tests/runtime/test_integration_startup.py
index b75ebe47..1fd720f8 100644
--- a/tests/runtime/test_integration_startup.py
+++ b/tests/runtime/test_integration_startup.py
@@ -15,6 +15,7 @@ from free_claude_code.config.api_keys import normalize_api_keys
from free_claude_code.config.loader import ManagedConfigStore
from free_claude_code.config.paths import claude_desktop_disconnect_path
from free_claude_code.config.settings import Settings
+from free_claude_code.core.gateway_model_ids import desktop_model_id
from free_claude_code.harnesses import (
claude_desktop_integration as desktop,
)
@@ -377,9 +378,21 @@ async def test_desktop_startup_rotates_selected_profile_and_disconnect_stays_off
True,
disconnect_path=claude_desktop_disconnect_path(),
)
+ profile = root / "configLibrary" / f"{desktop.FCC_ID}.json"
+ config = json.loads(profile.read_text())
+ models = [
+ {"name": desktop_model_id("nvidia_nim/one"), "labelOverride": "Pinned model"},
+ {"name": desktop_model_id("nvidia_nim/two"), "maxEffort": "high"},
+ ]
+ config["inferenceModels"] = models
+ profile.write_text(json.dumps(config))
try:
await runtime.start()
await runtime._integrations._desktop_update.task
+ refreshed = json.loads(profile.read_text())
+ assert refreshed["inferenceModels"] == models
+ assert refreshed["inferenceGatewayApiKey"] == TOKEN
+ assert refreshed["inferenceGatewayBaseUrl"] == "http://127.0.0.1:8000"
result = await runtime.claude_desktop_status()
assert result["connected"] is True
assert result["update"]["changed"] is True