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

Providers

Proksi API Claude Max

claude-max-api-proxy adalah paket npm komunitas (bukan plugin OpenClaw) yang menyediakan langganan Claude Max/Pro sebagai titik akhir API yang kompatibel dengan OpenAI, sehingga Anda dapat mengarahkan alat apa pun yang kompatibel dengan OpenAI ke langganan Anda alih-alih menggunakan kunci API Anthropic.

Mengapa menggunakannya

Pendekatan Jalur biaya Paling sesuai untuk
Kunci API Anthropic Bayar per token melalui Claude Console Aplikasi produksi, otomatisasi bersama, volume
Proksi langganan Claude Paket dan aturan kredit Claude Code / claude -p Eksperimen pribadi dengan alat yang kompatibel

Proksi ini memungkinkan langganan Claude Max atau Pro digunakan dengan alat yang kompatibel dengan OpenAI. Ini bukan jalur tarif tetap tanpa batas — proksi ini mewarisi batas penggunaan Claude Code. Kunci API tetap menjadi jalur penagihan yang lebih jelas untuk penggunaan produksi.

Cara kerjanya

text
Aplikasi Anda -> claude-max-api-proxy -> Claude Code CLI / claude -p -> Anthropic     (format OpenAI)                    (mengonversi format)          (menggunakan proses masuk Anda)

Proksi menjalankan Claude Code CLI sebagai subproses untuk setiap permintaan, mengonversi permintaan percakapan berformat OpenAI menjadi perintah CLI, lalu mengalirkan (atau mengembalikan) respons dalam format OpenAI.

Memulai

  • Instal proksi

    Memerlukan Node.js 20+ dan Claude Code CLI yang telah diautentikasi.

    bash
    npm install -g claude-max-api-proxy # Pastikan Claude CLI telah diautentikasiclaude --versionclaude auth login   # jika belum diautentikasi

  • Jalankan server

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

  • Uji proksi

    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!"}]  }'

  • Konfigurasikan OpenClaw

    Arahkan OpenClaw ke proksi sebagai titik akhir khusus yang kompatibel dengan OpenAI:

    json5
    {  env: {    OPENAI_API_KEY: "not-needed",    OPENAI_BASE_URL: "http://localhost:3456/v1",  },  agents: {    defaults: {      model: { primary: "openai/claude-opus-4" },    },  },}
    • ID model Alias CLI Pemetaan saat ini
    claude-opus-4 opus Claude Opus 4.5
    claude-sonnet-4 sonnet Claude Sonnet 4
    claude-haiku-4 haiku Claude Haiku 4

    Konfigurasi lanjutan

    Catatan kompatibilitas OpenAI bergaya proksi

    Ini menggunakan rute generik khusus /v1 milik OpenClaw yang kompatibel dengan OpenAI, yaitu jalur yang sama seperti backend lain yang kompatibel dengan OpenAI dan dihos sendiri:

    • Penyesuaian permintaan khusus OpenAI native tidak berlaku.
    • /fast dan service_tier hanya berlaku untuk lalu lintas langsung ke api.anthropic.com; rute proksi membiarkan service_tier tidak berubah (lihat mode cepat penyedia Anthropic).
    • Tidak ada pembentukan payload Responses store, petunjuk cache perintah, atau kompatibilitas penalaran OpenAI.
    • Header atribusi OpenAI/Codex milik OpenClaw (originator, version, User-Agent) hanya dikirim pada lalu lintas OAuth native ke api.openai.com, bukan ke target khusus OPENAI_BASE_URL seperti proksi ini.
    Jalankan otomatis di macOS dengan 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

    Catatan

    • Mewarisi perilaku penagihan, kredit penggunaan, dan batas laju claude -p milik Claude Code.
    • Hanya terikat ke 127.0.0.1; tidak mengirim data ke server pihak ketiga mana pun selain panggilan CLI itu sendiri ke Anthropic.
    • Respons streaming didukung.
    • Kegagalan autentikasi tidak diperiksa saat dimulai dan baru muncul setelah permintaan percakapan benar-benar dijalankan; jika CLI belum diautentikasi, permintaan pertama akan gagal, bukan server yang menolak untuk dimulai.

    Terkait

    Penyedia Anthropic

    Integrasi native OpenClaw dengan Claude CLI atau kunci API.
    Penyedia OpenAI

    Untuk langganan OpenAI/Codex.
    Pemilihan model

    Ikhtisar semua penyedia, referensi model, dan perilaku failover.
    Konfigurasi

    Referensi konfigurasi lengkap.
    Was this useful?
    On this page

    On this page