Claude Code 설치 방법: Windows, macOS 및 Linux용 공식 명령어, 구독 없는 API 키, /status 확인 및 카드나 Link로 결제

요약하면: 아래에서 macOS/Linux, PowerShell 또는 CMD에 맞는 공식 한 줄 명령을 선택해 Claude Code를 설치한 다음 로그인 대신 API key에 연결하세요. 필요한 변수는 여섯 개뿐입니다. ANTHROPIC_BASE_URL=https://api.kunavo.com(/v1 없이), key가 들어 있는 ANTHROPIC_AUTH_TOKEN, 그리고 모델을 고정하는 네 개의 변수입니다. /status로 결과를 확인하세요. Pro 또는 Max 구독은 필요하지 않으며, $10부터 선불 잔액에서 토큰당 결제합니다. 잔액은 카드(Visa, Mastercard 등) 또는 Link로 충전할 수 있습니다. QRIS, GoPay, OVO 및 DANA는 제공되지 않습니다.

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

:: Windows Command Prompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Semua perintah dan nama variabel di sini kami samakan dengan dokumentasi resmi Claude Code pada 2026년 10월 3일. Dokumentasi itu sudah ada dalam bahasa Indonesia, termasuk 설치 페이지 dan LLM gateway 연결 페이지, jadi Anda bisa mencocokkan sendiri. Harga dan metode pembayaran Kunavo dicek 2026년 10월 3일.

처음부터 Claude Code 실행까지의 6단계

1. 노트북이 요구 사항을 충족하는지 확인하고 Claude 계정 로그인 또는 API key 중 하나를 결정하세요.
2. 사용 중인 터미널에 맞는 native installer를 실행하세요.
3. 새 터미널을 열고 claude --version를 확인한 뒤 필요하면 PATH를 수정하세요.
4. API key를 설정하고 모델을 고정하세요.
5. 첫 세션을 열고 /status를 통해 key가 사용되는지 확인하세요.
6. 카드 또는 Link로 잔액을 충전한 후 작업을 시작하세요.

1단계: 요구 사항을 확인하고 로그인 또는 API key 선택

Setelah terinstal, Claude Code harus tahu siapa yang membayar. Jalan pertama adalah login akun Claude, yang mensyaratkan paket Pro, Max, Team, Enterprise, atau akun Console; paket gratis Claude.ai tidak mencakup Claude Code. Menurut Claude 가격 페이지 (dicek 2026년 10월 3일), Pro berharga $20 per bulan, atau $17 per bulan kalau dibayar tahunan ($200 di muka), Max mulai $100 per bulan, dan semua harga belum termasuk pajak. Untuk langganan yang dibeli lewat web, Anthropic hanya menerima kartu kredit atau debit; langganan dari aplikasi iOS atau Android dibayar lewat App Store atau Google Play (Claude 청구 FAQ, dicek 2026년 10월 3일). Cara login dijelaskan di 공식 인증 페이지.

이 가이드에서 자세히 설명하는 두 번째 방법은 API key입니다. 구독과 로그인 화면이 필요 없습니다. 실제로 사용한 토큰에 따라 결제하므로 한산한 달에는 비용도 낮아집니다. 빠지는 기능은 claude.ai 계정에 연결된 Remote Control과 음성 받아쓰기 두 가지뿐이며, 전체 차이점은 5단계에 나와 있습니다.

Baru pertama kali membuka terminal? Anthropic menyediakan 인도네시아어 터미널 가이드 untuk pemula.

2단계: installer 실행

macOS, Linux 및 WSL

페이지 시작 부분의 install.sh 줄을 Terminal에 붙여넣고 Enter를 누른 뒤 완료될 때까지 기다리세요. 이 스크립트는 claude.ai에서 직접 가져와 프로그램을 ~/.local/bin/claude에 설치하며, 이후 Claude Code가 백그라운드에서 자체 업데이트됩니다. 공식 문서에서는 이 방법에 “권장”이라는 라벨을 붙입니다.

Windows: 먼저 사용 중인 터미널 확인

많은 오래된 튜토리얼은 PowerShell을 “관리자 권한으로 실행”하고 먼저 WSL을 설치하라고 안내합니다. 둘 다 필요하지 않습니다. 인도네시아어 공식 문서에 따르면 Windows 설치는 관리자 권한 없이 일반 터미널에서 실행되며 WSL은 선택 사항입니다. 사용할 명령은 프롬프트 모양으로 결정됩니다:

• PS C:\Users\NamaAnda> 프롬프트는 PowerShell을 의미합니다. irm … | iex 줄을 사용하세요.
• C:\Users\NamaAnda> 프롬프트에 PS가 없으면 Command Prompt(CMD)입니다. install.cmd 줄을 사용하세요.
• 시작 메뉴에서 “Windows PowerShell”을 선택하고 “Windows PowerShell (x86)”은 선택하지 마세요. x86 버전은 32비트로 실행되며 노트북이 64비트여도 Claude Code does not support 32-bit Windows로 끝납니다.

잘못된 터미널의 명령은 메시지에서 바로 확인할 수 있습니다. 예를 들어 The token '&&' is not a valid statement separator(PowerShell에서 CMD 줄 사용) 또는 'irm' is not recognized as an internal or external command(CMD에서 PowerShell 줄 사용)입니다. 인도네시아어 Windows에서는 메시지가 번역되어 표시될 수 있습니다. 전체 목록은 아래 오류 표에 있습니다.

Git tidak wajib. Kalau Git for Windows terpasang, tool Bash Claude Code memakai Git Bash; kalau tidak, perintah dijalankan lewat PowerShell. Bila Git sudah ada tetapi Git Bash tidak ditemukan, isi CLAUDE_CODE_GIT_BASH_PATH di blok env ~/.claude/settings.json dengan lokasi bash.exe, misalnya C:\Program Files\Git\bin\bash.exe. Kapan WSL layak dipakai:

WSL을 선택했나요? WSL 터미널에서 install.sh 줄을 실행하고, 항상 같은 WSL 터미널에서 claude를 여세요.

대안: Homebrew, WinGet 또는 npm

Homebrew와 WinGet도 공식 방법이지만 문서에 따르면 기본적으로 자동 업데이트되지 않습니다. 직접 업데이트해야 합니다:

# macOS lewat Homebrew (tidak update otomatis; perbarui dengan brew upgrade)
brew install --cask claude-code

# Windows lewat WinGet (tidak update otomatis; perbarui dengan winget upgrade)
winget install Anthropic.ClaudeCode

npm masih didokumentasikan, dengan syarat Node.js 22 이상 (unduh dari nodejs.org). Di Node.js lama npm hanya memberi peringatan EBADENGINE dan tetap memasang, karena paket ini sebenarnya mengunduh program native yang tidak bergantung pada Node.js saat berjalan.

node -v                                    # harus v22 ke atas
npm install -g @anthropic-ai/claude-code   # jangan pakai sudo

# memperbarui ke versi terbaru
npm install -g @anthropic-ai/claude-code@latest

npm 설치를 망가뜨리는 세 가지 습관이 있습니다. sudo npm install -g(문서에서는 권한 문제와 보안 위험의 원인이라고 설명), @latest 대신 npm update -g로 업데이트하기, 그리고 .npmrc에서 --omit=optional 또는 optional=false를 통해 optional dependencies를 비활성화하기입니다. 마지막 경우 플랫폼용 @anthropic-ai/claude-code-* 패키지가 다운로드되지 않아 macOS 또는 Linux에서 claude가 claude native binary not installed를 반환합니다.

PowerShell에서 npm이 때때로 npm.ps1 cannot be loaded because running scripts is disabled on this system 오류로 진행되지 않습니다. 이는 실행 정책이 .ps1 스크립트를 차단하기 때문입니다. 문서에서는 다음 세 가지 해결 방법을 제시합니다. 아래 명령으로 본인 사용자 계정에서 로컬 스크립트를 허용하거나, npm.cmd와 claude.cmd를 호출하거나, npm 대신 네이티브 설치 프로그램을 사용하세요.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

한 가지 더 주의하세요. 튜토리얼에 나오는 제3자 .exe 설치 프로그램, 특히 관리자 권한을 요구하는 설치 프로그램은 사용하지 마세요. 위의 공식 명령이면 충분합니다.

3단계: Claude Code가 설치되었는지 확인

설치한 터미널을 닫고 새 터미널을 여세요. 이전 창은 설치 전의 PATH를 계속 사용하므로 해당 창에서는 claude가 인식되지 않는 경우가 많습니다. 새 터미널에서:

claude --version   # muncul nomor versi = instalasi berhasil
claude doctor      # cek instalasi dan file pengaturan tanpa membuka sesi

claude doctor는 두 종류의 문제를 구분하는 데 유용합니다. 보고서가 정상인데도 Claude Code가 연결되지 않으면 원인은 설치가 아니라 구성(4단계)에 있습니다.

여전히 command not found: claude 또는 'claude' is not recognized인가요? 설치 폴더가 PATH에 추가되지 않은 것입니다. macOS와 Linux에서는 해당 폴더가 ~/.local/bin, Windows에서는 %USERPROFILE%\.local\bin입니다. Windows의 경우 문서에서 다음 PowerShell 명령을 제공합니다:

# Ada hasilnya? Berarti PATH sudah benar, cukup buka terminal baru.
$env:PATH -split ';' | Select-String '\.local\\bin'

# Tidak ada hasil? Tambahkan folder instalasi ke PATH user:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# Tutup PowerShell, buka lagi, lalu:
claude --version

Kalau unduhan sudah gagal sejak awal, perhatikan pesannya. Menurut 설치 문제 해결 페이지 (dicek 2026년 10월 3일), syntax error near unexpected token '<' atau curl: (22) The requested URL returned error: 403 berarti yang terunduh adalah halaman HTML atau kode error, bukan skrip. Tulisan App unavailable in region berarti koneksi Anda terlihat berasal dari negara yang tidak didukung; karena Indonesia didukung, tersangka utamanya VPN atau proxy. 403 tanpa isi juga sering datang dari proxy kantor atau firewall kampus. Homebrew, WinGet, dan npm mengambil dari host yang sama, jadi coba jaringan lain atau minta admin jaringan membuka aksesnya sebelum berganti metode.

4단계: 구독 없이 API key 설정

Claude Code에는 Anthropic 이외의 gateway로 request를 보내기 위한 기본 변수 ANTHROPIC_BASE_URL가 있으며 공식 문서에도 이를 위한 별도 페이지가 있습니다. 따라서 이는 지원되는 구성이지 수정이나 plugin이 아닙니다. 먼저 sk-kn-… key를 발급받고(목록과 잔액 충전은 6단계 참조), 저장할 위치 중 하나를 선택하세요.

macOS 및 Linux: 이 여섯 줄을 ~/.zshrc(macOS의 기본 shell인 Zsh) 또는 ~/.bashrc의 끝에 추가하고 저장한 후 새 터미널을 여세요.

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # domain saja, tanpa /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
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

Windows에서 먼저 테스트: 하나의 PowerShell 창에서 변수를 설정한 다음 바로 claude를 실행하세요.

# Untuk uji coba: hanya berlaku sampai jendela PowerShell ini ditutup
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

모든 OS에서 영구적으로 적용: 사용자 설정 파일 ~/.claude/settings.json의 env 블록에 넣으세요(Windows: %USERPROFILE%\.claude\settings.json). 모든 프로젝트에 적용됩니다. 파일에 이미 내용이 있다면 다른 설정을 덮어쓰지 말고 env 블록만 삽입하세요.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

앞서 언급한 여섯 변수에서 주의할 점:

Kenapa model dikunci? Menurut 모델 구성 문서 (dicek 2026년 10월 3일), untuk pengguna API model default dan alias opus saat ini menunjuk Opus 5.5, dan alias sonnet menunjuk Sonnet 5.5. Alias itu bergeser setiap kali ada rilis baru. Per 2026년 10월 3일 Sonnet 5.5 belum tersedia di Kunavo, dan model berikutnya belum tentu langsung tersedia; request ke model yang tidak ada dijawab 404. Karena itu blok di atas juga mengunci alias sonnet dengan ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5: tanpa pin itu, /model sonnet, fase eksekusi opusplan, dan subagent bermodel sonnet berakhir 404. Alias opus dikunci ke Claude Opus 5.5 (claude-opus-5-5), yang butuh Claude Code v2.1.280 atau lebih baru; kalau versi Anda lebih lama, jalankan claude update.

Kunavo의 100만 토큰당 요금(입력 / 출력): Claude Sonnet 5 $1,40 / $7,00 (Anthropic 정가: $2,00 / $10,00), Claude Opus 5.5 $2,80 / $14,00, Claude Haiku 4.5 $0,70 / $3,50.

Dua jebakan lain. Pertama, key jangan pernah masuk ke .claude/settings.json milik proyek: menurut 게이트웨이 문서, file itu di-commit dan ikut ter-clone oleh siapa pun yang mengambil repositori. Kedua, kalau variabel yang sama ada di shell dan di blok env file pengaturan, umumnya nilai dari file pengaturan yang menang; jadi kalau perubahan di ~/.zshrc seperti tidak berefek, periksa file pengaturan. Pengguna ekstensi VS Code mengisi variabel yang sama di claudeCode.environmentVariables pada user settings VS Code.

5단계: 첫 세션을 열고 /status 확인

프로젝트 폴더로 이동한 후 claude를 입력합니다. 키가 읽히면 로그인 화면 없이 세션이 바로 열립니다. 로그인 화면이 나타나면 키가 전달되지 않은 것입니다. 가장 흔한 원인은 키가 .claude/settings.json 또는 .claude/settings.local.json에만 있는 경우입니다. 대화형 모드에서는 프로젝트 파일의 env 블록을 초기 마법사와 이 폴더를 신뢰할지 묻는 질문이 끝난 후에야 읽으므로, Claude Code는 첫 실행 시에도 로그인을 요청합니다. 키를 셸이나 ~/.claude/settings.json로 옮기세요.

세션이 열린 후 /status를 입력합니다. 다음과 같으면 구성이 올바른 것입니다:

• Anthropic base URL 행에 https://api.kunavo.com가 포함되어 있고(이 행은 게이트웨이가 구성된 경우에만 나타납니다. 없으면 ANTHROPIC_BASE_URL를 읽지 못한 것입니다),
• Auth token 행에 ANTHROPIC_AUTH_TOKEN가 언급되어 있습니다. Login method가 claude.ai 계정과 함께 표시되면 Claude Code는 여전히 이전 로그인을 사용하고 있는 것입니다.

Claude Code를 열기 전에 키를 테스트하고 싶으신가요? 공식 문서에서는 출력 토큰을 1개만 요청하는 요청을 사용하므로 차감되는 잔액이 매우 적습니다. 이 명령은 현재 활성화된 셸의 변수를 읽습니다. 키를 설정 파일에 저장했다면 먼저 이 터미널에서 export하세요. {"id":"msg_로 시작하는 결과는 정상임을, 401는 키가 거부되었음을 의미합니다.

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

PowerShell 버전입니다. 응답의 id 필드가 msg_로 시작하면 성공입니다:

Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Claude Code가 API 키와 게이트웨이를 사용할 때는 다음과 같은 몇 가지 차이가 있습니다:

6단계: 카드 또는 Link로 잔액 충전(QRIS, GoPay, OVO, DANA 제외)

Kunavo에서 결제하는 것은 구독이 아니라 선불 API 잔액입니다. 키가 설정된 후 Claude Code가 토큰별로 차감하는 잔액입니다. 순서는 다음과 같습니다:

1. Kunavo 계정 만들기에서 이메일 또는 Google 계정을 사용합니다. 가입 시 카드는 요구되지 않습니다.
2. Billing을 열고 금액을 선택합니다. 최소 금액은 $10이며 월별 비용은 없습니다. 더 큰 금액을 충전하면 잔액 보너스를 받을 수 있습니다: bayar $100 → saldo $110, bayar $1.000 → saldo $1.200, bayar $5.000 → saldo $6.250.
3. Di checkout Stripe, bayar dengan kartu (Visa, Mastercard, dll.), Link, atau Apple Pay/Google Pay kalau perangkat dan browser Anda sudah menyiapkannya. Link menyimpan data pembayaran sehingga top-up berikutnya cukup beberapa klik.
4. API Keys를 열고 키를 만듭니다. sk-kn-로 시작하는 키는 한 번만 표시되므로 즉시 ANTHROPIC_AUTH_TOKEN에 복사하세요.

QRIS, GoPay, OVO, DANA, ShopeePay, 가상 계좌 및 은행 송금은 사용할 수 없습니다. 국제 온라인 결제가 가능한 카드가 없으면 현재 Kunavo에서 충전할 수 없습니다. Visa 또는 Mastercard 로고가 있는 직불카드도 카드에 포함됩니다. 거부되는 경우 일반적으로 은행 앱에서 온라인 또는 해외 거래가 아직 활성화되지 않은 것이며, 최종 결정은 발급 은행에 있습니다.

Harga Kunavo dalam USD. Kalau checkout menampilkan rupiah, kursnya ditentukan Stripe dan sudah memuat biaya konversi 2–4% yang ditanggung pembeli (Stripe 적응형 가격 책정 문서, dicek 2026년 10월 3일). Memilih bayar dalam USD menghindari biaya itu, meski kurs dan biaya dari bank Anda sendiri tetap berlaku.

잔액은 만료되지 않으며 실패한 요청은 잔액을 차감하지 않습니다. 자동 충전은 저장된 카드 또는 Link로만 작동합니다. Kunavo는 어떤 세금 서류도 발행하지 않습니다. 이 잔액은 Claude Pro 또는 Max 결제에도 사용할 수 없습니다. 모든 Claude 모델의 요금과 인도네시아에서 결제하는 방법은 Claude API 가격에, Claude Code 전용 구독과 API 키 비용 비교는 Claude Code 가격에 설명되어 있습니다.

대략 얼마나 소진되나요?

Claude Code의 각 요청은 대화 컨텍스트를 다시 전송하지만, 요청마다 반복되는 동일한 앞부분에는 훨씬 저렴한 캐시 읽기 요금이 적용됩니다. 아래 계산은 명시된 가정을 바탕으로 한 순수 토큰 산술이며, 측정 결과나 상한선이 아닙니다:

• 요청 1회 = 입력 토큰 40.000개; 36.000(90%)는 캐시에서 읽고 나머지 4.000는 캐시에 기록합니다;
• 요청 1회에서 출력 토큰 1.000개가 생성됩니다;
• 세션 1개 = 50회 요청이며, 백그라운드에서 발생하는 Claude Haiku 4.5 호출은 포함하지 않습니다;
• 캐시 읽기 요금은 10%, 캐시 쓰기 요금은 입력 요금의 1,25×입니다(Kunavo에서 Claude Sonnet 5 비율이며, 표의 각 모델은 자체 비율을 사용합니다).

실제 수치는 컨텍스트 길이, 캐시 적중 빈도, 응답 길이, 작업을 전환할 때 /clear로 대화를 지우는지 여부에 따라 달라집니다. Anthropic 비용 문서에 따르면 Claude Code 자체의 백그라운드 프로세스는 일반적으로 세션당 $0,04 미만입니다(2026년 10월 3일 확인). 전체 요금은 가격 페이지에서 확인할 수 있으며, 자체 사용 패턴을 추정하려면 Claude 토큰 비용 계산기(영어)를 사용할 수 있습니다.

일상적인 Claude Code 사용 방법

cd ~/proyek-saya   # Claude Code bekerja di folder tempat ia dijalankan
claude              # mulai sesi
claude -c           # lanjutkan percakapan terakhir di folder ini

• “이 프로젝트의 구조를 설명해 줘” 또는 “로그인 페이지의 오류를 수정해 줘”처럼 평범한 말로 요청하세요. Claude Code는 파일을 읽고 무언가를 변경하거나 실행하기 전에 권한을 묻습니다.
• 작업을 전환할 때 /clear를 사용하면 이전 기록이 다시 전송되지 않으므로 요청당 토큰 수가 줄어듭니다.
• 모델을 변경하려면 /model를 사용합니다. 4단계에서 고정한 경우 opus = claude-opus-5-5, sonnet = claude-sonnet-5, haiku = claude-haiku-4-5입니다.
• 게이트웨이와 키를 확인하려면 /status를, 비용을 추정하려면 /usage를 사용합니다(정가 기준이며 5단계의 표 참조).

오류 메시지와 의미

제한 사항

• 카드, Link 또는 Apple Pay/Google Pay로만 결제할 수 있습니다. QRIS, GoPay, OVO, DANA, ShopeePay, 가상 계좌 또는 은행 송금은 제공되지 않으며, 자동 충전은 저장된 카드 또는 Link로만 가능합니다.
• Kunavo는 어떤 세금 서류도 발행하지 않습니다.
• 이는 Claude Pro 또는 Max 구독이 아니라 토큰당 요금이 부과되는 유료 API입니다. API 키를 사용하면 Remote Control과 음성 받아쓰기를 사용할 수 없고, /fast가 비활성화되며 MCP 도구 검색이 기본적으로 꺼져 있습니다.
• 2026년 10월 3일 기준으로 Sonnet 5.5는 Kunavo에서 아직 사용할 수 없습니다. 모델을 고정하지 않으면 기본 별칭이 404로 끝날 수 있습니다.
• Claude Code 문서는 인도네시아어로 제공되지만, Kunavo 통합 문서와 이 가이드의 영어 버전(Install Claude Code)은 아직 인도네시아어로 제공되지 않습니다.

자주 묻는 질문