Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

claude-max-api-proxy adalah alat komunitas yang mengekspos subscription Claude Max/Pro Anda sebagai endpoint API yang kompatibel dengan OpenAI. Ini memungkinkan Anda menggunakan subscription Anda dengan alat apa pun yang mendukung format API OpenAI.
Jalur ini hanya kompatibilitas teknis. Anthropic pernah memblokir sebagian penggunaan subscription di luar Claude Code. Anda harus memutuskan sendiri apakah ingin menggunakannya dan memverifikasi ketentuan Anthropic saat ini sebelum mengandalkannya.

Mengapa menggunakannya?

PendekatanBiayaPaling cocok untuk
API AnthropicBayar per token (~15/Minput,15/M input, 75/M output untuk Opus)Aplikasi produksi, volume tinggi
Subscription Claude Max$200/bulan flatPenggunaan personal, pengembangan, penggunaan tak terbatas
Jika Anda memiliki subscription Claude Max dan ingin menggunakannya dengan alat yang kompatibel dengan OpenAI, proxy ini dapat mengurangi biaya untuk beberapa alur kerja. API key tetap merupakan jalur kebijakan yang lebih jelas untuk penggunaan produksi.

Cara kerjanya

Aplikasi Anda → claude-max-api-proxy → Claude Code CLI → Anthropic (via subscription)
     (format OpenAI)                (mengonversi format)    (menggunakan login Anda)
Proxy ini:
  1. Menerima permintaan format OpenAI di http://localhost:3456/v1/chat/completions
  2. Mengonversinya menjadi perintah Claude Code CLI
  3. Mengembalikan respons dalam format OpenAI (streaming didukung)

Memulai

1

Instal proxy

Memerlukan Node.js 20+ dan Claude Code CLI.
npm install -g claude-max-api-proxy

# Verifikasi Claude CLI sudah diautentikasi
claude --version
2

Mulai server

claude-max-api
# Server berjalan di http://localhost:3456
3

Uji proxy

# Pemeriksaan kesehatan
curl http://localhost:3456/health

# Daftar model
curl http://localhost:3456/v1/models

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

Konfigurasikan OpenClaw

Arahkan OpenClaw ke proxy sebagai endpoint kustom yang kompatibel dengan OpenAI:
{
  env: {
    OPENAI_API_KEY: "not-needed",
    OPENAI_BASE_URL: "http://localhost:3456/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}

Katalog bawaan

ID ModelDipetakan ke
claude-opus-4Claude Opus 4
claude-sonnet-4Claude Sonnet 4
claude-haiku-4Claude Haiku 4

Konfigurasi lanjutan

Jalur ini menggunakan rute gaya proxy yang kompatibel dengan OpenAI yang sama seperti backend kustom /v1 lainnya:
  • Pembentukan permintaan khusus OpenAI native tidak berlaku
  • Tidak ada service_tier, tidak ada Responses store, tidak ada petunjuk prompt-cache, dan tidak ada pembentukan payload reasoning-compat OpenAI
  • Header atribusi OpenClaw tersembunyi (originator, version, User-Agent) tidak disisipkan pada URL proxy
Buat LaunchAgent untuk menjalankan proxy secara otomatis:
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

Tautan

Catatan

  • Ini adalah alat komunitas, tidak didukung secara resmi oleh Anthropic atau OpenClaw
  • Memerlukan subscription Claude Max/Pro aktif dengan Claude Code CLI yang sudah diautentikasi
  • Proxy berjalan secara lokal dan tidak mengirim data ke server pihak ketiga mana pun
  • Respons streaming didukung penuh
Untuk integrasi Anthropic native dengan Claude CLI atau API key, lihat Provider Anthropic. Untuk subscription OpenAI/Codex, lihat Provider OpenAI.

Terkait

Anthropic provider

Integrasi OpenClaw native dengan Claude CLI atau API key.

OpenAI provider

Untuk subscription OpenAI/Codex.

Model selection

Ikhtisar semua provider, referensi model, dan perilaku failover.

Configuration

Referensi konfigurasi lengkap.