Claude Max サブスクリプションを OpenAI 互換 API として利用する方法

API を使った開発では、リクエストを送るたびに発生する「トークン料金」が気になりがちです。特に大規模なコンテキストを扱う場合、コストを抑えるためにモデルの質を落としたり、試行回数を減らしたりするのは、開発の効率を下げてしまいます。

Claude Max や Pro のサブスクリプションをすでに持っているなら、追加の従量課金を気にせずに API 経由でモデルを利用したいはずです。claude-max-api-proxy は、ローカル環境で動作する Gateway となり、使い慣れた OpenAI 互換のツールから Claude の定額プランを利用できるようにします。

必要なもの

• Node.js 20+
• Claude Code CLI (認証済みであること)
• 有効な Claude Max または Claude Pro のサブスクリプション
• インストール済みの npm

クイックスタート

5 分もあれば、ローカル環境で API サーバーを立ち上げることができます。

1. インストール

まず、グローバルパッケージとしてインストールします。あわせて Claude CLI が認証されているか確認してください。

# Node.js 20+ と Claude Code CLI が必要です
npm install -g claude-max-api-proxy

# Claude CLI が認証済みか確認
claude --version

2. サーバーの起動

コマンドを実行すると、サーバーが起動します。

claude-max-api
# サーバーは http://localhost:3456 で動作します

3. 動作確認

curl を使って、正しくレスポンスが返ってくるかテストしましょう。

# ヘルスチェック
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 での利用例

OpenClaw の設定で、カスタムの OpenAI 互換エンドポイントとして指定できます。

{
  env: {
    OPENAI_API_KEY: "not-needed",
    OPENAI_BASE_URL: "http://localhost:3456/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}

利用可能なモデル

以下の Model ID が、それぞれの Claude モデルにマッピングされます。

Model ID	マッピング先
claude-opus-4	Claude Opus 4
claude-sonnet-4	Claude Sonnet 4
claude-haiku-4	Claude Haiku 4

macOS での自動起動設定

LaunchAgent を作成して、バックグラウンドで常時実行させることができます。

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 CLI が認証されていない: claude --version を実行して、正しくログインされているか確認してください。
• サブスクリプションの確認: このツールには有効な Claude Max または Pro のプランが必要です。
• コミュニティツール: これは Anthropic や OpenClaw による公式サポートツールではありません。
• データの安全性: プロキシはローカルで動作し、第三者のサーバーにデータを送信することはありません。

設定についてさらに詳しく知りたい場合は、AI Setup Assistant をご利用ください。

次のステップ

• Anthropic provider - セットアップトークンや API キーを使用した OpenClaw のネイティブ統合
• OpenAI provider - OpenAI/Codex サブスクリプションの利用