free_code

0
README.md

free-code

free-code

The free build of Claude Code.
All telemetry stripped. All guardrails removed. All experimental features unlocked.
One binary, zero callbacks home.

Install Stars Issues Feature Flags IPFS


Quick Install

Checks your system, installs Bun if needed, clones the repo, builds with all experimental features enabled, and symlinks

free-code
on your PATH.

Then run

free-code
and use the
/login
command to authenticate with your preferred model provider.


Table of Contents


What is this

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:

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

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, injected "cyber risk" instruction blocks, and 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.

Experimental features unlocked

Claude Code ships with 88 feature flags gated behind

bun:bundle
compile-time switches. Most are disabled in the public npm release. This build unlocks all 54 flags that compile cleanly. See Experimental Features below, or refer to FEATURES.md for the full audit.


Model Providers

free-code supports five API providers out of the box. Set the corresponding environment variable to switch providers -- no code changes needed.

Anthropic (Direct API) -- Default

Use Anthropic's first-party API directly.

ModelID
Claude Opus 4.6
claude-opus-4-6
Claude Sonnet 4.6
claude-sonnet-4-6
Claude Haiku 4.5
claude-haiku-4-5

OpenAI Codex

Use OpenAI's Codex models for code generation. Requires a Codex subscription.

ModelID
GPT-5.3 Codex (recommended)
gpt-5.3-codex
GPT-5.4
gpt-5.4
GPT-5.4 Mini
gpt-5.4-mini

AWS Bedrock

Route requests through your AWS account via Amazon Bedrock.

Uses your standard AWS credentials (environment variables,

~/.aws/config
, or IAM role). Models are mapped to Bedrock ARN format automatically (e.g.,
us.anthropic.claude-opus-4-6-v1
).

VariablePurpose
CLAUDE_CODE_USE_BEDROCK
Enable Bedrock provider
AWS_REGION
/
AWS_DEFAULT_REGION
AWS region (default:
us-east-1
)
ANTHROPIC_BEDROCK_BASE_URL
Custom Bedrock endpoint
AWS_BEARER_TOKEN_BEDROCK
Bearer token auth
CLAUDE_CODE_SKIP_BEDROCK_AUTH
Skip auth (testing)

Google Cloud Vertex AI

Route requests through your GCP project via Vertex AI.

Uses Google Cloud Application Default Credentials (

gcloud auth application-default login
). Models are mapped to Vertex format automatically (e.g.,
claude-opus-4-6@latest
).

Anthropic Foundry

Use Anthropic Foundry for dedicated deployments.

Supports custom deployment IDs as model names.

Provider Selection Summary

ProviderEnv VariableAuth Method
Anthropic (default)--
ANTHROPIC_API_KEY
or OAuth
OpenAI Codex
CLAUDE_CODE_USE_OPENAI=1
OAuth via OpenAI
AWS Bedrock
CLAUDE_CODE_USE_BEDROCK=1
AWS credentials
Google Vertex AI
CLAUDE_CODE_USE_VERTEX=1
gcloud
ADC
Anthropic Foundry
CLAUDE_CODE_USE_FOUNDRY=1
ANTHROPIC_FOUNDRY_API_KEY

Requirements

  • Runtime: Bun >= 1.3.11
  • OS: macOS or Linux (Windows via WSL)
  • Auth: An API key or OAuth login for your chosen provider

Build

Build Variants

CommandOutputFeaturesDescription
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 54 experimental flagsFull unlock build
bun run compile
./dist/cli
VOICE_MODE
only
Alternative output path

Custom Feature Flags

Enable specific flags without the full bundle:


Usage

Environment Variables Reference

VariablePurpose
ANTHROPIC_API_KEY
Anthropic API key
ANTHROPIC_AUTH_TOKEN
Auth token (alternative)
ANTHROPIC_MODEL
Override default model
ANTHROPIC_BASE_URL
Custom API endpoint
ANTHROPIC_DEFAULT_OPUS_MODEL
Custom Opus model ID
ANTHROPIC_DEFAULT_SONNET_MODEL
Custom Sonnet model ID
ANTHROPIC_DEFAULT_HAIKU_MODEL
Custom Haiku model ID
CLAUDE_CODE_OAUTH_TOKEN
OAuth token via env
CLAUDE_CODE_API_KEY_HELPER_TTL_MS
API key helper cache TTL

Experimental Features

The

bun run build:dev:full
build enables all 54 working feature flags. Highlights:

Interaction & UI

FlagDescription
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
TOKEN_BUDGET
Token budget tracking and usage warnings
HISTORY_PICKER
Interactive prompt history picker
MESSAGE_ACTIONS
Message action entrypoints in the UI
QUICK_SEARCH
Prompt quick-search
SHOT_STATS
Shot-distribution stats

Agents, Memory & Planning

FlagDescription
BUILTIN_EXPLORE_PLAN_AGENTS
Built-in explore/plan agent presets
VERIFICATION_AGENT
Verification agent for task validation
AGENT_TRIGGERS
Local cron/trigger tools for background automation
AGENT_TRIGGERS_REMOTE
Remote trigger tool path
EXTRACT_MEMORIES
Post-query automatic memory extraction
COMPACTION_REMINDERS
Smart reminders around context compaction
CACHED_MICROCOMPACT
Cached microcompact state through query flows
TEAMMEM
Team-memory files and watcher hooks

Tools & Infrastructure

FlagDescription
BRIDGE_MODE
IDE remote-control bridge (VS Code, JetBrains)
BASH_CLASSIFIER
Classifier-assisted bash permission decisions
PROMPT_CACHE_BREAK_DETECTION
Cache-break detection in compaction/query flow

See FEATURES.md for the complete audit of all 88 flags, including 34 broken flags with reconstruction notes.


S3 Log Upload

free-code can automatically upload API request/response logs to any S3-compatible storage (AWS S3, Cloud.ru, MinIO, etc.). Uploads happen in the background and never affect CLI operation -- if S3 is unreachable, errors are silently ignored.

To enable, set these environment variables (e.g. in

~/.zshrc
):

Logs are organized as

<prefix>/<YYYY-MM>-<username>/<session-id>/<file>.json
.

See docs/s3-log-upload.md for provider-specific examples (Cloud.ru, AWS, MinIO).


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 (Ink/React) commands/ # /slash command implementations tools/ # Agent tool implementations (Bash, Read, Edit, etc.) components/ # Ink/React terminal UI components hooks/ # React hooks services/ # API clients, MCP, OAuth, analytics api/ # API client + Codex fetch adapter oauth/ # OAuth flows (Anthropic + OpenAI) state/ # App state store utils/ # Utilities model/ # Model configs, providers, validation skills/ # Skill system plugins/ # Plugin system bridge/ # IDE bridge voice/ # Voice input tasks/ # Background task management

Tech Stack

RuntimeBun
LanguageTypeScript
Terminal UIReact + Ink
CLI ParsingCommander.js
Schema ValidationZod v4
Code Searchripgrep (bundled)
ProtocolsMCP, LSP
APIsAnthropic Messages, OpenAI Codex, AWS Bedrock, Google Vertex AI

IPFS Mirror

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

CID
bafybeiegvef3dt24n2znnnmzcud2vxat7y7rl5ikz7y7yoglxappim54bm
Gatewayhttps://w3s.link/ipfs/bafybeiegvef3dt24n2znnnmzcud2vxat7y7rl5ikz7y7yoglxappim54bm

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


Contributing

Contributions are welcome. If you're working on restoring one of the 34 broken feature flags, check the reconstruction notes in FEATURES.md first -- many are close to compiling and just need a small wrapper or missing asset.

  1. Fork the repository
  2. Create a feature branch (
    git checkout -b feat/my-feature
    )
  3. Commit your changes (
    git commit -m 'feat: add something'
    )
  4. Push to the branch (
    git push origin feat/my-feature
    )
  5. Open a Pull Request

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.