Claude Code unggul dalam membaca codebase besar dan mempertahankan rencana lintas banyak file. Codex unggul dalam perubahan yang cakupannya ketat dan digerakkan oleh pengujian. Banyak engineer akhirnya ingin memakai keduanya di repositori yang sama: satu menyusun draf refactor, sementara yang lain memperkuat test suite yang flaky. Begitu Anda mencobanya, direktori kerja yang sama justru menjadi masalahnya. Dua alat berbeda, dua CLI berbeda, satu folder yang keduanya tulis.
Panduan ini membahas penyiapannya langkah demi langkah, menyebutkan mode kegagalan di setiap langkah, dan menunjukkan di mana dua terminal berhenti skalabel. Sisi isolasinya sudah terpecahkan dengan git worktree. Sisi koordinasinya—mengetahui alat mana mengerjakan apa dan menjaga setiap perubahan tetap bisa ditinjau—di situlah lapisan yang netral terhadap runtime seperti Sharkly mengambil alih.
Sharkly bukan pengganti Claude Code atau Codex. Sharkly menambahkan lapisan Task, Computer, konteks, dan tinjauan bersama di sekitar alat eksekusi yang sudah Anda jalankan, sehingga sesi Claude Code dan sesi Codex menjadi dua penugasan dalam satu alur kerja, bukan dua terminal yang harus Anda awasi terus-menerus.
Mengapa menjalankan Claude Code dan Codex di repo yang sama
Ada tiga alasan yang muncul berulang kali, dan ketiganya bukan masalah yang sama.
Kekuatan berbeda untuk tugas berbeda. Anda kirimkan pekerjaan berkonteks luas (telusuri bug ini di seluruh modul, rencanakan migrasi ini) ke satu agen, dan pekerjaan sempit yang bisa diverifikasi (buat tes ini lulus, rapikan fungsi ini) ke agen lainnya. Mencocokkan alat dengan tugas adalah topik tersendiri; lihat model mana untuk tugas coding mana.
Adu langsung pada pekerjaan nyata. Satu-satunya benchmark yang jujur adalah codebase Anda, bukan papan peringkat. Menjalankan keduanya pada tiket yang sama lalu membandingkan diff-nya memberi Anda lebih banyak informasi daripada skor mana pun yang dipublikasikan. Metodenya kami bahas di cara membandingkan coding agent di codebase Anda sendiri.
Anda sudah membayar keduanya. Banyak tim sudah memiliki langganan Claude dan seat Codex atau API. Netralitas terhadap provider itulah intinya: alur kerja Anda harus tetap berjalan apa pun alat yang merilis model terbaik berikutnya, tanpa perlu dibangun ulang.
Apa pun alasannya, kegagalannya identik. Dua agen di satu folder berarti dua penulis yang menyunting satu dokumen tanpa penguncian. Yang satu mengganti branch tepat di bawah kaki yang lain, atau memformat ulang sebuah file di tengah pengeditan, dan Anda mendapat diff setengah jadi yang tidak masuk akal.
Langkah 1: beri setiap agen worktree-nya sendiri
git worktree memperbaiki tabrakan ini di akarnya. Satu repositori bisa memiliki beberapa direktori kerja yang di-checkout sekaligus, masing-masing di branch-nya sendiri, berbagi satu database .git. Alih-alih satu folder yang diperebutkan kedua alat, Anda mendapat satu folder per tugas.
# One checkout per task, each on its own branch
git worktree add ../app-refactor -b agent/refactor
git worktree add ../app-tests -b agent/tests
git worktree list
Arahkan alat yang berbeda ke tiap direktori:
cd ../app-refactor && claude # Claude Code on the refactor
cd ../app-tests && codex # Codex on the test suite
Mode kegagalan jika Anda melewati langkah ini: kedua alat menjalankan cd ke repo yang sama, berlomba pada file yang sama, dan salah satunya diam-diam menimpa pekerjaan yang belum di-commit milik yang lain. Worktree membuat itu mustahil secara fisik. Pembersihan setelahnya punya tantangannya sendiri; mengelola worktree tanpa sakit saat pembersihan membahas git worktree remove dan masalah branch usang.
Langkah 2: arahkan setiap alat ke instruksi yang tepat
Claude Code dan Codex membaca file proyek yang berbeda. Claude Code mencari CLAUDE.md; Codex membaca AGENTS.md. Jika repo Anda hanya punya salah satunya, satu agen bekerja tanpa mengetahui konvensi Anda.
Simpan keduanya, dan jaga agar tetap konsisten. Pola yang andal adalah menulis aturan bersama sekali saja, lalu membuat setiap entry point menyertakannya:
<!-- CLAUDE.md and AGENTS.md both start with -->
See ./docs/agent-conventions.md for build, test, and style rules.
# Verify each tool actually loads its file before you turn it loose
claude --version # Claude Code reads CLAUDE.md from the worktree root
codex --version # Codex reads AGENTS.md from the worktree root
Mode kegagalan jika Anda melewati langkah ini: Codex mengikuti satu konfigurasi lint sementara Claude Code mengikuti yang lain, dan setiap merge berubah menjadi pertengkaran gaya yang tidak pernah ditulis siapa pun. Ada catatan pribadi yang penting di sini: token instalasi tidak membawa konvensi Anda, dan file lokal yang masuk .gitignore tidak ikut berpindah ke worktree. Letakkan aturan bersama di file yang dilacak, atau setiap worktree baru akan dimulai dalam keadaan kosong.
Langkah 3: jalankan, lalu saksikan celah koordinasi terbuka
Dengan dua worktree dan dua file konfigurasi, mekanismenya berjalan. Anda punya Claude Code di satu branch dan Codex di branch lain, dan keduanya tidak menyentuh file milik yang lain. Untuk sesi sore hari dengan dua agen, ini cukup bertahan.
Celahnya terbuka begitu Anda mengangkat kepala dari keyboard. Setiap sesi menyimpan riwayatnya sendiri di tabnya sendiri, tak terlihat oleh yang lain. Saat sesi Codex perlu tahu apa yang sudah diubah sesi Claude Code, tidak ada memori bersama yang bisa dirujuk, jadi Andalah yang menjadi lapisan integrasinya. Agen-agen selesai pada waktu berbeda dan menunggu input dalam diam, sehingga "jalankan keduanya secara paralel" perlahan merosot menjadi "periksa satu per satu secara berurutan."
Sekarang coba skalakan ini melewati dua. Langkah berikutnya yang wajar adalah skrip wrapper yang membuat worktree, menjalankan alat yang tepat di masing-masing, dan menyalurkan output ke pane tmux bernama. Ini membantu untuk beberapa kali menjalankan. Lalu berkembang: penamaan branch, pembersihan, cara mengetahui alat mana mengerjakan tugas mana, percobaan ulang untuk yang crash. Tak lama kemudian Anda memelihara kerangka orkestrasi yang rapuh dan disatukan oleh bash, di mana separuh state-nya hidup di riwayat shell dan separuhnya lagi di kepala Anda. Menjalankan banyak agen sekaligus menghadapi dinding yang sama, entah agennya semua Claude Code—seperti pada menjalankan beberapa agen Claude Code—atau campuran.
Di mana dua terminal berhenti skalabel
Uji jujur untuk mengetahui apakah Anda sudah melampaui setup DIY:
- Bisakah rekan tim melihat apa yang sedang dilakukan agen Anda saat ini, tanpa Anda membacakan terminal Anda kepada mereka?
- Saat Codex selesai pukul 2 siang dan membutuhkan input, adakah yang memberi tahu Anda?
- Saat kedua agen selesai bersamaan, apakah ada antrean untuk meninjau pekerjaan mereka, atau hanya Anda dan dua branch?
Jika jawabannya tidak, bagian yang hilang bukanlah skrip shell lain. Yang hilang adalah lapisan yang menugaskan pekerjaan ke alat mana pun, menampilkan status secara langsung, dan menjaga setiap perubahan tetap bisa ditinjau sebelum di-merge. Itulah yang ditambahkan papan tugas di atas terminal mentah.
Batasan ini penting untuk dinyatakan secara gamblang. Claude Code dan Codex melakukan eksekusi. Lapisan komando mengelola penugasan, Computer yang terhubung, konteks tugas, progres, hambatan, hasil, dan tinjauan manusia di keduanya. Di Sharkly, Anda menugaskan satu Task ke sebuah Claude Code Runtime dan tugas lain ke Codex Runtime; masing-masing berjalan di worktree terisolasi miliknya sendiri pada Computer yang terhubung, dan eksekusi, hambatan, serta hasil kembali ke timeline Task alih-alih menghilang ke terminal pribadi.
Pembagian kerja tetap bersih. Agen meneliti, mengeksekusi, menguji, dan melaporkan. Manusia menetapkan arah, memberikan wewenang, dan menerima hasilnya. Otomatisasi berhenti di titik yang membutuhkan penilaian Anda, lalu menyerahkan kembali diff beserta bukti verifikasinya. Anda tetap memakai alat yang sudah Anda bayar, penggunaan model tetap berjalan melalui langganan dan API key yang dikonfigurasi di masing-masing alat, dan Anda mendapat satu tempat untuk melihat siapa mengerjakan apa.
Gunakan setup manual saat Anda menjalankan satu atau dua agen selama sesi sore dan bisa menyimpan state-nya di kepala. Beralihlah ke lapisan bersama saat orang kedua membutuhkan visibilitas, saat jumlahnya melampaui apa yang bisa ditampilkan satu jendela terminal, atau saat Anda cukup sering membandingkan alat sehingga "jalannya yang mana yang menghasilkan branch ini" tidak lagi jelas.
Checklist yang bisa Anda jalankan hari ini
Jalankan ini dari atas ke bawah saat berikutnya Anda menempatkan kedua alat di satu repo:
- [ ] Buat satu
git worktreeper tugas, masing-masing di branch-nya sendiri. Jangan pernah mengarahkan dua alat ke direktori yang sama. - [ ] Commit
CLAUDE.mddanAGENTS.md, masing-masing menunjuk ke satu file konvensi bersama di sumber yang dilacak. - [ ] Pastikan setiap alat memuat konfigurasinya dari root worktree sebelum Anda menugaskan pekerjaan.
- [ ] Tugaskan satu Task yang cakupannya jelas per agen. Pekerjaan berkonteks luas ke satu agen, pekerjaan sempit berbasis tes ke agen lainnya.
- [ ] Tentukan gate tinjauan Anda sejak awal: tidak ada branch yang di-merge sebelum seseorang membaca diff dan hasil tesnya.
- [ ] Saat Anda melewati dua atau tiga proses yang berjalan bersamaan, berhenti menskalakan bash dan pindahkan penugasan, status, serta tinjauan ke satu lapisan.
Jika Anda ingin terus memakai Claude Code dan Codex alih-alih berkomitmen pada satu ekosistem, itulah masalah yang hendak dipecahkan Sharkly. Unduh Sharkly, hubungkan satu Computer, dan tugaskan Task pertama Anda ke agen mana pun yang cocok dengan pekerjaannya.
FAQ
Bisakah Claude Code dan Codex menyunting file yang sama dengan aman? Tidak, jika berada di direktori yang sama. Beri masing-masing git worktree sendiri agar mereka bekerja di branch terpisah, lalu merge melalui tinjauan. Konkurensi di direktori yang sama adalah tempat pekerjaan yang belum di-commit hilang.
Apakah saya perlu dua langganan? Anda perlu apa pun yang dibutuhkan masing-masing alat. Penggunaan model tetap berjalan melalui langganan atau API key yang dikonfigurasi di Claude Code dan Codex; lapisan koordinasi tidak mengubah atau menjual ulang akses tersebut.
Apakah papan tugas berlebihan untuk dua agen? Untuk dua agen yang Anda kendalikan dalam satu sesi duduk, worktree biasa dan dua terminal sudah cukup. Papan tugas baru layak dipakai saat rekan tim membutuhkan visibilitas atau jumlah proses bertambah. Lihat alat terbaik untuk mengelola agen coding AI paralel.
