AI & Machine Learning

AI Coding Agent di Terminal: Workflow Praktis dengan Claude Code

Coding agent di terminal kini bisa membaca repo, menjalankan test, dan membuat PR. Ini workflow, konfigurasi CLAUDE.md, dan hooks yang membuatnya aman dan konsisten.

NP
novan putra 25 Maret 2026 · 3 mnt baca · 4.395 dilihat
AI Coding Agent di Terminal: Workflow Praktis dengan Claude Code

Kalau 2024 adalah tahun autocomplete AI, maka 2025–2026 adalah era coding agent: AI yang tidak hanya menyarankan baris kode, tapi bisa membaca seluruh repository, menjalankan perintah, memperbaiki test yang gagal, dan menyiapkan pull request. Claude Code, Codex CLI, dan Gemini CLI berlomba di terminal developer. Artikel ini membahas workflow yang terbukti efektif — fokus pada Claude Code, tapi prinsipnya berlaku untuk agent lain.

Instalasi

npm install -g @anthropic-ai/claude-code
cd project-kamu
claude

Di sesi pertama, jalankan /init agar agent membaca struktur project dan membuat file CLAUDE.md.

CLAUDE.md: Memori Project

CLAUDE.md dibaca otomatis di setiap sesi. Isinya adalah hal-hal yang tidak bisa ditebak dari kode:

# Blog Novan — Catatan untuk Agent

## Perintah
- Jalankan lokal: `php -S localhost:8000 index.php`
- Test: `vendor/bin/phpunit`
- Lint: `vendor/bin/phpstan analyse --level=6`

## Aturan
- PHP murni tanpa framework; jangan tambahkan Composer package tanpa izin.
- Semua query wajib prepared statement (PDO).
- Output HTML selalu lewat fungsi `e()` untuk escape.
- `config.php` berisi kredensial: JANGAN dibaca isinya atau di-commit.

## Struktur
- app/public = halaman publik, app/admin = panel admin
- Tema di assets/css/style.css (variabel CSS di :root)

Pendek, spesifik, dan berisi larangan yang penting. Agent yang tahu aturannya akan jauh lebih jarang membuat kesalahan.

Loop kerja coding agent
Agent bekerja dalam loop; tugasmu memastikan langkah verifikasi dan review tidak dilewati.

Workflow yang Efektif

1. Minta rencana dulu untuk tugas besar

Saya mau menambah fitur "artikel terkait" di halaman post.
Jangan ubah kode dulu. Baca post.php dan functions.php,
lalu jelaskan rencanamu dalam langkah-langkah.

Rencana yang keliru jauh lebih murah diperbaiki daripada kode yang keliru.

2. Berikan cara memverifikasi

Agent bekerja paling baik jika punya "hakim" objektif: test, linter, atau perintah yang bisa dijalankan. Kalimat seperti "pastikan phpunit hijau sebelum selesai" sangat berpengaruh.

3. Pecah tugas, commit sering

Satu tugas, satu sesi, satu commit. Jika hasilnya buruk, git checkout . dan coba lagi dengan instruksi yang lebih jelas.

Hooks: Pagar Otomatis

Hooks menjalankan perintah otomatis pada momen tertentu — misalnya merapikan format setiap kali agent mengedit file:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "vendor/bin/php-cs-fixer fix --quiet || true" }
        ]
      }
    ]
  }
}

Simpan di .claude/settings.json agar seluruh tim memakai aturan yang sama.

Mode Headless untuk Otomasi

Agent juga bisa dijalankan tanpa interaksi, cocok untuk CI atau script:

claude -p "Baca CHANGELOG.md dan buat ringkasan rilis dalam Bahasa Indonesia" \
  --output-format json > ringkasan.json

Kesalahan yang Sering Terjadi

Kesalahan Akibat Solusi
Instruksi terlalu umum Perubahan melebar ke mana-mana Sebut file dan batasannya
Tidak ada test Bug lolos tanpa disadari Minta agent tulis test dulu
Tidak membaca diff Kode aneh masuk ke main Review seperti PR rekan kerja
Memberi akses penuh tanpa batas Risiko perintah berbahaya Atur izin tool & gunakan sandbox

Penutup

Coding agent bukan pengganti developer — ia adalah rekan kerja yang sangat cepat tapi butuh arahan jelas. Investasikan waktu di CLAUDE.md, sediakan cara verifikasi, dan tetap review setiap diff. Dengan begitu, kamu mendapatkan kecepatan AI tanpa kehilangan kendali atas kualitas kode.

NP
Ditulis oleh

novan putra

Penulis utama blog ini.

0 Komentar

Komentar ditinjau dulu sebelum tampil.