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

Add Claude Desktop integration preview (#1843)

Ali Khokhar2fb4f6f1188f
diff --git a/e2e/test_admin_integrations.py b/e2e/test_admin_integrations.py
index 3247d7f3..88687f37 100644
--- a/e2e/test_admin_integrations.py
+++ b/e2e/test_admin_integrations.py
@@ -1,6 +1,6 @@
import json
import tomllib
-from itertools import pairwise
+from itertools import groupby, pairwise
import pytest
from playwright.sync_api import expect
@@ -56,12 +56,13 @@ def test_codex_connect_disconnect_and_modal_paths(
expect(page.locator("#openClaudeIntegration")).to_be_enabled()
expect(page.locator("#messageArea")).to_have_text("")
cards = page.locator("#view-integrations > article")
- expect(cards).to_have_count(3)
+ expect(cards).to_have_count(4)
expect(cards.locator("h3")).to_have_text(
[
"Claude Code in VS Code",
"Codex in VS Code and App",
"Claude Code in JetBrains ACP",
+ "Claude Desktop",
]
)
expect(page.locator("#claudeIntegrationStatus")).to_have_count(0)
@@ -72,12 +73,17 @@ def test_codex_connect_disconnect_and_modal_paths(
)
bounds = [card.bounding_box() for card in cards.all()]
if width >= 1200:
- assert len({bound["y"] for bound in bounds}) == 1
- assert all(right["x"] > left["x"] for left, right in pairwise(bounds))
descriptions = [
card.locator(".section-heading p").bounding_box() for card in cards.all()
]
- assert len({description["y"] for description in descriptions}) == 1
+ for _, row in groupby(range(len(bounds)), key=lambda index: bounds[index]["y"]):
+ indices = list(row)
+ assert all(
+ bounds[right]["x"] > bounds[left]["x"]
+ for left, right in pairwise(indices)
+ )
+ assert len({descriptions[index]["y"] for index in indices}) == 1
+ assert bounds[1]["y"] == bounds[0]["y"]
else:
assert all(right["y"] > left["y"] for left, right in pairwise(bounds))
assert page.locator("body").evaluate(
@@ -122,7 +128,8 @@ def test_codex_connect_disconnect_and_modal_paths(
button.bounding_box()
for button in page.locator(".integration-card > button").all()
]
- assert len({button["y"] for button in buttons}) == 1
+ for _, row in groupby(range(len(bounds)), key=lambda index: bounds[index]["y"]):
+ assert len({buttons[index]["y"] for index in row}) == 1
assert len({button["height"] for button in buttons}) == 1
expect(page.locator("#codexIntegrationMessage")).to_have_text(
"Settings saved. Restart Codex and select an FCC model."
@@ -148,24 +155,52 @@ def test_codex_connect_disconnect_and_modal_paths(
assert not (tmp_path / ".claude.json").exists()
[email protected]("width", [1280, 390])
-def test_jetbrains_preview_connect_is_noop_and_modal_dismisses(
- page, admin_base_url, tmp_path, width
+ "integration,title,description,modal_description,card_index",
+ [
+ (
+ "JetBrains",
+ "Claude Code in JetBrains ACP",
+ "Use FCC's models in Claude Code through JetBrains ACP.",
+ "Route Claude Code in JetBrains through your FCC server.",
+ 2,
+ ),
+ (
+ "ClaudeDesktop",
+ "Claude Desktop",
+ "Use FCC's models in the Claude desktop app.",
+ "Route Claude Desktop through your FCC server. Setup is coming soon.",
+ 3,
+ ),
+ ],
+ ids=["jetbrains", "claude-desktop"],
+)
[email protected]("width", [1200, 1440, 390])
+def test_preview_connect_is_noop_and_modal_dismisses(
+ page,
+ admin_base_url,
+ tmp_path,
+ width,
+ integration,
+ title,
+ description,
+ modal_description,
+ card_index,
):
page.set_viewport_size({"width": width, "height": 900})
page.goto(f"{admin_base_url}/admin/integrations")
expect(page.locator("#messageArea")).to_have_text("")
expect(page.locator("#openClaudeIntegration")).to_be_enabled()
expect(page.locator("#openCodexIntegration")).to_be_enabled()
- opener = page.locator("#openJetBrainsIntegration")
+ opener = page.locator(f"#open{integration}Integration")
expect(opener).to_be_enabled()
expect(opener).to_have_text("Connect")
- card = page.locator("#view-integrations > article").nth(2)
- expect(card).to_contain_text(
- "Use FCC's models in Claude Code through JetBrains ACP."
- )
+ card = page.locator("#view-integrations > article").nth(card_index)
+ expect(card).to_contain_text(description)
expect(card.get_by_role("status")).to_have_count(0)
- page.screenshot(path=str(tmp_path / f"jetbrains-card-{width}.png"), full_page=True)
+ page.screenshot(
+ path=str(tmp_path / f"{integration}-card-{width}.png"), full_page=True
+ )
paths = [
tmp_path / ".fcc" / ".env",
tmp_path / "vscode" / "settings.json",
@@ -180,17 +215,15 @@ def test_jetbrains_preview_connect_is_noop_and_modal_dismisses(
requests.append((request.method, request.url))
page.on("request", record_request)
- dialog = page.get_by_role("dialog", name="Claude Code in JetBrains ACP", exact=True)
+ dialog = page.get_by_role("dialog", name=title, exact=True)
for dismiss in ("close", "escape", "outside"):
opener.click()
expect(dialog).to_be_visible()
close = dialog.get_by_role("button", name="Close", exact=True)
expect(close).to_be_focused()
- expect(dialog).to_have_accessible_description(
- "Route Claude Code in JetBrains through your FCC server."
- )
+ expect(dialog).to_have_accessible_description(modal_description)
assert dialog.evaluate("element => element.scrollWidth <= element.clientWidth")
- page.locator("#jetBrainsIntegrationDescription").click()
+ dialog.locator("p").click()
dialog.click(position={"x": 10, "y": 80})
expect(dialog).to_be_visible()
action = dialog.get_by_role("button", name="Connect", exact=True)
@@ -200,7 +233,7 @@ def test_jetbrains_preview_connect_is_noop_and_modal_dismisses(
expect(dialog).to_be_visible()
expect(action).to_have_text("Connect")
if dismiss == "close":
- page.screenshot(path=str(tmp_path / f"jetbrains-modal-{width}.png"))
+ page.screenshot(path=str(tmp_path / f"{integration}-modal-{width}.png"))
close.click()
elif dismiss == "escape":
page.keyboard.press("Escape")
@@ -210,6 +243,8 @@ def test_jetbrains_preview_connect_is_noop_and_modal_dismisses(
expect(opener).to_be_focused()
expect(opener).to_have_text("Connect")
assert requests == []
+ expect(page.locator("#dirtyState")).to_have_text("No changes")
+ expect(page.locator("#applyButton")).to_be_disabled()
assert {
path: path.read_bytes() if path.exists() else None for path in paths
} == before
diff --git a/pyproject.toml b/pyproject.toml
index 19faaab3..859912fe 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "free-claude-code"
-version = "6.2.47"
+version = "6.2.48"
description = "Local proxy connecting coding agents to OpenAI-compatible AI providers"
readme = "README.md"
requires-python = ">=3.14.0"
diff --git a/src/free_claude_code/api/admin_static/admin.js b/src/free_claude_code/api/admin_static/admin.js
index 8aac97b9..315b3bfd 100644
--- a/src/free_claude_code/api/admin_static/admin.js
+++ b/src/free_claude_code/api/admin_static/admin.js
@@ -1710,6 +1710,17 @@ jetBrainsIntegrationDialog.addEventListener("click", (event) => {
}
});
+const claudeDesktopIntegrationDialog = byId("claudeDesktopIntegrationDialog");
+byId("openClaudeDesktopIntegration").addEventListener("click", () => claudeDesktopIntegrationDialog.showModal());
+byId("closeClaudeDesktopIntegration").addEventListener("click", () => claudeDesktopIntegrationDialog.close());
+claudeDesktopIntegrationDialog.addEventListener("click", (event) => {
+ if (event.target !== claudeDesktopIntegrationDialog) return;
+ const bounds = claudeDesktopIntegrationDialog.getBoundingClientRect();
+ if (event.clientX < bounds.left || event.clientX > bounds.right || event.clientY < bounds.top || event.clientY > bounds.bottom) {
+ claudeDesktopIntegrationDialog.close();
+ }
+});
+
// Keep footer clearance exact when messages wrap or a view hides the bar.
new ResizeObserver(([entry]) => {
document.documentElement.style.setProperty(
diff --git a/src/free_claude_code/api/admin_static/index.html b/src/free_claude_code/api/admin_static/index.html
index 957fe099..0c3ca3cc 100644
--- a/src/free_claude_code/api/admin_static/index.html
+++ b/src/free_claude_code/api/admin_static/index.html
@@ -128,6 +128,23 @@
<p id="jetBrainsIntegrationDescription">Route Claude Code in JetBrains through your FCC server.</p>
<button id="confirmJetBrainsIntegration" class="primary-button" type="button">Connect</button>
</dialog>
+ <article class="provider-strip integration-card">
+ <div class="section-heading">
+ <div>
+ <h3>Claude Desktop</h3>
+ <p>Use FCC's models in the Claude desktop app.</p>
+ </div>
+ </div>
+ <button id="openClaudeDesktopIntegration" class="primary-button" type="button">Connect</button>
+ </article>
+ <dialog id="claudeDesktopIntegrationDialog" class="integration-dialog" aria-labelledby="claudeDesktopIntegrationTitle" aria-describedby="claudeDesktopIntegrationDescription">
+ <div class="section-heading">
+ <h3 id="claudeDesktopIntegrationTitle">Claude Desktop</h3>
+ <button id="closeClaudeDesktopIntegration" class="ghost-button" type="button" aria-label="Close" autofocus>×</button>
+ </div>
+ <p id="claudeDesktopIntegrationDescription">Route Claude Desktop through your FCC server. Setup is coming soon.</p>
+ <button id="confirmClaudeDesktopIntegration" class="primary-button" type="button">Connect</button>
+ </dialog>
</section>
<section id="view-code" class="admin-view" data-view="code" hidden>
diff --git a/uv.lock b/uv.lock
index d0013737..96e09453 100644
--- a/uv.lock
+++ b/uv.lock
@@ -599,7 +599,7 @@ wheels = [
[[package]]
name = "free-claude-code"
-version = "6.2.47"
+version = "6.2.48"
source = { editable = "." }
dependencies = [
{ name = "aiohttp" },