A lightweight wrapper that configures Clxxxx Free-Code to use synthetic.new's API instead of Anthropic's — enabling free, high-quality AI coding with models like Kimi-K2.5-NVFP4.
free-code is a drop-in replacement for claude that redirects all API calls to synthetic.new's Anthropic-compatible endpoint. You get:
- ✅ Same Claude Code experience — agents, skills, subagents, tools
- ✅ Free/cheap AI models — Kimi-K2.5, GLM-4, and more
- ✅ No auth/login prompts — direct API key auth
- ✅ Privacy-first — telemetry disabled by default
# 1. Install Claude Code (if not already)
npm install -g @anthropic-ai/claude-code
# 2. Install free-code wrapper
curl -fsSL https://raw.githubusercontent.com/moseslua/free-code-synthetic/main/install.sh | bash
# 3. Configure your API key
export SYNTHETIC_API_KEY="syn_your_key_here"
# 4. Use it exactly like claude
free-code# Download the wrapper
curl -fsSL https://raw.githubusercontent.com/moseslua/free-code-synthetic/main/free-code -o ~/.local/bin/free-code
chmod +x ~/.local/bin/free-code
# Set environment variables
export ANTHROPIC_AUTH_TOKEN="syn_your_key_here"
export ANTHROPIC_BASE_URL="https://api.synthetic.new/anthropic"
# Run
free-code| Variable | Default | Description |
|---|---|---|
ANTHROPIC_AUTH_TOKEN |
required | Your synthetic.new API key (preferred) |
SYNTHETIC_API_KEY |
- | Alternative API key name |
ANTHROPIC_API_KEY |
- | Fallback API key name |
ANTHROPIC_BASE_URL |
https://api.synthetic.new/anthropic |
API endpoint |
ANTHROPIC_DEFAULT_OPUS_MODEL |
hf:nvidia/Kimi-K2.5-NVFP4 |
Model for complex tasks |
ANTHROPIC_DEFAULT_SONNET_MODEL |
hf:nvidia/Kimi-K2.5-NVFP4 |
Model for standard tasks |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
hf:zai-org/GLM-4.7-Flash |
Model for quick tasks |
CLAUDE_CODE_SUBAGENT_MODEL |
hf:nvidia/Kimi-K2.5-NVFP4 |
Model for crew agents |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC |
1 |
Disable telemetry |
DEBUG |
- | Show debug output |
free-code --help # Show help
free-code --version # Show version
free-code --bare # Fast startup (no hooks/plugins)
free-code -p "prompt" # Print mode (non-interactive)Pass any Claude Code options directly — they're passed through transparently.
This wrapper pairs perfectly with My-Brain-Is-Full-Crew — a 21-agent research system:
# 1. Clone crew repo
cd ~/your-vault
git clone https://github.com/moseslua/My-Brain-Is-Full-Crew.git
cd My-Brain-Is-Full-Crew
bash scripts/launchme.sh
# 2. Use free-code instead of claude
cd ~/your-vault
free-code
> initialize the vaultSee synthetic.new/docs/api/models for full list.
Popular choices:
hf:nvidia/Kimi-K2.5-NVFP4— Best overall (default)hf:moonshotai/Kimi-K2.5— Alternative Kimihf:zai-org/GLM-4.7-Flash— Fast, cheap
free-code (wrapper script)
↓
Sets environment variables
↓
Executes claude-code CLI
↓
API calls go to synthetic.new/anthropic
↓
Returns responses from Kimi/GLM models
The wrapper is transparent — Claude Code thinks it's talking to Anthropic, but the requests are proxied to synthetic.new.
- synthetic.new Claude Code Guide
- My-Brain-Is-Full-Crew — 21-agent research crew
MIT — same as Claude Code
