claude-worker-proxy

Claude Worker Proxy is a lightweight Cloudflare Worker-based proxy that routes requests to Claude Code services at the edge. It is designed to minimize latency by handling routing, header normalization, and optional transformations close to users, while keeping configuration simple and maintainable. The proxy supports configuring allowed origins, timeouts, and logging, so you can tailor it to your deployment environment. After deployment, you can point your front-end to the proxy URL, which will forward requests to Claude's API and return responses with minimal processing.

To use the toolset, ensure you have a Claude API key and base URL configured. The worker accepts standard Claude Code API requests and transparently forwards them, applying any defined routing rules and header normalization. You can adjust runtime options such as allowed origins, request timeouts, and log verbosity to suit your security and performance needs. The setup is designed for quick deployment via Wrangler, allowing you to deploy to Cloudflare Workers with minimal boilerplate.

Prerequisites:

• Node.js (LTS) installed
• npm (comes with Node.js)
• Cloudflare Wrangler CLI installed
• A Cloudflare account with a zone and route to attach the worker
• Claude API credentials (API key and base URL)

Step-by-step installation:

1. Install Wrangler globally npm install -g wrangler

2. Authenticate with Cloudflare wrangler login

3. Create or configure your project

   • If starting from an existing repo, navigate to the project directory.
   • Ensure wrangler.toml is present and configured (account_id, zone_id, route, etc.).

4. Install dependencies (if needed) npm install

5. Configure environment variables

   • In wrangler.toml, or via Wrangler environment settings, set: CLAUDE_API_KEY, CLAUDE_API_BASE, PROXY_ALLOWED_ORIGINS, PROXY_TIMEOUT_MS, LOG_LEVEL

6. Build and publish to Cloudflare Workers wrangler publish

7. Validate deployment

   • Open the route URL in a browser or run curl against the route to ensure requests are proxied to Claude.

Notes:

• The repository layout includes src/ with the worker logic and a wrangler.toml for deployment. If you need to customize the entry point, modify src/worker.js (or the path used in wrangler.config).

Helpful tips:

• Keep CLAUDE_API_KEY secure; avoid embedding in public repositories.
• Use PROXY_TIMEOUT_MS to prevent long hangs; adjust based on your latency expectations.
• Set PROXY_ALLOWED_ORIGINS to restrict who can call the proxy; use a comma-separated list.
• Enable LOG_LEVEL as needed for debugging, but consider reducing it in production to minimize log volume.
• Regularly update to the latest release to incorporate security fixes and feature improvements from the upstream project.
• If you encounter deployment issues, check wrangler logs and Cloudflare Workers’ live logs for error messages.