High-Performance LLM Proxy for the Modern Era

🌍 Language Support

🇺🇸 English | 🇨🇳 简体中文

ClewdR is a production-grade, high-performance proxy server engineered specifically for Claude (Claude.ai, Claude Code) and Google Gemini (AI Studio, Vertex AI). Built with Rust for maximum performance and minimal resource usage, it provides enterprise-level reliability with consumer-friendly simplicity.

• 🚄 10x Performance: Outperforms script-language implementations
• 💾 1/10th Memory: Uses only single-digit MB in production
• 🔧 Production Ready: Handles thousands of requests per second
• 🌐 Multi-Platform: Native support for Windows, macOS, Linux, Android

# Download the latest release for your platform
wget https://github.com/Xerxes-2/clewdr/releases/latest/download/clewdr-[platform]

# Extract the binary (if necessary)
tar -xzf clewdr-[platform].tar.gz

# Navigate to the directory
cd clewdr-[platform]

# Make executable (Linux/macOS)
chmod +x clewdr

# Run ClewdR
./clewdr

1. 🌐 Open your browser to http://127.0.0.1:8484
2. 🔐 Use the Web Admin Password displayed in the console
3. 🎉 Welcome to ClewdR's management interface!

💡 Pro Tips:

• Forgot password? Delete clewdr.toml and restart
• Docker users: Password appears in container logs
• Change password: Use the web interface settings

ClewdR provides multiple API endpoints. Check the console output for available endpoints:

# Claude Endpoints
Claude Web:    http://127.0.0.1:8484/v1/messages          # Native format
Claude OpenAI: http://127.0.0.1:8484/v1/chat/completions  # OpenAI compatible
Claude Code:   http://127.0.0.1:8484/code/v1/messages     # Claude Code

# Gemini Endpoints  
Gemini Native: http://127.0.0.1:8484/v1/v1beta/generateContent    # Native format
Gemini OpenAI: http://127.0.0.1:8484/gemini/chat/completions      # OpenAI compatible
Vertex AI:     http://127.0.0.1:8484/v1/vertex/v1beta/            # Vertex AI

{
  "api_url": "http://127.0.0.1:8484/v1/chat/completions",
  "api_key": "your-api-password-from-console",
  "model": "claude-3-sonnet-20240229"
}

{
  "models": [
    {
      "title": "Claude via ClewdR",
      "provider": "openai",
      "model": "claude-3-sonnet-20240229",
      "apiBase": "http://127.0.0.1:8484/v1/",
      "apiKey": "your-api-password-from-console"
    }
  ]
}

{
  "openaiApiBase": "http://127.0.0.1:8484/v1/",
  "openaiApiKey": "your-api-password-from-console"
}

• ✅ Check cookie/key status in the web dashboard
• ✅ Monitor request logs for successful connections
• ✅ Test with a simple chat request
• ✅ Enjoy blazing-fast LLM proxy performance!

ClewdR keeps state in a local clewdr.toml file by default. To persist configuration, cookies, and API keys in a database instead, compile the binary with the database feature set and point persistence.mode at your driver.

• Build from source with the matching feature flag: cargo build --release --no-default-features --features "embed-resource,xdg,db-sqlite"
• Choose db-sqlite, db-postgres, or db-mysql (they automatically include the base db feature)
• Custom Docker images should adjust the cargo build step to include the desired db-* feature; the published Dockerfile uses file mode by default

Add a persistence section to clewdr.toml (or set the equivalent environment variables):

[persistence]
mode = "postgres"            # sqlite | postgres | mysql
database_url = "postgres://user:pass@db:5432/clewdr"

• SQLite: optionally set sqlite_path = "/var/lib/clewdr/clewdr.db"; ClewdR expands this to sqlite:///var/lib/clewdr/clewdr.db?mode=rwc and creates the parent folder when possible

• Postgres/MySQL: database_url must be provided (for example postgres://user:pass@host:5432/db)

• Environment variable form uses Figment’s double-underscore syntax, e.g.:

  export CLEWDR_PERSISTENCE__MODE=sqlite
  export CLEWDR_PERSISTENCE__SQLITE_PATH=/var/lib/clewdr/clewdr.db
  # or database_url for server backends
  export CLEWDR_PERSISTENCE__DATABASE_URL="postgres://user:pass@db/clewdr"

• On first start ClewdR runs automatic SeaORM migrations (config, cookies, keys, wasted tables); ensure the account can create tables and indexes
• API endpoints that write cookies/keys check GET /api/storage/status; failed connections surface as Database storage is unavailable
• SQLite paths should live on persistent storage (bind mount the directory when running in containers)
• Setting persistence.mode without a matching db-* build leaves ClewdR in file mode—verify your binary with clewdr -V or rebuild with the correct features
• The admin API exposes helpers: GET /api/storage/status to inspect health, and authenticated POST /api/storage/import|export for file migration

Github Aggregated Wiki: https://github.com/Xerxes-2/clewdr/wiki

• Database persistence guide (中文)

• wreq - Excellent browser fingerprinting library used for API access.
• Clewd Modified Version - A modified version of the original Clewd, providing many inspirations and foundational features.
• Clove - Provides the support logic for Claude Code.