blackhatdevx/claudefree-installer

ClaudeFree is a Shell-based installer that automates the setup of Claude Code inside VS Code with a single command. According to the description, it configures the environment for unlimited free usage without requiring a credit card or accepting token limits. The README includes a short demo video showing the install process end to end. The installer runs a single command in the terminal for Linux and macOS, or a PowerShell command on Windows. It auto-detects your operating system and architecture, then handles all installation steps on its own, including setting up VS Code, the OpenCode extension, and related components. Supported platforms listed in the README are macOS (Apple Silicon), all Linux distributions, and all Windows versions. No other prerequisites are listed. The project distributes prebuilt executables in its repository, which are compiled automatically from the open-source shell scripts via GitHub Actions and pushed into the repo by the CI bot, so the full build pipeline is traceable from source. The README points readers to the underlying setup.ps1 and setup.sh scripts so they can verify what the compiled executables actually do rather than trusting the binaries blindly. This targets developers who want to run Claude Code in VS Code without going through the standard paid setup. The README lists a custom license rather than a standard open source one, and points users to the GitHub issues page for support. The README is short and does not explain the underlying mechanism that enables the claimed free unlimited usage, so that part should be treated with some caution.