Panduan untuk pengembang · 18 tugas
AI untuk pengembang: agen pemrograman, biaya, dan serah terima yang aman
Jika Anda sudah memakai pelengkapan kode dan chat, langkah berikutnya adalah agen yang membaca repositori, menjalankan perintah, dan membuka pull request. Apakah itu menghemat waktu lebih bergantung pada penyiapannya daripada pada modelnya. Bagian pertama berlaku untuk agen pemrograman apa pun; bagian Claude Code dan Codex membahas perintah, file, dan pengaturan masing-masing, berdasarkan dokumentasi resminya.
Agen pemrograman apa pun
01
Beri agen tugas yang penyelesaiannya bisa dibuktikan
Agen gagal pada perintah “sempurnakan ini” dan berhasil pada tugas yang berakhir dengan pemeriksaan: tes gagal yang harus lulus, perintah yang output-nya harus berubah. Tuliskan buktinya ke dalam tugas, dan agen akan terus bekerja sampai selesai alih-alih berhenti saat tampaknya sudah selesai.
Contoh
“Perbaiki parser tanggal untuk tanggal minggu ISO. Selesai berarti npm test -- dates lulus, termasuk tes baru untuk 2026-W01. Jangan ubah tesnya.” Agen menjalankan tes sampai lulus dan menempelkan output-nya; Anda meninjau diff 30 baris, bukan tebakan.
Cara melakukannya
- 1Sebelum menyerahkannya, tulis atau tunjukkan pemeriksaannya: tes yang gagal, atau perintah beserta output yang diharapkan.
- 2Berikan tugasnya dengan prompt di halaman ini, termasuk file yang boleh diubah dan yang tidak boleh.
- 3Biarkan agen menjalankan pemeriksaan sendiri dan menempelkan output akhirnya.
- 4Tinjau diff seperti pull request dari rekan kerja; pemeriksaan yang lulus adalah awal peninjauan, bukan akhirnya.
Bawaan
Prompt untuk disalin
Tugas: [perubahan]. Selesai berarti: [tes atau perintah] lulus dan mencetak [output yang diharapkan]. Jalankan sebelum Anda selesai dan tempelkan hasilnya. Anda boleh mengubah: [path]. Jangan ubah: [path], dependensi, atau tesnya. Jika Anda tidak bisa membuatnya lulus, berhenti dan jelaskan alasannya alih-alih mengakali pemeriksaannya.Di mana hasilnya bisa keliru
- Agen terkadang membuat tes lulus dengan melemahkannya. Larang perubahan pada tes, dan periksa hal itu di diff.
- Tugas yang terlalu besar untuk satu pemeriksaan terlalu besar untuk satu kali serah terima. Pecah tugasnya.
02
Jalankan tugas di cloud selagi Anda mengerjakan hal lain
Agen cloud bekerja pada repositori Anda di lingkungannya sendiri dan kembali dengan perubahan untuk ditinjau, sehingga beberapa tugas berjalan selagi Anda mengerjakan hal lain. Cara ini hanya bermanfaat untuk tugas yang dirumuskan dengan baik; tugas yang samar kembali sebagai diff besar yang harus Anda urai.
Contoh
Tiga tugas kecil sebelum makan siang: memperbarui satu dependensi, menambahkan indeks basis data yang belum ada, memperbaiki tes yang tidak stabil. Masing-masing diserahkan ke agen cloud dengan pemeriksaannya sendiri, dan pada sore hari Anda meninjau tiga pull request alih-alih berganti konteks tiga kali.
Cara melakukannya
- 1Pilih yang paling dekat dengan kode Anda: Codex Cloud, Copilot cloud agent di GitHub, atau Claude Code on the web.
- 2Pastikan lingkungannya bisa memasang dependensi dan menjalankan tes Anda; tanpa itu, agen hanya menebak.
- 3Kirim tugas kecil yang saling independen, masing-masing dengan pemeriksaannya sendiri, seperti pada tugas di atas.
- 4Biarkan peninjau otomatis membaca setiap pull request lebih dulu, lalu tinjau sendiri.
Bawaan
Prompt untuk disalin
Di repositori ini: [tugas]. Konteks: [lokasi di kode, issue terkait]. Selesai jika: [tes atau perintah] lulus di lingkungan Anda; cantumkan output-nya di deskripsi pull request. Batasi pull request di bawah [n] baris yang diubah. Jika butuh lebih, berhenti dan usulkan cara memecahnya.Di mana hasilnya bisa keliru
- Tes yang memerlukan rahasia atau layanan yang tidak Anda siapkan akan dilewati atau gagal. Hasil hijau tanpa tes itu tidak banyak membuktikan.
- Beberapa agen yang mengerjakan kode yang saling terkait menghasilkan pull request yang berkonflik. Tempatkan tugas paralel di area terpisah.
03
Buat pemeriksaan berjalan tanpa Anda
Jangan habiskan waktu peninjauan untuk hal yang bisa diperiksa mesin. Hook menjalankan formatter, linter, dan tes Anda setelah setiap perubahan yang dibuat agen, dan bot peninjau membaca setiap pull request sebelum Anda. Peninjauan Anda kemudian berfokus pada desain, bukan salah ketik.
Contoh
Sebuah hook menjalankan formatter dan unit test setelah setiap pengeditan. Perubahan dari agen merusak dua tes; agen melihat kegagalannya di output hook dan memperbaikinya sebelum Anda melihat. Bot peninjau lalu menandai satu kasus error yang tidak ditangani, dan yang satu itu Anda yang memutuskan.
Cara melakukannya
- 1Masukkan perintah build, test, dan lint Anda ke file instruksi yang dibaca agen di awal setiap sesi; dokumentasi setiap agen menyebutkan nama file tersebut.
- 2Di Claude Code, tambahkan hook yang menjalankan formatter dan tes setelah setiap pengeditan, agar agen melihat kegagalan dan memperbaikinya.
- 3Minta bot meninjau setiap pull request: aktifkan “Automatic review” di Codex, atau minta Copilot sebagai peninjau.
- 4Jika agen membuat kesalahan yang sama dua kali, jadikan itu tes atau aturan di file instruksi.
Bawaan
Prompt untuk disalin
Baca repositori ini dan tulis file instruksi untuk agen pemrograman: 1. Perintah persis untuk install, build, test, lint, dan format. 2. Struktur proyek dalam 10 baris atau kurang. 3. Konvensi yang sering salah dipahami pendatang baru di sini, masing-masing dengan satu contoh. 4. Apa yang tidak boleh dilakukan agen di sini, misalnya mengubah migrasi atau mengedit file yang dihasilkan otomatis. Cantumkan hanya perintah yang berhasil Anda jalankan; tandai sisanya “belum diverifikasi”.Di mana hasilnya bisa keliru
- File instruksi dengan perintah yang sudah tidak berfungsi mengajari agen untuk mengabaikannya. Jalankan ulang perintah itu saat penyiapan berubah.
- Bot peninjau juga membuat kesalahan dengan penuh keyakinan. Anggap komentarnya sebagai saran.
04
Hubungkan agen ke alat Anda, dengan akses seminimal mungkin
Agen hanya sebaik apa yang bisa dilihatnya: issue, dokumentasi, log, skema basis data. MCP menghubungkan semua itu, tetapi setiap koneksi adalah akses, dan teks yang dibacanya dari luar bisa membawa instruksi. Mulailah dengan akses baca saja dan perluas hanya saat tugas memerlukannya.
Contoh
Agen membaca issue 482 dari tracker, menemukan stack trace di log, dan memeriksa dokumentasi library, lalu menyebutkan file penyebab masalahnya, semuanya lewat token baca saja. Perbaikannya ditulis di repositori Anda, tempat Anda meninjaunya seperti biasa.
Cara melakukannya
- 1Daftarkan apa yang paling sering Anda tempelkan ke chat, seperti issue, log error, dokumentasi, atau skema. Hubungkan itu lebih dulu.
- 2Tambahkan server MCP resmi untuk masing-masing, dengan token yang hanya bisa membaca. Di Gemini CLI, sebuah ekstensi bisa menggabungkan server MCP beserta penyiapannya.
- 3Berikan tugas yang memerlukannya dan periksa apakah agen memanggil yang tepat.
- 4Setiap beberapa minggu, hapus server yang sudah tidak Anda pakai.
Bawaan
Prompt untuk disalin
Sebelum Anda mengubah apa pun: baca issue [id] di tracker, temukan error di log, dan periksa dokumentasi [library]. Sebutkan apa yang Anda dapat dari masing-masing dan file mana yang menurut Anda menjadi penyebab masalah. Jangan menulis ke alat apa pun yang terhubung.Di mana hasilnya bisa keliru
- Halaman web, issue, atau dokumen bisa memuat teks yang ditulis untuk mengarahkan agen. Jangan beri akses tulis ke alat yang membaca konten dari luar.
- Token di file konfigurasi bisa bocor. Gunakan penyimpanan rahasia milik klien atau variabel lingkungan, jangan pernah repositori.
05
Pilih antara langganan dan bayar per token
Sesi agen membaca file dan menjalankan banyak langkah, sehingga memakai jauh lebih banyak token daripada chat. Hitung biaya satu minggu pemakaian khas Anda sebelum memilih: langganan memberi batas pada pemakaian interaktif, sedangkan penagihan per token memungkinkan Anda membatasi setiap proses otomatis.
Contoh
Satu minggu pemakaian agen setiap hari mencapai sekitar 40 juta token input dan 3 juta token output. Hitung harganya di halaman harga API untuk model yang Anda pakai, lalu bandingkan dengan biaya langganan sebulan. Jika langganan lebih murah dan batasnya sesuai dengan minggu Anda, ambil langganan, dan simpan kunci API berbatas untuk CI.
Cara melakukannya
- 1Periksa apa yang sudah Anda bayar: paket ChatGPT sudah termasuk Codex, dan paket berbayar Claude sudah termasuk Claude Code.
- 2Catat pemakaian token dari beberapa sesi khas, di tempat agen Anda menampilkannya.
- 3Hitung harga pemakaian itu di halaman harga API kami dan bandingkan dengan langganan.
- 4Untuk otomatisasi dan CI, gunakan kunci API dengan batas pengeluaran agar loop tidak bisa menimbulkan tagihan besar.
Bawaan
Prompt untuk disalin
Berikut pemakaian saya dari [jumlah] sesi khas: [token masuk dan keluar]. Saya bekerja sekitar [jumlah hari] hari seminggu. Perkirakan biaya bulanan saya per token dengan harga berikut: [tempel dari halaman harga API]. Bandingkan dengan langganan seharga [harga] per bulan. Tunjukkan perhitungannya agar saya bisa memeriksanya.Di mana hasilnya bisa keliru
- Langganan juga punya batas pemakaian. Mencapai batas di tengah tugas membuang waktu; periksa batasnya, bukan hanya harganya.
- Model memengaruhi tagihan lebih besar daripada faktor lain mana pun. Bandingkan biayanya menggunakan model yang benar-benar Anda pakai.
Claude Code
06
Beri setiap sesi awal yang sama dengan CLAUDE.md
Jika Anda menjelaskan perintah build dan konvensi Anda di awal setiap sesi, Anda sedang melakukan tugas CLAUDE.md. Claude membacanya di awal setiap sesi; buat tetap singkat dan benar, dan kesalahan yang sama berhenti berulang.
Contoh
Sebuah repositori tempat Claude terus menjalankan npm test alih-alih pnpm test:unit milik proyek, dan terus mengedit file yang dihasilkan otomatis. Dua baris di CLAUDE.md, perintah yang benar dan “jangan pernah mengedit src/gen/”, dan kedua kesalahan itu berhenti.
Cara melakukannya
- 1Jalankan /init di repositori: perintah ini menganalisis basis kode dan menulis CLAUDE.md awal, atau menyarankan perbaikan untuk yang sudah Anda punya.
- 2Simpan aturan tim, seperti perintah build dan test serta standar penulisan kode, di ./CLAUDE.md dan commit file itu. Preferensi pribadi Anda masuk ke ~/.claude/CLAUDE.md untuk semua proyek, atau CLAUDE.local.md untuk proyek ini.
- 3Rujuk dokumen yang lebih panjang alih-alih menempelkannya: @path/to/file mengimpor file lain saat dijalankan.
- 4Setiap kali Claude salah dalam hal yang sama dua kali, tambahkan satu baris yang seharusnya bisa mencegahnya.
Prompt untuk disalin
Baca repositori ini dan perbaiki CLAUDE.md. Buat kurang dari 60 baris: 1. Perintah persis untuk build, test, dan lint. 2. Struktur proyek dalam beberapa baris. 3. Konvensi yang sering salah dipahami pendatang baru di sini. 4. File dan folder yang tidak boleh diedit. Hapus apa pun yang sudah tidak benar. Tandai perintah yang tidak Anda jalankan sebagai “belum diverifikasi”.Di mana hasilnya bisa keliru
- Semua isi CLAUDE.md dimuat di setiap sesi dan memakan konteks. Pindahkan detail ke file yang diimpornya.
- Instruksi yang sudah tidak benar lebih buruk daripada tidak ada instruksi sama sekali. Periksa lagi perintahnya saat penyiapan berubah.
Dari dokumentasi resmi: Claude Code docs: How Claude remembers your project
07
Rencanakan dulu, lalu biarkan Claude mengedit
Untuk perubahan di banyak file, kesalahan yang mahal adalah pendekatan yang salah, bukan baris yang salah. Dalam plan mode, Claude meneliti dan menulis rencana tanpa mengedit file sumber Anda; Anda mengoreksi rencananya, lalu menyetujuinya.
Contoh
Memindahkan autentikasi dari cookie ke token di 14 file. Rencana pertama melupakan klien seluler; Anda menunjukkannya, rencana mendapat satu langkah tambahan, dan baru setelah itu Claude mengedit apa pun.
Cara melakukannya
- 1Tekan Shift+Tab sampai bilah status menampilkan “plan mode on”, atau awali prompt Anda dengan /plan.
- 2Jelaskan perubahannya dan apa yang tidak boleh berubah. Claude mungkin tetap menjalankan perintah untuk menjelajah, tetapi tidak mengedit file selama membuat rencana.
- 3Baca rencananya seperti catatan desain: file yang salah, kasus yang terlewat, perubahan yang terlalu besar. Minta perubahan sampai benar, lalu setujui.
- 4Sebelum tugas berikutnya yang tidak berkaitan, mulai dari awal dengan /clear.
Prompt untuk disalin
/plan Ubah [apa] agar [tujuan]. Batasan: [apa yang tidak boleh berubah]. Sebutkan file yang akan Anda ubah, urutan perubahannya, tes yang membuktikan setiap langkah, dan apa pun yang Anda ragukan. Jangan mengedit apa pun sampai saya menyetujuinya.Di mana hasilnya bisa keliru
- Rencana yang menyentuh lebih banyak file daripada yang Anda perkirakan adalah tanda bahaya. Tanyakan alasannya sebelum Anda menyetujui.
- Plan mode tetap menjalankan perintah untuk menjelajah. Mode ini tidak membuat repositori yang belum dikenal aman untuk dijalankan.
Dari dokumentasi resmi: Claude Code docs: Choose a permission mode · Claude Code docs: Commands · Claude Code docs: Best practices
08
Berhenti menyetujui perintah yang sama lima puluh kali
Menyetujui setiap proses tes secara manual melatih Anda untuk mengeklik ya tanpa membaca. Izinkan perintah yang aman dan berulang sekali saja di pengaturan proyek, tolak yang berbahaya, dan biarkan permintaan persetujuan untuk sisanya.
Contoh
Sebuah tim mengizinkan perintah test dan lint-nya serta menolak pembacaan file .env di pengaturan proyek bersama. Permintaan persetujuan berkurang menjadi beberapa perintah yang layak dibaca, dan tidak ada sesi siapa pun yang bisa membuka kuncinya.
Cara melakukannya
- 1Buka /permissions untuk melihat setiap aturan dan dari file pengaturan mana aturan itu berasal.
- 2Simpan aturan tim di .claude/settings.json dan commit file itu. Aturan pribadi masuk ke ~/.claude/settings.json atau .claude/settings.local.json.
- 3Aturan diperiksa mulai dari deny, lalu ask, lalu allow, sehingga satu aturan deny mengalahkan allow mana pun.
- 4Ganti mode dengan Shift+Tab: acceptEdits menyetujui pengeditan file di direktori kerja. bypassPermissions mematikan permintaan persetujuan dan pemeriksaan keamanan; dokumentasinya menyarankan memakainya hanya di container atau VM terisolasi tanpa akses internet.
Prompt untuk disalin
Lihat perintah yang Anda jalankan di sesi ini. Usulkan aturan izin untuk .claude/settings.json: izinkan perintah baca saja dan perintah tes yang kita pakai setiap hari, tolak apa pun yang membaca rahasia atau menghapus di luar proyek, dan biarkan sisanya meminta persetujuan. Jelaskan setiap aturan dalam satu baris.Di mana hasilnya bisa keliru
- Aturan allow yang cocok dengan perintah apa pun sama saja dengan tanpa permintaan persetujuan. Izinkan perintah yang persis.
- Aturan di .claude/settings.json berlaku untuk seluruh tim setelah di-commit. Tinjau seperti kode.
Dari dokumentasi resmi: Claude Code docs: Configure permissions · Claude Code docs: Settings files and precedence · Claude Code docs: Choose a permission mode
09
Jaga agar setiap sesi tetap fokus
Sesi yang sudah membawa tiga tugas yang tidak berkaitan masih menyimpan ketiganya di konteksnya, dan itu terlihat. Bersihkan di antara tugas, ringkas tugas yang panjang dengan fokus tertentu, dan biarkan subagen melakukan pencarian luas di konteksnya sendiri.
Contoh
Setelah memperbaiki bug, Anda meminta refactor di sesi yang sama dan Claude terus mengikuti solusi sementara yang lama dari bug itu. Dengan /clear dan satu kalimat konteks, hal itu tidak terjadi.
Cara melakukannya
- 1Di antara tugas yang tidak berkaitan, /clear memulai percakapan baru dengan konteks kosong.
- 2Dalam tugas yang panjang, /compact dengan fokus, misalnya “/compact pertahankan rencana dan tes yang gagal”, meringkas apa yang sudah terjadi sebelumnya.
- 3Serahkan pencarian luas ke subagen: masing-masing berjalan di jendela konteksnya sendiri, sehingga hanya jawabannya yang kembali ke sesi Anda.
- 4Claude Code juga meringkas sendiri saat mendekati batas; meringkas sendiri pada saat yang tepat mempertahankan apa yang Anda pilih.
Bawaan
Prompt untuk disalin
/compact Pertahankan: tujuan, rencana, file yang sudah diubah sejauh ini, dan tes yang masih gagal. Buang hasil penjelajahan.Di mana hasilnya bisa keliru
- /clear melupakan percakapan. Apa pun yang akan Anda butuhkan lagi harus dimasukkan ke CLAUDE.md lebih dulu.
- Jawaban subagen adalah satu-satunya yang Anda terima kembali. Mintalah path file dan nomor baris, bukan hanya kesimpulan.
Dari dokumentasi resmi: Claude Code docs: Commands · Claude Code docs: Best practices · Claude Code docs: Create custom subagents
10
Jalankan dua tugas sekaligus tanpa bentrok
Dua sesi di satu checkout saling mengedit file yang sama. claude --worktree memberi setiap sesi salinannya sendiri di branch-nya sendiri, sehingga refactor dan perbaikan bug bisa berjalan berdampingan.
Contoh
Upgrade dependensi di satu worktree dan perbaikan UI di worktree lain, keduanya berjalan selagi Anda meninjau pull request ketiga. Tidak ada sesi yang melihat file setengah jadi milik sesi lain.
Cara melakukannya
- 1Mulai setiap sesi dengan claude --worktree <name> (atau -w). Perintah ini membuat git worktree di .claude/worktrees/<name>/ pada branch worktree-<name>.
- 2Tambahkan .claude/worktrees/ ke .gitignore, seperti yang disarankan dokumentasi.
- 3Beri setiap sesi satu tugas dengan pemeriksaannya sendiri, agar Anda bisa meninjaunya satu per satu.
- 4Tinjau dan gabungkan setiap branch seperti pull request lainnya.
Prompt untuk disalin
Anda bekerja di worktree pada branch worktree-[nama]. Tugas: [satu perubahan]. Selesai jika: [tes atau perintah] lulus. Commit hanya di branch ini; jangan merge atau rebase branch lain.Di mana hasilnya bisa keliru
- Setiap worktree adalah folder tersendiri, jadi dependensi dan hasil build tidak dibagi. Lakukan instalasi di masing-masing.
- Dua tugas yang menyentuh file yang sama tetap berkonflik saat Anda menggabungkannya, dengan atau tanpa worktree.
Dari dokumentasi resmi: Claude Code docs: Run parallel sessions with worktrees
11
Batalkan langkah yang salah dengan rewind
Saat sesi berjalan salah, meminta Claude membatalkan perubahannya sendiri sering menambah kekacauan kedua. Rewind memulihkan percakapan, kode, atau keduanya ke titik sebelum kesalahan. Rewind tidak bisa membatalkan apa yang dilakukan perintah shell, jadi commit dulu sebelum langkah berisiko.
Contoh
Refactor yang mengarah ke arah yang salah sejak tiga prompt lalu. Rewind ke titik sebelumnya memulihkan file dan percakapan, lalu Anda merumuskan ulang permintaan alih-alih berdebat agar kodenya dikembalikan.
Cara melakukannya
- 1Tekan Esc dua kali pada prompt kosong, atau ketik /rewind (/checkpoint dan /undo juga berfungsi).
- 2Pilih titik sebelum semuanya salah dan pulihkan percakapan, kode, atau keduanya.
- 3Ketahui batasnya: file yang diubah oleh perintah shell seperti rm, mv, atau cp tidak dipulihkan, begitu pula pengeditan yang dibuat di luar Claude Code atau di sesi lain.
- 4Commit sebelum langkah berisiko. Checkpoint berguna untuk pemulihan cepat di dalam sesi, bukan pengganti git.
Prompt untuk disalin
Sebelum mulai, commit keadaan saat ini dengan pesan “checkpoint sebelum [tugas]”. Lalu [tugas]. Tanyakan kepada saya sebelum menjalankan perintah apa pun yang menghapus atau memindahkan file.Di mana hasilnya bisa keliru
- Rewind tidak mengembalikan file yang dihapus oleh perintah. Hanya git yang bisa.
- Pengeditan yang Anda buat secara manual sementara itu juga tidak tercatat. Commit dulu sebelum Anda melakukan rewind.
Dari dokumentasi resmi: Claude Code docs: Checkpointing · Claude Code docs: Commands
12
Jalankan dari skrip dan CI
Agen yang sama berjalan tanpa chat: claude -p menerima prompt, mengerjakan tugasnya, dan keluar dengan status yang bisa diperiksa skrip Anda. Di CI, --bare melewati hook, skill, server MCP, dan CLAUDE.md lokal Anda, sehingga setiap proses berperilaku sama di mana pun.
Contoh
Tugas malam hari menjalankan claude -p dengan “perbarui changelog dari pull request yang digabung hari ini” dan --output-format json, dan menggagalkan build jika status keluar bukan 0, sehingga proses yang rusak ketahuan keesokan paginya.
Cara melakukannya
- 1claude -p "..." berjalan secara non-interaktif. --output-format json atau stream-json memberi output yang bisa diurai oleh skrip.
- 2Perintah ini keluar dengan 0 jika berhasil dan bukan nol jika gagal, sehingga CI bisa bercabang berdasarkan hasilnya.
- 3Tambahkan --bare di CI untuk proses yang tidak bergantung pada penyiapan lokal.
- 4Untuk pull request, /install-github-app menyiapkan Claude Code GitHub Actions (hanya untuk repositori github.com); setelah itu sebut @claude di komentar pull request atau issue.
Prompt untuk disalin
claude -p "Baca diff terhadap main. Daftarkan setiap perubahan yang menambahkan dependensi, menyentuh autentikasi, atau mengubah migrasi basis data, dalam format JSON: {\"files\": [], \"reason\": \"\"}. Kembalikan daftar kosong jika tidak ada." --output-format jsonDi mana hasilnya bisa keliru
- Skrip berjalan dengan izin yang Anda berikan. Beri CI izin seminimal yang diperlukannya.
- /install-github-app hanya berfungsi dengan repositori di github.com.
Dari dokumentasi resmi: Claude Code docs: Run Claude Code programmatically · Claude Code docs: GitHub Actions
Codex
13
AGENTS.md: instruksi yang menjadi titik awal setiap tugas Codex
Codex membaca AGENTS.md sebelum mengerjakan apa pun, mulai dari file global Anda hingga folder tempatnya bekerja. Tulis perintah dan aturan sekali saja, dekat dengan kode yang diaturnya, dan file yang paling dekatlah yang berlaku.
Contoh
Sebuah repositori dengan aplikasi web dan layanan pembayaran. AGENTS.md di root berisi perintah bersama; payments/AGENTS.md menambahkan “jangan pernah mengubah pembulatan mata uang tanpa tes”. Pekerjaan di payments/ mengikuti keduanya, dan file yang lebih dekat yang berlaku jika keduanya berbeda.
Cara melakukannya
- 1Jalankan /init di CLI untuk menulis AGENTS.md awal di folder saat ini.
- 2Simpan panduan pribadi di ~/.codex/AGENTS.md dan aturan proyek di repositori. Subfolder bisa punya file sendiri; file yang lebih dekat dengan tempat Codex bekerja yang berlaku.
- 3Buat file tetap singkat: ukuran gabungannya dibatasi, 32 KiB secara default.
- 4Tambahkan bagian “## Code Review Rules”: review Codex di GitHub mengikutinya.
Prompt untuk disalin
Baca repositori ini dan tulis AGENTS.md: 1. Perintah persis untuk install, build, test, dan lint. 2. Struktur proyek dalam beberapa baris. 3. Konvensi yang sering salah dipahami pendatang baru di sini. 4. Bagian “## Code Review Rules” berisi apa yang harus selalu ditandai oleh peninjau. Cantumkan hanya perintah yang berhasil Anda jalankan; tandai sisanya “belum diverifikasi”.Di mana hasilnya bisa keliru
- File yang panjang merugikan Anda: ukuran gabungannya dibatasi 32 KiB secara default.
- File di subfolder yang bertentangan dengan file root tanpa menyebutkannya membingungkan orang sama seperti membingungkan Codex. Sebutkan apa yang ditimpanya.
Dari dokumentasi resmi: Codex docs: AGENTS.md · Codex docs: CLI commands · Codex docs: GitHub integration
14
Tentukan seberapa banyak yang boleh dilakukan Codex sendiri
Mode izin menentukan apa yang dilakukan Codex tanpa bertanya. “Ask for approval” bekerja di dalam ruang kerja dan berhenti sejenak sebelum melangkah ke luar; “Full access” menghapus sandbox dan pertanyaannya. Pilih per tugas, bukan sekali untuk selamanya.
Contoh
Membaca repositori yang belum dikenal dalam mode baca saja, lalu beralih ke “Ask for approval” untuk memperbaiki satu bug. Codex mengedit di dalam repositori tetapi berhenti untuk bertanya sebelum melangkah ke luar.
Cara melakukannya
- 1Di CLI, /permissions mengganti mode, dan /status menampilkan kebijakan persetujuan dan folder yang bisa ditulisi yang sedang berlaku.
- 2“Ask for approval”, default yang direkomendasikan, mengedit dan menjalankan perintah di dalam ruang kerja dan berhenti sejenak sebelum melangkah ke luar.
- 3“Approve for me” mempertahankan sandbox yang sama tetapi mengirim permintaan persetujuan ke review otomatis, bukan kepada Anda.
- 4“Full access” menghapus batasan sistem file dan jaringan. Dokumentasinya menambahkan peringatan; gunakan hanya untuk lingkungan yang boleh Anda buang.
Prompt untuk disalin
Sebelum mulai, jalankan /status dan sebutkan kebijakan persetujuan dan folder yang bisa ditulisi. Lalu [tugas]. Tanyakan sebelum menjalankan perintah apa pun yang memerlukan jaringan atau menulis di luar repositori ini.Di mana hasilnya bisa keliru
- Dengan “Approve for me”, tidak ada orang yang membaca setiap permintaan. Gunakan di tempat tindakan yang salah mudah dibatalkan.
- “Full access” berlaku untuk seluruh mesin, bukan hanya repositori.
Dari dokumentasi resmi: Codex docs: Permission modes · Codex docs: Sandboxing · Codex docs: Approvals and security · Codex docs: CLI commands
15
Jalankan Codex dari skrip dan CI
codex exec menjalankan tugas tanpa chat: progres dikirim ke stderr dan hanya pesan akhir ke stdout, sehingga skrip bisa memakai jawabannya. Perintah ini dimulai dalam mode baca saja; beri akses tulis hanya saat pekerjaan memerlukannya.
Contoh
Skrip rilis menjalankan codex exec dengan “tulis catatan rilis dari commit sejak tag terakhir” dan menyimpan stdout ke RELEASE.md. Mode baca saja sudah cukup, karena skrip itu sendiri yang menulis filenya.
Cara melakukannya
- 1codex exec "..." berjalan secara non-interaktif dan secara default memakai sandbox baca saja.
- 2Tambahkan --sandbox workspace-write saat perlu mengedit file; --full-auto sudah usang.
- 3--json mengeluarkan aliran event JSON Lines untuk skrip yang membutuhkan setiap langkah.
- 4Di GitHub Actions, openai/codex-action@v1 menjalankan codex exec untuk Anda.
Prompt untuk disalin
codex exec "Baca perubahan sejak tag [v1.2.0]. Tulis catatan rilis yang dikelompokkan sebagai Ditambahkan, Diubah, dan Diperbaiki: satu baris per perubahan, dengan kata-kata yang dipahami pengguna, tanpa hash commit."Di mana hasilnya bisa keliru
- Panduan lama masih memakai --full-auto. Opsi itu sudah usang; gunakan --sandbox workspace-write.
- Pekerjaan yang hanya membaca sebaiknya tetap dalam mode baca saja, di CI juga.
Dari dokumentasi resmi: Codex docs: Non-interactive mode · Codex docs: GitHub Action
16
Dapatkan review sebelum Anda push
Codex meninjau working tree, branch, atau pull request Anda. Di GitHub, Codex hanya menandai masalah paling serius, P0 dan P1, sehingga komentarnya layak dibaca. Jalankan sebelum Anda push, dan biarkan Codex meninjau setiap pull request.
Contoh
Sebelum push migrasi, /review menandai bahwa kolom baru tidak punya nilai default, sehingga baris yang sudah ada akan gagal. Satu menit sebelum push, alih-alih deploy yang gagal.
Cara melakukannya
- 1/review di CLI meninjau working tree Anda. codex review melakukan hal yang sama tanpa chat, terhadap branch dasar, commit, atau perubahan yang belum di-commit.
- 2Di GitHub, tulis komentar @codex review di pull request.
- 3Aktifkan review otomatis di bagian “Personal preferences” pada pengaturan Codex; setelah itu tidak perlu komentar.
- 4Tulis aturan tim Anda di bagian “## Code Review Rules” dalam AGENTS.md.
Bawaan
Prompt untuk disalin
## Code Review Rules - Tandai setiap perubahan pada autentikasi atau izin. - Tandai migrasi basis data yang tidak bisa dikembalikan. - Tandai dependensi baru dan sebutkan apakah memang diperlukan. - Abaikan format; linter yang menanganinya.Di mana hasilnya bisa keliru
- Review di GitHub hanya menandai masalah P0 dan P1. Tidak ada komentar bukan berarti desainnya benar.
- Review adalah pendapat kedua, bukan hasil tes. Tetap pertahankan tesnya.
Dari dokumentasi resmi: Codex docs: CLI commands · Codex docs: GitHub integration
17
Serahkan tugas ke Codex Cloud
Codex Cloud terus bekerja selagi komputer Anda tidur, setiap tugas di ruang kerjanya sendiri yang dibuat dari lingkungan yang Anda siapkan sekali. Dengan lingkungan yang layak, Codex bisa melakukan install, build, dan test; tanpa itu, Codex menebak.
Contoh
Empat refactor kecil dikirim dengan codex cloud exec sebelum rapat, masing-masing di ruang kerjanya sendiri dari lingkungan yang sama. Untuk yang paling rumit, Anda meminta tiga percobaan dan menyimpan yang terbaik; setelahnya Anda meninjau empat diff.
Cara melakukannya
- 1Buat lingkungan berisi repositori, dependensi, alat, dan pengaturan akses yang dibutuhkan tugas. Lingkungan baru merekam skrip instalasi dan skill awal.
- 2Atur akses internet per lingkungan: hanya pengelola paket, domain pilihan, atau semuanya.
- 3Mulai tugas dari ChatGPT, dari ekstensi IDE untuk pekerjaan yang lebih panjang, atau dari terminal dengan codex cloud exec; --attempts 1-4 meminta beberapa percobaan untuk dibandingkan.
- 4Code Review serta integrasi GitHub dan Linear masih berjalan di Codex Cloud (Legacy) yang lebih lama, yang rencananya akan dihentikan OpenAI.
Bawaan
Prompt untuk disalin
codex cloud exec --attempts 3 "Tugas: [perubahan]. Konteks: [file]. Selesai jika [tes] lulus di lingkungan ini. Batasi diff di bawah [n] baris."Di mana hasilnya bisa keliru
- Internet tanpa batasan memungkinkan tugas menjangkau situs apa pun, termasuk halaman yang ditulis untuk mengarahkannya. Izinkan hanya yang dibutuhkan pekerjaan.
- Jika skrip instalasi tidak ada, tes mungkin tidak dijalankan. Periksa apakah tugas benar-benar menjalankannya.
Dari dokumentasi resmi: Codex docs: Cloud environments · Codex docs: CLI commands · Codex docs: IDE extension
18
Siapkan Codex sekali: config, profil, dan MCP
Jika Anda mengubah model dan pengaturan secara manual di setiap sesi, masukkan ke config.toml. Codex selalu membaca ~/.codex/config.toml, juga pengaturan proyek di proyek tepercaya, dan sebuah profil mengganti seluruh set pengaturan sekaligus.
Contoh
Profil “deep” dengan upaya penalaran tinggi untuk pertanyaan desain, dan default untuk perbaikan cepat. codex --profile deep sebelum pertanyaan arsitektur; codex biasa untuk hal lainnya.
Cara melakukannya
- 1Atur model default dan upaya penalaran di ~/.codex/config.toml (model dan model_reasoning_effort). CLI dan ekstensi IDE memakai file yang sama.
- 2Buat profil sebagai file tersendiri, ~/.codex/<name>.config.toml, dan mulai dengan --profile <name>.
- 3Tambahkan server MCP dengan codex mcp add <name> -- <command>; masing-masing menjadi tabel [mcp_servers.<name>], dan /mcp menampilkan daftar server yang aktif.
- 4/status menampilkan pengaturan yang berlaku, dan codex resume --last melanjutkan sesi terakhir di folder ini.
Prompt untuk disalin
Baca ~/.codex/config.toml dan .codex/config.toml milik proyek ini. Sebutkan model, upaya penalaran, sandbox, dan server MCP yang berlaku, dari file mana masing-masing berasal, dan apa pun yang bertentangan.Di mana hasilnya bisa keliru
- Pengaturan proyek hanya dimuat untuk proyek tepercaya. Jika suatu pengaturan tampak diabaikan, periksa hal itu lebih dulu.
- Profil kini berupa file terpisah. Panduan yang menaruh [profiles.name] di dalam config.toml sudah usang.
Dari dokumentasi resmi: Codex docs: MCP · Codex docs: Config basics · Codex docs: Advanced config · Codex docs: CLI commands
Aturan untuk pengembang
- Jangan pernah menempelkan rahasia, kunci, atau data pelanggan ke prompt; jauhkan semua itu dari folder yang diindeks.
- Jalankan agen di branch dengan izin yang meminta persetujuan sebelum menjalankan perintah; tinjau setiap diff.
- Jalankan sendiri tesnya sebelum menggabungkan kode yang ditulis agen.
- Tetapkan batas pengeluaran untuk setiap kunci API yang dipakai agen.
Pelajari lebih dalam
- Berikan konteks yang tepat pelajaran, sekitar 8 menit
- Tunjukkan contoh dan format yang Anda inginkan pelajaran, sekitar 8 menit
- Perbaiki jawabannya langkah demi langkah pelajaran, sekitar 8 menit
- Claude Code 101 Anthropic (Claude Academy)
- Get Started with Codex OpenAI (OpenAI Academy)
- AI Agents Course Hugging Face
- Full Course: Spec-Driven Development with Coding Agents DeepLearningAI on YouTube