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
Install FCC without requiring Git (#1087)
Ali Khokhar2da271505c7f
diff --git a/README.md b/README.mdindex 0985aa90..97064879 100644--- a/README.md+++ b/README.md@@ -69,8 +69,6 @@ Run Claude Code or Codex with free, paid, or local models. Choose and validate p### 1. Install Or Update-The installer uses the official native installers for missing Claude Code, Codex, and uv, then installs Free Claude Code with uv-managed Python 3.14. Install [Git](https://git-scm.com/downloads) first because FCC is installed directly from this repository. Every step is verified, and the installer stops immediately if one fails.-macOS/Linux:```bashdiff --git a/pyproject.toml b/pyproject.tomlindex cbb69189..d6b4515c 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -4,7 +4,7 @@ build-backend = "hatchling.build"[project]name = "free-claude-code"-version = "3.5.18"+version = "3.5.19"description = "Local proxy connecting Claude Code and Codex to OpenAI-compatible AI providers"readme = "README.md"requires-python = ">=3.14.0"diff --git a/scripts/install.ps1 b/scripts/install.ps1index 5876103c..b66000e2 100644--- a/scripts/install.ps1+++ b/scripts/install.ps1@@ -13,7 +13,7 @@ Set-StrictMode -Version Latest$ErrorActionPreference = "Stop"$ProgressPreference = "SilentlyContinue"-$RepoGitUrl = "git+https://github.com/Alishahryar1/free-claude-code.git"+$RepoArchiveUrl = "https://github.com/Alishahryar1/free-claude-code/archive/refs/heads/main.zip"$PythonVersion = "3.14.0"$MinUvVersion = "0.11.0"$ClaudeInstallUrl = "https://claude.ai/install.ps1"@@ -161,19 +161,6 @@ function Add-KnownBinDirectories {}}-function Assert-Prerequisites {- if ($DryRun) {- Write-Host "+ git --version"- return- }-- $gitCommand = Get-ApplicationCommand "git"- if (-not $gitCommand) {- throw "git is required to install Free Claude Code from GitHub. Install Git, then rerun this installer."- }- Invoke-NativeCommand -FilePath $gitCommand.Source -Arguments @("--version")-}-function Invoke-DownloadedPowerShellInstaller {param([string] $Url,@@ -369,20 +356,28 @@ function Get-PackageSpec {}if ($includeNim -and $includeLocal) {- return "free-claude-code[voice,voice_local] @ $RepoGitUrl"+ return "free-claude-code[voice,voice_local] @ $RepoArchiveUrl"}if ($includeNim) {- return "free-claude-code[voice] @ $RepoGitUrl"+ return "free-claude-code[voice] @ $RepoArchiveUrl"}if ($includeLocal) {- return "free-claude-code[voice_local] @ $RepoGitUrl"+ return "free-claude-code[voice_local] @ $RepoArchiveUrl"}- return $RepoGitUrl+ return "free-claude-code @ $RepoArchiveUrl"}function Install-FreeClaudeCode {$packageSpec = Get-PackageSpec- $arguments = @("tool", "install", "--force", "--python", $PythonVersion)+ $arguments = @(+ "tool",+ "install",+ "--force",+ "--refresh-package",+ "free-claude-code",+ "--python",+ $PythonVersion+ )if (-not [string]::IsNullOrWhiteSpace($TorchBackend)) {$arguments += @("--torch-backend", $TorchBackend)}@@ -458,9 +453,6 @@ if ((-not [string]::IsNullOrWhiteSpace($TorchBackend)) -and (-not ($VoiceLocal -Add-KnownBinDirectories-Write-Step "Checking installation prerequisites"-Assert-Prerequisites-Write-Step "Ensuring Claude Code is installed"Ensure-ClaudeCodediff --git a/scripts/install.sh b/scripts/install.shindex 07c595af..49dbf502 100644--- a/scripts/install.sh+++ b/scripts/install.sh@@ -1,7 +1,7 @@#!/bin/shset -eu-REPO_GIT_URL="git+https://github.com/Alishahryar1/free-claude-code.git"+REPO_ARCHIVE_URL="https://github.com/Alishahryar1/free-claude-code/archive/refs/heads/main.zip"PYTHON_VERSION="3.14.0"MIN_UV_VERSION="0.11.0"CLAUDE_INSTALL_URL="https://claude.ai/install.sh"@@ -355,13 +355,13 @@ package_spec() {fiif [ "$include_nim" -eq 1 ] && [ "$include_local" -eq 1 ]; then- printf 'free-claude-code[voice,voice_local] @ %s' "$REPO_GIT_URL"+ printf 'free-claude-code[voice,voice_local] @ %s' "$REPO_ARCHIVE_URL"elif [ "$include_nim" -eq 1 ]; then- printf 'free-claude-code[voice] @ %s' "$REPO_GIT_URL"+ printf 'free-claude-code[voice] @ %s' "$REPO_ARCHIVE_URL"elif [ "$include_local" -eq 1 ]; then- printf 'free-claude-code[voice_local] @ %s' "$REPO_GIT_URL"+ printf 'free-claude-code[voice_local] @ %s' "$REPO_ARCHIVE_URL"else- printf '%s' "$REPO_GIT_URL"+ printf 'free-claude-code @ %s' "$REPO_ARCHIVE_URL"fi}@@ -369,9 +369,9 @@ install_free_claude_code() {spec=$(package_spec)if [ -n "$torch_backend" ]; then- run uv tool install --force --python "$PYTHON_VERSION" --torch-backend "$torch_backend" "$spec"+ run uv tool install --force --refresh-package free-claude-code --python "$PYTHON_VERSION" --torch-backend "$torch_backend" "$spec"else- run uv tool install --force --python "$PYTHON_VERSION" "$spec"+ run uv tool install --force --refresh-package free-claude-code --python "$PYTHON_VERSION" "$spec"fi}@@ -414,8 +414,6 @@ require_command curlrequire_command bashrequire_command shrequire_command mktemp-require_command git-run git --versionstep "Ensuring Claude Code is installed"ensure_claudediff --git a/tests/scripts/test_installers.py b/tests/scripts/test_installers.pyindex 514be431..e714daf4 100644--- a/tests/scripts/test_installers.py+++ b/tests/scripts/test_installers.py@@ -124,10 +124,6 @@ def posix_harness(tmp_path: Path) -> PosixHarness:for path in (bin_dir, fixtures, tool_bin, home):path.mkdir(parents=True)- _write_executable(- bin_dir / "git",- '#!/bin/sh\necho "git:$*" >> "$CALL_LOG"\necho "git version 2.0.0"\n',- )_write_executable(bin_dir / "curl","""#!/bin/sh@@ -232,9 +228,14 @@ def test_install_sh_fresh_install_is_verified(posix_harness: PosixHarness) -> Noassert calls.index("codex-install:1") < calls.index("codex:--version")assert calls.index("uv-install") < calls.index("uv:--version")assert any(- call.startswith("uv:tool install --force --python 3.14.0 git+")+ call.startswith(+ "uv:tool install --force --refresh-package free-claude-code "+ "--python 3.14.0 free-claude-code @ "+ "https://github.com/Alishahryar1/free-claude-code/archive/refs/heads/main.zip"+ )for call in calls)+ assert not any(call.startswith("git:") for call in calls)assert calls[-3:] == ["uv:tool update-shell","uv:tool dir --bin",@@ -354,7 +355,9 @@ def test_install_sh_voice_flags_only_change_fcc_spec(assert result.returncode == 0, result.stderrassert any(- "--torch-backend cu130 free-claude-code[voice,voice_local] @ git+" in call+ "--torch-backend cu130 free-claude-code[voice,voice_local] @ "+ "https://github.com/Alishahryar1/free-claude-code/archive/refs/heads/main.zip"+ in callfor call in posix_harness.calls())@@ -427,7 +430,7 @@ class PowerShellHarness:def add_uv(self, version: str) -> None:_write_executable(self.bin_dir / "uv.cmd", _batch_uv(version))- def run(self, fail_step: str = "") -> subprocess.CompletedProcess[str]:+ def run(self, *args: str, fail_step: str = "") -> subprocess.CompletedProcess[str]:env = self.env | {"FAIL_STEP": fail_step}return subprocess.run([@@ -437,6 +440,7 @@ class PowerShellHarness:"Bypass","-File",str(self.wrapper),+ *args,],check=False,capture_output=True,@@ -471,10 +475,6 @@ def powershell_harness(for path in (bin_dir, fixtures, tool_bin, home, local_app_data):path.mkdir(parents=True)- _write_executable(- bin_dir / "git.cmd",- '@echo off\necho git:%*>>"%CALL_LOG%"\necho git version 2.0.0\n',- )(fixtures / "claude-command.cmd").write_text(_batch_client("claude"), encoding="utf-8")@@ -551,7 +551,7 @@ function Invoke-RestMethod {Copy-Item -LiteralPath $source -Destination $OutFile -Force}$installer = [scriptblock]::Create([IO.File]::ReadAllText($env:FCC_INSTALLER))-& $installer+& $installer @args""",encoding="utf-8",)@@ -590,9 +590,14 @@ def test_install_ps1_fresh_install_is_verified(assert calls.index("codex-install:1") < calls.index("codex:--version")assert calls.index("uv-install") < calls.index("uv:--version")assert any(- call.startswith("uv:tool install --force --python 3.14.0 git+")+ call.startswith(+ "uv:tool install --force --refresh-package free-claude-code "+ '--python 3.14.0 "free-claude-code @ '+ 'https://github.com/Alishahryar1/free-claude-code/archive/refs/heads/main.zip"'+ )for call in calls)+ assert not any(call.startswith("git:") for call in calls)assert calls[-3:] == ["uv:tool update-shell","uv:tool dir --bin",@@ -721,16 +726,18 @@ def test_install_ps1_rejects_unparseable_existing_uv(assert not any("astral.sh" in call for call in powershell_harness.calls())-def test_install_ps1_requires_git_before_mutation(+def test_install_ps1_voice_flags_only_change_fcc_spec(powershell_harness: PowerShellHarness,) -> None:- (powershell_harness.bin_dir / "git.cmd").unlink()-- result = powershell_harness.run()+ result = powershell_harness.run("-VoiceAll", "-TorchBackend", "cu130")- assert result.returncode != 0- assert powershell_harness.calls() == []- assert "git is required" in result.stderr+ assert result.returncode == 0, result.stderr+ assert any(+ '--torch-backend cu130 "free-claude-code[voice,voice_local] @ '+ 'https://github.com/Alishahryar1/free-claude-code/archive/refs/heads/main.zip"'+ in call+ for call in powershell_harness.calls()+ )def test_installers_use_native_clients_and_single_python_selection() -> None:@@ -740,11 +747,28 @@ def test_installers_use_native_clients_and_single_python_selection() -> None:for text in (shell, powershell):assert "@anthropic-ai/claude-code" not in textassert "@openai/codex" not in text+ assert "git+" not in text+ assert "git --version" not in text+ assert (+ "https://github.com/Alishahryar1/free-claude-code/archive/refs/heads/main.zip"+ in text+ )assert "python install" not in text+ assert "--refresh-package" in textassert "tool update-shell" in textassert "--python" in text+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(+ "### 2. Start The Server", 1+ )[0]++ assert "Install Git" not in install_section+ assert "official native installers" not in install_section++@pytest.mark.parametrize("powershell", _powershells())def test_install_ps1_falls_back_when_pshome_executable_is_unavailable(tmp_path: Path,diff --git a/uv.lock b/uv.lockindex 8f905758..9dce648a 100644--- a/uv.lock+++ b/uv.lock@@ -561,7 +561,7 @@ wheels = [[[package]]name = "free-claude-code"-version = "3.5.18"+version = "3.5.19"source = { editable = "." }dependencies = [{ name = "aiohttp" },