by starbaser
Build mods for Claude Code: Hook any request, modify any response, /model "with-your-custom-model", intelligent model routing using your logic or ours
# Add to your Claude Code skills
git clone https://github.com/starbaser/ccproxyccproxy - Claude Code Proxy Join starbased HQ for questions, sharing setups, and contributing to development.
ccproxy unlocks the full potential of your Claude Code by enabling Claude use alongside other LLM providers like OpenAI, Gemini, and Perplexity
It works by intercepting Claude Code's requests through a LiteLLM Proxy Server, allowing you to route different types of requests to the most suitable model - keep your unlimited Claude for standard coding, send large contexts to Gemini's 2M token window, route web searches to Perplexity, all while Claude Code thinks it's talking to the standard API.
⚠️⚠️
mainBranch Status: As of 2026-02-05, the current release may not be stable for ALL Claude Code versions. Progress towards the next release candidate is ongoing, please consider the Discord before filing an issue.
⚠️ Note: While core functionality is complete, real-world testing and community input are welcomed. Please open an issue to share your experience, report bugs, or suggest improvements, or even better, submit a PR!
Important: ccproxy must be installed with LiteLLM in the same environment so that LiteLLM can import the ccproxy handler.
# Install from PyPI
uv tool install claude-ccproxy --with 'litellm[proxy]'
# Or install from GitHub (latest)
uv tool install git+https://github.com/starbased-co/ccproxy.git --with 'litellm[proxy]'
No comments yet. Be the first to share your thoughts!
This installs:
ccproxy command (for managing the proxy)litellm bundled in the same environment (so it can import ccproxy's handler)# Install both packages in the same virtual environment
pip install git+https://github.com/starbased-co/ccproxy.git
pip install 'litellm[proxy]'
Note: With pip, both packages must be in the same virtual environment.
ccproxy --help
# Should show ccproxy commands
which litellm
# Should point to litellm in ccproxy's environment
Run the automated setup:
# This will create all necessary configuration files in ~/.ccproxy
ccproxy install
tree ~/.ccproxy
# ~/.ccproxy
# ├── ccproxy.yaml
# └── config.yaml
# ccproxy.py is auto-generated when you start the proxy
# Start the proxy server
ccproxy start --detach
# Start Claude Code
ccproxy run claude
# Or add to your .zshrc/.bashrc
export ANTHROPIC_BASE_URL="http://localhost:4000"
# Or use an alias
alias claude-proxy='ANTHROPIC_BASE_URL="http://localhost:4000" claude'
Congrats, you have installed ccproxy! The installed configuration files are intended to be a simple demonstration, thus continuing on to the next section to configure ccproxy is recommended.