Skip to content

CodeFreedom

One CLI for every code agent. Switch LLM providers, isolate environments, and manage everything from ~/.codefreedom. 

pip install codefreedom
Get Started GitHub

What Problem Does This Solve

You have code agents (Claude Code, MiMo Code, OpenCode, etc.). You want to switch between AI models (DeepSeek, GPT, Claude) without reconfiguring everything. You want isolated environments. You want one place for all your settings.

CodeFreedom gives you that.

What You Get

  • Switch models instantly

DeepSeek for drafting, GPT for reasoning, free models for testing. Same command, different profile. No code changes.

Agents

  • Isolated sandboxes

Every session runs in a fresh Docker container. CUDA, ROCm, or plain Ubuntu. Clean slate every time.

Sandbox

  • Self-hosted proxy

One local endpoint (localhost:4000) routes to any LLM provider. Add API keys, switch backends, track spend.

Proxy

  • Browser and API tools

Headless Chrome, web search, GitHub API — all as Docker containers your code agent can use.

Tools

How It Works

You → cf run agent claude-code → LiteLLM Proxy → Your chosen AI model
  1. You run cf run agent claude-code
  2. CodeFreedom sets up environment variables from your profile
  3. Claude Code talks to your local proxy at localhost:4000
  4. The proxy routes the request to whichever AI model you configured

Change the model? Edit one line in your profile. Done.

Quick Start

Four commands, five minutes:

pip install codefreedom          # Install
cf setup init                    # Set up config via recipe
cf run proxy start               # Start the proxy
cf run agent claude-code         # Launch Claude Code

Short aliases

All commands have short aliases for faster workflows:

cf s i                           # cf setup init
cf r px start                    # cf run proxy start
cf r ag cc                       # cf run agent claude-code
cf r ag mc                       # cf run agent mimo-code
cf r ag oc                       # cf run agent open-code
cf m dr                          # cf manage doctor

Get started step by step →