Claude Max API Proxy Setup for Openclaw

A local proxy server that routes OpenAI-compatible requests through your Claude Max or Pro subscription to eliminate per-token billing.

error403agent
v1.1.0
Feb 26, 2026
0
1.7k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install claude-max-proxy-setup

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install claude-max-proxy-setup using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Claude Max API Proxy Setup?

The Claude Max API Proxy skill provides a bridge between your local environment and Anthropic's powerful models without the burden of per-token costs. By utilizing the authenticated session of your Claude CLI, this setup exposes a local endpoint that mimics the OpenAI API structure. This is a game-changer for developers using Openclaw Skills who require high-volume model access but prefer the predictable pricing of a flat-rate subscription over variable API charges.

This utility specifically targets advanced users and autonomous agents that generate high token throughput. By mapping standard OpenAI requests to your Claude subscription, it allows for a seamless transition between providers while maintaining compatibility with the vast ecosystem of tools designed for OpenAI-like endpoints.

Claude Max API Proxy Setup Use Cases

  • Replacing expensive per-token billing ($15-75/M tokens) with a flat-rate Claude subscription.
  • Using Openclaw Skills with premium models like Claude Opus 4.6 and Sonnet 4.6 at a fixed monthly cost.
  • Building and testing long-running agentic workflows that would otherwise be cost-prohibitive.
  • Providing a local OpenAI-compatible gateway for tools like LangChain or custom automation scripts.

How Claude Max API Proxy Setup Works

  1. The proxy identifies your existing authenticated session created via the Claude Code CLI.
  2. It initializes a local HTTP server on port 3456 that listens for OpenAI-formatted requests.
  3. When a request is received, the proxy translates the payload and pipes it through the authenticated CLI session.
  4. The response from Claude is captured and reformatted back into a standard OpenAI chat completion JSON object for the client.

Claude Max API Proxy Setup Setup

1. Requirements

Ensure you have Node.js 20+ and the Claude CLI installed. You must be logged in locally:

claude login

2. Installation

Install the proxy package globally to enable the CLI command:

npm install -g claude-max-api-proxy

3. Execution

Start the proxy on your local machine:

claude-max-api

4. Integration

Configure your client, such as when using Openclaw Skills, by setting the base URL and a dummy API key:

{
  "OPENAI_BASE_URL": "http://localhost:3456/v1",
  "OPENAI_API_KEY": "sk-not-required"
}

Claude Max API Proxy Setup Data Schema & Taxonomy

The proxy organizes data by mapping model IDs to specific CLI aliases. Below is the internal mapping and configuration schema:

Proxy Model ID Subscription Tier Context Window
claude-opus-4 Max / Pro 200,000 tokens
claude-sonnet-4 Max / Pro 200,000 tokens
claude-haiku-4 Max / Pro 200,000 tokens

All interactions are handled locally; the proxy stores no keys or request history, ensuring your subscription credentials remain within your local CLI environment.

Claude Max API Proxy Setup Advanced Features

  • Systemd Integration: Run the proxy as a persistent background service that starts automatically on boot.
  • Multi-Model Support: Choose between Opus, Sonnet, or Haiku models via model ID selection in your agent configuration.
  • Subscription Compatibility: Works with both the $200/mo Max plan and the $20/mo Pro plan.
  • Zero-Configuration Auth: Automatically inherits permissions from your existing claude CLI login.
  • Localhost Binding: Enforced security by binding to 127.0.0.1 to prevent external network access to your subscription.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*