Instalasi Claude Code — satu perintah dan dua titik yang menghambat setelahnya

Pemasangan Claude Code sendiri hanya memerlukan satu perintah, tetapi kendala sebenarnya muncul setelahnya. Sebagian besar artikel tentang pemasangan berakhir pada “Pemasangan selesai”, tetapi di Korea ada dua gerbang tambahan sebelum dapat menjalankannya — izin pemasangan global dan login serta pembayaran. Artikel ini merangkum ketiga tahap tersebut secara berurutan, termasuk solusi ketika masing-masing mengalami kendala.

Tahap 1 — Pemasangan (satu perintah)

Satu-satunya prasyarat adalah Node.js 18 atau yang lebih baru. Perintahnya sama di macOS, Windows (WSL), dan Linux.

# Node.js 18 이상이 필요합니다. 먼저 확인하세요.
node --version

# 설치
npm install -g @anthropic-ai/claude-code

# 확인 — 버전이 출력되면 설치 자체는 끝난 것입니다
claude --version

claude --versionJika versi ini ditampilkan, pemasangan selesai. Jika berhenti di sini, Anda mengalami salah satu dari dua masalah di bawah.

Tahap 2 — Kesalahan izin dan jalur

Dua kesalahan yang paling umum pada tahap pemasangan.

Menambahkan sudo ke EACCES tidak disarankan. Pemasangan memang berhasil untuk sementara, tetapi masalah yang sama akan berulang pada setiap pembaruan, dan kepemilikan direktori global akan menjadi milik root sehingga masalah makin rumit. Memindahkan jalur ke home lebih rapi.

# npm 전역 설치에서 EACCES가 나면 sudo를 붙이지 말고
# 전역 경로를 홈 디렉터리로 옮기는 편이 안전합니다.
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

# 셸 설정에 추가한 뒤 새 터미널을 엽니다
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc

Jika menggunakan Windows, pasang di dalam WSL. File proyek juga harus berada di sistem file WSL agar pemantauan file dan pemrosesan jalur berjalan normal.

Tahap 3 — Login dan pembayaran (titik yang benar-benar menghambat di Korea)

Setelah pemasangan selesai dan Anda menjalankan claude, Anda akan diminta login. Di Korea, inilah titik yang paling sering membuat proses berhenti, dan penyebabnya tidak berkaitan dengan pemasangan.

• Kartu yang memblokir pembayaran internasional — gagal saat membayar langganan. Biasanya masalah selesai setelah pembayaran internasional diizinkan melalui aplikasi atau situs penerbit kartu.
• KakaoPay dan Toss — tidak didukung untuk pembayaran web claude.ai (hanya tersedia sebagai metode pembayaran toko untuk langganan aplikasi seluler). Jika Anda mengharapkan pembayaran digital domestik, proses akan terhenti pada tahap ini.
• Jika Anda tidak memiliki kartu yang mendukung pembayaran internasional — Anda tidak dapat menggunakan jalur langganan web. Autentikasi kunci di bawah ini menggunakan saldo Kunavo; ketika checkout ditampilkan dalam won, KakaoPay·Naver Pay·PAYCO·Samsung Pay dan kartu domestik (kartu yang tidak mengaktifkan pembayaran internasional) tersedia sebagai metode pembayaran, sehingga Anda dapat mengisi saldo tanpa kartu pembayaran internasional (Toss tidak didukung).

Metode pembayaran yang didukung dan yang tidak didukung dirangkum dalam cara pembayaran Claude.

Jika pembayaran langganan terhambat — jalankan dengan kunci tanpa memasang ulang

Selain login langganan, Claude Code juga mendukung autentikasi kunci API. Jika dua variabel lingkungan di bawah telah diatur, program akan berjalan tanpa melalui layar login; hapus variabel tersebut untuk kembali ke kondisi semula. Pemasangan ulang tidak diperlukan.

# 구독 결제가 막혔을 때 설치한 클로드 코드를 그대로 쓰는 방법.
# 이 두 줄이 있으면 로그인 대신 키로 인증하고, 지우면 원래대로 돌아갑니다.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# 클로드 코드의 기본 모델과 opus·sonnet 별칭은 Anthropic의 최신 모델을 따라가므로,
# Kunavo가 제공하는 모델로 고정해 404를 막습니다. sonnet 별칭은 Kunavo가 제공하지
# 않는 Sonnet 5.5를 요청하므로, 고정하지 않으면 /model sonnet, opusplan의 실행 단계,
# sonnet 서브에이전트가 404로 실패합니다. opus는 Opus 5.5로 고정하며,
# 클로드 코드 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-5

claude

Dengan jalur ini, Anda membayar token yang benar-benar digunakan, bukan biaya bulanan, sehingga tidak ada biaya pada bulan ketika Anda tidak bekerja. Prosedur penerbitan kunci ada di penerbitan kunci API Claude, sedangkan perbandingan biaya langganan dan bayar sesuai pemakaian ada di harga Claude Code.

Eksekusi pertama setelah pemasangan — 3 menit untuk verifikasi

Setelah berjalan, buka claude di direktori proyek dan jalankan /init sekali. Program akan membaca repositori dan membuat CLAUDE.md, yang kemudian dibaca otomatis pada semua sesi berikutnya. Pengoperasian setelah tahap ini — penulisan aturan, pengaturan izin, dan perintah khusus — dilanjutkan di cara menggunakan Claude Code.

Kesalahan yang muncul setelah dijalankan (401, 429, 529) memiliki penyebab yang sama sekali berbeda dari tahap pemasangan. Cara membedakannya dirangkum dalam panduan kesalahan Claude Code.

Pertanyaan yang sering diajukan