Catatan penulis: Codex dan WorkBuddy bukan klien yang dirancang khusus untuk Claude, sehingga hampir semua error muncul di lapisan integrasi. Artikel ini membagi error menjadi tiga kategori—endpoint, siklus tool, dan blok pemikiran—serta mencocokkan pesan error dengan cara memperbaikinya.
Kami sendiri pernah mengalami masalah ini. Awalnya, demi praktis, kami menggunakan protokol yang kompatibel dengan OpenAI untuk memanggil Claude, seolah-olah Claude adalah model OpenAI. Percakapan sederhana berjalan lancar, tetapi begitu tool dipanggil, muncul error yang tidak hilang meski dicoba ulang. Barulah setelah protokol diganti kembali ke /v1/messages bawaan Anthropic, semuanya berjalan lancar.
Pertama, periksa apakah Anda mengalami masalah yang sama: Codex langsung menampilkan error terkait wire_api saat dijalankan, WorkBuddy bisa mengobrol normal tetapi mengembalikan error 400 saat memanggil tool, atau isi respons tiba-tiba kosong. Jika ya, kemungkinan besar inilah masalah yang dibahas dalam artikel ini.
- Modelnya sendiri tidak bermasalah. Ada tiga ketidakcocokan di lapisan integrasi: endpoint, siklus tool, dan blok pemikiran.
- Kategori ke-3 (blok pemikiran dan anggaran output) paling mudah diperbaiki: cukup ubah cara klien membaca respons dan nilai
max_tokens. - Kategori ke-2 (siklus tool) memiliki tingkat kesulitan sedang dan umumnya diperbaiki melalui lapisan penerjemah atau gateway.
- Kategori ke-1 (endpoint) paling sulit: Anda harus mengganti klien atau menambahkan gateway penerjemah.
Kesimpulan artikel ini, dari pilihan terbaik hingga terakhir, adalah: protokol Anthropic bawaan > gateway yang menerjemahkan ke anthropic > chat yang kompatibel dengan OpenAI. Untuk memulai, gunakan tabel di bawah untuk memastikan kategori error yang Anda alami.
Tiga penyebab utama error saat menggunakan Claude di Codex atau WorkBuddy
Mari pahami beberapa istilah terlebih dahulu. Responses, Messages, dan Chat Completions bisa dianggap sebagai tiga cara memesan makanan: hidangan yang disiapkan dapur sama, tetapi format menunya berbeda. Codex hanya bisa memesan lewat Responses, sedangkan Claude hanya menerima Messages dan Chat Completions. Blok thinking ibarat kertas coretan model; Anthropic memeriksa apakah coretan ini telah diubah.
| Kategori | Mekanisme singkat | Pihak yang terutama memperbaiki | Tingkat kesulitan |
|---|---|---|---|
| Kategori 1: Endpoint tidak cocok | Codex hanya mengirim Responses, sedangkan Claude tidak menerima format tersebut | Ganti alat atau gateway | Paling sulit |
| Kategori 2: Pertukaran data alat tidak cocok | ID, blok konten, atau blok thinking berubah selama proses penerjemahan | Terutama gateway | Sedang |
| Kategori 3: Blok thinking dan anggaran tidak cocok | Model selalu melakukan proses berpikir, tetapi klien masih membaca hasil dengan cara lama | Klien | Paling mudah |
Kategori 1: Endpoint tidak cocok saat Codex memanggil Claude
Pesan error: Error loading config.toml: wire_api = "chat" is no longer supported. How to fix: set wire_api = "responses".
Artinya, konfigurasi wire_api = "chat" sudah tidak didukung dan perlu diubah menjadi responses.
Penyebabnya: Menurut referensi konfigurasi resmi Codex, wire_api sekarang hanya menerima nilai responses. Cara lama yang mengubah wire_api menjadi chat sebagai solusi cadangan sudah tidak berlaku. Codex versi terbaru akan langsung menampilkan error saat memuat konfigurasi. Bahkan jika provider tersebut tidak digunakan, codex login status pun tidak bisa dijalankan. Di sisi lain, model Claude di APIYI apiyi.com hanya menyediakan endpoint anthropic dan openai, tanpa /v1/responses. Format kedua sisi tidak cocok dan tidak ada penerjemah di antaranya, sehingga error tidak terhindarkan.
Cara memperbaiki:
1. Klien: Buka ~/.codex/config.toml, lalu hapus konfigurasi chat yang tersisa sesuai petunjuk error agar Codex bisa dijalankan terlebih dahulu.
2. Ganti alat: Jika hanya ingin menggunakan Claude untuk menulis kode, langsung gunakan Claude Code yang memakai Messages native.
3. Gateway: Jika harus tetap menggunakan Codex, tambahkan gateway yang dapat menerjemahkan Responses menjadi Messages. Untuk alamat provider, utamakan endpoint native Anthropic.
Kriteria keberhasilan: codex login status berjalan normal; saat menggunakan gateway, berikan instruksi yang mengharuskan Codex membaca file dan pastikan Codex berhasil menyelesaikan satu pemanggilan alat.
Kategori 2: Pertukaran pemanggilan tool Claude tidak cocok
Seperti apa pesan error-nya:
– tool_use ids were found without tool_result blocks immediately after
– An assistant message with 'tool_calls' must be followed by tool messages...
– thinking or redacted_thinking blocks in the latest assistant message cannot be modified
– Invalid signature in thinking block. The block is bound to a different conversation.
Pesan pertama berarti ada tool_use yang tidak langsung diikuti tool_result yang sesuai. Pesan kedua adalah masalah serupa dalam format Chat. Pesan ketiga berarti blok thinking dari putaran sebelumnya telah diubah. Pesan keempat berarti signature blok thinking tidak cocok dengan sesi saat ini.
Mengapa terjadi: Lapisan kompatibilitas harus menerjemahkan blok konten Claude seperti text, tool_use, tool_result, dan thinking satu per satu menjadi tool_calls dan role: tool, lalu menerjemahkannya kembali. Jika ID tidak cocok, blok konten digabungkan, atau blok thinking dipindahkan, proses ini akan menghasilkan error 400. Responses memiliki role developer, sedangkan Messages tidak, sehingga konten developer perlu digabungkan ke system. Selain itu, claude-opus-5-5 tidak menerima pola lama berikut: memaksa tool_choice (any atau tool tertentu), mengisi pesan assistant di awal (prefill), dan menggunakan temperature / top_p / top_k.
Cara memperbaikinya:
1. Gateway: Pastikan setiap tool_use langsung diikuti tool_result dengan ID yang sama, dan letakkan tool_result di bagian paling depan blok konten pesan user.
2. Gateway: Kirim kembali pesan assistant dari putaran sebelumnya tanpa perubahan, termasuk blok dengan field thinking yang kosong; gabungkan konten developer ke system.
3. Klien: Gunakan hanya auto atau none untuk tool_choice, lalu hapus prefill dan parameter sampling.
4. Klien: Jika error signature sudah muncul, langsung mulai sesi baru. Menurut FAQ resmi APIYI, error ini terkadang ditampilkan sebagai Request rejected (429), tetapi penyebabnya bukan pembatasan laju, jadi mencoba ulang dengan jeda bertahap tidak akan membantu.
5. Ganti tool: Jika harness memaksa tool_choice dan Anda tidak bisa mengubahnya, ganti klien.
Untuk menelusuri error 400 serupa, lihat Error 400 tool use concurrency pada Claude Code. Artikel tersebut menjelaskan cara menemukan penyebab kegagalan pencocokan tool_use dan tool_result satu per satu.
Kriteria keberhasilan: Beberapa putaran pemanggilan tool berturut-turut (membaca file, mengubah file, lalu membacanya lagi) tidak lagi menghasilkan error 400, dan tidak ada lagi error signature dalam sesi yang sama.
Kategori 3: Blok thinking Claude dan anggaran output tidak sesuai
Seperti apa error-nya: "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior. Bisa juga muncul "thinking.type.disabled" is not supported for this model. Dalam beberapa kasus, tidak ada error, tetapi respons kosong atau terpotong.
Penyebabnya: claude-opus-5-5 melakukan proses berpikir pada setiap permintaan, sehingga respons bisa diawali dengan blok thinking. Jika klien membaca content[0].text berdasarkan posisi, hasilnya akan kosong. Token thinking ditagih sebagai output dan juga menghabiskan max_tokens. Mulai generasi ini, narasi di antara pemanggilan tool juga dimasukkan ke blok thinking. Karena display secara default adalah omitted, narasi tersebut terlihat kosong.
Cara memperbaikinya:
1. Klien: Hilangkan parameter thinking atau gunakan thinking: {"type": "adaptive"}, lalu hapus budget_tokens.
2. Klien: Gunakan output_config.effort untuk mengatur kedalaman berpikir. Pilihannya adalah low / medium / high / xhigh / max, dengan medium sebagai default.
3. Klien: Saat membaca respons, cari blok text berdasarkan type, bukan berdasarkan posisi.
4. Klien: Pastikan max_tokens cukup untuk proses berpikir sekaligus isi respons. Jika ingin melihat narasinya, atur thinking.display menjadi summarized.
Untuk memahami mekanisme baru ini lebih lanjut, baca Penjelasan Adaptive Thinking. Artikel tersebut menjelaskan cara beralih dari budget_tokens ke tingkat effort.
Kriteria keberhasilan: Kirim petunjuk yang sama beberapa kali berturut-turut. Isi respons harus selalu ada, dan error terkait thinking.type tidak lagi muncul.
Tabel referensi cepat pesan error Claude
| Kata kunci pesan error | Kategori | Pemeriksaan mandiri dalam 5 menit | Jika masih error, baca |
|---|---|---|---|
wire_api = "chat" is no longer supported |
Kategori 1 | Periksa apakah masih ada konfigurasi chat di config.toml | Tutorial Magpie |
tool_use ids were found without tool_result |
Kategori 2 | Periksa ID dan posisi tool_result | Error 400 Claude Code: konkurensi tool use |
must be followed by tool messages |
Kategori 2 | Pastikan apakah permintaan melewati lapisan kompatibilitas Chat | Error 400 Claude Code: konkurensi tool use |
Invalid signature in thinking block |
Kategori 2 | Mulai sesi baru dan coba lagi | Memahami Adaptive Thinking |
thinking.type.enabled / respons kosong |
Kategori 3 | Hapus budget_tokens, lalu baca berdasarkan type | Memahami Adaptive Thinking |
| Percakapan sederhana berhasil, tetapi muncul error saat memanggil tool | Kategori 2 | Periksa protokol integrasi WorkBuddy | Apakah WorkBuddy mendukung pemanggilan dengan format native Claude? |
Dua cara mengatasi error saat Codex dan WorkBuddy memanggil Claude
| Cara | Cocok untuk | Prioritas protokol |
|---|---|---|
| A Kembali ke klien native | Hanya ingin memakai Claude untuk menulis kode | Tertinggi, tanpa kehilangan akibat penerjemahan protokol |
| B Tambahkan gateway penerjemah | Harus tetap memakai Codex atau WorkBuddy | Berikutnya, isi alamat penyedia dengan alamat Anthropic |
| Tetap memakai chat kompatibel dalam jangka panjang | Tidak disarankan | Terendah, pemanggilan tool dan blok thinking rentan bermasalah |
Cara A: Jika ingin memakai Claude di Codex, beralihlah ke Claude Code. Konfigurasi model resmi WorkBuddy hanya menyediakan /chat/completions dan sakelar «protokol kustom», tanpa opsi Anthropic native. Jadi, jangan berharap mendapatkan thinking native di WorkBuddy. Lihat Apakah WorkBuddy mendukung pemanggilan format native Claude? untuk penjelasan tentang mengapa «percakapan berhasil, tetapi tool mengalami error» dan cara mengatasinya.
Untuk mengonfigurasi koneksi langsung di WorkBuddy, buka «Pengaturan → Model → Kustom». Isi Base URL dengan https://api.apiyi.com/v1, nama model dengan claude-opus-5-5, dan Key dengan token yang dibuat di halaman token APIYI apiyi.com. Tulis URL hanya sampai /v1; jangan tambahkan /chat/completions sendiri.
Keterangan: Periksa apakah URL hanya sampai /v1, nama modelnya claude-opus-5-5, dan sakelar «protokol kustom» tetap nonaktif.
Cara B: Saat menambahkan gateway ke Codex, biarkan wire_api = "responses" di Codex tetap seperti semula. Gateway akan menerjemahkan permintaan ke format Messages sebelum meneruskannya. Arahkan URL model kustom WorkBuddy ke gateway lokal, lalu isi alamat penyedia untuk model Claude dengan endpoint Anthropic native https://api.apiyi.com.
🎯 Saran teknis: Satu Key bisa digunakan untuk menguji endpoint Messages native dan chat kompatibel sekaligus. Sebaiknya gunakan kuota uji di APIYI apiyi.com untuk membandingkan hasil pemanggilan tool pada kedua protokol sebelum menentukan cara yang dipilih.
Menghubungkan Claude ke Codex dan WorkBuddy dengan Magpie
Magpie adalah tool sumber terbuka dari komunitas dengan lisensi MIT. Tool ini menjalankan gateway lokal di 127.0.0.1:3425 yang bisa menerjemahkan protokol antara OpenAI Chat, Responses, dan Anthropic Messages, sehingga menutup celah pada jenis pertama. Selain konfigurasi manual, Magpie juga bisa diatur melalui antarmuka visual. Isi API Key dan Base URL di antarmuka grafis, lalu hubungkan Codex dan WorkBuddy ke gateway yang sama tanpa perlu mengedit file konfigurasi. Langkah lengkapnya ada di tutorial Magpie, yang menjelaskan cara menyatukan sumber model untuk beberapa Agent melalui satu gateway.
- Halaman penyedia: Tambahkan Key. APIYI ada di grup «Proksi», atau klik «+ Penyedia Kustom» untuk mengisinya secara manual.
- Halaman Agent: Pilih claude-opus-5-5 untuk masing-masing Codex dan WorkBuddy.
- Mulai sesi baru; jangan gunakan riwayat dari sesi lama.
Keterangan: Periksa apakah penyedia ditampilkan sebagai tersedia di grup «Proksi», Base URL menggunakan alamat Anthropic native, dan kedua sakelar di halaman Agent sudah aktif.
Harga Pemanggilan Claude dan Biaya Cache
Harga berikut dalam dolar AS per juta token, diperiksa pada 2026-10-28. Daftar model dan harga mengacu pada daftar model di platform:
| Model | Input | Output | Pembacaan cache | Platform yang tersedia |
|---|---|---|---|---|
| claude-opus-5-5 | $4 | $20 | $0.2 | APIYI apiyi.com |
| claude-sonnet-5-5 | $2 | $10 | $0.1 | APIYI apiyi.com |
| claude-haiku-5-5 | $0.1 | $0.5 | $0.01 | APIYI apiyi.com |
Agent mengirim ulang seluruh riwayat pada setiap putaran, dan token pemikiran claude-opus-5-5 dikenai tarif output. Jika lapisan penerjemah mengubah urutan system, tools, atau prefiks, titik pemisah cache_control tidak lagi berfungsi, sehingga biaya dan latensi sama-sama meningkat. Jika tingkat hit cache tidak normal, lihat Tingkat Hit Cache Claude Turun ke 0 (diagnostics) untuk mengetahui cara mencari penyebab titik pemisah tidak berfungsi.
Risiko dan Pemblokiran Akun Ditanggung Sendiri
Gateway seperti Magpie adalah alat sumber terbuka dari komunitas, bukan komponen resmi APIYI. Kami tidak memberikan dukungan atau jaminan atas alat tersebut. Meneruskan permintaan melalui alat seperti ini dapat menyebabkan layanan tujuan membatasi permintaan atau bahkan memblokir akun. Segala konsekuensinya menjadi tanggung jawab pengguna. Sebaiknya uji seluruh alur terlebih dahulu dengan akun uji. Setelah dipastikan tidak ada masalah, barulah pertimbangkan untuk menggunakannya pada akun produksi.
Dalam Situasi Ini, Tak Perlu Repot
Kalau kamu hanya sesekali memakai Claude di Codex, lingkungan perusahaan tidak mengizinkan pemasangan perangkat lunak tambahan, atau kamu memang hanya perlu menjalankan Claude, tidak perlu menyiapkan gateway. Lebih praktis langsung ganti klien ke Claude Code, atau gunakan model yang mendukung Responses secara native di Codex.
Pertanyaan Umum FAQ
Q1: Apakah Codex secara resmi mendukung Claude?
Tidak. Codex hanya menggunakan Responses, sedangkan Claude tidak menyediakan endpoint tersebut. Jadi, keduanya harus dihubungkan melalui lapisan penerjemah protokol.
Q2: Apakah Claude di APIYI bisa menggunakan /v1/responses?
Tidak. Model Claude di APIYI apiyi.com hanya menyediakan dua jenis endpoint: anthropic dan openai.
Q3: Apakah error 429 berarti terkena pembatasan laju?
Jika pesan error berisi `Invalid signature in thinking block`, penyebabnya bukan pembatasan laju, melainkan kegagalan validasi tanda tangan blok pemikiran. Cukup mulai sesi baru.
Q4: Apakah WorkBuddy bisa menggunakan protokol native Anthropic?
Konfigurasi resminya tidak menyediakan opsi native Anthropic. Kamu harus menggunakan jalur yang kompatibel dengan OpenAI atau melakukan konversi melalui gateway.
Q5: Bagaimana cara cepat memastikan masalahnya sudah teratasi?
Gunakan kuota uji APIYI apiyi.com untuk membuka sesi baru, jalankan beberapa putaran pemanggilan alat secara berurutan, lalu pastikan isi respons tidak kosong.
Daftar Periksa Error Claude di Codex dan WorkBuddy
- Konfigurasi Codex sudah tidak menggunakan format chat.
- Permintaan Claude menggunakan protokol native atau gateway yang menerjemahkannya ke protokol Anthropic, bukan kompatibilitas chat.
- Setiap
tool_uselangsung diikuti olehtool_resultdengan ID yang sama. - Blok
thinkingdari putaran sebelumnya dikirim kembali apa adanya, tanpa perubahan. - Tidak menggunakan
tool_choiceyang dipaksakan, prefill, atau parameter sampling. - Respons dibaca berdasarkan
type, danmax_tokenssudah menyediakan ruang untuk proses berpikir.
Kesimpulan
Error Claude di Codex dan WorkBuddy umumnya berkaitan dengan tiga hal: endpoint, pertukaran tool, dan blok thinking. Urutan perbaikannya: ubah dulu cara klien membaca respons, lalu perbaiki lapisan penerjemahan. Jika masih bermasalah, pertimbangkan mengganti klien atau menambahkan gateway.
Untuk protokol, gunakan Anthropic native jika tersedia. Jika tidak, gunakan gateway yang menerjemahkan permintaan ke protokol Anthropic. Hindari mengandalkan kompatibilitas chat dalam jangka panjang. Kamu bisa menggunakan APIYI apiyi.com untuk membandingkan hasil berbagai protokol dengan kunci API yang sama.
📚 Referensi
- Referensi konfigurasi Codex: penjelasan nilai
wire_api - Tautan:
developers.openai.com/codex/config-reference - Keterangan: Memastikan bahwa
wire_apisaat ini hanya mendukungresponses - Contoh kesalahan pemuatan konfigurasi Codex
- Tautan:
github.com/openai/codex/issues/41816 - Keterangan: Sumber pesan kesalahan asli
wire_api - Panduan migrasi Claude Opus 5.5
- Tautan:
platform.claude.com/docs/en/models/opus-5-5/migration-guide - Keterangan: Batasan wajib untuk
thinking,tool_choice, dan parameter sampling - Pemecahan masalah pemanggilan tool Anthropic
- Tautan:
platform.claude.com/docs/en/agents-and-tools/tool-use/troubleshooting-tool-use - Keterangan: Aturan pemasangan
tool_usedantool_result - Konfigurasi model WorkBuddy
- Tautan:
www.workbuddy.ai/docs/zh/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model - Keterangan: Tempat mengakses pengaturan model kustom dan tombol pengaturan protokol kustom
- Repositori Magpie
- Tautan:
github.com/yetone/magpie - Keterangan: Gateway sumber terbuka dari komunitas; evaluasi risikonya sebelum digunakan
Penulis: Tim Teknis APIYI
Diskusi teknis: Hubungi kami melalui beranda APIYI di apiyi.com. Untuk informasi lebih lanjut, kunjungi pusat dokumentasi di docs.apiyi.com
