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

Providers

Claude Max API プロキシ

claude-max-api-proxy はコミュニティ製の npm パッケージ（OpenClaw plugin ではありません）であり、 Claude Max/Pro サブスクリプションを OpenAI 互換 API エンドポイントとして公開します。これにより、 Anthropic API キーの代わりに、任意の OpenAI 互換ツールをサブスクリプションへ接続できます。

これを使用する理由

方法 課金経路 最適な用途
Anthropic API キー Claude Console を通じたトークン単位の従量課金 本番アプリ、共有自動化、大量利用
Claude サブスクリプションプロキシ Claude Code／claude -p のプランおよびクレジットのルール 互換ツールを使用した個人的な実験

このプロキシを使用すると、Claude Max または Pro サブスクリプションを OpenAI 互換 ツールで利用できます。無制限の定額制ではなく、Claude Code の利用 上限が引き継がれます。本番環境での利用には、API キーの方が明確な課金方法です。

仕組み

text
アプリ -> claude-max-api-proxy -> Claude Code CLI / claude -p -> Anthropic   （OpenAI 形式）                 （形式を変換）                 （ログイン情報を使用）

プロキシはリクエストごとに Claude Code CLI をサブプロセスとして起動し、 OpenAI 形式のチャットリクエストを CLI プロンプトへ変換して、レスポンスを OpenAI 形式でストリーミング（または一括返却）します。

はじめに

  • プロキシをインストール

    Node.js 20 以降と、認証済みの Claude Code CLI が必要です。

    bash
    npm install -g claude-max-api-proxy # Claude CLI が認証済みであることを確認claude --versionclaude auth login   # まだ認証していない場合

  • サーバーを起動

    bash
    claude-max-api# サーバーは http://localhost:3456 で稼働

  • プロキシをテスト

    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": "こんにちは！"}]  }'

  • OpenClaw を設定

    カスタム OpenAI 互換エンドポイントとして、OpenClaw の接続先をプロキシに設定します。

    json5
    {  env: {    OPENAI_API_KEY: "not-needed",    OPENAI_BASE_URL: "http://localhost:3456/v1",  },  agents: {    defaults: {      model: { primary: "openai/claude-opus-4" },    },  },}
    • モデル ID CLI エイリアス 現在の対応モデル
    claude-opus-4 opus Claude Opus 4.5
    claude-sonnet-4 sonnet Claude Sonnet 4
    claude-haiku-4 haiku Claude Haiku 4

    高度な設定

    プロキシ形式の OpenAI 互換に関する注記

    これは OpenClaw の汎用カスタム /v1 OpenAI 互換ルートを使用します。これは、 他のセルフホスト型 OpenAI 互換バックエンドと同じ経路です。

    • OpenAI ネイティブ専用のリクエスト整形は適用されません。
    • /fast と service_tier は直接の api.anthropic.com トラフィックにのみ適用されます。プロキシルートでは service_tier は変更されません （Anthropic プロバイダーの高速モードを参照）。
    • Responses store、プロンプトキャッシュのヒント、OpenAI reasoning 互換の ペイロード整形はありません。
    • OpenClaw の OpenAI/Codex 帰属ヘッダー（originator、version、 User-Agent）は、ネイティブの api.openai.com OAuth トラフィックでのみ送信され、 このプロキシのようなカスタム OPENAI_BASE_URL ターゲットには送信されません。
    LaunchAgent を使用して macOS で自動起動
    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

    注記

    • Claude Code の claude -p 課金、利用クレジット、およびレート制限の動作を引き継ぎます。
    • 127.0.0.1 にのみバインドします。CLI 自体による Anthropic への呼び出しを除き、サードパーティーのサーバーへデータを送信しません。
    • ストリーミングレスポンスに対応しています。
    • 起動時には認証エラーを確認せず、チャットリクエストが実際に実行された時点でのみエラーが表面化します。CLI が未認証の場合、サーバーが起動を拒否するのではなく、最初のリクエストが失敗します。

    関連項目

    Anthropic プロバイダー

    Claude CLI または API キーを使用する OpenClaw のネイティブ統合。
    OpenAI プロバイダー

    OpenAI/Codex サブスクリプション向け。
    モデルの選択

    すべてのプロバイダー、モデル参照、フェイルオーバー動作の概要。
    設定

    完全な設定リファレンス。
    Was this useful?
    On this page

    On this page