Claude Proxy

Claude Code Proxy

A lightweight Node.js proxy (~150 lines, zero dependencies) that wraps Anthropic API requests with the Claude Code envelope, routing billing through your Claude Code subscription instead of direct API credits.

What It Does

Setup

That's it. No dependencies to install.

Configuration

config.json:

Usage

Point your Anthropic client at http://127.0.0.1:8082 instead of https://api.anthropic.com. The proxy passes through your API key and adds the Claude Code billing envelope.

Endpoints

Requirements

- Node.js 18+
- A valid Anthropic API key (from an account with Claude Code / Max subscription)

Run as a Service (macOS)

To keep the proxy running persistently, create a launchd plist at ~/Library/LaunchAgents/com.claude-proxy.plist:

Replace /path/to/node with your node binary path (which node) and /path/to/claude-proxy with where you cloned this repo.

The proxy will auto-restart on crash and start on boot.

OpenClaw Skill (Troubleshooting)

This repo includes an OpenClaw skill for automated troubleshooting. If you're using OpenClaw and the proxy stops working, the skill walks your agent through diagnosing and fixing common issues (baseUrl overwrites, auth token cycling, Keychain sync, etc).

Install the skill

Copy the skill folder into your OpenClaw workspace:

Or if your workspace is in a different location:

That's it — OpenClaw will automatically detect the skill and use it when proxy-related issues come up.

License

MIT