Claude Code LiteLLM Proxy

TypeScript proxy for Claude Code → LiteLLM → any LLM provider.

Supports: streaming, tool calling, images, multi-turn conversations, system messages.

Quick Start

1. Install Dependencies

pnpm install

2. Configure

cp .env.example .env
# Edit: LITELLM_BASE_URL, MODEL, UPSTREAM_API_KEY

3. Run

pnpm dev  # or: pnpm build && pnpm start

4. Configure Claude Code

./configure-claude.sh http://localhost:8082

This updates ~/.claude/settings.json with the proxy URL. Test with claude.

Config

Required: LITELLM_BASE_URL, MODEL, UPSTREAM_API_KEY
Optional: PORT (8082), LOG_LEVEL (info), NODE_ENV (development)

Deploy

Docker: docker build -t claude-proxy . && docker run -p 8082:8082 --env-file .env claude-proxy
PM2: pnpm build && pm2 start dist/server.js --instances max
Systemd: See Dockerfile for service setup

---

JSON logs. Health at /health. MIT license.