ID ▾
API kompatibel OpenAI, alternatif untuk Claude Codehttps://api.claudecodeapikey.com/v1
Dapatkan kunci API

BerandaPanduan

Endpoint Kustom API Claude Code untuk Cursor

Mencari API claude code untuk penyiapan cursor yang tidak bergantung pada satu vendor? Cursor dapat berbicara dengan endpoint yang kompatibel dengan OpenAI, dan panduan ini menunjukkan setiap pengaturan yang Anda butuhkan.

Diperbarui

Ilustrasi isometrik editor kode yang terhubung ke server API, menunjukkan penyiapan endpoint kustom

Yang sedang Anda siapkan

Cursor adalah editor dengan fitur AI bawaan. Di antara pengaturan modelnya ada bidang yang memungkinkan Anda mengganti URL dasar OpenAI dengan milik Anda sendiri, bersama dengan tempat untuk memasukkan kunci Anda sendiri. Itu memungkinkan pengiriman permintaan obrolan ke layanan apa pun yang mengikuti format chat-completions OpenAI. Layanan ini melakukannya, sehingga Cursor dapat menggunakannya sebagai model di balik obrolan dan edit inline.

Nilai yang akan Anda masukkan adalah tetap. URL Dasar: https://api.claudecodeapikey.com/v1. Nama model: uncensored. Kunci: yang berasal dari akun Anda, dikirim sebagai token Bearer. Tidak ada yang perlu dikonfigurasi di sisi server.

Pahami dengan jelas apa ini. Model di balik endpoint adalah model open-weight dari penyedia independen. Ini bukan model Claude dan bukan API resmi Anthropic atau pihak lain. Jika Anda datang ke sini dengan harapan Claude itu sendiri di dalam Cursor, ini adalah hal yang berbeda, dan bagian penutup menjelaskan cara menilai apakah ini cukup baik untuk pekerjaan Anda.

Sebelum Anda membuka Cursor

Siapkan ini terlebih dahulu, agar Anda tidak berhenti di tengah jalan.

  1. Buat akun dengan Google atau dengan email dan kata sandi.
  2. Buka halaman kunci API dan buat kunci. panduan kunci menunjukkan di mana setiap tombol berada.
  3. Klaim kredit uji coba $0,50 jika Anda ingin menguji tanpa membayar. Ini satu klik, tidak perlu kartu, dan berlaku selama 7 hari.
  4. Jalankan pemeriksaan cepat dari terminal untuk mengonfirmasi bahwa kunci berfungsi sebelum menyalahkan editor.
curl https://api.claudecodeapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say ready."}]}'

Balasan JSON dengan pesan berarti kunci dan URL baik. HTTP 401 berarti kunci salah atau memiliki spasi tak sengaja. Perbaiki itu di sini, karena pesan kesalahan Cursor kurang spesifik dibandingkan curl.

Konfigurasi langkah demi langkah di Cursor

Nama menu berubah antar versi Cursor, jadi perlakukan label di bawah ini sebagai panduan dan cari kecocokan terdekat.

  1. Buka pengaturan Cursor dan buka bagian model.
  2. Temukan bidang untuk kunci API OpenAI dan tempel kunci Anda dari layanan ini.
  3. Aktifkan opsi untuk mengganti URL dasar OpenAI, dan masukkan https://api.claudecodeapikey.com/v1. Sertakan /v1 di akhir dan biarkan jalur akhir seperti /chat/completions tidak disertakan.
  4. Gunakan opsi untuk menambahkan model kustom, dan ketik uncensored persis, huruf kecil semua.
  5. Tekan tombol verifikasi atau simpan di samping bidang kunci. Cursor mengirim permintaan uji kecil.
  6. Buka panel chat, pilih uncensored di dropdown model, dan kirim prompt pendek.

Jika langkah verifikasi gagal tetapi pemeriksaan curl berhasil, periksa apakah Anda telah memasukkan URL ke dalam bidang URL dasar dan bukan ke dalam bidang kunci, serta apakah versi Cursor Anda telah mengatur ulang override setelah pembaruan. quickstart mempertahankan langkah-langkah saat ini untuk editor ini.

Satu detail yang layak diketahui: satu override berlaku untuk slot penyedia OpenAI. Jika Anda juga menggunakan model OpenAI asli melalui slot itu, mereka sekarang akan dialihkan ke endpoint ini juga. Banyak orang menyimpan profil Cursor terpisah atau mematikan override ketika mereka ingin beralih kembali.

Uji dengan prompt coding nyata

Sapaan membuktikan sedikit. Gunakan prompt yang melatih konteks dan instruksi. Pilih fungsi di proyek Anda, buka chat, dan minta sesuatu yang konkret, seperti menambahkan validasi input dan unit test. Perhatikan tiga hal.

  • Streaming. Jawaban harus muncul token demi token. Endpoint melakukan streaming melalui SSE, sehingga waktu tunggu yang lama diikuti oleh blok teks menunjukkan proxy atau pengaturan sedang bufferingnya.
  • Penggunaan konteks. Lampirkan dua atau tiga file dan ajukan pertanyaan yang membutuhkan semuanya. Jendela konteks adalah 100.000 token, yang menampung banyak sumber, tetapi editor Anda memutuskan berapa banyak yang sebenarnya dikirim.
  • Kepatuhan pada instruksi. Minta balasan hanya diff atau format output ketat dan lihat apakah model mematuhinya. Model open-weight berbeda di sini, dan Anda ingin mempelajarinya pada hari pertama.

Simpan daftar pendek lima tugas nyata dari repositori Anda sendiri, dan jalankan ulang setiap kali Anda mengubah pengaturan seperti suhu. Menilai dari kode Anda sendiri mengalahkan klaim umum apa pun, termasuk milik kami.

Memperbaiki kesalahan umum

401 atau kunci tidak valid

Kunci salah, kedaluwarsa dari clipboard Anda, atau memiliki spasi di sekitarnya. Tempelkan lagi. Pastikan skema Authorization adalah Bearer, yang dilakukan Cursor untuk Anda ketika Anda menggunakan bidang kunci OpenAI.

404 atau model tidak ditemukan

Hampir selalu masalah URL dasar. /v1 yang hilang atau /chat/completions tambahan merusak jalur. Nama model juga harus uncensored, tanpa huruf kapital atau spasi.

429 dengan rate_limited atau concurrency

Anda mencapai batas. Kunci uji coba memungkinkan 2 permintaan konkuren dan 60 per menit, dan kunci penuh memungkinkan 8 konkuren dan 300 per menit. Editor dapat memicu beberapa permintaan sekaligus, misalnya obrolan plus edit latar belakang, dan streaming memegang slotnya hingga berakhir. Kode kesalahan memberi tahu Anda batas mana: rate_limited adalah permintaan per menit, concurrency adalah terlalu banyak sekaligus. Beban berlebih sementara juga mengembalikan 429 dengan Retry-After: 5, sehingga menunggu lima detik dan mencoba lagi adalah benar.

Jawaban terpotong

Jendela konteks adalah 100.000 token, prompt plus penyelesaian. Lampiran yang sangat besar meninggalkan sedikit ruang untuk balasan. Kirim lebih sedikit file, atau mulai obrolan baru.

Fitur yang tidak melakukan apa-apa

API hanya teks, dan tidak menawarkan embedding. Jika fitur Cursor membutuhkan model embedding atau input gambar, fitur itu tidak akan berfungsi melalui endpoint ini.

Pengaturan yang layak disesuaikan setelah berhasil

Setelah chat sukses pertama, beberapa penyesuaian membuat penggunaan harian lebih lancar.

Turunkan suhu untuk tugas pengeditan. Jika editor Anda menampilkannya, nilai sekitar 0,2 memberikan kode yang lebih stabil. Untuk brainstorming, naikkan. Selanjutnya, perhatikan berapa banyak konteks yang Anda lampirkan. Jendela konteksnya luas, tetapi setiap file yang dilampirkan ditagih sebagai input, sehingga menutup tab yang tidak terkait dan mengecualikan folder build menjaga biaya tetap rendah dan jawaban lebih fokus.

Jika Anda menggunakan mode agen atau multi-langkah, ingat dukungan pemanggilan fungsi: endpoint menerima tools dan tool_choice dan melakukan streaming tool_calls. Apakah fitur Cursor tertentu menggunakannya bergantung pada versi, jadi jalankan satu tugas agen kecil dan baca apa yang terjadi sebelum mempercayainya dengan perubahan besar. Terakhir, lihat header X-Balance-USD dalam pengujian terminal sesekali, sehingga saldo rendah tidak mengejutkan Anda di tengah pekerjaan.

Menggunakan kunci yang sama dalam skrip

Salah satu keuntungan dari endpoint OpenAI-compatible adalah kunci yang Anda atur di Cursor juga berfungsi dalam kode. Berikut contoh Node, berguna untuk skrip build atau alat pesan commit.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.claudecodeapikey.com/v1",
  apiKey: process.env.API_KEY,
});

const out = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "user", content: "Write a conventional commit message for: fixed null check in parser" },
  ],
});

console.log(out.choices[0].message.content);

Simpan kunci dalam variabel lingkungan, bukan dalam file yang Anda commit. Setiap respons menyertakan header X-Balance-USD, sehingga skrip dapat memperingatkan Anda ketika kredit hampir habis.

Biaya dan kapan sebaiknya tetap dengan pengaturan lama

Penggunaan editor sangat berat input karena setiap permintaan membawa konteks file. Pada $0,15 per 1M token input dan $0,50 per 1M output, permintaan dengan 15.000 token input dan 1.000 token output berbiaya 0,015 x $0,15 + 0,001 x $0,50 = $0,00225 + $0,0005 = $0,00275. Seratus dari itu adalah $0,275. halaman harga memiliki jumlah isi saldo, mulai dari $20, dengan bonus dari $50.

Pertahankan pengaturan Anda yang ada jika Anda bergantung pada model vendor tertentu untuk refaktor yang rumit, atau jika alur kerja Anda bergantung pada fitur yang tidak dapat diberikan endpoint obrolan biasa. Gunakan ini ketika Anda menginginkan harga per token yang rendah, API yang sederhana, dan lebih sedikit penolakan konten pada pekerjaan yang sah. Banyak pengembang mempertahankan keduanya yang dikonfigurasi dan beralih per tugas.

Tanya jawab

URL dasar apa yang saya masukkan di Cursor?

Masukkan https://api.claudecodeapikey.com/v1 termasuk /v1. Jangan tambahkan /chat/completions di akhir.

Nama model apa yang harus saya tambahkan?

Tambahkan model kustom bernama uncensored, dalam huruf kecil. Itu adalah satu-satunya ID model yang dilayani API.

Apakah ini memberi saya model Claude di Cursor?

Tidak. Endpoint melayani satu model bobot terbuka dari penyedia independen. Ini bukan API resmi dari Anthropic atau vendor lain.

Mengapa saya mendapatkan kesalahan 429 di editor?

Anda melewati batas per menit atau Anda memiliki terlalu banyak permintaan sekaligus. Kunci uji coba memungkinkan 2 permintaan konkuren dan 60 per menit, kunci penuh 8 dan 300.

Bisakah saya mencobanya tanpa membayar?

Ya. Pengguna baru dapat mengklaim $0,50 kredit uji coba di halaman kunci API. Ini tidak memerlukan kartu dan berlaku selama 7 hari.

Kunci Anda hanya selangkah lagi dari satu formulir

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

Dapatkan kunci API