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

Fix Windows ARM64 installation without source builds (#1293)

Ali Khokhara8b6dabfaa03
diff --git a/pyproject.toml b/pyproject.toml
index b995d322..b045e4bd 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "free-claude-code"
-version = "4.15.0"
+version = "4.15.1"
description = "Local proxy connecting coding agents to OpenAI-compatible AI providers"
readme = "README.md"
requires-python = ">=3.14.0"
diff --git a/scripts/install.ps1 b/scripts/install.ps1
index 5c940be6..87b11213 100644
--- a/scripts/install.ps1
+++ b/scripts/install.ps1
@@ -14,7 +14,8 @@ $ErrorActionPreference = "Stop"
$ProgressPreference = "SilentlyContinue"
$RepoArchiveUrl = "https://github.com/Alishahryar1/free-claude-code/archive/refs/heads/main.zip"
-$PythonVersion = "3.14.0"
+# Windows on ARM emulates x64, whose Python package ecosystem has broader wheel support.
+$PythonRequest = "cpython-3.14.0-windows-x86_64-none"
$MinUvVersion = "0.11.16"
$ClaudeInstallUrl = "https://claude.ai/install.ps1"
$CodexInstallUrl = "https://chatgpt.com/codex/install.ps1"
@@ -499,7 +500,7 @@ function Install-FreeClaudeCode {
"--refresh-package",
"free-claude-code",
"--python",
- $PythonVersion
+ $PythonRequest
)
if (-not [string]::IsNullOrWhiteSpace($TorchBackend)) {
$arguments += @("--torch-backend", $TorchBackend)
diff --git a/tests/scripts/test_installers.py b/tests/scripts/test_installers.py
index dcf795fc..7f026830 100644
--- a/tests/scripts/test_installers.py
+++ b/tests/scripts/test_installers.py
@@ -1161,7 +1161,8 @@ def test_install_ps1_fresh_install_is_verified(
assert any(
call.startswith(
"uv:tool install --force --refresh-package free-claude-code "
- '--python 3.14.0 "free-claude-code @ '
+ "--python cpython-3.14.0-windows-x86_64-none "
+ '"free-claude-code @ '
'https://github.com/Alishahryar1/free-claude-code/archive/refs/heads/main.zip"'
)
for call in calls
@@ -1545,6 +1546,12 @@ def test_installers_use_native_clients_and_single_python_selection() -> None:
assert "https://pi.dev/install.ps1" in powershell
+def test_install_ps1_uses_x64_python_for_windows_arm_compatibility() -> None:
+ powershell = (_repo_root() / "scripts" / "install.ps1").read_text(encoding="utf-8")
+
+ assert '$PythonRequest = "cpython-3.14.0-windows-x86_64-none"' in powershell
+
+
def test_readme_install_section_has_no_manual_git_prerequisite() -> None:
readme = (_repo_root() / "README.md").read_text(encoding="utf-8")
install_section = readme.split("### 1. Install Or Update", 1)[1].split(
diff --git a/uv.lock b/uv.lock
index 25457840..24526446 100644
--- a/uv.lock
+++ b/uv.lock
@@ -620,7 +620,7 @@ wheels = [
[[package]]
name = "free-claude-code"
-version = "4.15.0"
+version = "4.15.1"
source = { editable = "." }
dependencies = [
{ name = "aiohttp" },