claude-max-api-proxy はコミュニティ製の npm パッケージ（OpenClaw Plugin ではありません）で、
Claude Max/Pro サブスクリプションを OpenAI 互換 API エンドポイントとして公開するため、
Anthropic API キーの代わりに、任意の OpenAI 互換ツールを自分のサブスクリプションへ向けられます。
技術的な互換性のみであり、公式に認可された経路ではありません。Anthropic は過去に
Claude Code 以外での一部のサブスクリプション利用をブロックしたことがあります。これに依存する前に、
Anthropic の現在の請求ルールを確認してください。Anthropic の Claude Code ドキュメントでは、claude -p は Agent SDK/プログラムからの
利用として説明されています。Anthropic の 2026 年 6 月 15 日のサポート更新時点では、Claude Agent SDK、
claude -p、およびサードパーティアプリの利用は、サインイン中のサブスクリプションの
利用上限から消費されます（以前発表されていた別個の Agent SDK クレジットプランは
一時停止されています）。Anthropic の Agent SDK プラン
記事、
Pro/Max
および Team/Enterprise
プラン記事、ならびに OpenClaw 独自の Claude CLI 請求に関する注記については
Anthropic プロバイダーを参照してください。 これを使う理由
| アプローチ | コスト経路 | 最適な用途 |
|---|
| Anthropic API キー | Claude Console 経由でトークンごとに支払い | 本番アプリ、共有自動化、大量利用 |
| Claude サブスクリプションプロキシ | Claude Code / claude -p のプランおよびクレジットルール | 互換ツールでの個人的な実験 |
仕組み
Your App -> claude-max-api-proxy -> Claude Code CLI / claude -p -> Anthropic
(OpenAI format) (converts format) (uses your login)
はじめに
プロキシをインストールする
Node.js 20+ と、認証済みの Claude Code CLI が必要です。npm install -g claude-max-api-proxy
# Verify Claude CLI is authenticated
claude --version
claude auth login # if not already authenticated
サーバーを起動する
claude-max-api
# Server runs at http://localhost:3456
プロキシをテストする
curl http://localhost:3456/health
curl 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!"}]
}'
OpenClaw を設定する
カスタム OpenAI 互換エンドポイントとして、OpenClaw をプロキシに向けます。{
env: {
OPENAI_API_KEY: "not-needed",
OPENAI_BASE_URL: "http://localhost:3456/v1",
},
agents: {
defaults: {
model: { primary: "openai/claude-opus-4" },
},
},
}
下記のモデル ID は、OpenClaw の Anthropic モデル参照ではなく、このプロキシ独自のカタログです。
各 ID は Claude Code CLI のモデルエイリアス（opus、sonnet、
haiku）に対応しているため、Anthropic が CLI 内のそのエイリアスを更新するたびに、
基盤となるモデルは変わります。特定の対応関係に依存する前に、プロキシの現在の README を確認してください。
| モデル ID | CLI エイリアス | 現在の対応 |
|---|
claude-opus-4 | opus | Claude Opus 4.5 |
claude-sonnet-4 | sonnet | Claude Sonnet 4 |
claude-haiku-4 | haiku | Claude Haiku 4 |
高度な設定
これは 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 起動時に自動起動する
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 サブスクリプション向け。
モデル選択
すべてのプロバイダー、モデル参照、フェイルオーバー動作の概要。
