Cara bermigrasi dari Claude Code ke Codex pada 2026: panduan langkah demi langkah

Dokumentasi Ailoot: API, kunci, dan penyiapan.

Mengapa alat Migrasi Codex diperlukan?#

OpenAI menambahkan fitur ini ke Codex pada awal Juni 2026. Changelog resmi menjelaskannya secara singkat:

Dengan kata lain: saat pertama kali meluncurkan Codex App, atau melalui pengaturan klien yang sudah berjalan, sebuah wizard akan dimulai untuk membaca konfigurasi lokal agen lain. Claude Code dan Claude Cowork saat ini didukung.

Alasan OpenAI melakukannya jelas. Setelah Sites diluncurkan dan Codex App diperbarui pada Mei–Juni 2026, Codex mendapatkan semua hal yang sebelumnya dimiliki Claude Code dan tidak dimiliki OpenAI: terminal, plugin, sesi panjang, dan orkestrasi. Migrasi menghilangkan hambatan terakhir bagi tim yang sudah mengintegrasikan Claude Code ke dalam stack mereka: "pengaturan yang didukung dapat diimpor, lalu diperiksa terhadap inventaris asli."

Alasan Anda mungkin membutuhkannya tidak sesederhana itu. Saya membandingkan keduanya secara langsung dalam panduan Codex vs. Claude Code: Claude masih unggul dalam diskusi arsitektur panjang dan Plan Mode, sedangkan Codex lebih cepat untuk tugas otonom dan PR paralel. Jika Anda sudah memutuskan untuk beralih sepenuhnya, lanjutkan membaca. Jika Anda sedang mempertimbangkan kombinasi, pola kolaborasi mungkin lebih relevan.

Apa yang dipindahkan secara otomatis oleh alat Migrasi?#

Saya akan membahas tiap kelompok dan menjelaskan dengan tepat apa yang terjadi pada setiap bagian ~/.claude.

1. Instruksi dan konteks. Berkas CLAUDE.md—yang global di ~/.claude/ dan berkas proyek di repositori—dikonversi ke format AGENTS.md. Berkas global ditempatkan di ~/.codex/AGENTS.md; berkas proyek tetap berada di root repositori dan folder turunannya. Format AGENTS.md pada dasarnya adalah jenis berkas Markdown yang sama, berisi aturan; perbedaannya sebagian besar kosmetik—nama bagian dan beberapa direktif khusus. Saya menjelaskan apa itu AGENTS.md dan alasan Codex membutuhkannya.

2. Skills. Folder ~/.claude/skills/ dipindai seluruhnya; setiap skill disesuaikan dengan struktur Codex dan ditempatkan di $HOME/.agents/skills. Skill proyek dari .claude/skills/ di repositori dipindahkan ke .agents/skills. Format SKILL.md dengan frontmatter dipindahkan hampir tanpa perubahan. Jika sebuah skill menggunakan pemicu khusus Claude, skill itu ditandai untuk ditinjau.

3. Server MCP. Konfigurasi .mcp.json (baik global maupun tingkat proyek) diimpor ke format Codex. Nama server, perintah peluncuran, dan path dipertahankan. Yang tidak dipindahkan: token dan variabel lingkungan. Demi keamanan, Codex akan meminta kunci API dan kata sandi Anda lagi agar tidak terekspos selama migrasi. Ini tugas sekali saja: buka bagian MCP di Codex App dan masukkan token yang sudah Anda simpan di pengelola kata sandi.

4. Hooks. Inilah kelompok yang rumit. Hooks dengan logika deterministik (memblokir rm -rf, memberi peringatan tentang path yang tampak seperti kredensial, merekam bukti) dipindahkan sepenuhnya. Hooks dengan pemicu yang tidak memiliki padanan di Codex (misalnya, peristiwa siklus hidup Claude Code tertentu) ditandai untuk "manual review" dan tidak diaktifkan secara otomatis. Saya menjelaskan secara terperinci cara kerja hooks di Claude Code, sebagai acuan—Codex memiliki lebih sedikit jenis hook.

5. Riwayat sesi. Aktivitas Claude Code hingga 30 hari terakhir diimpor sebagai referensi. Artinya bukan "melanjutkan tepat dari posisi terakhir Anda," tetapi percakapan terdahulu akan terlihat di Codex sehingga Anda dapat mengingat konteks proyek dengan cepat tanpa menjelaskan semuanya lagi.

Alat Migrasi tidak membedakan berkas aktif dan artefak eksperimen—alat ini memindahkan semua berkas. Setelah migrasi, ada baiknya membersihkan secara manual apa pun yang tidak Anda gunakan selama enam bulan terakhir.

Apa yang TIDAK dipindahkan, dan mengapa?#

Saya akan membahas tiap kelompok dari sudut pandang "apa yang harus dilakukan setelah migrasi."

Token MCP dan kunci API. Ini bagian yang paling mudah diprediksi. Setelah pemindaian, Codex akan menampilkan daftar semua server MCP yang ditemukan di Claude. Codex akan meminta kunci dan token untuk masing-masing server. Cara termudah adalah menyiapkan pengelola kata sandi dan mengisi semua server sekaligus. Setelah itu, MCP bekerja dengan cara yang sama di Codex dan Claude Code. Periksa perintah dan parameter koneksi untuk server MCP yang Anda pilih dengan merujuk dokumentasinya.

Slash command /name. Di Claude Code, Anda terbiasa memanggil skill dengan /skill-name. Di Codex, pemanggilan kanonis berbeda: $skill-name. Kesalahan migrasi yang umum adalah menganggap perintah /name sebagai bukti bahwa skill sudah dimuat.

Setelah migrasi, uji beberapa skill penting dengan $skill-name di Codex. Jika berfungsi, migrasi benar-benar berhasil. Jangan percaya tanda centang "skills migrated" di wizard—pastikan dengan memanggil skill tersebut.

Hooks tanpa padanan di Codex. Jika Anda memiliki hook untuk peristiwa Claude Code tertentu—misalnya, pada pre-tool-use untuk kombinasi alat tertentu—pemicu itu mungkin tidak tersedia di Codex. Alat Migrasi akan menandainya dan membiarkannya tidak aktif. Anda harus memutuskan apakah akan menulis ulang agar sesuai dengan Codex, menghapusnya, atau tetap menggunakannya di Claude Code (jika Anda menjalankan keduanya secara paralel). Aturan praktis yang baik: pindahkan hanya hooks deterministik; hal lainnya menjadi alasan untuk tidak menduplikasi tangga di alat baru.

Alur kerja tim yang dibangun dengan subagen. Saya menjelaskan apa itu subagen di Claude Code dan cara menggunakan subagen bertingkat. Di Codex, subagen diatur melalui profil dan peran (lihat di bawah). Jika Anda memiliki pipeline kompleks dengan beberapa subagen berantai di Claude, Anda harus menulis ulang alur tersebut dengan konsep profil Codex. Alat Migrasi menandai penyiapan semacam itu sebagai "requires architectural rework".

Berkas CLAUDE.md besar yang khusus untuk Claude. Jika sebuah berkas telah berkembang menjadi 2.000–3.000 baris dengan bagian untuk setiap proyek, Codex mungkin menerimanya, tetapi itu pola yang buruk. AGENTS.md dirancang agar ringkas dan tersebar: aturan global di ~/.codex/AGENTS.md, aturan khusus proyek di root repositori, dan penggantian yang lebih sempit di folder turunannya. Setelah migrasi, jangan biarkan CLAUDE.md menjadi "berkas instruksi raksasa"; pecah menjadi beberapa tingkat. Saya menjelaskan cara mengonfigurasi CLAUDE.md dengan benar; pendekatan yang sama berlaku untuk AGENTS.md.

Langkah demi langkah: 4 tindakan di Codex App#

Berikut daftar periksa khususnya.

1. Langkah 1: Perbarui Codex App ke versi 26.608 atau yang lebih baru

   Alat Migrasi muncul pada versi 26.608 (dirilis 9 Juni 2026). Di macOS, buka Codex App dan periksa pembaruan. Lakukan hal yang sama di Windows. Jika Anda menjalankan Codex CLI, pastikan kompatibel dengan App saat ini. Tanpa versi terbaru, "Import other agent setup" tidak akan muncul di Settings.

2. Langkah 2: Mulai impor dari Settings

   Di Codex App, buka Settings dan cari "Import other agent setup." Jika Anda baru memasang Codex App, wizard akan menawarkan migrasi saat onboarding. Setelah dimulai, wizard memindai sistem berkas: ~/.claude/ dan repositori yang berisi CLAUDE.md atau .claude/. Pemindaian berlangsung 30 detik hingga beberapa menit, tergantung jumlah berkas.

3. Langkah 3: Konfirmasikan rencana migrasi

   Setelah pemindaian, Codex akan menampilkan inventaris: jumlah skill yang ditemukan, jumlah server MCP, jumlah berkas CLAUDE.md yang ditemukan, hook yang memenuhi syarat untuk dimigrasikan, dan jumlah hari riwayat sesi yang tersedia. Anda dapat menghapus centang pada kelompok yang tidak ingin dipindahkan. Secara default, semua yang dianggap aman untuk diimpor oleh Codex akan dipilih.

4. Langkah 4: Tunggu hingga selesai dan masukkan token

   Impor memerlukan waktu 1–5 menit. Setelah selesai, Codex akan membuka jendela tindak lanjut: "berikut yang tidak dapat saya pindahkan secara otomatis; periksa secara manual." Biasanya, ini adalah daftar server MCP yang memerlukan token. Buka pengelola kata sandi dan masukkan kunci ke formulir Codex. Setelah itu, bagian utama migrasi selesai.

Selanjutnya, verifikasi hasilnya. Buka proyek yang biasa Anda kerjakan di Claude Code dan periksa:

• cat ~/.codex/AGENTS.md — apakah aturan global Anda ada di sana?
• Jalankan skill apa saja: $skill-name. Skill tersebut seharusnya dimuat.
• Buka .mcp.json di proyek dan periksa apakah server yang diperlukan berjalan.
• Mulai percakapan yang mencerminkan cara kerja Anda biasanya. Codex akan menunjukkan hooks impor yang tidak dapat digunakannya; inilah item inventaris spesifik yang perlu ditangani manual; tidak ada sisa tetap yang dibuktikan.

Hooks dan subagen: padanan di Codex dan apa yang perlu ditulis ulang#

Hooks. Di Claude Code, Anda dapat melampirkan perintah shell ke setiap peristiwa siklus hidup (pre-tool-use, post-tool-use, on-error, on-context-load, dan seterusnya). Codex memiliki rangkaian peristiwa yang lebih kecil: Codex dapat memeriksa sebelum eksekusi, merekam bukti, dan memblokir perintah berbahaya. Jika Anda memiliki hook pre-tool-use yang menyaring kombinasi tertentu, di Codex Anda harus membungkusnya dalam pemeriksaan pra-eksekusi umum atau menghapusnya. Saya menjelaskan arsitektur hooks Claude Code secara terperinci; jika sering menggunakannya, daftarkan setiap pemicu serta efek wajib, identifikasi padanan yang didukung, dan verifikasi sebelum mengaktifkannya.

Subagen. Di Claude Code, subagen adalah konteks terpisah dengan system prompt-nya sendiri, yang diluncurkan melalui /command atau dari percakapan utama. Codex memiliki konsep serupa dalam profil: Anda dapat menentukan profil dengan seperangkat skills, izin, dan kebijakan persetujuan tertentu. Profil menyelesaikan kurang lebih masalah yang sama—mengisolasi konteks untuk kelas tugas tertentu—tetapi melalui pengaturan, bukan pemanggilan agen secara eksplisit.

Apa artinya dalam praktik:

• Jika Anda memiliki subagen "security-reviewer" dengan prompt-nya sendiri, buat profil security-review di Codex dengan izin yang diperlukan dan tingkat penalaran yang lebih tinggi.
• Jika Anda memiliki subagen "feature-developer", itu cukup menjadi profil kerja bawaan; tidak ada hal khusus yang diperlukan.
• Jika Anda menggunakan subagen bertingkat, alur tersebut tidak akan berfungsi satu per satu di Codex; pikirkan ulang dengan rangkaian profil atau skill eksplisit.

Alat Migrasi akan mencoba membuat profil menggunakan nama subagen Anda dan menandai pemicu yang tidak dipindahkan. Pekerjaan yang diperlukan bergantung pada jumlah peran, pemicu, izin, dan dependensi; uji setiap pipeline wajib sebelum menganggapnya termigrasi.

Kapan sebaiknya bermigrasi sepenuhnya dan kapan mempertahankan kedua alat#

Filter keputusan sederhana:

Beralih sepenuhnya ke Codex masuk akal jika:

• Anda terutama mengerjakan PR otonom dan tugas paralel.
• Alur kerja GitHub Anda terintegrasi erat, dan Codex Cloud Agent menangani 80% pekerjaan.
• Anda tidak banyak menghabiskan waktu untuk diskusi arsitektur dan Plan Mode.
• Anda ingin membayar satu alat saja, bukan dua.

Pertahankan Claude Code + Codex bersama-sama jika:

• Anda rutin menggunakan Plan Mode untuk keputusan arsitektur yang panjang.
• Anda membutuhkan pekerjaan paralel: Codex berjalan di cloud untuk satu tugas sementara Claude Code menyimpan konteks untuk tugas lainnya.
• Anda sering membuat peretasan sekali pakai dan proyek mikro yang membuat Plan Mode terasa berlebihan.
• Anda memiliki pipeline subagen kompleks yang tidak dapat ditulis ulang dalam satu malam.

Saya pribadi menggunakan keduanya: Claude Code menyimpan percakapan panjang, sementara Codex mengerjakan "perbaiki N bug secara paralel" atau "tinjau PR." Saya menjelaskan lebih lanjut cara kerjanya dalam panduan menggunakan Claude Code dan Codex bersama.

Hal utama yang ingin saya sampaikan tentang migrasi: alat Migrasi menghilangkan hambatan teknis untuk beralih, tetapi tidak menjawab apakah Anda perlu beralih sejak awal. Tentukan dahulu jenis pekerjaan yang Anda lakukan. Lalu pilih alatnya.

Jika Anda memerlukan akses ke jaringan neural melalui Ailoot, kunjungi Ailoot.