This skill should be used when user encounters "ccproxy not found", "LiteLLM connection failed", "localhost:4000 refused", "OAuth failed", "proxy not running", or needs help configuring ccproxy/LiteLLM integration.

281stars34forks
|2 views

Skill Content

1,585 characters

ccproxy-tools Setup

Run /ccproxy-tools:setup to configure ccproxy/LiteLLM.

Quick Fixes

  • ccproxy/litellm not found - Install with uv tool install 'litellm[proxy]' 'ccproxy'
  • Connection refused localhost:4000 - Start proxy: ccproxy start or litellm --config ~/.litellm/config.yaml
  • OAuth failed - Re-run ccproxy init and authenticate via browser
  • Invalid model name - Check model names in .claude/settings.json match LiteLLM config
  • Changes not applied - Restart Claude Code after updating settings

Environment Variables

Key settings in .claude/settings.jsonenv:

| Variable | Purpose | | -------------------------------- | -------------------------------------- | | ANTHROPIC_BASE_URL | Proxy endpoint (http://localhost:4000) | | ANTHROPIC_AUTH_TOKEN | Auth token for proxy | | ANTHROPIC_DEFAULT_OPUS_MODEL | Opus model name | | ANTHROPIC_DEFAULT_SONNET_MODEL | Sonnet model name | | ANTHROPIC_DEFAULT_HAIKU_MODEL | Haiku model name |

Check Proxy Health

curl http://localhost:4000/health

Resources

  • ccproxy: https://github.com/starbased-co/ccproxy
  • LiteLLM: https://docs.litellm.ai

Installation

Marketplace
Step 1: Add marketplace
/plugin marketplace add fcakyon/claude-codex-settings
Step 2: Install plugin
/plugin install ccproxy-tools@claude-settings