free-code-claude-cli

Q: How do I install free-code-claude-cli?

Run npx skills add https://github.com/reason-machines/trending-skills --skill free-code-claude-cli in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/free-code-claude-cli/ (personal) or .claude/skills/free-code-claude-cli/ (project).

by reason-machines

Build and use free-code, the open-source fork of Claude Code CLI with telemetry removed, guardrails stripped, and all experimental features unlocked.

Installs: 629
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/reason-machines/trending-skills --skill free-code-claude-cli

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads free-code-claude-cli automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

free-code Claude CLI

Skill by ara.so — Daily 2026 Skills collection.

free-code is a buildable fork of Anthropic's Claude Code CLI — a terminal-native AI coding agent. It removes all telemetry and phone-home callbacks, strips Anthropic's injected system-prompt guardrails, and unlocks 54 experimental feature flags that are disabled in the public npm release. It supports five model providers: Anthropic, OpenAI Codex, AWS Bedrock, Google Vertex AI, and Anthropic Foundry.

Installation

One-liner (recommended)

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

This installs Bun if needed, clones the repo, builds with experimental features, and symlinks free-code on your PATH.

Manual build

# Requires Bun >= 1.3.11
curl -fsSL https://bun.sh/install | bash

git clone https://github.com/paoloanzn/free-code.git
cd free-code
bun run build
./cli

Key CLI Commands

# Start interactive REPL
free-code

# One-shot prompt
free-code -p "explain this codebase"

# Specify model
free-code --model claude-opus-4-6

# OAuth login (runs /login slash command)
free-code /login

# Run from source (slower, no build step)
bun run dev

Slash commands inside the REPL

/login          Authenticate with your chosen provider
/help           List all available commands
/clear          Clear conversation context
/compact        Compact context window
/memory         View/edit memory files

Build Variants

Command	Output	Features
`bun run build`	`./cli`	VOICE_MODE only (production-like)
`bun run build:dev`	`./cli-dev`	VOICE_MODE only, dev stamp
`bun run build:dev:full`	`./cli-dev`	All 54 experimental flags unlocked
`bun run compile`	`./dist/cli`	Alternative output path

Enable specific feature flags

# Unlock ultrathink + ultraplan only
bun run ./scripts/build.ts --feature=ULTRATHINK --feature=ULTRAPLAN

# Dev build with bridge mode added
bun run ./scripts/build.ts --dev --feature=BRIDGE_MODE

# Full experimental unlock
bun run build:dev:full

Model Provider Configuration

Switch providers entirely via environment variables — no code changes needed.

Anthropic (default)

export ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY"
free-code --model claude-opus-4-6

Available models: claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5

Override model defaults:

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_BASE_URL="https://api.anthropic.com"  # custom endpoint

OpenAI Codex

export CLAUDE_CODE_USE_OPENAI=1
free-code --model gpt-5.3-codex

Available models: gpt-5.3-codex, gpt-5.4, gpt-5.4-mini

AWS Bedrock

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION="us-east-1"
# Uses standard AWS credential chain: env vars, ~/.aws/config, or IAM role
free-code

Additional Bedrock variables:

export ANTHROPIC_BEDROCK_BASE_URL="https://..."   # custom endpoint
export AWS_BEARER_TOKEN_BEDROCK="$TOKEN"           # bearer token auth
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1             # skip auth (testing only)

Google Cloud Vertex AI

# Authenticate first
gcloud auth application-default login

export CLAUDE_CODE_USE_VERTEX=1
free-code

Anthropic Foundry

export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_API_KEY="$ANTHROPIC_FOUNDRY_API_KEY"
free-code --model my-deployment-id

Experimental Features Reference

Build with bun run build:dev:full to unlock all 54 flags, or pass --feature=FLAG individually.

High-value flags

Flag	What it does
`ULTRATHINK`	Type "ultrathink" in a prompt to boost reasoning depth
`ULTRAPLAN`	Remote multi-agent planning (Opus-class) via Claude Code web
`VOICE_MODE`	Push-to-talk voice input and dictation
`TOKEN_BUDGET`	Real-time token budget tracking and warnings
`HISTORY_PICKER`	Interactive prompt history picker
`EXTRACT_MEMORIES`	Auto-extracts memories after each query
`VERIFICATION_AGENT`	Validation agent that checks task completion
`AGENT_TRIGGERS`	Local cron/trigger tools for background automation
`BRIDGE_MODE`	IDE remote-control bridge (VS Code, JetBrains)
`BASH_CLASSIFIER`	AI-assisted bash permission decisions
`BUILTIN_EXPLORE_PLAN_AGENTS`	Preset explore/plan agent configs
`TEAMMEM`	Team-shared memory files with watcher hooks
`COMPACTION_REMINDERS`	Smart reminders around context window compaction

Environment Variables Quick Reference

# Authentication
ANTHROPIC_API_KEY              # Anthropic API key
ANTHROPIC_AUTH_TOKEN           # Alternative auth token
CLAUDE_CODE_OAUTH_TOKEN        # OAuth token via env (skips /login)

# Provider selection
CLAUDE_CODE_USE_OPENAI=1       # Switch to OpenAI Codex
CLAUDE_CODE_USE_BEDROCK=1      # Switch to AWS Bedrock
CLAUDE_CODE_USE_VERTEX=1       # Switch to Google Vertex AI
CLAUDE_CODE_USE_FOUNDRY=1      # Switch to Anthropic Foundry

# Model overrides
ANTHROPIC_MODEL                # Override default model for session
ANTHROPIC_BASE_URL             # Custom API base URL

# Tuning
CLAUDE_CODE_API_KEY_HELPER_TTL_MS  # API key helper cache TTL in ms

Project Structure

scripts/
  build.ts              # Build script — feature flag injection lives here

src/
  entrypoints/cli.tsx   # CLI entry — Commander.js setup, arg parsing
  commands.ts           # Slash command registry
  tools.ts              # Agent tool registry
  QueryEngine.ts        # Core LLM query orchestration
  screens/REPL.tsx      # Interactive terminal UI (React + Ink)

  commands/             # /slash command implementations
  tools/                # Agent tools: Bash, Read, Edit, Glob, Grep, etc.
  components/           # Ink/React terminal UI components
  services/
    api/                # Anthropic + Codex API clients
    oauth/              # OAuth flows (Anthropic, OpenAI)
  state/                # Global app state store
  utils/model/          # Model config, provider routing, validation
  bridge/               # IDE bridge (BRIDGE_MODE)
  voice/                # Voice input (VOICE_MODE)
  skills/               # Skill system
  plugins/              # Plugin system
  tasks/                # Background task management

Common Patterns

Use ultrathink for hard problems

After building with --feature=ULTRATHINK:

> ultrathink refactor this authentication module to use JWTs

The keyword ultrathink in your prompt triggers extended reasoning mode.

Pipe files into one-shot mode

cat src/auth.ts | free-code -p "find security issues in this file"
free-code -p "write tests for $(cat src/utils.ts)"

Run with a specific provider per session

# One-off Bedrock session without changing env permanently
CLAUDE_CODE_USE_BEDROCK=1 AWS_REGION=eu-west-1 free-code

# One-off Vertex session
CLAUDE_CODE_USE_VERTEX=1 free-code -p "review this PR diff"

Custom build for CI with minimal features

// scripts/build.ts accepts --feature flags
// Build only what you need for a headless CI agent:
// bun run ./scripts/build.ts --feature=VERIFICATION_AGENT --feature=AGENT_TRIGGERS

Troubleshooting

`bun: command not found`

curl -fsSL https://bun.sh/install | bash
source ~/.bashrc  # or ~/.zshrc

`free-code: command not found` after install

The install script symlinks to your PATH. If it's missing:

cd free-code
ln -sf "$(pwd)/cli" /usr/local/bin/free-code

Build fails on experimental flags

Some of the 88 flags don't compile cleanly. Use build:dev:full which only enables the 54 working flags. For broken flags, check FEATURES.md for reconstruction notes:

# Safe full-unlock build (54 working flags only)
bun run build:dev:full

Authentication errors with Bedrock

Verify your AWS credential chain is working independently:

aws sts get-caller-identity
# If this fails, fix AWS credentials before setting CLAUDE_CODE_USE_BEDROCK=1

Vertex AI auth errors

gcloud auth application-default login
gcloud auth application-default print-access-token  # verify it works
export CLAUDE_CODE_USE_VERTEX=1
free-code

Context window fills up quickly

Enable compaction reminders and use the /compact command:

bun run ./scripts/build.ts --feature=COMPACTION_REMINDERS
# Inside REPL when warned:
/compact

IPFS Fallback

If the GitHub repo is unavailable, the full source is permanently mirrored:

CID: bafybeiegvef3dt24n2znnnmzcud2vxat7y7rl5ikz7y7yoglxappim54bm
URL: https://w3s.link/ipfs/bafybeiegvef3dt24n2znnnmzcud2vxat7y7rl5ikz7y7yoglxappim54bm

FAQ

What does the free-code-claude-cli skill do?

Build and use free-code, the open-source fork of Claude Code CLI with telemetry removed, guardrails stripped, and all experimental features unlocked.

How do I install free-code-claude-cli?

Run npx skills add https://github.com/reason-machines/trending-skills --skill free-code-claude-cli in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/free-code-claude-cli/ (personal) or .claude/skills/free-code-claude-cli/ (project).

Which AI agents can use free-code-claude-cli?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is free-code-claude-cli safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains free-code-claude-cli?

It is published by reason-machines in reason-machines/trending-skills. It has 629 recorded installs.

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs

free-code-claude-cli

Install

Install

Describe the task

Review the result

SKILL.md

free-code Claude CLI

Installation

One-liner (recommended)

Manual build

Key CLI Commands

Slash commands inside the REPL

Build Variants

Enable specific feature flags

Model Provider Configuration

Anthropic (default)

OpenAI Codex

AWS Bedrock

Google Cloud Vertex AI

Anthropic Foundry

Experimental Features Reference

High-value flags

Environment Variables Quick Reference

Project Structure

Common Patterns

Use ultrathink for hard problems

Pipe files into one-shot mode

Run with a specific provider per session

Custom build for CI with minimal features

Troubleshooting

bun: command not found

free-code: command not found after install

Build fails on experimental flags

Authentication errors with Bedrock

Vertex AI auth errors

Context window fills up quickly

IPFS Fallback

FAQ

More from reason-machines/trending-skills

Popular other skills

`bun: command not found`

`free-code: command not found` after install