---
read_when:
    - Anda ingin menggunakan subscription Claude Max dengan alat yang kompatibel dengan OpenAI
    - Anda menginginkan server API lokal yang membungkus Claude Code CLI
    - Anda ingin mengevaluasi akses Anthropic berbasis subscription vs berbasis API key
summary: Proxy komunitas untuk mengekspos kredensial subscription Claude sebagai endpoint yang kompatibel dengan OpenAI
title: Proxy API Claude Max
x-i18n:
  refreshed_at: '2026-04-28T05:23:26Z'
  generated_at: "2026-04-24T09:22:29Z"
  model: gpt-5.4
  provider: openai
  source_hash: 06c685c2f42f462a319ef404e4980f769e00654afb9637d873b98144e6a41c87
  source_path: providers/claude-max-api-proxy.md
  workflow: 15
---

**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.

<Warning>
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.
</Warning>

## Mengapa menggunakannya?

| Pendekatan              | Biaya                                                | Paling cocok untuk                         |
| ----------------------- | ---------------------------------------------------- | ------------------------------------------ |
| API Anthropic           | Bayar per token (~$15/M input, $75/M output untuk Opus) | Aplikasi produksi, volume tinggi        |
| Subscription Claude Max | $200/bulan flat                                      | Penggunaan 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

<Steps>
  <Step title="Instal proxy">
    Memerlukan Node.js 20+ dan Claude Code CLI.

    ```bash
    npm install -g claude-max-api-proxy

    # Verifikasi Claude CLI sudah diautentikasi
    claude --version
    ```

  </Step>
  <Step title="Mulai server">
    ```bash
    claude-max-api
    # Server berjalan di http://localhost:3456
    ```
  </Step>
  <Step title="Uji proxy">
    ```bash
    # 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!"}]
      }'
    ```

  </Step>
  <Step title="Konfigurasikan OpenClaw">
    Arahkan OpenClaw ke proxy sebagai endpoint kustom 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" },
        },
      },
    }
    ```

  </Step>
</Steps>

## Katalog bawaan

| ID Model          | Dipetakan ke     |
| ----------------- | ---------------- |
| `claude-opus-4`   | Claude Opus 4    |
| `claude-sonnet-4` | Claude Sonnet 4  |
| `claude-haiku-4`  | Claude Haiku 4   |

## Konfigurasi lanjutan

<AccordionGroup>
  <Accordion title="Catatan gaya proxy yang kompatibel dengan OpenAI">
    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

  </Accordion>

  <Accordion title="Auto-start di macOS dengan LaunchAgent">
    Buat LaunchAgent untuk menjalankan proxy secara otomatis:

    ```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
    ```

  </Accordion>
</AccordionGroup>

## Tautan

- **npm:** [https://www.npmjs.com/package/claude-max-api-proxy](https://www.npmjs.com/package/claude-max-api-proxy)
- **GitHub:** [https://github.com/atalovesyou/claude-max-api-proxy](https://github.com/atalovesyou/claude-max-api-proxy)
- **Issues:** [https://github.com/atalovesyou/claude-max-api-proxy/issues](https://github.com/atalovesyou/claude-max-api-proxy/issues)

## 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

<Note>
Untuk integrasi Anthropic native dengan Claude CLI atau API key, lihat [Provider Anthropic](/id/providers/anthropic). Untuk subscription OpenAI/Codex, lihat [Provider OpenAI](/id/providers/openai).
</Note>

## Terkait

<CardGroup cols={2}>
  <Card title="Anthropic provider" href="/id/providers/anthropic" icon="bolt">
    Integrasi OpenClaw native dengan Claude CLI atau API key.
  </Card>
  <Card title="OpenAI provider" href="/id/providers/openai" icon="robot">
    Untuk subscription OpenAI/Codex.
  </Card>
  <Card title="Model selection" href="/id/concepts/model-providers" icon="layers">
    Ikhtisar semua provider, referensi model, dan perilaku failover.
  </Card>
  <Card title="Configuration" href="/id/gateway/configuration" icon="gear">
    Referensi konfigurasi lengkap.
  </Card>
</CardGroup>
