free-code

English | 简体中文

The free build of Claude Code.

Now with full-platform deployment: prebuilt one-command installers for Linux, macOS, and Windows, plus GitHub Actions release automation for cross-platform builds.

All telemetry stripped. All injected security-prompt guardrails removed. All experimental features unlocked. One binary, zero callbacks home.

This repository extends the original reconstructed free-code work by paoloanzn, adding full-platform deployment, one-command installers, and GitHub Actions release automation. A preserved mirror of the original repo is available at https://gitlawb.com/node/repos/z6MkgKkb/paoloanzn-free-code

curl -fsSL https://raw.githubusercontent.com/Cross2pro/free-coder/main/install.sh | bash

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/Cross2pro/free-coder/main/install.ps1 | iex"

The installers now prefer prebuilt release packages for Linux, macOS, and Windows. If a matching release asset is unavailable, they fall back to building from source.

---

What is this

This is a clean, buildable fork of Anthropic's Claude Code CLI -- the terminal-native AI coding agent. The upstream source became publicly available on March 31, 2026 through a source map exposure in the npm distribution.

This fork applies three categories of changes on top of that snapshot:

1. Telemetry removed

The upstream binary phones home through OpenTelemetry/gRPC, GrowthBook analytics, Sentry error reporting, and custom event logging. In this build:

• All outbound telemetry endpoints are dead-code-eliminated or stubbed
• GrowthBook feature flag evaluation still works locally (needed for runtime feature gates) but does not report back
• No crash reports, no usage analytics, no session fingerprinting

2. Security-prompt guardrails removed

Anthropic injects system-level instructions into every conversation that constrain Claude's behavior beyond what the model itself enforces. These include:

• Hardcoded refusal patterns for certain categories of prompts
• Injected "cyber risk" instruction blocks
• Managed-settings security overlays pushed from Anthropic's servers

This build strips those injections. The model's own safety training still applies -- this just removes the extra layer of prompt-level restrictions that the CLI wraps around it.

3. Experimental features enabled

Claude Code ships with dozens of feature flags gated behind bun:bundle compile-time switches. Most are disabled in the public npm release. This build unlocks all 45+ flags that compile cleanly, including:

Feature	What it does
ULTRAPLAN	Remote multi-agent planning on Claude Code web (Opus-class)
ULTRATHINK	Deep thinking mode -- type "ultrathink" to boost reasoning effort
VOICE_MODE	Push-to-talk voice input and dictation
AGENT_TRIGGERS	Local cron/trigger tools for background automation
BRIDGE_MODE	IDE remote-control bridge (VS Code, JetBrains)
TOKEN_BUDGET	Token budget tracking and usage warnings
BUILTIN_EXPLORE_PLAN_AGENTS	Built-in explore/plan agent presets
VERIFICATION_AGENT	Verification agent for task validation
BASH_CLASSIFIER	Classifier-assisted bash permission decisions
EXTRACT_MEMORIES	Post-query automatic memory extraction
HISTORY_PICKER	Interactive prompt history picker
MESSAGE_ACTIONS	Message action entrypoints in the UI
QUICK_SEARCH	Prompt quick-search
SHOT_STATS	Shot-distribution stats
COMPACTION_REMINDERS	Smart reminders around context compaction
CACHED_MICROCOMPACT	Cached microcompact state through query flows

See FEATURES.md for the full audit of all 88 flags and their status.

---

Quick install

curl -fsSL https://raw.githubusercontent.com/Cross2pro/free-coder/main/install.sh | bash

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/Cross2pro/free-coder/main/install.ps1 | iex"

On supported releases, this downloads a prebuilt binary for your platform and installs free-code onto your PATH. If no release asset matches, the installer falls back to a source build.

After install, just run:

export ANTHROPIC_API_KEY="sk-ant-..."
free-code

---

Requirements

• For prebuilt install: no Bun required
• For source builds: Bun >= 1.3.11
• An Anthropic API key (set ANTHROPIC_API_KEY in your environment)

---

Build

# Clone the repo
git clone https://github.com/Cross2pro/free-coder.git
cd free-coder

# Install dependencies
bun install

# Standard build -- produces ./cli
bun run build

# Dev build -- dev version stamp, experimental GrowthBook key
bun run build:dev

# Dev build with ALL experimental features enabled -- produces ./cli-dev
bun run build:dev:full

# Compiled build (alternative output path) -- produces ./dist/cli
bun run compile

Build variants

Command	Output	Features	Notes
bun run build	./cli	VOICE_MODE only	Production-like binary
bun run build:dev	./cli-dev	VOICE_MODE only	Dev version stamp
bun run build:dev:full	./cli-dev	All 45+ experimental flags	The full unlock build
bun run compile	./dist/cli	VOICE_MODE only	Alternative output directory

Release packaging

# Build all release archives into ./dist/release
bun run release:build

# Build just a subset while iterating locally
bun run release:build --targets=windows-x64,linux-x64,macos-arm64

This generates:

• Versionless install assets such as free-code-windows-x64.zip and free-code-linux-x64.tar.gz
• manifest.json with target metadata
• checksums.txt with SHA-256 sums

The repository also includes release.yml, which builds and publishes these archives automatically when you push a v* tag.

Individual feature flags

You can enable specific flags without the full bundle:

# Enable just ultraplan and ultrathink
bun run ./scripts/build.ts --feature=ULTRAPLAN --feature=ULTRATHINK

# Enable a specific flag on top of the dev build
bun run ./scripts/build.ts --dev --feature=BRIDGE_MODE

---

Run

# Run the built binary directly
./cli

# Or the dev binary
./cli-dev

# Or run from source without compiling (slower startup)
bun run dev

# Set your API key
export ANTHROPIC_API_KEY="sk-ant-..."

# Or use Claude.ai OAuth
./cli /login

Quick test

# One-shot mode
./cli -p "what files are in this directory?"

# Interactive REPL (default)
./cli

# With specific model
./cli --model claude-sonnet-4-6-20250514

---

Project structure

scripts/
  build.ts              # Build script with feature flag system

src/
  entrypoints/cli.tsx   # CLI entrypoint
  commands.ts           # Command registry (slash commands)
  tools.ts              # Tool registry (agent tools)
  QueryEngine.ts        # LLM query engine
  screens/REPL.tsx      # Main interactive UI

  commands/             # /slash command implementations
  tools/                # Agent tool implementations (Bash, Read, Edit, etc.)
  components/           # Ink/React terminal UI components
  hooks/                # React hooks
  services/             # API client, MCP, OAuth, analytics
  state/                # App state store
  utils/                # Utilities
  skills/               # Skill system
  plugins/              # Plugin system
  bridge/               # IDE bridge
  voice/                # Voice input
  tasks/                # Background task management

---

Tech stack

Runtime	Bun
Language	TypeScript
Terminal UI	React + Ink
CLI parsing	Commander.js
Schema validation	Zod v4
Code search	ripgrep (bundled)
Protocols	MCP, LSP
API	Anthropic Messages API

---

IPFS Mirror

A full copy of this repository is permanently pinned on IPFS via Filecoin:

• CID: bafybeiegvef3dt24n2znnnmzcud2vxat7y7rl5ikz7y7yoglxappim54bm
• Gateway: https://w3s.link/ipfs/bafybeiegvef3dt24n2znnnmzcud2vxat7y7rl5ikz7y7yoglxappim54bm

If this repo gets taken down, the code lives on.

---

Credits

• Original product: Anthropic Claude Code
• Original reconstructed free-code repository and research packaging work: paoloanzn
• Original reconstructed repo mirror: https://gitlawb.com/node/repos/z6MkgKkb/paoloanzn-free-code

---

License

The original Claude Code source is the property of Anthropic. This fork exists because the source was publicly exposed through their npm distribution. Use at your own discretion.