Claude Code 2.1: Panduan dengan Contoh Praktis

Claude Code adalah alat pengodean beragen yang dikembangkan oleh Anthropic yang berjalan langsung di terminal Anda dan juga dapat beroperasi melalui antarmuka web yang terhubung. Alih-alih bekerja pada prompt terisolasi, Claude Code memahami seluruh repositori, dapat bernalar lintas file, mengedit kode, dan menjalankan alat. 

Dibandingkan dengan versi sebelumnya yang berfokus terutama pada bantuan kode interaktif, Claude Code 2.1 memiliki dukungan tambahan untuk agen, hook, dan keterampilan yang dapat digunakan kembali yang dapat secara aktif membentuk bagaimana dan kapan perubahan kode terjadi.

Claude Code dirancang untuk pengembang yang menginginkan bantuan AI tertanam langsung ke dalam alur kerja nyata, alih-alih bolak-balik antara editor dan antarmuka chat. Meski masih dalam pratinjau riset, alat ini sudah menunjukkan kegunaan praktis yang kuat dalam alur kerja pengembangan nyata. 

Jika Anda ingin mempelajari lebih lanjut tentang model Claude, saya merekomendasikan kursus Introduction to Claude Models. Anda juga dapat melihat tutorial Claude Cowork kami.  

Apa yang Baru di Claude Code 2.1?

Claude Code 2.1 membangun pengalaman terminal inti dengan memperkenalkan serangkaian peningkatan yang membuat alur kerja berbasis agen lebih fleksibel. Perubahan ini memperluas cara Claude Code bernalar tentang codebase dan bagaimana pengembang berinteraksi dengannya selama tugas pengembangan nyata.

Beberapa tambahan paling menonjol di Claude Code 2.1 meliputi:

• Hook agen dan keterampilan di frontmatter, memungkinkan pengembang memberlakukan pemeriksaan dan batasan sebelum perubahan kode diterapkan.
• Dukungan keterampilan yang diperluas dengan forked context, hot reload, dan definisi keterampilan kustom, menjadikan alur kerja yang dapat digunakan kembali lebih fleksibel dan kuat.
• Pemanggilan keterampilan dengan garis miring (/) memungkinkan akses cepat ke tindakan yang sering digunakan selama sesi interaktif.
• Agen di Claude Code 2.1 tidak lagi menghentikan penalaran ketika pemanggilan alat ditolak, memungkinkan alur kerja berlanjut tanpa gangguan.
• Alat ini mendukung respons yang dikendalikan bahasa, yang sangat berguna untuk dokumentasi multibahasa, ulasan, dan kolaborasi tim.
• Izin alat wildcard, seperti Bash(*-h*), memberikan kontrol otomasi yang lebih terperinci.
• CLI kini mendukung Shift+Enter untuk input multilini, meningkatkan pengalaman penulisan interaktif tanpa memerlukan pengaturan tambahan.

Dalam panduan ini, kami berfokus pada serangkaian eksperimen praktis yang menunjukkan bagaimana kemampuan baru ini diterapkan dalam proyek dunia nyata.

Menyiapkan Pengalaman Web Berbasis Cloud Claude Code

Claude Code 2.1 tersedia sebagai pengalaman berbasis web yang sepenuhnya berjalan di cloud. Mode ini sangat berguna untuk alur kerja kolaboratif, ulasan pull request, dan otomasi tingkat repositori tanpa memerlukan pengaturan lokal.

Langkah 1: Masuk dan akses Claude Code

Untuk memulai, buka https://claude.ai/code, dan Anda akan masuk ke antarmuka Claude Code (Pratinjau Riset). 

Langkah 2: Hubungkan Claude Code ke GitHub

Untuk bekerja dengan repositori nyata, Claude Code memerlukan akses ke GitHub. Klik Connect to GitHub, yang akan memasang Aplikasi GitHub Claude. 

Selama otorisasi, GitHub akan meminta izin untuk terhubung ke repositori dengan cara:

• Memverifikasi identitas GitHub Anda
• Melihat repositori mana yang dapat diakses Claude
• Bertindak atas nama Anda (misalnya, membuat branch atau commit)

Anda dapat memilih antara:

• Semua repositori, atau
• Hanya repositori tertentu (direkomendasikan untuk kontrol yang lebih ketat)

Izin yang umum meliputi:

• Akses baca ke metadata repositori dan pemeriksaan
• Akses baca dan tulis ke kode, isu, pull request, dan workflow

Klik Install & Authorize, dan Anda dapat mengubah atau mencabut akses nanti langsung dari pengaturan aplikasi GitHub. Langkah ini diperlukan agar Claude Code dapat membaca repositori, membuka pull request, dan mendorong commit saat bekerja di lingkungan web.

Langkah 3: Buat lingkungan cloud

Sebelum memulai sesi pertama Anda, Claude Code meminta Anda membuat lingkungan cloud. Lingkungan ini mengontrol akses jaringan dan batas eksekusi Claude.

Opsi yang tersedia meliputi:

• None: Opsi ini tidak memiliki akses internet, terutama berguna untuk keamanan maksimal.
• Trusted (direkomendasikan): Memberikan akses ke sumber paket yang terverifikasi.
• Full: Pengaturan ini memberikan akses internet tanpa batas.

Untuk sebagian besar kasus penggunaan, opsi Trusted memberikan keseimbangan terbaik antara keamanan dan fleksibilitas.

Langkah 4: Mulai sesi web

Setelah penyiapan selesai, Anda akan dibawa ke editor web Claude Code seperti pada tangkapan layar di bawah ini.

Dari sini, Anda dapat:

• Memilih repositori dan branch
• Menjalankan refactor dan review
• Membuat branch dan commit baru
• Melanjutkan sesi sebelumnya (jika ada)
• Beralih antar repositori tanpa mengubah lingkungan

Menyiapkan Pengalaman CLI Berbasis Terminal Claude Code

CLI adalah cara paling langsung untuk bekerja dengan Claude Code 2.1. Ini ideal untuk pengembangan lokal, refactor langkah demi langkah, dan situasi di mana Anda menginginkan kontrol terperinci atas apa yang dilakukan Claude di repositori Anda.

Langkah 1: Instalasi

Claude Code dapat dipasang langsung dari terminal menggunakan penginstal spesifik platform.

macOS, Linux, WSL:

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

Windows PowerShell:

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

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Setelah instalasi selesai, Anda akan melihat pesan konfirmasi yang menunjukkan versi Claude Code bersama dengan path instalasi. Untuk opsi penyiapan tambahan, Anda dapat merujuk ke panduan penyiapan resmi.

Langkah 2: Memulai

Setelah instalasi, arahkan ke root proyek Anda dan jalankan Claude Code:

cd your-project-directory
Claude Code

Saat Claude Code dimulai, ia segera memindai repositori dan membangun pemahaman awal tentang codebase. 

Konteks awal ini memungkinkan Claude Code untuk bernalar lebih efektif pada langkah-langkah berikutnya.

Mencoba Claude Code 2.1

Untuk demo ini, saya menggunakan salah satu proyek saya dari GPT 5.2. Berikut gambaran singkat proyeknya.

Setelah Claude Code memiliki akses ke setiap file dan folder di dalam folder tersebut, kita dapat mulai bereksperimen.

Refactor menggunakan keterampilan forked context 

Sebagai bagian dari evaluasi Claude Code 2.1, saya melakukan refactor skala repositori untuk meningkatkan pipeline. Eksperimen ini menyoroti keterampilan dengan forked context, di mana Claude dapat bernalar lintas banyak file alih-alih membuat edit file tunggal yang terisolasi.

Prompt:

Refactor the CSV parsing and slide generation logic across the repository.
Improve readability, split responsibilities, and avoid duplicated logic.

Claude terlebih dahulu menghasilkan rencana refactoring yang terperinci, termasuk struktur modul yang diusulkan, titik duplikasi, dan urutan implementasi, lalu meminta persetujuan sebelum mengubah apa pun. 

Setelah Anda menyetujui, Claude menerapkan refactor secara bertahap, menampilkan diff dan kemajuan saat proses berjalan.

Dengan Claude Code, saya mencapai peningkatan berikut:

• Membagi tanggung jawab di seluruh modul: Claude memisahkan pemuatan CSV, transformasi, pembangunan Excel, pembuatan PowerPoint, dan perencanaan LLM (pada dasarnya semua modul) menjadi komponen khusus.
• Mengurangi logika duplikat: Ia memusatkan utilitas yang berulang (seperti deteksi kolom dan pemformatan) dan memindahkan konstanta bersama ke lapisan konfigurasi umum.
• Meningkatkan kemampuan pemeliharaan: Claude juga mengurangi ukuran app.py sambil menjaga perilaku eksternal aplikasi tetap konsisten.

Berikut perbandingan struktur proyek dan keluaran refactoring sebelum dan sesudah perubahan.

Sebelum:

Sesudah:

Terakhir, saya mencoba refactor yang sama di Claude Code Web. Perbedaan utamanya adalah alur kerja:

• CLI berjalan langkah demi langkah dengan persetujuan eksplisit.
• Web dapat mendorong refactor langsung ke branch baru, yang nyaman untuk kolaborasi dan alur kerja berbasis PR.

Akhirnya, Claude melakukan refactor dan mendorong kode ke sebuah branch.

Hook validasi pra-edit

Pipeline data sering gagal karena alasan sederhana, yaitu skema CSV masukan tidak sesuai dengan yang diharapkan kode. Di Claude Code 2.1, Anda dapat mengurangi kelas kegagalan ini dengan menggunakan hook pra-edit. Kemampuan baru ini memungkinkan agen menjalankan pemeriksaan validasi sebelum Claude diizinkan memodifikasi kode.

Dalam contoh ini, saya meminta Claude Code membuat agen yang memvalidasi struktur CSV sebelum perubahan apa pun diterapkan.

Prompt:

Create a Claude Code agent that validates the CSV schema before modifying any code. The agent should reject edits if the CSV schema is unclear.

Claude Code terlebih dahulu membuat agen validasi skema CSV dan menghubungkannya ke alur kerja sehingga dapat bertindak sebagai penjaga gerbang. Output CLI menunjukkan bahwa Claude tidak hanya membuat satu skrip, tetapi menyusun sistem validasi kecil yang mencakup:

• Modul validator skema inti yang memeriksa kolom wajib, nilai yang hilang, dan konsistensi dasar.
• Hook penjaga pra-edit yang menjalankan validasi secara otomatis sebelum edit dilanjutkan.
• Terakhir, rangkaian pengujian dan beberapa contoh penggunaan untuk memverifikasi validator pada kasus CSV valid/tidak valid.

Dalam praktiknya, alur kerjanya menjadi sederhana:

• Claude secara otomatis menjalankan pemeriksaan skema sebelum membuat perubahan kode apa pun, memberlakukan prasyarat.
• Jika skema tidak jelas atau tidak valid, agen akan memblokir edit dan mengembalikan pesan kesalahan yang dapat ditindaklanjuti untuk memandu perbaikan.
• Setelah validasi lolos, Claude melanjutkan modifikasi, membuat perubahan tetap terjaga oleh guardrail dan dapat diprediksi.

Output web menunjukkan hasil serupa, tetapi dengan perbedaan kunci. Claude Code Web dapat mendorong perubahan langsung ke branch baru, termasuk modul validasi, integrasi hook, dokumentasi, dan pengujian. 

Secara keseluruhan, Claude Code 2.1 memberlakukan guardrail sebelum edit terjadi dengan menanamkan hook langsung ke dalam agen dan keterampilan. Ini membuat hook sangat berharga dalam proyek yang berat data, di mana kebenaran masukan sering kali menjadi sumber bug yang lebih besar dibandingkan kode itu sendiri.

Keterampilan slash-command untuk tugas berulang

Claude Code 2.1 memperkenalkan keterampilan slash-command yang dapat digunakan kembali, yaitu alur kerja yang berdiri sendiri yang dapat dipanggil secara interaktif di dalam sesi Claude atau dijalankan langsung dari baris perintah. 

Dalam contoh ini, kita membuat keterampilan /generate-slides yang dapat digunakan kembali untuk mengonversi file CSV menjadi presentasi PowerPoint profesional.

Prompt:

Create a reusable skill called /generate-slides that converts a CSV into a PPT.

Tip: Gunakan /statusline untuk mengonfigurasi baris status kustom yang muncul di bawah prompt input (berguna untuk menampilkan repo, branch, atau mode).

Claude Code menghasilkan definisi keterampilan lengkap di bawah .claude/skills/, termasuk dokumentasi, logika validasi, dan entry point Python yang dapat dijalankan.

• Pembuatan keterampilan: Claude menulis keterampilan generate-slides yang terdokumentasi penuh, menjelaskan tujuan, input, langkah validasi, dan alur eksekusinya.
• Validasi skema: Keterampilan memvalidasi skema CSV sebelum pemrosesan, memastikan kualitas data dan pesan kesalahan yang jelas.
• Eksekusi: Keterampilan dapat dijalankan langsung dari terminal, berperilaku seperti alat baris perintah mandiri.
• Penanganan error: File hilang, skema tidak valid, atau API key yang tidak ada menghasilkan error yang jelas dan dapat ditindaklanjuti.
• Otomasi: Satu perintah menghasilkan artefak Excel, grafik, dan dek PowerPoint.

Anda dapat menguji keterampilan secara lokal dengan:

python .claude/skills/generate-slides.py --csv-file kpis.csv

Catatan: Pastikan Anda menambahkan API key Anda sebelum menjalankannya. 

Keterampilan slash-command mengubah Claude Code menjadi mesin alur kerja, bukan sekadar asisten. Alih-alih terus-menerus memberi prompt untuk tugas yang sama, Anda mendefinisikannya sekali dan menggunakannya kembali di berbagai proyek, sesi, dan lingkungan. Anda dapat melihat struktur repositori yang diperbarui di bawah ini, mencerminkan penambahan keterampilan baru.

Contoh ini menunjukkan bagaimana:

• Keterampilan dapat dipanggil secara interaktif dari CLI.
• Keterampilan yang dihasilkan Claude terintegrasi dengan rapi ke dalam codebase yang ada.

Sub-agen Asinkron dan Backgrounding

Salah satu titik gesekan terbesar pada alat pengodean AI adalah "waktu tunggu"; menatap kursor yang berkedip saat AI berpikir atau menjalankan rangkaian pengujian yang lama. Claude Code 2.1 menyelesaikan ini dengan Sub-agen Asinkron.

Kini Anda dapat mendorong tugas yang berjalan lama—seperti refactor kompleks, menjalankan pengujian, atau peninjauan dokumentasi—ke latar belakang menggunakan Ctrl+B. Ini segera membebaskan terminal Anda, memungkinkan Anda untuk:

• Terus melakukan kueri pada codebase.
• Mengantrikan tugas kedua secara paralel.
• Meninjau file secara manual saat Claude bekerja.

Misalnya, saat Claude merefaktor modul app.py (yang mungkin memakan waktu menit untuk merencanakan dan mengeksekusi), Anda dapat menekan Ctrl+B dan segera bertanya: "Sambil itu berjalan, jelaskan logika autentikasi di auth.py."

Saat tugas latar belakang selesai, Claude memberi tahu Anda, dan Anda dapat menggabungkan konteksnya kembali ke alur utama. Ini secara efektif mengubah Claude Code dari antarmuka chat single-threaded menjadi mitra pengembangan multi-threaded, mencerminkan cara kerja insinyur senior sebenarnya.

Keluaran yang dikendalikan bahasa 

Claude Code 2.1 dapat dikonfigurasi untuk merespons dalam bahasa tertentu, yang berguna untuk tim multibahasa, dokumentasi yang dilokalkan, dan penjelasan kode non-Inggris. Dalam contoh ini, kami meminta Claude menjelaskan pipeline pembuatan slide di repositori sepenuhnya dalam bahasa Jepang.

Prompt:

Explain the slide generation logic in Japanese.

Claude merespons dalam bahasa Jepang dan menghasilkan penjelasan terstruktur tentang alur end-to-end. Seperti yang ditunjukkan pada output, ia tidak hanya menerjemahkan ringkasan tetapi juga memetakan pipeline menjadi fase-fase yang jelas dan merujuk pada modul yang relevan di setiap langkah. Output CLI menunjukkan:

• Bahasa Jepang dari awal hingga akhir: Respons tetap dalam bahasa Jepang sepanjang, termasuk heading dan poin-poin.
• Alur langkah demi langkah: Claude memecah pipeline menjadi tahapan yang berbeda (validasi CSV, pemrosesan data, workbook Excel, perencanaan LLM, dan pembuatan slide).
• Referensi yang sadar codebase: Ia menunjuk ke file dan direktori yang relevan sambil menjelaskan fungsi tiap komponen.
• Format bergaya dokumentasi: Output dibaca seperti dokumentasi internal, sehingga mudah digunakan ulang di README atau panduan onboarding.

Catatan: Saya hanya menguji perilaku ini di CLI untuk contoh ini, tetapi kemampuan pengendalian bahasa yang sama merupakan bagian dari Claude Code 2.1 secara keseluruhan.

Fitur ini tampak kecil di atas kertas, tetapi dalam praktiknya, merupakan peningkatan produktivitas besar saat dokumentasi dan review perlu dilakukan dalam bahasa selain Inggris.

Perintah Claude Code 2.1

Berikut beberapa perintah yang bisa Anda coba dengan Claude Code.

Kesimpulan

Dalam panduan ini, kami mengeksplorasi Claude Code 2.1 dengan menjalankan eksperimen langsung di alur kerja CLI dan web. Kami menggunakan Claude Code untuk merefaktor repositori yang ada menggunakan keterampilan forked context, menegakkan jaminan data dengan hook validasi pra-edit, membuat keterampilan slash-command yang dapat digunakan kembali, dan menghasilkan penjelasan yang dikendalikan bahasa langsung dari codebase.

Contoh-contoh ini menyoroti bagaimana Claude Code 2.1 melampaui pengeditan berbantuan AI sederhana menuju alur kerja pengembangan yang lebih digerakkan agen. Meskipun Claude Code 2.1 masih dalam pratinjau riset, alat ini sudah menunjukkan nilai praktis yang kuat dalam proyek nyata.