Banyak tulisan membahas cara menggunakan Claude Code, tetapi sebagian besar berakhir setelah “menginstal dan menerima respons pertama”. Masalah sebenarnya muncul setelah itu — Anda terus mengulang penjelasan yang sama, dialog konfirmasi terlalu sering muncul, dan jendela penggunaan 5 jam tertutup saat pekerjaan sedang berlangsung. Tulisan ini dimulai tepat ketika panduan pemula berakhir dan membahas ketiga masalah tersebut secara berurutan.
Mari samakan satu pemahaman. Claude Code bukan alat untuk menempelkan kode ke jendela chat, melainkan agen yang berada di repositori melalui terminal. Agen ini membaca dan mengubah file, menjalankan pengujian, bahkan membuat commit. Karena itu, hal pertama yang harus dilakukan bukan menghafal cara penggunaannya, melainkan memberikan aturan proyek kepadanya.
Tiga langkah pertama — jalankan, /init, dan buat permintaan spesifik
Hanya tiga hal ini yang layak dilakukan segera setelah instalasi. Terutama, jika Anda melewati /init kedua, Anda akan terus mengulang penjelasan yang sama di setiap sesi berikutnya.
# 1. 프로젝트 디렉터리에서 실행한다 (이게 전제 조건입니다)
cd ~/work/my-app
claude
# 2. 첫 명령은 /init — 저장소를 읽고 CLAUDE.md를 만들어 줍니다
> /init
# 3. 이후엔 한국어로 그냥 부탁하면 됩니다. 파일 경로를 붙일수록 정확해집니다
> src/api/user.ts의 검증 로직을 zod로 바꾸고 테스트도 같이 고쳐줘/init membaca repositori dan membuat CLAUDE.md. Karena konten yang dihasilkan masih berupa draf, jangan biarkan begitu saja; rapikan dengan tangan. Bagian berikut membahas isinya.
CLAUDE.md — tulis sekali hal yang sebelumnya dijelaskan setiap kali
CLAUDE.md adalah file Markdown yang diletakkan di root proyek dan dibaca secara otomatis di setiap sesi. Yang perlu ditulis di sana hanyalah “hal-hal yang tidak dapat diketahui dengan membaca kode”.
# CLAUDE.md — 프로젝트 루트에 두고 git에 커밋합니다
## 명령어
- 테스트: npm test (파일 하나만: npm test -- path/to/file)
- 타입 검사: npx tsc --noEmit
- 린트: npm run lint
## 규칙
- 날짜는 date-fns만 사용. moment 금지.
- API 핸들러는 app/api/**/route.ts에만 둔다.
- 커밋 메시지는 한국어, prefix는 feat / fix / docs.
## 건드리면 안 되는 곳
- db/migrations/ — 생성물. 직접 수정 금지.Sebaliknya, hal-hal yang tidak boleh ditulis juga jelas. Struktur direktori atau penjelasan fungsi tidak diperlukan karena dapat diketahui dengan membaca kode. CLAUDE.md disertakan dalam setiap permintaan, sehingga semakin panjang isinya, semakin banyak token yang digunakan — buat singkat, hanya aturan. Jika dikomit ke git, aturan yang sama berlaku untuk seluruh tim.
Izin — kurangi dialog konfirmasi, tetapi jangan menonaktifkan semuanya
Dialog konfirmasi muncul setiap kali file diubah atau perintah dijalankan. Karena ini adalah pengaman, pendekatan praktisnya adalah tidak menonaktifkannya semua, melainkan hanya mengizinkan operasi baca dan verifikasi. Pilih “Selalu izinkan” selama sesi agar pilihan tersebut diingat, dan tuliskan di .claude/settings.json untuk menetapkannya pada tingkat proyek.
Ada flag untuk melewati semua konfirmasi, tetapi penghapusan dan push jarak jauh juga akan berjalan tanpa konfirmasi. Gunakan hanya di dalam container atau worktree sekali pakai yang dapat dibuang jika rusak. Kriterianya dirangkum dalam kapan menggunakan --dangerously-skip-permissions.
Perintah kustom — jangan mengetikkan permintaan yang sama setiap kali
Pekerjaan yang hampir selalu diminta dengan cara yang sama, seperti review, pemeriksaan sebelum rilis, atau merapikan pesan commit, dapat dibuat menjadi perintah. Cukup letakkan file Markdown di .claude/commands/.
# .claude/commands/review.md — 파일만 두면 /review로 쓸 수 있습니다
지정된 파일을 리뷰하고 다음 세 가지만 지적하세요.
1. 실제로 실패하는 조건이 있는 버그 (재현 방법 포함)
2. 기존 유틸리티로 대체 가능한 중복
3. 테스트가 없는 분기
스타일 취향은 지적하지 마세요.Dengan begitu, /review src/api/user.ts menjalankan review dari sudut pandang yang sama. Jika dikomit ke git, perintah tersebut dapat dibagikan kepada tim, dan kriteria review itu sendiri dapat disimpan di repositori. Bentuk perintah yang digunakan dalam praktik dijelaskan lebih rinci dalam bahasa Inggris di Claude Code workflows.
Cara melanjutkan ketika jendela penggunaan tertutup
Penggunaan langganan dikelola melalui jendela bergulir 5 jam, dan sering kali tertutup pada sore hari ketika pekerjaan sedang berlangsung. Meningkatkan paket juga tidak langsung membukanya. Secara praktis, ada tiga pilihan.
| Pilihan | Situasi yang tepat |
|---|---|
| Menunggu sampai window terbuka | Tidak ada tenggat. Dapat ditunda beberapa jam |
| Beralih ke paket yang lebih tinggi | Terjadi setiap hari. Batas terus-menerus tidak mencukupi |
| Alihkan hanya tugas tersebut ke API key | Harus selesai hari ini. Batas hanya tercapai beberapa kali per bulan |
Pilihan ketiga dapat dilakukan tanpa membatalkan langganan. Penggunaan ditagih berdasarkan pemakaian hanya selama dua baris di bawah ini dikonfigurasi; setelah variabel dihapus, Anda kembali ke langganan. Jika belum memiliki kunci, mulai dengan mendapatkan kunci API Claude.
# 사용량 창이 닫혀도 작업을 이어가는 두 줄.
# 이 변수가 설정된 동안에만 종량제로 청구되고, 지우면 구독으로 돌아갑니다.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
# 클로드 코드의 기본 모델과 opus 별칭은 최신 Opus를, sonnet 별칭은 Sonnet 5.5를
# 가리킵니다. Kunavo가 제공하지 않는 모델(Sonnet 5.5, 아직 들어오지 않은 새 Opus)을
# 요청해 404가 나지 않도록 모델을 고정합니다. sonnet을 고정하지 않으면 /model sonnet,
# opusplan의 실행 단계, model: sonnet으로 지정한 서브에이전트가 404를 받습니다.
# opus 별칭에 고정한 Opus 5.5는 Claude Code v2.1.280 이상이 필요합니다
# (이전 버전이면 먼저 claude update).
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
# 보조 작업을 가장 싼 모델로 넘기는 한 줄 (매 세션 효과가 있습니다)
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5Tarif dibaca langsung dari katalog: Claude Sonnet 5 adalah $1,40 / $7,00 per 1 juta token, sedangkan Claude Haiku 4.5 adalah $0,70 / $3,50. Biaya dipotong dari saldo prabayar, jadi tidak ada tagihan pada bulan ketika Anda tidak bekerja. Perbandingan biaya langganan dan pemakaian serta perhitungan titik impas tersedia di harga Claude Code, solusi ketika pembayaran dengan kartu Korea terblokir ada di harga dan pembayaran Claude API, sedangkan struktur jendela penggunaan dijelaskan di batas Claude Pro.
Permintaan yang meningkatkan hasil dan yang memperburuknya
Terakhir, inilah bagian yang paling jelas menunjukkan perbedaan cara penggunaan. Jika Anda menyertakan jalur file, token yang digunakan untuk eksplorasi berkurang sehingga hasilnya lebih cepat dan akurat — “perbaiki logika validasi” dibandingkan “ubah logika validasi di src/api/user.ts menjadi zod”.
Selain itu, jangan memberikan pekerjaan besar sekaligus. Pisahkan menjadi perubahan → pengujian → perubahan berikutnya agar titik untuk kembali jelas ketika terjadi kegagalan. Cara membedakan jenis kesalahan dijelaskan di ringkasan kesalahan Claude Code.
Jika Anda ingin menggunakan agen coding dari OpenAI dengan cara yang sama, cara menggunakan Codex menjelaskan cara menjalankan Codex CLI dengan API key tanpa paket ChatGPT.
Pertanyaan yang sering diajukan
Apa yang harus dilakukan pertama kali saat menggunakan Claude Code?
Jalankan claude dari direktori proyek, lalu jalankan /init sekali. /init membaca repositori dan membuat CLAUDE.md. File ini berisi cara menjalankan pengujian, aturan proyek, dan jalur yang tidak boleh disentuh, lalu dibaca secara otomatis dalam semua sesi berikutnya. Jika Anda melewati langkah ini, Anda harus menulis ulang penjelasan yang sama setiap kali.
Apa yang harus ditulis di CLAUDE.md?
Tulis hanya “hal-hal yang harus Anda jelaskan berulang kali”. Tiga hal sudah cukup: perintah pengujian dan pemeriksaan tipe, aturan khusus proyek (gunakan pustaka ini, jangan letakkan logika di lapisan ini), serta jalur artefak hasil generate yang tidak boleh diubah. Sebaliknya, jangan tulis struktur direktori atau penjelasan fungsi yang dapat diketahui dengan membaca kode. CLAUDE.md disertakan dalam setiap permintaan, jadi semakin panjang isinya, semakin besar biayanya tanpa meningkatkan akurasi.
Apa yang harus dilakukan jika terkena batas penggunaan 5 jam?
Ada tiga pilihan: menunggu sampai jendela terbuka kembali, meningkatkan paket, atau mengalihkan tugas tersebut ke API key. Pilihan ketiga hanya memerlukan dua baris, ANTHROPIC_BASE_URL dan ANTHROPIC_AUTH_TOKEN, dan Anda tidak perlu membatalkan langganan. Selama variabel tersebut ada, penggunaan ditagih berdasarkan pemakaian; setelah dihapus, Anda kembali ke kondisi semula. Meningkatkan paket juga tidak langsung membuka jendela, jadi pada hari dengan tenggat waktu, pilihan ketiga adalah yang tercepat.
Bisakah saya mengurangi dialog konfirmasi yang muncul setiap kali saya menjalankan sesuatu?
Bisa. Pilih “Selalu izinkan” selama sesi agar pilihan tersebut diingat, atau tuliskan di .claude/settings.json untuk menetapkannya pada tingkat proyek. Dengan hanya mengizinkan operasi baca dan verifikasi seperti npm test atau git status, jumlah konfirmasi dapat berkurang drastis. Ada juga flag untuk melewati semua konfirmasi, tetapi itu membuat penghapusan dan push tidak memerlukan konfirmasi, jadi gunakan hanya di dalam container yang boleh dibuang.
Bagaimana cara membuat perintah kustom?
Cukup letakkan file Markdown di bawah .claude/commands/. Jika Anda membuat review.md, perintah tersebut dapat dipanggil dengan /review. Isinya cukup berupa prompt bahasa alami. Jika dikomit ke git, seluruh tim dapat menggunakan perintah yang sama, sehingga pekerjaan yang selalu diminta dengan cara yang sama, seperti kriteria review atau pemeriksaan rilis, dapat disimpan di repositori.
Apa kiat paling andal untuk meningkatkan kualitas hasil?
Sertakan jalur file secara spesifik. “Perbaiki logika validasi” lebih lambat dan kurang akurat daripada “ubah logika validasi di src/api/user.ts menjadi zod” karena permintaan kedua menggunakan lebih sedikit token untuk eksplorasi. Kiat lainnya adalah jangan memberikan pekerjaan besar sekaligus — pisahkan menjadi perubahan → pengujian → perubahan berikutnya agar titik untuk kembali jelas ketika terjadi kegagalan.