Mesin Anda baik-baik saja. CLI versi terbaru, API key valid, model sedang online. Tapi satu perintah refactor besar berhenti, kursor diam beberapa menit, lalu muncul Request timed out. Yang menyebalkan: lima menit lalu perintah pendek di terminal yang sama jalan tanpa keluhan.
Pola itu hampir selalu menunjuk ke satu tempat yang jarang dibahas panduan resmi — rute jaringan antara terminal Anda dan server API. Saran yang biasa Anda temukan (pangkas konteks, ganti ke model lebih ringan, restart sesi) memang kadang menolong, tapi cuma menutupi gejala. Begitu perintah yang identik berhasil lewat hotspot ponsel dan gagal lewat WiFi kantor, prompt-nya jelas bukan tersangka.
Tiga situasi yang paling sering memicunya
Yang pertama, dan paling lazim, menimpa pengembang yang trafiknya menempuh jalur internasional panjang sebelum sampai ke API. Token balasan harus melewati banyak hop, dan kalau salah satu hop di tengah mulai membuang paket, aliran respons tersendat sampai klien menyerah. Model sebenarnya sudah menjawab. Jawabannya yang tak sanggup pulang.
Situasi kedua khas jaringan kantor dan kampus: koneksi putus di tengah respons, ditandai pesan Partial response received. Penyebabnya bukan model, tapi proxy atau firewall yang menyangga stream lalu menutup koneksi yang dianggapnya menganggur — padahal model cuma sedang berpikir.
Situasi ketiga muncul di eksekusi headless dan pipeline CI. Di sini agent merangkai puluhan pemanggilan tool berturut-turut. Satu pulang-pergi yang macet sudah cukup untuk menyeret seluruh job ke status gagal. Benang merahnya satu: permintaan tak pernah tuntas dengan bersih.
Membaca lapisan jaringan, bukan menebaknya
Bagian ini yang biasanya hilang dari tutorial. Sebelum menyentuh konfigurasi apa pun, ada baiknya memisahkan dua hal yang sering tertukar.
"Timeout beneran" itu beda dengan "sekadar lambat"
Claude Code memberi jendela cukup longgar per permintaan — bawaannya sekitar sepuluh menit. Jadi timeout sejati berarti stream tidak menghasilkan apa pun yang berguna sepanjang rentang itu, bukan sekadar model yang berpikir lama. Mulai dari yang murah: claude --version untuk memastikan CLI mutakhir, lalu /doctor yang menyapu sebagian besar salah konfigurasi sekaligus. Kirim satu prompt sebaris. Kalau permintaan kecil balik instan tapi tugas agent besar tetap mati, jalurnya jelas tersambung — yang lemah adalah daya tahannya menanggung trafik berkepanjangan.
Ukur latensi dan kehilangan paket
Dua alat tua sudah cukup. ping memberi gambaran waktu pulang-pergi dasar ke host API. mtr (atau traceroute) menunjukkan di hop mana paket mulai hilang — dan ini yang paling informatif, karena masalahnya kerap bukan di ujung melainkan di satu titik transit di tengah.
Patokan praktisnya: coding interaktif nyaman di pulang-pergi yang stabil di bawah 150 milidetik dengan kehilangan paket nyaris nol. Lewat 250 milidetik plus loss putus-putus di hop tengah, streaming mulai tersendat dan panggilan panjang rawan timeout. Satu hal yang sering dilupakan — jitter kadang lebih merusak daripada latensi tinggi yang konsisten. Rute yang melompat-lompat antara 80 dan 400 milidetik akan memutus stream dengan cara yang sulit ditebak, jauh lebih menyebalkan ketimbang rute lambat tapi rata.
Tafsirkan "Partial response received"
Pesan ini bukan galat model. Ia memberi tahu Anda bahwa koneksi TLS yang membawa balasan terputus sebelum token terakhir tiba. Tiga hal layak dicek: apakah ada proxy korporat yang duduk di depan trafik, apakah header keep-alive dilucuti di tengah jalan, dan apakah prompt yang sama tuntas mulus saat dijalankan di jaringan lain. Jika ya pada pertanyaan terakhir, koneksi lokal Anda yang bermasalah — bukan Claude.
Pisahkan: lokal, rute, atau hulu
Singkirkan tiap kemungkinan secara berurutan. Halaman status resmi memberi tahu apakah API-nya sendiri sedang turun. Kalau semuanya hijau, kesalahan ada di bawah lapisan aplikasi. Uji ulang lewat hotspot ponsel atau koneksi berbeda — kalau timeout-nya lenyap di sana, rute utama Anda biang keladinya. Inilah lapisan yang ditangani NasaCode: alih-alih membiarkan paket berkelana di rute bawaan yang padat, trafik dikunci ke jalur teroptimasi dengan latensi lebih rata dan kehilangan paket lebih rendah, supaya stream bertahan cukup lama untuk menuntaskan tugas agent yang besar.
Membandingkan beberapa cara menyambung
Tidak semua jalur menuju API setara, terutama untuk trafik streaming yang panjang dan tak boleh putus. Tabel berikut merangkum bedanya.
| Cara menyambung | Ketahanan stream tugas panjang | Pilihan rute | Dukungan klien | Privasi |
|---|---|---|---|---|
| Koneksi langsung bawaan | Sulit ditebak di hop internasional panjang | Bergantung pada ISP | Terminal apa pun | Standar |
| Proxy publik gratis | Kerap reset di tengah | Sedikit, padat, berbagi pakai | Manual dan rapuh | Buram, berisiko untuk API key |
| Tunnel konsumen umum | Sedang, tak disetel untuk streaming | Node wilayah generik | Aplikasi desktop | Bervariasi |
| Rute teroptimasi NasaCode | Latensi rata untuk stream berkelanjutan | Node latensi rendah untuk pengembang | Desktop dan CLI | Tanpa log |
Intinya bukan soal mana yang "paling cepat" di satu uji ping, melainkan mana yang menjaga koneksi tetap hidup dan rata selama tugas berlangsung. Untuk sesi IDE atau agent multi-langkah, konsistensi mengalahkan kecepatan puncak.
Beberapa pertanyaan yang sering muncul
Kalau batas timeout-nya saya naikkan, beres tidak?
Biasanya tidak. Jendela yang lebih panjang cuma menolong saat stream sudah hampir selesai. Kalau paket benar-benar hilang atau koneksi ter-reset, timeout yang lebih besar hanya membuat Anda menunggu lebih lama untuk kegagalan yang persis sama. Perbaiki rutenya dulu, baru sentuh angka timeout.
Mengganti laptop dengan yang lebih kencang membantu?
Tidak. Timeout adalah peristiwa jaringan — byte sedang terbang antara terminal dan API. CPU serta RAM memengaruhi kecepatan tool lokal, bukan apakah balasan sanggup melewati hop yang membuang paket.
Bagaimana memastikan ini gangguan resmi, bukan koneksi saya?
Buka halaman status resmi lebih dulu. Kalau semuanya sehat tapi prompt sederhana pun masih menggantung, masalahnya ada di rute Anda. Mengulang tes di jaringan lain biasanya menjawab keraguan ini dalam waktu kurang dari semenit.
Apa yang membuat sesi agent panjang bertahan tanpa putus?
Jaga beban tiap langkah tetap wajar, itu satu hal. Tapi yang lebih menentukan adalah menjalankannya di rute dengan latensi rata dan loss rendah. Koneksi semacam itulah yang membuat tugas banyak langkah mempertahankan stream-nya dari awal sampai tuntas.
Yang sebaiknya Anda ingat
Timeout di Claude Code hampir selalu masalah rute yang menyamar sebagai masalah aplikasi. Begitu Anda mulai mengukur latensi dan kehilangan paket alih-alih menebak, langkah perbaikannya jadi gamblang — stabilkan jalur, jangan utak-atik prompt.
Kalau rute bawaan Anda memang labil dan tes di jaringan lain membuktikannya, mengalirkan trafik coding lewat jalur yang disetel untuk streaming berkelanjutan adalah cara paling langsung menutup celah itu. NasaCode dibangun persis untuk pekerjaan itu, dan rinciannya bisa Anda telusuri sendiri.
