ID ▾

Alternatif OpenAI untuk Claude Code: Setup Agen Koding

Claude Code berkomunikasi dengan API milik Anthropic, sehingga tidak dapat sekadar diarahkan ke endpoint gaya OpenAI. Berikut adalah solusi yang berfungsi: agen koding yang menerima base URL OpenAI kustom, dan cara menghubungkannya ke API ini.

Diperbarui

Jendela terminal yang terhubung dengan kabel bercahaya ke kubus server API, mengilustrasikan agen koding menggunakan endpoint kustom

Poin utama

  • Claude Code dibangun di sekitar format API Anthropic, sedangkan layanan ini menggunakan format chat completions OpenAI.
  • Aider, Continue, Cline, dan alat gaya Cursor menerima base URL kompatibel OpenAI kustom dan nama model.
  • Gunakan base URL https://api.minimaxapikey.com/v1 dengan ID model uncensored dan kunci Bearer.
  • Uji dengan curl terlebih dahulu, lalu pertahankan concurrency pada atau di bawah 8 permintaan, karena agen mengirim banyak panggilan sekaligus.

Jawaban singkat

Jika Anda mencari alternatif openai untuk claude code, hal pertama yang harus diselesaikan adalah apa yang ingin Anda ganti. Claude Code adalah agen koding terminal milik Anthropic. Alat ini dirancang untuk berkomunikasi dengan API milik Anthropic, yang menggunakan format permintaan berbeda dari OpenAI. Layanan ini mengimplementasikan format chat completions OpenAI, sehingga keduanya tidak dapat saling terhubung hanya dengan mengubah URL.

Yang berfungsi adalah keluarga besar agen koding dan plugin editor yang menerima endpoint kompatibel OpenAI. Anda memberikannya base URL, kunci, dan nama model, lalu mereka mengirim permintaan POST /v1/chat/completions biasa. Aider, Continue, dan Cline termasuk dalam kelompok ini, dan beberapa editor memiliki penggantian base URL untuk model OpenAI. Untuk API ini, tiga nilai tersebut adalah base URL https://api.minimaxapikey.com/v1, ID model uncensored, dan kunci Anda sebagai token Bearer.

Pertahankan ekspektasi Anda tetap realistis. Model di balik endpoint ini adalah satu model bobot terbuka yang dijalankan oleh penyedia independen, yang disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Ini bukan Claude, dan ini bukan API resmi dari vendor model mana pun. Apakah ini cocok untuk repositori Anda adalah sesuatu yang Anda temukan sendiri melalui tugas Anda, dan artikel ini menunjukkan cara menjalankan uji tersebut dengan murah.

Mengapa Anda tidak dapat hanya mengubah URL di Claude Code

Format API lebih dari sekadar alamat. API Anthropic memiliki struktur pesan sendiri, cara sendiri untuk mengekspresikan prompt sistem, blok penggunaan alat sendiri, dan event streaming sendiri. Server gaya OpenAI mengharapkan messages dengan roles, array tools definisi fungsi, dan event server-sent yang membawa choices[0].delta. Klien yang dibuat untuk satu format akan gagal atau berperilaku salah terhadap server untuk format lain, bahkan jika URL dapat dijangkau.

Beberapa orang menempatkan lapisan terjemahan di antara keduanya, proxy kecil yang mengubah permintaan dan respons. Itu bisa berhasil, tetapi itu adalah perangkat lunak terpisah yang harus Anda jalankan dan debug sendiri, dan perilaku seputar panggilan alat dan streaming cenderung menjadi tempat lapisan tersebut rusak. Apakah Claude Code menawarkan pengaturan resmi untuk endpoint pihak ketiga adalah sesuatu yang harus diperiksa dalam dokumentasi terbaru Anthropic, karena opsi tersebut berubah.

Jalur yang lebih sederhana adalah memilih agen yang sudah berbicara format OpenAI. Anda tidak kehilangan apa pun dalam hal loop dasar: agen membaca file Anda, membuat prompt, meminta model untuk edit, dan menerapkannya. Model adalah bagian yang Anda ganti, dan bagian itu hanya memerlukan endpoint yang kompatibel.

Uji endpoint dengan curl sebelum menyentuh alat apa pun

Setiap masalah integrasi lebih mudah didiagnosis jika Anda sudah mengetahui API mentah berfungsi. Buat kunci di halaman kunci API, ekspor, dan jalankan satu permintaan. Jika ini berhasil, kegagalan selanjutnya ada di pengaturan alat, bukan di kunci atau jaringan.

export UNCENSORED_KEY="paste-your-key-here"

curl -s https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $UNCENSORED_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise coding assistant."},
      {"role": "user", "content": "Write a Python function that parses an ISO date string."}
    ]
  }'

Anda juga dapat mencantumkan model dengan GET /v1/models. Banyak alat memanggil endpoint ini saat Anda menyimpan provider, untuk mengonfirmasi bahwa kunci valid, jadi ada baiknya melihatnya kembali sebelum Anda mengonfigurasi apa pun. Halaman dokumentasi memiliki referensi permintaan lengkap.

Di mana setiap alat mengambil base URL

Nama pengaturan berbeda, tetapi idenya sama di mana-mana. Tabel mencantumkan alat koding umum dan bidang yang Anda isi. Menu berpindah antar versi, jadi perlakukan ini sebagai peta dan periksa dokumentasi masing-masing alat untuk tata letak saat ini.

AlatDi mana memasukkan endpointNama model yang digunakan
AiderVariabel lingkungan atau flag baris perintah untuk base URL OpenAI dan kunciopenai/uncensored
ContinueEntri model dalam file konfigurasinya, dengan provider openai dan apiBaseuncensored
ClineDaftar provider, pilih opsi kompatibel OpenAIuncensored
KursorPengaturan model, bagian kunci API OpenAI dengan penggantian base URLuncensored sebagai model kustom
Skrip Anda sendiriArgumen base_url dari SDK OpenAI apa pununcensored

Karena layanan ini mengekspos tepat satu model, tidak ada pemilih model untuk dikonfigurasi. Di mana pun alat menginginkan nama model, ketik uncensored. Jika alat bersikeras pada daftar model yang diketahui dan menolak nama yang tidak dikenal, cari opsi "model kustom" atau "tambah model".

Contoh Aider

Aider berjalan di terminal Anda, mengedit file di repositori git dan melakukan commit hasilnya, yang membuatnya paling mirip secara semangat dengan Claude Code. Ini menggunakan LiteLLM di bawahnya, sehingga nama model membawa prefix provider. Untuk server kompatibel OpenAI, prefix tersebut adalah openai/.

pip install aider-chat

export OPENAI_API_BASE="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"

cd your-repo
aider --model openai/uncensored

Setelah dimulai, minta perubahan kecil dalam satu file dan perhatikan diff. Mulailah dengan sesuatu yang dapat Anda verifikasi dalam hitungan detik, seperti menambahkan docstring atau mengganti nama fungsi, sebelum memberinya tugas multi-file. Aider mengirim peta repositori dan file yang Anda tambahkan ke chat di setiap giliran, sehingga prompt tumbuh dengan cepat. Jendela 100.000 token (prompt plus completion) cukup luas, tetapi repositori besar masih membutuhkan Anda untuk hanya menambahkan file yang relevan.

Jika Aider memperingatkan bahwa ia tidak mengetahui ukuran konteks atau harga model, itu wajar: ia tidak memiliki entri untuk nama model kustom. Peringatan itu tidak menghentikannya bekerja.

Contoh Continue

Continue adalah ekstensi editor yang menambahkan fitur obrolan, edit, dan autocomplete di dalam VS Code dan JetBrains. Konfigurasi mencantumkan model, masing-masing dengan penyedia dan opsi penimpaan. Entri model untuk API ini terlihat seperti berikut. Nama file dan skema yang tepat bergantung pada versi Continue yang Anda pasang, jadi bandingkan dengan dokumentasi terbaru.

{
  "models": [
    {
      "title": "Uncensored API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.minimaxapikey.com/v1",
      "apiKey": "paste-your-key-here"
    }
  ]
}

Permintaan chat dan edit bekerja dengan baik pada endpoint seperti ini. Autocomplete dengan Tab adalah beban kerja yang berbeda: dipicu hampir setiap kali ada jeda saat mengetik dan membutuhkan latensi sangat rendah, yang lebih baik dilayani oleh model lokal kecil. Menggunakan model chat yang dihosting untuk penyelesaian baris akan membakar permintaan terhadap batas 300 per menit Anda dengan hasil yang minim.

Bangun agen minimal sendiri

Jika tidak ada alat yang cocok, dukungan panggilan alat membuat agen kecil mudah ditulis. API menerima tools dan tool_choice, streaming tool_calls kembali, dan mengambil hasil sebagai pesan dengan role: "tool". Loop di bawah memberi model satu fungsi yang membaca file, lalu terus berlanjut hingga model menjawab dalam teks biasa.

import json
from openai import OpenAI

client = OpenAI(base_url="https://api.minimaxapikey.com/v1", api_key="paste-your-key-here")

tools = [{
    "type": "function",
    "function": {
        "name": "read_file",
        "description": "Return the text of a file in the current project.",
        "parameters": {
            "type": "object",
            "properties": {"path": {"type": "string"}},
            "required": ["path"],
        },
    },
}]

messages = [{"role": "user", "content": "Summarise what main.py does."}]

while True:
    resp = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
    msg = resp.choices[0].message
    messages.append(msg)
    if not msg.tool_calls:
        print(msg.content)
        break
    for call in msg.tool_calls:
        args = json.loads(call.function.arguments)
        with open(args["path"], encoding="utf-8") as f:
            result = f.read()
        messages.append({"role": "tool", "tool_call_id": call.id, "content": result})

Tambahkan fungsi tulis dan prompt konfirmasi sebelum dijalankan, dan Anda memiliki inti agen koding dalam sekitar lima puluh baris. Selalu validasi jalur sebelum membaca atau menulis: model dapat meminta jalur apa pun yang diinginkannya.

Batas dan biaya untuk direncanakan

Agen berperilaku berbeda dari orang yang sedang mengobrol. Mereka mengirim serangkaian permintaan, sering kali beberapa secara paralel. Kunci penuh mengizinkan 8 permintaan bersamaan dan 300 permintaan per menit. Kunci uji coba mengizinkan 2 permintaan bersamaan dan 60 per menit, yang bisa ketat untuk agen. Saat Anda melebihi batas, API menjawab dengan HTTP 429 dan kode kesalahan rate_limited atau concurrency. Saat kelebihan beban sementara, API juga mengembalikan 429 dengan Retry-After: 5. Sebagian besar klien yang baik akan mencoba ulang saat 429, tetapi jika milik Anda tidak, turunkan pengaturan paralelismenya. Permintaan streaming memegang slot konkurensinya hingga stream berakhir, sehingga edit streaming panjang dihitung terhadap batas 8.

Dari segi biaya, penagihan adalah bayar sesuai penggunaan dari saldo prabayar pada $0,15 per 1M input token dan $0,50 per 1M output token. Katakanlah sesi mengirim 40 permintaan membawa 30.000 input token masing-masing, dan menerima 1.000 output token masing-masing. Itu adalah 1.200.000 input token, atau $0,18, ditambah 40.000 output token, atau $0,02, total $0,20. Permintaan yang gagal atau ditolak tidak dikenakan biaya, dan saldo tidak pernah kedaluwarsa. Lihat halaman harga untuk jumlah isi ulang dan bonus.

Akun baru dapat mengklaim $0,50 kredit uji coba dengan satu klik di halaman kunci, tanpa kartu, berlaku selama 7 hari. Itu cukup untuk menjalankan uji curl dan beberapa edit Aider kecil. Prompt tidak digunakan untuk pelatihan.

Tanya jawab

Bisakah Anda mengarahkan Claude Code itu sendiri ke API ini?

Tidak secara langsung. Claude Code dirancang untuk format API Anthropic, sedangkan layanan ini mengimplementasikan chat completions bergaya OpenAI. Periksa dokumentasi terbaru Anthropic untuk mengetahui dukungan Claude Code, dan gunakan agen yang kompatibel dengan OpenAI jika Anda ingin menggunakan endpoint ini.

Alat coding mana yang berfungsi dengan base URL OpenAI kustom?

Aider, Continue, dan Cline memungkinkan Anda memasukkan base URL yang kompatibel dengan OpenAI, kunci, dan nama model. Cursor juga menawarkan penggantian base URL untuk model bergaya OpenAI, meskipun Anda harus memeriksa pengaturan dan batas paket saat ini.

Apakah API mendukung pemanggilan fungsi untuk agen?

Ya. Anda dapat mengirim alat dan tool_choice, menerima tool_calls yang di-streaming, dan mengembalikan hasil dengan role tool. Apakah plugin editor tertentu menggunakan bidang-bidang ini bergantung pada plugin tersebut.

Berapa biaya sesi coding?

Harga adalah $0,15 per 1M token input dan $0,50 per 1M token output. Agen mengirim ulang banyak konteks, sehingga token input biasanya mendominasi tagihan.

Kunci Anda hanya selangkah lagi dari satu formulir

Buat akun, salin kunci, ubah base URL. Itu saja seluruh proses pengaturannya.

Dapatkan kunci API