Kalau kamu menjalankan Codex CLI cukup intens, kamu pasti akan bertemu error 429. Sesi otonom yang panjang, refactor besar, atau agen kedua yang berjalan paralel bisa mendorong satu akun ke batas laju tepat di tengah pekerjaan yang penting. Codex Multi-Auth adalah tool open source yang dibuat untuk momen itu. Ia mengumpulkan beberapa akun ChatGPT di balik proxy loopback untuk Codex CLI resmi, memilih akun paling sehat untuk setiap permintaan, dan beralih otomatis saat satu akun terkena limit, sehingga sesimu terus berjalan alih-alih berhenti pada 429 pertama.
Poin Penting
Codex Multi-Auth adalah pooler akun open source untuk Codex CLI resmi, bukan penggantinya.
Proxy loopback-nya merotasi beberapa akun ChatGPT, menyegarkan token, dan beralih otomatis saat terkena batas laju dalam anggaran retry yang terbatas.
Ia hanya berjalan lewat wrapper-nya (codex-multi-auth-codex atau mcodex) atau ikatan aplikasi desktop opt-in. Ia tidak pernah memasang atau membayangi binary codex biasa.
Kamu butuh Node.js 22.19 atau lebih baru dan Codex CLI resmi di PATH. Akun disimpan secara lokal, dengan file 0600 dan direktori 0700.
Saat artikel ini ditulis, ia punya 560 bintang, 74 fork, dan 2.253 commit, dengan versi 2.24.0 sebagai rilis stabil saat ini.
Rotasi membantu mengatasi limit kuota, tapi tidak membuat akun gabungan kebal aturan. Proyeknya sendiri bilang ia ditujukan untuk penggunaan pengembangan pribadi.
Tonton sinyal repo 30 detiknya
Sebenarnya Apa Itu Codex Multi-Auth
Codex Multi-Auth, buatan ndycode, menggambarkan dirinya sebagai "Codex CLI multi-account OAuth manager with account switching, health checks, runtime rotation, diagnostics, and recovery tools for @openai/codex". Dalam bahasa sederhana, ini adalah pengelola beberapa login ChatGPT yang bisa dipakai Codex CLI, alih-alih terikat pada satu akun sepanjang sesi.
Perbedaan itu penting. Codex CLI resmi, buatan OpenAI, adalah agen coding ringan yang berjalan di terminal, dengan 132.273 bintang saat artikel ini ditulis, dan OpenAI menyarankan masuk dengan akun ChatGPT di paket Plus, Pro, Business, Edu, atau Enterprise, atau memakai API key dengan penyiapan tambahan. Codex Multi-Auth tidak menggantikan semua itu. Ia duduk di depan tool resmi, mengelola akun, dan menyerahkan login yang masih berfungsi untuk setiap permintaan.
Proyek ini bukan barang baru. Repositorinya dibuat pada 2026-02-22, berlisensi MIT, dan punya 73 rilis, yang menunjukkan perawatan yang konsisten, bukan eksperimen satu akhir pekan. Saat artikel ini ditulis, ia punya 560 bintang dan 74 fork, jadi ini tool niche dengan basis pengguna nyata, bukan utilitas arus utama.
Cara Kerja Proxy dan Rotasi
Ide intinya sederhana, dan implementasinya lah yang bernilai. Codex Multi-Auth menjalankan proxy loopback-only, artinya proxy hanya mendengarkan di mesinmu sendiri, bukan di jaringan. Saat kamu menjalankan Codex lewat wrapper, permintaan melewati proxy itu, yang memilih akun dari pool-mu.
Langkah | Yang terjadi |
|---|---|
Pilih | Proxy memilih akun paling sehat untuk permintaan, secara default |
Segarkan | Ia menyegarkan token sesuai kebutuhan, supaya login yang kedaluwarsa tidak mematikan sesi |
Beralih | Saat terkena batas laju, ia pindah ke akun lain di pool |
Batas | Retry tetap dalam anggaran retry yang terbatas, jadi tidak berputar selamanya |
Periksa ulang | Blok batas laju lokal berlaku paling lama 1 jam sebelum memeriksa ulang ke upstream |
Dua detail patut dicatat. Pertama, tool ini juga punya fallback Luna Reserve yang aktif setelah 429 kuota Luna yang asli, sebagai jaring pengaman kedua saat pool utama habis. Kedua, rotasi hanya bekerja di dalam wrapper atau ikatan aplikasi desktop opt-in. Kalau kamu menjalankan codex biasa secara langsung, kamu mendapat Codex satu akun yang biasa, tanpa disentuh. Pengekangan itu adalah fitur: tool ini tidak pernah memasang atau membayangi binary codex, jadi menghapusnya tidak mengganggu penyiapan normalmu.
Tool ini hadir dengan 31 subcommand dan 4 binary: codex-multi-auth, codex-ma, wrapper codex-multi-auth-codex, dan launcher mcodex. Permukaan perintah itu mencakup manajemen akun, pemeriksaan kesehatan, diagnostik, dan pemulihan, bukan cuma proxy-nya. Kalau satu akun berhenti bekerja, kamu bisa mendiagnosisnya alih-alih menebak login mana yang rusak.
Kenapa Error 429 Tidak Selalu Berarti "Kuota Habis"
Menggoda untuk membaca setiap 429 sebagai "akun ini sudah habis dipakai", tapi kenyataannya lebih rumit, dan itu penting untuk memahami apa yang bisa dan tidak bisa diperbaiki rotasi. OpenAI menjelaskan bahwa 429 berarti batas laju terlampaui, dan limit ada untuk mencegah penyalahgunaan, memastikan akses yang adil, dan mengelola beban agregat. Contoh kerjanya menunjukkan limit terkait Codex sebesar 20 permintaan per menit yang terlampaui pada 24 per menit. Itu pembatasan laju, bukan banned.
Laporan nyata dari Oktober 2026 membuat nuansa ini konkret. Dalam issue openai/codex 55964, yang diterbitkan 2026-10-21, pengguna Codex CLI 0.146.0 dengan autentikasi akun ChatGPT berulang kali terkena error 429 dengan kode turn_rate_limit_exceeded dan pesan "Codex is at capacity, please try again later", dengan Retry-After 152 detik, padahal pemeriksaan penggunaan akunnya tidak menunjukkan kuota yang habis. Permintaan kecil ke model lain berhasil. Dengan kata lain, limit kapasitas dan limit khusus model bisa memicu 429 bahkan saat kuotamu terlihat cukup, dan berotasi ke akun lain pada model yang sama-sama kelebihan beban mungkin tidak membantu sebanyak ganti model atau menunggu.
Itulah bingkai yang jujur untuk tool ini. Rotasi adalah jawaban yang kuat untuk limit kuota per akun, dan jawaban parsial untuk limit kapasitas. Ia menjaga sesi tetap bergerak saat satu akun dibatasi, tapi tidak bisa menciptakan kapasitas yang tidak ada.
Yang Kamu Butuhkan untuk Menjalankannya
Penyiapannya mudah kalau kamu sudah memakai Codex CLI, dan sengaja dibuat lokal. Tidak ada bagian pool yang butuh server jarak jauh.
Kebutuhan | Detail |
|---|---|
Node.js | Versi 22.19 atau lebih baru |
Codex CLI | CLI resmi terpasang dan ada di PATH |
Akun | Beberapa akun ChatGPT, masing-masing login lewat tool ini |
Penyimpanan | Lokal saja, di ~/.codex/multi-auth, file 0600, direktori 0700 |
Titik masuk | Jalankan lewat codex-multi-auth-codex atau mcodex, bukan codex biasa |
Detail penyimpanan lokal ini layak dijeda sejenak. Tool apa pun yang memegang token OAuth untuk beberapa akun adalah target bernilai tinggi, dan izin file proyek ini (0600 untuk file, 0700 untuk direktori) adalah baseline yang tepat. Ekosistem yang lebih luas menunjukkan kenapa kehati-hatian itu bukan teori. Aikido Security melaporkan pada Mei 2026 bahwa sebuah paket yang tidak terkait diam-diam mengirim seluruh ~/.codex/auth.json pada setiap pemanggilan, termasuk refresh token yang tidak kedaluwarsa. Paket itu bukan Codex Multi-Auth, dan tidak ada dalam laporan itu yang mengaitkannya, tapi pelajarannya bisa dipindahkan: pasang paket yang persis dari repo resmi, periksa apa yang kamu jalankan, dan jangan pernah menempel token ke tool yang mirip.
Baseline Manual yang Digantikannya
Sebelum tool seperti ini, solusi untuk banyak akun Codex dilakukan manual, dan itu merepotkan. Sanghun Kang menggambarkan polanya pada Oktober 2026: alias seperti CODEX_HOME="$HOME/.codex2" codex, hanya memisahkan auth.json dan membuat symlink untuk sisanya supaya riwayat, memori, dan skill tetap dibagikan sementara hanya login yang berbeda. Post yang sama memperingatkan bahwa pemakaian bersamaan bisa terkena penanganan kunci SQLite Codex dan menyebabkan kegagalan startup atau macet sementara, dan penulisnya berpindah akun saat satu akun kehabisan penggunaan, bukan menjalankan keduanya sekaligus.
Codex Multi-Auth menghilangkan perpindahan manual itu. Proxy memutuskan, per permintaan, akun mana yang sehat, dan failover terjadi tanpa kamu berhenti, mengedit alias, dan memulai ulang. Untuk alur kerja berat atau agen otonom yang berjalan berjam-jam, perbedaan itu adalah inti persoalannya: sesi bertahan melewati limit, bukan menunggu manusia menyadarinya.
Tool pembanding, panduan Codex Multi-Account dari shunt, menunjukkan pola yang sama dari sudut lain: ia mencatat jendela penggunaan backend 5 jam dan 7 hari lalu berotasi secara proaktif dari akun yang mendekati kuota, dengan failover berbasis cooldown sebagai pengaman. Rotasi yang sadar kuota menjadi pola yang mapan, bukan hack sekali pakai, dan Codex Multi-Auth adalah versi open source yang paling lengkap dari pola itu pada skala ini.
Peringatan Aturan yang Tidak Boleh Dilewatkan
Rotasi adalah solusi teknis, dan ketentuan layanan adalah persoalan terpisah. Bagian ketentuan Codex Multi-Auth sendiri bilang ia "intended for personal development use", bahwa ia adalah "an independent open-source project, not an official OpenAI product", dan bahwa "you are responsible for your own usage and policy compliance", ditambah bahwa untuk beban kerja produksi atau komersial kamu sebaiknya memakai OpenAI Platform API.
Tulisan independen tentang poin yang sama lebih blak-blakan. Manifest for Devs menulis pada Juli 2026 bahwa langganan ChatGPT strictly personal, satu langganan untuk satu pengguna, dan berbagi melanggar ketentuan, termasuk "account pooling and account rotation, where several people share the same credentials to dodge rate limits". Post yang sama berargumen bahwa otomatisasi seperti runner CI dan scheduler sebaiknya berjalan dengan harga per token, bukan langganan, karena begitu sebuah sistem memanggil API sementara kamu tidak terlibat, penggunaannya berhenti bersifat personal.
Baca keduanya bersamaan dan garisnya jelas. Menggabungkan akunmu sendiri untuk pekerjaan pengembangan pribadimu adalah kasus penggunaan yang dideskripsikan proyek ini. Membagikan satu akun ke banyak orang, atau menjalankan beban kerja produksi tanpa pengawasan di atas langganan, adalah klaim yang berbeda, dan rotasi tidak membuatnya kebal aturan. Kalau beban kerjamu komersial atau tanpa pengawasan, Platform API adalah jalur yang ditunjuk proyek ini sendiri.
Siapa yang Cocok Mencobanya, dan Siapa yang Sebaiknya Menunggu
Codex Multi-Auth paling masuk akal untuk developer yang sudah menjalankan sesi Codex berat dan sudah memegang lebih dari satu akun ChatGPT. Kalau kamu menjalankan sesi agen otonom yang panjang, agen paralel, atau refactor berturut-turut, dan 429 rutin mengganggumu, pool dengan failover otomatis mudah dibenarkan untuk dicoba.
Ia juga cocok kalau kamu menyukai keamanan desainnya: penyimpanan lokal saja, proxy loopback, tidak membayangi binary resmi, dan anggaran retry terbatas yang menghentikan tool berputar selamanya pada akun yang rusak.
Kamu mungkin sebaiknya menunggu, atau menjaga ekspektasi tetap rendah, kalau kamu hanya memakai Codex sesekali, kalau kamu punya satu akun, atau kalau beban kerjamu komersial. Dengan satu akun tidak ada yang bisa dirotasi, dan dengan beban kerja komersial Platform API adalah jawaban yang jujur, bukan pool langganan. Dan seperti tool apa pun yang memegang token OAuth, coba di mesin yang kamu kontrol, pasang dari repo resmi, dan periksa apa yang disimpannya sebelum menyerahkan beberapa login.
Kalau kamu bekerja di dunia coding otonom yang sama, situs ini punya spotlight terkait tentang tool yang membangun dan menguji aplikasi Xcode untukmu: AgentSwift: Agen Coding AI Open Source yang Membangun dan Menguji Aplikasi Xcode untuk Kamu. Memasangkan tool yang menjaga agenmu tetap berjalan dengan tool yang memeriksa apa yang dibangunnya adalah kombinasi yang masuk akal.
Pertanyaan yang Sering Diajukan
Apakah Codex Multi-Auth tool resmi OpenAI?
Tidak. Ini proyek open source independen, berlisensi MIT, dan bukan produk resmi OpenAI. Ia membungkus Codex CLI resmi tanpa memodifikasi binary-nya.
Apakah ia menggantikan Codex CLI?
Tidak. Kamu tetap butuh Codex CLI resmi terpasang dan ada di PATH. Codex Multi-Auth mengelola akun dan mengarahkan permintaan lewat proxy-nya; CLI resmi yang melakukan pekerjaan coding yang sebenarnya.
Apa yang terjadi saat semua akun di pool terkena limit?
Failover berhenti membantu begitu pool habis. Retry tetap dalam anggaran terbatas, blok lokal diperiksa ulang setelah paling lama 1 jam, dan fallback Luna Reserve mencakup 429 kuota Luna yang asli. Di luar itu, kamu menunggu kuota reset, sama seperti dengan satu akun.
Apakah aman menyerahkan beberapa login ChatGPT kepadanya?
Ia menyimpan akun secara lokal di ~/.codex/multi-auth dengan file 0600 dan direktori 0700, dan proxy-nya loopback-only. Itu baseline yang sehat, tapi tool pemegang kredensial apa pun layak diperlakukan hati-hati: pasang dari repo resmi, verifikasi paketnya, dan simpan di mesin yang kamu kontrol.
Apakah rotasi akun bisa mengakali ketentuan OpenAI?
Tidak, dan proyek ini tidak mengklaim demikian. Ia bilang ditujukan untuk penggunaan pengembangan pribadi dan kamu bertanggung jawab atas kepatuhan kebijakan. Berbagi akun ke banyak orang atau menjalankan beban kerja produksi di atas langganan adalah persoalan berbeda, dan proyek ini mengarahkan pengguna komersial ke Platform API.