This skill provides troubleshooting guides and setup instructions for configuring ccproxy and LiteLLM proxy integration. It helps users resolve common connection issues, configure environment variables, and verify proxy health without any executable code.

382stars39forks
|368 views|Found in hesreallyhim/awesome-claude-code

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