Catatan penulis: OpenCode 2.2.3 menambahkan provider Claude Agent. Artikel ini menjelaskan perbedaannya dengan plugin OAuth yang dihapus pada Maret, menyajikan 3 langkah integrasi, dan merangkum 5 batasannya untuk membantu kamu memutuskan apakah perlu menggunakannya.
Pada 30 Oktober, OpenCode merilis versi 2.2.3 dengan provider bawaan Claude Agent. Cara menggunakannya: instal Claude Code di komputer, jalankan claude auth login sekali, lalu pilih Claude Agent di menu /connect OpenCode. Setelah itu, kamu bisa menjalankan model Claude dengan langganan Claude milikmu sendiri. Hingga 31 Oktober, pengumuman resmi @opencode telah dilihat sekitar 510 ribu kali.
Ini bukan mekanisme OAuth yang dihapus pada Maret. Solusi baru ini menggunakan binary resmi Claude Code dan Claude Agent SDK. OpenCode tidak membaca atau menyimpan kredensial login kamu; permintaan ke model dikirim oleh proses claude di komputer lokal. Pihak OpenCode menyatakan telah mendapat izin dari Anthropic, tetapi Anthropic belum merilis pengumuman tersendiri.
Pengembang Chen Cheng (@chenchengpro) menguraikan cara kerjanya: saat dijalankan, sistem mengatur tools: [] dan settingSources: [], lalu hanya mengizinkan alat mcp__opencode__*. Karena handler MCP tidak bisa mendapatkan tool_use_id, pencatatannya harus dilakukan satu per satu melalui hook PreToolUse. Akibatnya, pembacaan file secara paralel berubah menjadi serial. System prompt yang dipakai masih bawaan Claude Code. Menurutnya, “hasilnya pasti tidak sebaik menggunakan Claude Code secara langsung”. Artikel ini membahas 3 langkah integrasi, 5 batasan, dan pilihan yang sesuai untuk 3 tipe pengguna.
Keterangan: Artikel ini disusun berdasarkan catatan rilis OpenCode, dokumen desain PR #58782, dokumentasi resmi Claude Code, dan masukan komunitas. Belum ada pengujian end-to-end yang dilakukan.
Menggunakan langganan Claude di OpenCode: kesimpulannya
Singkatnya: bisa, tetapi bukan dengan cara lama, dan ada komprominya.
- Syarat: OpenCode V2 versi 2.2.3 atau lebih baru; Claude Code terpasang di mesin yang sama dan sudah login menggunakan
claude auth login. - Cara kerjanya: OpenCode menggunakan Claude Agent SDK untuk memanggil proses
claudedi mesin lokal. OpenCode tidak mengimplementasikan OAuth sendiri, serta tidak membaca atau menyimpan token. - Komprominya: pemanggilan tool berjalan secara serial; banyak fitur Claude Code tidak tersedia; dan hanya bisa dijalankan di mesin lokal, bukan di lingkungan hosted atau remote.
Soal “gratis”, ada yang perlu diluruskan. Claude versi gratis tidak menyertakan Claude Code, jadi cara ini tidak bisa digunakan. Kamu memerlukan paket Pro, Max, Ultra, Team, atau Enterprise, atau akun Console. Ini juga bukan berarti tanpa biaya: pemakaian tetap mengurangi kuota 5 jam dan kuota mingguan langgananmu. OpenCode hanya menampilkan $0 karena biayanya sudah tercakup dalam langganan.
Kalau kamu belum punya langganan, atau tim membutuhkan satu akses bersama, kamu bisa menggunakan API dengan pembayaran sesuai pemakaian. Misalnya, panggil model Claude melalui APIYI apiyi.com menggunakan antarmuka yang kompatibel dengan OpenAI. Cara ini tidak terikat pada mesin lokal dan tidak dibatasi oleh kuota langganan.
Mengapa langganan Claude di OpenCode dihapus pada Maret lalu kembali pada Oktober
Ada empat peristiwa penting sepanjang 2026:
- 9 Januari: Anthropic memperketat pembatasan terhadap harness pihak ketiga. Pada hari yang sama, issue #7410《Broken Claude Max》muncul di OpenCode setelah pengguna melaporkan Claude Max tiba-tiba mengalami error.
- 20 Februari: Media internasional melaporkan bahwa Anthropic mengubah ketentuannya untuk melarang penggunaan token OAuth di produk lain, termasuk produk yang dibangun dengan Agent SDK.
- 19 Maret: OpenCode menggabungkan PR #18186《anthropic legal requests》, menghapus plugin bawaan
opencode-anthropic-auth, dan menghapus anthropic dari daftar penyedia. - 30 Oktober: OpenCode 2.2.3 kembali menghadirkan Claude Agent. Versi 2.2.4 yang dirilis pada hari yang sama menambahkan konfigurasi terpandu.
Titik baliknya terlihat dalam teks ketentuan Anthropic. Arsip Wayback halaman kepatuhan hukum Anthropic pada 21 Februari masih menyatakan bahwa penggunaan token OAuth Free, Pro, atau Max di produk, alat, atau layanan lain apa pun, termasuk Agent SDK, melanggar Consumer ToS. Dalam arsip 30 September, kalimat itu sudah dihapus dan ada pengecualian baru: pengguna akhir boleh masuk dengan langganan mereka di binari Claude Code yang tidak dimodifikasi, termasuk ketika platform meng-host Claude Code. Halaman pada Oktober masih memuat pengecualian tersebut.
Claude Agent di OpenCode dirancang mengikuti pengecualian ini. Di kolom komentar PR #58782, seseorang bertanya apakah pengguna bisa diblokir. Penulis PR, Tarquinen, menjawab bahwa mereka sudah mendapat izin dari Anthropic dan implementasinya sepenuhnya sesuai dengan ToS. Anggota OpenCode Daniel Smolsky juga menulis “We got permission” di X. Namun, hingga 31 Oktober, tidak ditemukan pengumuman tersendiri dari Anthropic terkait hal ini. Jadi, klaim “sudah mendapat izin” saat ini masih berasal dari pihak OpenCode saja.
| Aspek | Plugin OAuth sebelum Maret | Claude Agent pada Oktober |
|---|---|---|
| Cara masuk | OpenCode menjalankan OAuth claude.ai sendiri untuk mendapatkan token | Pengguna menjalankan claude auth login di Claude Code pada perangkat lokal |
| Pihak yang mengirim permintaan | OpenCode langsung memanggil Anthropic API | Proses claude lokal mengirim permintaan melalui Agent SDK |
| Membaca atau menyimpan token | Plugin menyimpan token OAuth | Tidak membaca atau menyimpan token; /connect hanya mencatat metode yang dipilih |
| Sikap Anthropic | Ketentuan Februari melarangnya secara eksplisit, plugin dihapus pada Maret | OpenCode mengklaim sudah mendapat izin, ketentuan September menambahkan pengecualian, tetapi tidak ada pengumuman tersendiri |
| Risiko | Ada risiko akun diblokir dan plugin dihapus | Lebih rendah dibandingkan Maret, tetapi kebijakan bisa berubah lagi |
Risikonya tetap perlu dipahami. Ketentuan yang berlaku memberi Anthropic hak untuk “melakukan penegakan tanpa pemberitahuan terlebih dahulu”, dan masih melarang pihak ketiga mengumpulkan, menyimpan, atau meneruskan kredensial Claude. Jadi, perhatikan dua hal saat menghubungkannya: jangan memasang plugin OAuth versi lama yang beredar di internet, dan jangan menyerahkan akun untuk dijalankan di platform milik orang lain.
Cara kerja OpenCode Claude Agent: alur dan alasan eksekusi serial
Alur lengkapnya adalah: OpenCode → Claude Agent SDK → claude lokal → Anthropic. OpenCode tidak berada di antara Claude Code dan Anthropic, dan tidak mengubah permintaan. Secara default, executable claude dicari di PATH, tetapi lokasinya juga bisa ditentukan lewat variabel lingkungan OPENCODE_CLAUDE_PATH.
Saat dimulai, banyak fitur Claude Code dinonaktifkan atau diganti. Secara ringkas: “tiga dinonaktifkan, satu diganti, satu dijalankan secara serial”:
- Menonaktifkan tool bawaan: dengan mengatur
tools: [], semua tool baca-tulis dan Bash bawaan Claude Code tidak digunakan. - Menonaktifkan konfigurasi pengguna: dengan mengatur
settingSources: [],~/.claudedan.claudedi proyek tidak dibaca. CLAUDE.md, hooks, skills, dan MCP servers juga tidak dimuat. - Hanya mengizinkan tool OpenCode: hanya tool dengan prefiks
mcp__opencode__*yang diizinkan. Jika Claude memanggil tool dengan nama lain, Claude akan menerimaNo such tool available, dan OpenCode tidak akan menjalankan pemanggilan tersebut. - Mengganti implementasi tool: OpenCode menjadikan tool-nya sendiri sebagai MCP server di dalam proses. Saat dijalankan, tool menggunakan pop-up izin milik OpenCode. System prompt tetap menggunakan bawaan Claude Code, ditambah keterangan bahwa Claude sedang berjalan di opencode, lalu dilengkapi dengan agent prompt yang dipilih dan AGENTS.md.
- Menjalankan tool secara serial: tool handler OpenCode tidak bisa mengakses
tool_use_idmilik Claude secara langsung. ID tersebut harus dicatat terlebih dahulu oleh hookPreToolUsesebelum bisa diambil. Hook hanya bisa mencatat satu ID dalam satu waktu, sehingga tool tidak bisa ditandai untuk berjalan secara paralel. Claude yang biasanya membaca beberapa file secara bersamaan kini harus membacanya satu per satu.
OpenCode punya alasan untuk memilih desain ini. Apa pun model yang menghasilkan konten, format riwayat sesi tetap sama, sehingga tidak kacau saat berpindah model. Selain itu, hanya ada satu sistem izin untuk semuanya. Konsekuensinya, cukup banyak kemampuan asli Claude Code yang harus dilepas. Menurut Chen Cheng, “Dengan semua perubahan ini, rasanya hasilnya pasti tidak sebagus langsung memakai Claude Code.” Hal ini perlu dipertimbangkan sebelum memutuskan untuk mengintegrasikannya.
Ada beberapa detail operasional lain: setiap sesi menjalankan satu proses claude jangka panjang yang berhenti setelah tidak aktif selama 5 menit dan berjalan kembali saat pesan berikutnya tiba. Permintaan yang gagal dicoba ulang oleh Claude Code sendiri; OpenCode tidak melakukan percobaan ulang tambahan.
Hubungkan Langganan Claude ke OpenCode dalam 3 Langkah
Sebelum mulai, pastikan 5 syarat berikut terpenuhi:
- OpenCode yang digunakan adalah V2 versi 2.2.3 atau lebih baru, bukan V1.
- Claude Code sudah terpasang di komputer lokal.
- Akun Claude menggunakan paket berbayar, atau merupakan akun Console.
- OpenCode dan Claude Code berada di komputer yang sama.
- Lingkungan yang digunakan bukan hosted OpenCode atau remote workspace.
Perintah instalasi V2 adalah curl -fsSL https://opencode.ai/v2/install | bash. Kamu juga bisa mengunduh versi desktop.
Langkah 1: Instal Claude Code
Yang akan terlihat: Jalankan claude --version di terminal. Jika muncul pesan bahwa perintah tidak ditemukan, berarti Claude Code belum terpasang.
Yang perlu dilakukan: Di macOS dan Linux, gunakan skrip resmi install.sh. Di Windows, jalankan install.ps1 resmi di PowerShell. Jika sudah terpasang tetapi versinya lama, jalankan claude update untuk memperbaruinya.
Cara memastikan berhasil: claude --version menampilkan nomor versi.
Langkah 2: Masuk ke akun Claude
Yang akan terlihat: Setelah menjalankan claude auth login, browser akan membuka halaman login resmi Anthropic.
Yang perlu dilakukan: Masuk menggunakan akun Claude berbayar, lalu jalankan claude auth status untuk memeriksa statusnya.
Cara memastikan berhasil: Metode autentikasi yang ditampilkan adalah login langganan, bukan api_key atau none.
Ada hal yang perlu diperhatikan: jika ANTHROPIC_API_KEY diatur di shell, Claude Code mungkin memprioritaskan kunci API sehingga biaya dihitung berdasarkan pemakaian. Sebelum masuk, jalankan unset ANTHROPIC_API_KEY. Jika Claude Code bertanya apakah kamu ingin menggunakan kunci tersebut, pilih untuk menolak.
Langkah 3: Hubungkan Claude Agent di OpenCode
Yang akan terlihat: Ketik /connect di OpenCode untuk menampilkan daftar penyedia.
Yang perlu dilakukan: Pilih Claude Agent, bukan “Anthropic”. Lalu gunakan /models untuk memilih model Claude. Versi 2.2.4 dan yang lebih baru menyediakan panduan untuk menyalin perintah login, memeriksa instalasi, dan memverifikasi koneksi sebelum masuk ke pemilihan model. Jika lebih terbiasa menggunakan baris perintah, kamu juga bisa menjalankan opencode auth login untuk melakukan hal yang sama.
Cara memastikan berhasil: Kamu bisa memilih model Claude dari daftar, menerima balasan saat mengirim petunjuk uji coba, dan melihat pop-up izin OpenCode muncul dengan normal saat alat digunakan.
Daftar pemecahan masalah
- Claude Agent tidak ada dalam daftar: Jalankan
opencode --versionuntuk memeriksa versi. Jika lebih rendah dari 2.2.3, perbarui dan pastikan yang terpasang adalah V2. - Muncul pesan bahwa claude tidak ditemukan: Periksa
PATH, atau gunakanOPENCODE_CLAUDE_PATHuntuk menentukan jalur absolut keclaude. - Terus kembali ke halaman login: Beberapa pengguna awal melaporkan koneksi terputus setelah satu atau dua kali tersambung, lalu kembali ke halaman login saat mencoba menyambungkan ulang. Komunitas masih memperbaikinya. Sementara itu, jalankan kembali
claude auth logindi terminal, lalu kembali ke/connect. - Muncul pesan plan limit tercapai: Kuota langganan untuk 5 jam atau mingguan sudah habis. Kamu perlu menunggu hingga batasnya direset.
- Tidak bisa terhubung dari lingkungan jarak jauh: Penggunaan ini memang tidak didukung; koneksi hanya bisa digunakan di komputer lokal.
Perlu diingat juga, dokumentasi penyedia OpenCode V1 masih memuat peringatan lama bahwa “Anthropic melarang Pro/Max”. Peringatan itu berlaku sebelum Maret. Jangan mencari Claude Agent melalui /connect di V1 karena fitur ini hanya tersedia di V2.
5 keterbatasan menggunakan langganan Claude di OpenCode
| Keterbatasan | Dampaknya | Paling berdampak pada |
|---|---|---|
| Eksekusi alat berurutan | Hook hanya mencatat satu tool_use_id setiap kali, sehingga pembacaan file paralel berubah menjadi satu per satu |
Repositori besar, refactoring lintas banyak file |
| Prompt bukan milik OpenCode | Menggunakan system prompt Claude Code; prompt bawaan OpenCode tidak berlaku | Pengguna yang bergantung pada perilaku agent bawaan OpenCode |
| Fitur Claude Code tidak tersedia | Tidak ada /usage, auto mode, memory, cloud sessions, agent teams, dan sebagainya |
Pengguna intensif Claude Code |
| Hanya di mesin lokal | Hosted dan remote tidak didukung; claude harus berada di mesin yang sama |
Pengembangan di cloud, tim jarak jauh, CI |
| Parameter dan plugin terbatas | Parameter seperti temperature, top-p, seed, dan stop tidak didukung; hook http.request tidak berjalan |
Pengguna yang perlu mengatur parameter secara detail atau memakai gateway |
Eksekusi alat berurutan: Dampaknya mungkin tidak terlalu terasa pada proyek kecil. Namun, jika satu tugas perlu memindai puluhan file, waktu tunggunya akan jauh lebih lama. Jika sering melakukan refactoring berskala besar, pertimbangkan tambahan waktu ini.
Prompt bukan milik OpenCode: Prompt agent kustom tetap berlaku, tetapi prompt dasar yang digunakan berasal dari Claude Code. Jika sudah terbiasa dengan perilaku agent bawaan OpenCode, kamu mungkin akan merasakan perubahan gaya model setelah beralih.
Fitur tidak tersedia: Ini keterbatasan yang paling berdampak. Dokumen desain mencantumkan fitur yang tersedia di Claude Code tetapi tidak tersedia di OpenCode, termasuk auto mode, ultracode, auto memory, away summaries, cloud sessions, /teleport, agent teams, /loop, computer use, sandboxed Bash, notebook editing, serta skills bawaan seperti /simplify dan /verify.
Hanya di mesin lokal: Proses Claude akan berhenti setelah tidak aktif selama 5 menit, lalu berjalan kembali saat pesan berikutnya dikirim. Cara ini tidak bisa digunakan di CI atau mesin pengembangan jarak jauh.
Parameter dan plugin terbatas: Semua parameter sampling tidak didukung. Base URL dan headers hanya bisa dibaca dari file konfigurasi; plugin tidak bisa mengubahnya untuk setiap permintaan. Hook http.request dan http.response juga tidak berjalan karena permintaan dikirim oleh Claude Code.
Ada beberapa hal lain yang perlu diperhatikan soal pemakaian: kamu tidak bisa melihat /usage Claude di OpenCode; proses tidak akan berlanjut secara otomatis setelah mencapai batas; dan kamu juga tidak bisa membeli kuota tambahan di sini. /usage milik OpenCode menampilkan pemakaian OpenCode Console, bukan kuota langganan Claude kamu. Ada juga klaim bahwa pengguna claude -p dan SDK mendapat kuota langganan lebih sedikit dibandingkan penggunaan Claude Code secara biasa. Namun, dokumen desain menyatakan klaim itu “belum diverifikasi”, jadi belum bisa dianggap sebagai fakta.
Singkatnya: jika kamu membutuhkan auto mode, memory, cloud sessions, agent teams, computer use, atau notebook editing, gunakan Claude Code secara langsung. Solusi ini baru layak dipakai jika kamu membutuhkan model Claude dengan sistem alat dan izin OpenCode, serta bisa menerima eksekusi alat secara berurutan.
Menggunakan langganan Claude di OpenCode: siapa yang cocok, siapa yang tidak
Secara garis besar, ada tiga kelompok pengguna:
- Sudah menggunakan OpenCode 2.x, punya langganan Claude, dan hanya menulis kode di komputer lokal: layak dicoba. Anda bisa beralih antara Claude dan model lain dalam satu harness, tanpa membayar API secara terpisah.
- Hanya menggunakan Claude Code: tidak perlu repot. Gunakan Claude Code langsung—fiturnya lebih lengkap, alatnya bisa berjalan paralel, dan petunjuknya juga versi asli.
- Tim, CI, pengembangan jarak jauh, atau pengguna yang bergantung pada auto mode, memory, dan panel kuota: sebaiknya jangan gunakan cara ini. Solusi ini hanya bisa berjalan di komputer lokal, beberapa fiturnya tidak tersedia, dan tagihannya kurang transparan. Kunci API atau APIYI apiyi.com dengan pembayaran sesuai pemakaian lebih cocok.
| Opsi | Harga (per 27 Oktober) | Cocok untuk |
|---|---|---|
| Claude Pro | $20/bulan | Penggunaan ringan individu, dengan batas penggunaan per 5 jam dan per minggu |
| Claude Max / Ultra | $100 / $200 per bulan | Pengguna individu dengan penggunaan intensif |
| Klien OpenCode | Gratis dan open source | Semua orang |
| OpenCode Go (opsional) | $10/bulan | Pengguna yang membutuhkan model yang di-host oleh OpenCode; bukan syarat untuk menggunakan Claude Agent |
| APIYI Claude Opus 5.5 | Input $4 / output $20 | Penggunaan bersama dalam tim, CI, dan kebutuhan tagihan yang jelas |
| APIYI Claude Sonnet 5.5 / Haiku 5.5 | $2/$10, $0,1/$0,5 | Penulisan kode sehari-hari dan tugas batch |
Harga APIYI dalam tabel berlaku per satu juta token. Pembacaan cache dikenakan biaya terpisah.
💰 Saran untuk pembayaran sesuai pemakaian: Jika tidak punya langganan, perlu penggunaan bersama dalam tim, atau ingin menghitung setiap biaya dengan jelas, Anda bisa menggunakan APIYI apiyi.com. Layanan ini menyediakan endpoint
messages(format asli Anthropic) dan endpointchat(format kompatibel OpenAI). Isi base_url denganhttps://api.apiyi.com/v1. Lihat daftar model di platform untuk model dan harga terbaru.
Pertanyaan Umum FAQ
Q1: Apakah menggunakan langganan Claude di OpenCode bisa membuat akun diblokir?
Risikonya lebih rendah dibandingkan pada bulan Maret: metode baru menggunakan binari resmi, OpenCode tidak membaca token, dan sesuai dengan pengecualian yang ditambahkan ke ketentuan pada bulan September. Namun, klaim “sudah mendapat izin” berasal dari OpenCode; Anthropic tidak mengumumkannya secara terpisah dan tetap berhak melakukan penegakan aturan tanpa pemberitahuan terlebih dahulu. Jangan gunakan plugin OAuth lama.
Q2: Mengapa Claude Agent tidak ditemukan di /connect?
Biasanya masalahnya ada pada versi: versinya masih di bawah 2.2.3 atau masih menggunakan V1. Setelah memperbarui ke versi V2 terbaru, cari “Claude Agent” di `/connect`, bukan “Anthropic”.
Q3: OpenCode menampilkan biaya $0. Apakah benar gratis?
Tidak. Biaya $0 ditampilkan karena sudah tercakup dalam langganan, tetapi penggunaan tetap mengurangi kuota 5 jam dan kuota mingguan langganan. Jika menggunakan kunci API, OpenCode akan menampilkan biaya berdasarkan harga di models.dev.
Q4: Apakah bisa digunakan di mesin pengembangan jarak jauh atau cloud?
Tidak. `claude` harus terpasang di mesin yang sama dengan OpenCode; workspace hosted maupun remote tidak didukung. Untuk penggunaan di cloud atau CI, sebaiknya gunakan kunci API atau panggil model sesuai pemakaian melalui APIYI apiyi.com.
Q5: Bagaimana memilih antara akses lewat langganan dan kunci API?
Akses lewat langganan cocok untuk penggunaan pribadi di mesin lokal, asalkan Anda sudah membayar langganannya. Kunci API tidak terikat pada mesin, bisa digunakan bersama oleh beberapa orang, memiliki tagihan yang jelas, dan tidak dibatasi oleh kuota langganan. Jika ingin membandingkan Claude dengan model lain, Anda bisa beralih model untuk pengujian hanya dengan satu kunci di APIYI apiyi.com.
Q6: Apakah Claude versi gratis bisa digunakan?
Tidak. Versi gratis tidak menyertakan Claude Code. Anda memerlukan setidaknya paket Pro atau akun Team, Enterprise, atau Console.
Ringkasan: Langganan Claude di OpenCode dalam 3 kalimat
Bisa digunakan: OpenCode versi 2.2.3 ke atas memanggil claude yang terpasang secara lokal melalui Agent SDK resmi. OpenCode menyatakan sudah mendapat izin dari Anthropic, tetapi kebijakan masih bisa berubah. Cara menghubungkannya: Instal Claude Code, jalankan claude auth login, lalu pilih Claude Agent di /connect. Kapan sebaiknya tidak digunakan: Jika membutuhkan alat paralel, fitur lengkap Claude Code, atau penggunaan jarak jauh maupun bersama tim, gunakan Claude Code secara langsung atau panggil Claude melalui APIYI apiyi.com dengan biaya sesuai pemakaian.
Penulis: Tim Teknis APIYI
Diskusi teknis: Untuk pertanyaan tentang integrasi model Claude, hubungi kami melalui halaman utama APIYI apiyi.com. Dokumentasi selengkapnya tersedia di docs.apiyi.com.
