Cara beralih daripada Claude Code kepada Codex pada 2026: panduan langkah demi langkah

Dokumentasi Ailoot: API, kunci dan persediaan.

Mengapa alat Codex Migration diperlukan?#

OpenAI menambah ciri ini pada Codex pada awal Jun 2026. Changelog rasmi menerangkannya secara ringkas:

Dengan kata lain: apabila anda melancarkan Aplikasi Codex buat kali pertama, atau melalui tetapan klien yang sedang berjalan, satu wizard akan dimulakan untuk membaca konfigurasi tempatan ejen lain. Claude Code dan Claude Cowork kini disokong.

Sebab OpenAI melakukan perkara ini jelas. Selepas Sites dilancarkan dan Aplikasi Codex dikemas kini pada Mei–Jun 2026, Codex memperoleh segala-galanya yang sebelum ini menjadi kelebihan Claude Code berbanding OpenAI: terminal, pemalam, sesi panjang dan orkestrasi. Migrasi menghapuskan halangan terakhir bagi pasukan yang telah menyepadukan Claude Code ke dalam susunan teknologi mereka: "tetapan disokong boleh diimport, kemudian diperiksa berbanding inventori asal."

Sebab anda mungkin memerlukannya kurang jelas. Saya membandingkan kedua-duanya secara langsung dalam panduan Codex vs. Claude Code: Claude masih lebih baik untuk perbincangan seni bina yang panjang dan Plan Mode, manakala Codex lebih pantas untuk tugas autonomi dan PR selari. Jika anda sudah memutuskan untuk beralih sepenuhnya, teruskan membaca. Jika anda sedang mempertimbangkan gabungan, corak kerjasama mungkin lebih relevan.

Apakah yang dipindahkan secara automatik oleh alat Migration?#

Saya akan menghuraikan kumpulan-kumpulan ini dan menerangkan dengan tepat perkara yang berlaku kepada setiap bahagian ~/.claude.

1. Arahan dan konteks. Fail CLAUDE.md—fail global dalam ~/.claude/ dan fail projek dalam repositori—ditukar kepada format AGENTS.md. Fail global diletakkan di ~/.codex/AGENTS.md; fail projek kekal di akar repositori dan folder anak. Format AGENTS.md pada asasnya jenis fail Markdown yang sama dengan peraturan; perbezaannya kebanyakannya kosmetik—nama bahagian dan beberapa arahan khusus. Saya telah menerangkan apa itu AGENTS.md dan sebab Codex memerlukannya.

2. Skills. Folder ~/.claude/skills/ diimbas sepenuhnya; setiap skill disesuaikan kepada struktur Codex dan diletakkan dalam $HOME/.agents/skills. Skills projek daripada .claude/skills/ dalam repositori dipindahkan ke .agents/skills. Format SKILL.md dengan frontmatter dipindahkan hampir tanpa perubahan. Jika sesuatu skill menggunakan pencetus khusus Claude, ia ditandakan untuk semakan.

3. Pelayan MCP. Konfigurasi .mcp.json (pada peringkat global dan projek) diimport ke dalam format Codex. Nama pelayan, arahan pelancaran dan laluan dikekalkan. Perkara yang tidak dipindahkan: token dan pemboleh ubah persekitaran. Atas sebab keselamatan, Codex akan meminta anda memasukkan semula kunci API dan kata laluan supaya maklumat tersebut tidak terdedah semasa migrasi. Ini tugas sekali sahaja: buka bahagian MCP dalam Aplikasi Codex dan masukkan token yang sudah anda simpan dalam pengurus kata laluan.

4. Hooks. Inilah kumpulan yang rumit. Hooks dengan logik deterministik (menyekat rm -rf, memberi amaran tentang laluan yang menyerupai kelayakan, merekodkan bukti) dipindahkan sepenuhnya. Hooks dengan pencetus yang tiada padanan dalam Codex (contohnya, peristiwa kitar hayat khusus Claude Code) ditandakan untuk "manual review" dan tidak diaktifkan secara automatik. Saya telah menerangkan secara terperinci cara hooks berfungsi dalam Claude Code, sebagai rujukan—Codex mempunyai lebih sedikit jenis.

5. Sejarah sesi. Sehingga 30 hari terakhir aktiviti Claude Code diimport sebagai rujukan. Ini tidak bermakna "sambung tepat dari tempat anda berhenti," tetapi perbualan terdahulu anda akan kelihatan dalam Codex supaya anda boleh mengingat semula konteks projek dengan cepat tanpa perlu menerangkan semuanya sekali lagi.

Alat Migration tidak membezakan fail aktif dan artifak eksperimen—semuanya dipindahkan. Selepas migrasi, elok anda membersihkan secara manual apa-apa yang tidak digunakan dalam tempoh enam bulan lalu.

Apakah yang TIDAK dipindahkan, dan mengapa?#

Saya akan meneliti setiap kumpulan dari sudut "perkara yang perlu dilakukan selepas migrasi."

Token MCP dan kunci API. Inilah bahagian yang paling mudah dijangka. Selepas imbasan, Codex akan memaparkan senarai semua pelayan MCP yang ditemuinya dalam Claude. Codex akan meminta kunci dan token untuk setiap pelayan. Cara paling mudah ialah menyediakan pengurus kata laluan dan melengkapkan semua pelayan sekali gus. Selepas itu, MCP berfungsi dengan cara yang sama dalam Codex dan Claude Code. Semak arahan dan parameter sambungan untuk pelayan MCP pilihan anda berdasarkan dokumentasinya.

Arahan slash /name. Dalam Claude Code, anda biasa memanggil skill menggunakan /skill-name. Dalam Codex, cara pemanggilan kanonik berbeza: $skill-name. Kesilapan migrasi yang lazim ialah menganggap arahan /name sebagai bukti bahawa skill telah dimuatkan.

Selepas migrasi, uji beberapa skills utama menggunakan $skill-name dalam Codex. Jika berfungsi, migrasi itu benar-benar berjaya. Jangan bergantung pada kotak pilihan "skills migrated" dalam wizard—sahkan dengan memanggilnya.

Hooks tanpa padanan dalam Codex. Jika anda mempunyai hook untuk peristiwa khusus Claude Code—contohnya, pada pre-tool-use untuk gabungan alat tertentu—pencetus itu mungkin tiada dalam Codex. Alat Migration akan menandakannya dan membiarkannya tidak aktif. Anda perlu memutuskan sama ada hendak menulis semula supaya sepadan dengan Codex, menggugurkannya atau mengekalkannya dalam Claude Code (jika anda menjalankan kedua-duanya serentak). Satu kaedah baik: pindahkan hooks deterministik sahaja; perkara lain ialah alasan untuk tidak menggandakan tangga dalam alat baharu.

Aliran kerja pasukan yang dibina menggunakan subagen. Saya telah menerangkan apa itu subagen dalam Claude Code dan cara menggunakan subagen bersarang. Dalam Codex, subagen disusun melalui profil dan peranan (lihat di bawah). Jika anda mempunyai aliran kerja kompleks dengan beberapa subagen yang dirantai dalam Claude, anda perlu menulisnya semula berasaskan konsep profil Codex. Alat Migration menandakan persediaan seperti ini sebagai "requires architectural rework".

Fail CLAUDE.md besar yang khusus untuk Claude. Jika fail telah berkembang sehingga 2,000–3,000 baris dengan bahagian untuk setiap projek, Codex mungkin menerimanya, tetapi itu corak yang tidak baik. AGENTS.md direka bentuk supaya ringkas dan diagihkan: peraturan global dalam ~/.codex/AGENTS.md, peraturan khusus projek di akar repositori dan penggantian yang lebih khusus dalam folder anak. Selepas migrasi, jangan biarkan CLAUDE.md menjadi "fail arahan gergasi"; pecahkannya mengikut peringkat. Saya telah menerangkan cara mengkonfigurasi CLAUDE.md dengan betul; pendekatan yang sama boleh digunakan untuk AGENTS.md.

Langkah demi langkah: 4 tindakan dalam Aplikasi Codex#

Berikut senarai semak khusus.

1. Langkah 1: Kemas kini Aplikasi Codex kepada versi 26.608 atau lebih baharu

   Alat Migration diperkenalkan dalam versi 26.608 (dikeluarkan pada 9 Jun 2026). Pada macOS, buka Aplikasi Codex dan semak kemas kini. Lakukan perkara yang sama pada Windows. Jika anda menjalankan Codex CLI, pastikan ia serasi dengan Aplikasi Codex semasa. Tanpa versi terkini, "Import other agent setup" tidak akan muncul dalam Settings.

2. Langkah 2: Mulakan import daripada Settings

   Dalam Aplikasi Codex, buka Settings dan cari "Import other agent setup." Jika anda baru memasang Aplikasi Codex, wizard akan menawarkan migrasi semasa persediaan awal. Selepas dimulakan, wizard akan mengimbas sistem fail: ~/.claude/ dan repositori yang mengandungi CLAUDE.md atau .claude/. Pengimbasan mengambil masa antara 30 saat hingga beberapa minit, bergantung pada bilangan fail.

3. Langkah 3: Sahkan pelan migrasi

   Selepas imbasan, Codex akan memaparkan inventori: bilangan skills yang ditemui, bilangan pelayan MCP, bilangan fail CLAUDE.md, hooks yang layak untuk migrasi dan jumlah hari sejarah sesi yang tersedia. Anda boleh menyahpilih mana-mana kumpulan yang tidak mahu dipindahkan. Secara lalai, semua yang dianggap selamat untuk diimport oleh Codex dipilih.

4. Langkah 4: Tunggu sehingga selesai dan masukkan token

   Import mengambil masa 1–5 minit. Apabila selesai, Codex akan membuka tetingkap susulan: "here's what I couldn't transfer automatically; check it manually." Biasanya, ini ialah senarai pelayan MCP yang memerlukan token. Buka pengurus kata laluan anda dan masukkan kunci dalam borang Codex. Selepas itu, bahagian utama migrasi selesai.

Seterusnya, sahkan hasilnya. Buka projek yang biasa anda kerjakan dalam Claude Code dan semak:

• cat ~/.codex/AGENTS.md — adakah peraturan global anda ada di situ?
• Jalankan mana-mana skill: $skill-name. Skill itu sepatutnya dimuatkan.
• Buka .mcp.json dalam projek dan semak sama ada pelayan yang diperlukan sedang berjalan.
• Mulakan perbualan yang mencerminkan cara anda biasanya bekerja. Codex akan menunjukkan hooks yang diimport tetapi tidak boleh digunakan; ini item inventori khusus yang perlu dikendalikan secara manual; tiada baki tetap dibuktikan.

Hooks dan subagen: padanan dalam Codex dan perkara yang perlu ditulis semula#

Hooks. Dalam Claude Code, anda boleh melampirkan arahan shell pada setiap peristiwa kitar hayat (pre-tool-use, post-tool-use, on-error, on-context-load dan sebagainya). Codex mempunyai set peristiwa yang lebih kecil: ia boleh menyemak sebelum pelaksanaan, merekodkan bukti dan menyekat arahan berbahaya. Jika anda mempunyai hook pre-tool-use yang menapis gabungan tertentu, dalam Codex anda perlu membungkusnya dalam semakan pra-pelaksanaan umum atau menggugurkannya. Saya telah menerangkan secara terperinci seni bina hooks Claude Code; jika banyak menggunakannya, senaraikan setiap pencetus serta kesan diperlukan, kenal pasti padanan disokong dan sahkan sebelum mendayakannya.

Subagen. Dalam Claude Code, subagen ialah konteks berasingan dengan system prompt tersendiri, yang dilancarkan melalui /command atau daripada perbualan utama. Codex mempunyai konsep yang serupa dalam profil: anda boleh menentukan profil dengan set skills, kebenaran dan dasar kelulusan tertentu. Profil menyelesaikan masalah yang lebih kurang sama—mengasingkan konteks bagi kategori tugas tertentu—tetapi melalui tetapan dan bukannya pemanggilan ejen secara eksplisit.

Maksudnya dalam amalan:

• Jika anda mempunyai subagen "security-reviewer" dengan prompt tersendiri, cipta profil security-review dalam Codex dengan kebenaran yang diperlukan dan tahap usaha penaakulan yang lebih tinggi.
• Jika anda mempunyai subagen "feature-developer", itu cuma profil kerja lalai; tiada apa-apa yang khusus perlu dilakukan.
• Jika anda menggunakan subagen bersarang, cara itu tidak akan berfungsi secara langsung dalam Codex; fikirkan semula aliran tersebut menggunakan rangkaian profil atau skills eksplisit.

Alat Migration akan cuba mencipta profil menggunakan nama subagen anda dan menandakan pencetus yang tidak dipindahkan. Kerja diperlukan bergantung pada bilangan peranan, pencetus, kebenaran dan kebergantungan; uji setiap saluran diperlukan sebelum menganggapnya dimigrasi.

Bila perlu beralih sepenuhnya dan bila perlu mengekalkan kedua-dua alat#

Panduan ringkas untuk membuat keputusan:

Beralih sepenuhnya kepada Codex masuk akal jika:

• Anda kebanyakannya membuat PR autonomi dan tugas selari.
• Aliran kerja GitHub anda disepadukan secara mendalam, dan Codex Cloud Agent mengendalikan 80% kerja.
• Anda tidak banyak meluangkan masa untuk perbincangan seni bina dan Plan Mode.
• Anda mahu membayar untuk satu alat dan bukannya dua.

Kekalkan Claude Code dan Codex bersama-sama jika:

• Anda kerap menggunakan Plan Mode untuk keputusan seni bina yang panjang.
• Anda memerlukan kerja selari: Codex berjalan dalam awan untuk satu tugas sementara Claude Code mengekalkan konteks untuk tugas lain.
• Anda banyak melakukan hack sekali guna dan projek kecil yang tidak memerlukan Plan Mode.
• Anda mempunyai aliran kerja subagen yang kompleks dan tidak dapat ditulis semula dalam satu malam.

Saya sendiri menggunakan kedua-duanya: Claude Code mengekalkan perbualan panjang, manakala Codex mengendalikan tugas seperti "betulkan N pepijat secara selari" atau "semak PR." Saya menerangkan lebih lanjut tentang cara ini berfungsi dalam panduan menggunakan Claude Code dan Codex bersama-sama.

Perkara utama yang ingin saya katakan tentang migrasi: alat Migration menghapuskan halangan teknikal untuk beralih, tetapi tidak menjawab sama ada anda perlu beralih sejak awal lagi. Mula-mula, tentukan jenis kerja yang anda lakukan. Kemudian pilih alat.

Jika anda memerlukan akses kepada rangkaian neural melalui Ailoot, lihat Ailoot.