OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Proxy d’API Claude Max

claude-max-api-proxy est un paquet npm communautaire (et non un plugin OpenClaw) qui expose un abonnement Claude Max/Pro sous forme de point de terminaison d’API compatible avec OpenAI, afin que vous puissiez connecter tout outil compatible avec OpenAI à votre abonnement plutôt que d’utiliser une clé d’API Anthropic.

Pourquoi utiliser cette solution

Approche Mode de facturation Idéal pour
Clé d’API Anthropic Paiement par jeton via Claude Console Applications de production, automatisation partagée, volume
Proxy d’abonnement Claude Règles du forfait et des crédits Claude Code / claude -p Expérimentations personnelles avec des outils compatibles

Ce proxy permet d’utiliser un abonnement Claude Max ou Pro avec des outils compatibles avec OpenAI. Il ne s’agit pas d’une formule illimitée à tarif fixe : il hérite des limites d’utilisation de Claude Code. Les clés d’API restent le mode de facturation le plus clair pour une utilisation en production.

Fonctionnement

text
Votre application -> claude-max-api-proxy -> Claude Code CLI / claude -p -> Anthropic     (format OpenAI)                    (convertit le format)              (utilise votre connexion)

Le proxy lance la CLI Claude Code en tant que sous-processus pour chaque requête, convertit les requêtes de conversation au format OpenAI en invites pour la CLI, puis diffuse en continu (ou renvoie) la réponse au format OpenAI.

Prise en main

  • Installer le proxy

    Nécessite Node.js 20+ et une CLI Claude Code authentifiée.

    bash
    npm install -g claude-max-api-proxy # Verify Claude CLI is authenticatedclaude --versionclaude auth login   # if not already authenticated

  • Démarrer le serveur

    bash
    claude-max-api# Server runs at http://localhost:3456

  • Tester le proxy

    bash
    curl http://localhost:3456/healthcurl http://localhost:3456/v1/models curl http://localhost:3456/v1/chat/completions \  -H "Content-Type: application/json" \  -d '{    "model": "claude-opus-4",    "messages": [{"role": "user", "content": "Hello!"}]  }'

  • Configurer OpenClaw

    Configurez OpenClaw pour utiliser le proxy comme point de terminaison personnalisé compatible avec OpenAI :

    json5
    {  env: {    OPENAI_API_KEY: "not-needed",    OPENAI_BASE_URL: "http://localhost:3456/v1",  },  agents: {    defaults: {      model: { primary: "openai/claude-opus-4" },    },  },}
    • ID du modèle Alias de la CLI Correspondance actuelle
    claude-opus-4 opus Claude Opus 4.5
    claude-sonnet-4 sonnet Claude Sonnet 4
    claude-haiku-4 haiku Claude Haiku 4

    Configuration avancée

    Remarques sur le proxy compatible avec OpenAI

    Cette solution utilise la route générique personnalisée /v1 compatible avec OpenAI d’OpenClaw, soit le même chemin que pour tout autre moteur auto-hébergé compatible avec OpenAI :

    • La mise en forme des requêtes propre à l’API OpenAI native ne s’applique pas.
    • /fast et service_tier ne s’appliquent qu’au trafic direct vers api.anthropic.com ; les routes du proxy laissent service_tier inchangé (consultez le mode rapide du fournisseur Anthropic).
    • Aucune mise en forme de charge utile pour store de Responses, les indications de cache d’invites ou la compatibilité avec le raisonnement OpenAI.
    • Les en-têtes d’attribution OpenAI/Codex d’OpenClaw (originator, version, User-Agent) sont envoyés uniquement avec le trafic OAuth natif vers api.openai.com, et non vers les cibles OPENAI_BASE_URL personnalisées telles que ce proxy.
    Démarrage automatique sous macOS avec LaunchAgent
    bash
    cat > ~/Library/LaunchAgents/com.claude-max-api.plist << 'EOF'<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict>  <key>Label</key>  <string>com.claude-max-api</string>  <key>RunAtLoad</key>  <true/>  <key>KeepAlive</key>  <true/>  <key>ProgramArguments</key>  <array>    <string>/usr/local/bin/node</string>    <string>/usr/local/lib/node_modules/claude-max-api-proxy/dist/server/standalone.js</string>  </array>  <key>EnvironmentVariables</key>  <dict>    <key>PATH</key>    <string>/usr/local/bin:/opt/homebrew/bin:~/.local/bin:/usr/bin:/bin</string>  </dict></dict></plist>EOF launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.claude-max-api.plist

    Remarques

    • Hérite du comportement de facturation, des crédits d’utilisation et des limites de débit de claude -p dans Claude Code.
    • Se lie uniquement à 127.0.0.1 ; n’envoie de données à aucun serveur tiers en dehors de l’appel propre à la CLI vers Anthropic.
    • Les réponses diffusées en continu sont prises en charge.
    • Les échecs d’authentification ne sont pas vérifiés au démarrage et n’apparaissent qu’au moment de l’exécution effective d’une requête de conversation ; si la CLI n’est pas authentifiée, attendez-vous à ce que la première requête échoue plutôt qu’à ce que le serveur refuse de démarrer.

    Ressources associées

    Fournisseur Anthropic

    Intégration native d’OpenClaw avec la CLI Claude ou des clés d’API.
    Fournisseur OpenAI

    Pour les abonnements OpenAI/Codex.
    Sélection du modèle

    Présentation de tous les fournisseurs, des références de modèles et du comportement de basculement.
    Configuration

    Référence complète de la configuration.
    Was this useful?
    On this page

    On this page