Panduan Claude Code untuk Pemula: Instalasi, Izin Aman, dan 30 Menit Pertama

Claude Code adalah agen coding AI yang berjalan dari terminal. Ia bukan sekadar chat untuk menempel potongan kode. Claude Code dapat membaca file proyek, mencari di repository, mengusulkan perubahan, mengedit file saat Anda mengizinkan, dan menjalankan perintah seperti test atau build.

Kesalahan paling umum bagi pemula adalah memulai dengan tugas terlalu besar. Prompt seperti “buat aplikasi ini lebih bagus” akan menghasilkan perubahan yang sulit diperiksa. Awal yang lebih aman adalah membaca proyek, memahami struktur, memilih satu tugas kecil, lalu memeriksa hasilnya.

Panduan ini mengikuti dokumentasi resmi setup, common workflows, dan CLI usage. Setelah ini, baca juga panduan CLAUDE.md dan manajemen konteks.

Cara Memahami Claude Code

Claude Code paling berguna untuk tugas kecil yang punya konteks jelas: memahami codebase, menemukan file penting, memperbaiki bug kecil, menambah test, memperbaiki README, atau menyiapkan ringkasan PR.

Urutan aman untuk pemula:

Langkah	Aksi	Tujuan
1	Instal dan login	Memastikan alat berjalan
2	Baca tanpa edit	Membuat peta proyek
3	Pilih tugas kecil	Menurunkan risiko
4	Review diff dan test	Memverifikasi hasil
5	Catat aturan	Membuat sesi berikutnya stabil

Ini terasa lebih lambat, tetapi jauh lebih mudah dikontrol.

Persiapan

Jangan mulai di branch produksi. Buat branch aman:

git status
git switch -c try-claude-code

Jika Git lama:

git checkout -b try-claude-code

Pastikan:

• akun Claude yang bisa memakai Claude Code
• koneksi internet
• folder root proyek
• Git berjalan
• ada perintah test atau build
• .env, secret, dan data pelanggan tidak dibuka ke model

Di Windows, PowerShell dan CMD berbeda. Prompt PS C:\ berarti PowerShell.

Instalasi

macOS, Linux, atau WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Lalu verifikasi:

claude --version
claude doctor

claude doctor berguna untuk menemukan masalah instalasi dan konfigurasi sejak awal.

Instalasi npm juga tersedia:

npm install -g @anthropic-ai/claude-code

Namun jika tidak ada alasan khusus, pakai installer native resmi terlebih dahulu. Hindari sudo npm install -g karena dapat menimbulkan masalah izin dan keamanan.

30 Menit Pertama

Masuk ke root proyek:

cd my-project
claude

Setelah login, jangan langsung meminta fitur besar. Mulai dengan prompt read-only:

Saya baru pertama kali melihat proyek ini.
Jangan edit file dulu. Baca saja dan jelaskan:

- proyek ini melakukan apa
- direktori utama dan tanggung jawabnya
- kandidat command dev, test, dan build
- file yang tampak berisiko untuk diubah
- 5 file pertama yang sebaiknya saya baca

Sertakan path file sebagai bukti dan jangan menebak jika tidak jelas.

Kemudian minta tugas kecil:

Usulkan 5 tugas yang cocok untuk pemula di repository ini.
Setiap tugas harus:

- selesai sekitar 30 menit
- menyentuh maksimal 2 file
- punya test atau verifikasi manual
- menghindari auth, billing, secret, dan data produksi

Tambahkan level risiko dan langkah verifikasi.

Dengan begitu Claude Code menjadi asisten onboarding, bukan generator perubahan besar.

Izin yang Aman

Karena Claude Code dapat menjalankan perintah dan mengedit file, izin harus hati-hati. Untuk awal yang aman:

claude --permission-mode plan

Di dalam sesi:

/permissions

Hati-hati dengan bypassPermissions dan --dangerously-skip-permissions. Gunakan hanya di container sekali pakai atau VM terisolasi.

Contoh pola izin konservatif:

{
  "permissions": {
    "allow": [
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(npm run test *)",
      "Bash(npm run build *)"
    ],
    "deny": [
      "Bash(git push *)",
      "Bash(rm -rf *)",
      "Read(.env)",
      "Read(**/.env)"
    ]
  }
}

Prinsipnya: izinkan pemeriksaan risiko rendah, blokir secret, dan jangan otomatisasi aksi destruktif.

Contoh 1: Memperbaiki README

README adalah tugas pertama yang aman.

Saya ingin memperbaiki README.md.
Pertama baca README.md dan package.json.
Daftar apa yang kurang, tapi jangan edit dulu.
Setelah saya setujui, ubah hanya README.md.

Setelah itu batasi:

Tambahkan hanya dua bagian ke README.md:

- pengembangan lokal
- command test

Gunakan hanya command yang terlihat di package.json.
Jangan membuat tool atau langkah deploy baru.

Contoh 2: Memperbaiki Bug Kecil

Deskripsi bug yang jelas membuat hasil lebih baik.

Investigasi bug ini.

Masalah:
- Saat input pencarian hanya berisi spasi, aplikasi menampilkan semua hasil.

Ekspektasi:
- Input hanya spasi harus diperlakukan seperti pencarian kosong.

Batasan:
- Jelaskan kemungkinan penyebab terlebih dahulu.
- Ubah maksimal 1 file.
- Berikan test atau verifikasi manual.

Lihat diff:

git diff

Minta review:

Review git diff saat ini.
Cari perubahan tidak sengaja, abstraksi berlebihan, kurang test, dan edge case.
Jika aman, rangkum 3 langkah verifikasi manual.

Contoh 3: CTA ke PDF, Produk, atau Konsultasi

Untuk situs konten atau dokumentasi, Claude Code dapat membantu membuat langkah berikutnya yang natural.

Baca artikel ini dan usulkan 3 CTA untuk pemula.

Tujuan:
- mengurangi kecemasan pengguna pertama
- menghubungkan ke PDF gratis, produk, atau konsultasi
- maksimal 80 karakter per CTA
- hindari bahasa jualan agresif

Implementasi harus mengikuti pola yang ada:

Cari pola CTA yang sudah ada di halaman artikel.
Tambahkan satu CTA di akhir artikel dengan nada yang sama.
Jangan buat komponen baru dan jangan ubah style global.

Kesalahan Umum

Pertama, meminta terlalu banyak. “Perbaiki aplikasi” bukan tugas. “Perbaiki pencarian untuk input spasi” adalah tugas.

Kedua, melewati fase baca. Jika Claude Code belum bisa menjelaskan arsitektur, jangan biarkan ia mengedit.

Ketiga, memperluas izin terlalu cepat. Diff yang mudah dipahami lebih penting daripada otomatisasi cepat.

Keempat, percaya pesan selesai tanpa bukti. Cek test, build, browser, atau git diff.

Kelima, melanjutkan percakapan yang terlalu panjang. Jika topik berubah, rangkum dan mulai sesi bersih. Lihat manajemen konteks.

Checklist Saat Macet

• Apakah claude --version berjalan?
• Apa hasil claude doctor?
• Apakah Anda di root proyek?
• Apakah git status jelas?
• Apakah PowerShell dan CMD tercampur?
• Apakah WSL, SSH, atau container butuh alur login khusus?
• Apakah Anda mencoba membaca .env atau key?
• Apakah mode izin berbahaya aktif?
• Apakah command test benar-benar ada?

Prompt diagnosis:

Claude Code tidak berjalan sesuai harapan.
Jangan edit file. Bantu diagnosis saja.

Lingkungan:
- OS:
- shell:
- command:
- pesan error:
- perilaku yang diharapkan:

Urutkan pemeriksaan dari yang paling aman.

Catatan Verifikasi Masa

Di ClaudeCodeLab, pola paling stabil adalah membaca, merencanakan, mengubah sedikit, lalu memverifikasi. Ini berlaku untuk artikel, terjemahan, CSS, dan script deploy. Tugas kecil menghasilkan diff yang bisa dipahami. Otomatisasi terlalu panjang membuat niat perubahan sulit dilacak.

Rekomendasi saya untuk pemula: selama minggu pertama, biarkan konfirmasi izin terlihat, baca setiap git diff, dan simpan prompt yang berhasil. Setelah stabil, lanjut ke tips produktivitas.

Langkah Berikutnya

Hari ini buka repository yang tidak kritis, minta peta read-only, pilih perbaikan 30 menit, lalu review diff.

Untuk ringkasan command dan prompt, unduh gratis Claude Code Quick Reference Cheatsheet. Untuk adopsi tim, training, atau penerapan proyek nyata, lanjutkan lewat materi dan link konsultasi di situs ini.