Claude Codeのインストール方法：Windows、macOS、Linux向け公式コマンド、サブスクリプションなしのAPIキー、/statusの確認、カードまたはLinkでの支払い

要約すると、公式の1つのコマンドでClaude Codeをインストールし（以下でmacOS/Linux、PowerShell、またはCMD用の行を選択）、ログインではなくAPI keyで接続します。必要なのは6つの変数だけです。ANTHROPIC_BASE_URL=https://api.kunavo.com（/v1なし）、keyを含むANTHROPIC_AUTH_TOKEN、そしてモデルを固定する4つの変数です。/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ゲートウェイへの接続ページ, jadi Anda bisa mencocokkan sendiri. Harga dan metode pembayaran Kunavo dicek 2026年10月3日.

ゼロからClaude Codeを実行するまでの6ステップ

1. ノートパソコンが要件を満たしていることを確認し、Claudeアカウントでログインするか、API keyを使うかを決めます。
2. 使用するターミナルに応じたネイティブインストーラーを実行します。
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 公式認証ページ.

このガイドで詳しく説明する2つ目の方法はAPI keyです。サブスクリプションは不要で、ログイン画面も表示されません。実際に使用したトークンごとに支払うため、利用の少ない月は料金も少なくなります。失われるのはclaude.aiアカウントに紐づく2つの機能、Remote Controlと音声ディクテーションだけです。違いの一覧はステップ5にあります。

Baru pertama kali membuka terminal? Anthropic menyediakan インドネシア語のターミナルガイド untuk pemula.

ステップ2：インストーラーを実行する

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のインストールを壊す3つの習慣があります。sudo npm install -gを使用すること（ドキュメントでは、権限問題とセキュリティリスクの原因とされています）、@latestではなくnpm update -gで更新すること、そして--omit=optionalまたは.npmrc内のoptional=falseでオプションの依存関係を無効にすることです。最後の操作により、プラットフォーム用の@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をやめてネイティブインストーラーを使う、という3つの解決策を示しています。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

もう1つ注意があります。チュートリアルで流通している第三者製の.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は2種類の問題を切り分けるのに役立ちます。レポートが正常なのに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以外のゲートウェイにリクエストを送信するための組み込み変数ANTHROPIC_BASE_URLがあり、公式ドキュメントにも専用ページがあります。したがって、これはサポートされている設定であり、改変やプラグインではありません。まずsk-kn-…のキーを取得し（アカウント登録と残高のチャージについてはステップ6を参照）、保存場所を1つ選びます。

macOSとLinux：~/.zshrc（macOSのデフォルトであるZsh）または~/.bashrcの末尾にこの6行を追加し、保存してから新しいターミナルを開きます。

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でまず試す場合：1つの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"
  }
}

先ほどの6つの変数について注意すべき点：

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と入力します。keyが読み込まれていれば、セッションはログイン画面なしで直接開きます。ログイン画面が表示される場合は、keyが渡っていないサインです。最も多い原因は、keyがプロジェクトの.claude/settings.jsonまたは.claude/settings.local.jsonにしかないことです。インタラクティブモードでは、プロジェクトファイルのenvブロックは初期ウィザードと、このフォルダーを信頼するかどうかの質問の後に初めて読み込まれます。そのため、Claude Codeの初回起動時にはログインを求められます。keyをシェルまたは~/.claude/settings.jsonに移してください。

セッションが開いたら/statusと入力します。次の状態なら設定は正しいです。

• Anthropic base URL行にhttps://api.kunavo.comが含まれている（この行はゲートウェイが設定されている場合のみ表示されます。表示されない場合はANTHROPIC_BASE_URLが読み込まれていません）、かつ
• ANTHROPIC_AUTH_TOKEN に言及している Auth token の行があります。Login method に claude.ai アカウントが表示されている場合、Claude Code はまだ以前のログインを使用しています。

Claude Codeを開く前にkeyをテストしますか？公式ドキュメントでは、出力を1トークンだけ要求するリクエストを使用するため、差し引かれる残高はごくわずかです。このコマンドは現在アクティブなシェルから変数を読み込みます。keyを設定ファイルに保存している場合は、このターミナルで先にexportしてください。{"id":"msg_で始まる結果は成功、401はkeyが拒否されたことを意味します。

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 keyとゲートウェイを使用している間は、いくつかの動作が異なります。

ステップ6：カードまたはLinkで残高をチャージする（QRIS、GoPay、OVO、DANAは不可）

Kunavoで支払うのはサブスクリプションではなく、プリペイドAPI残高です。keyの設定後、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を開いてkeyを作成します。sk-kn-で始まるkeyは一度しか表示されないため、その場で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のAdaptive Pricingに関するドキュメント, 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 keyの比較は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自体のバックグラウンド処理は通常、1セッションあたり$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です。
• ゲートウェイとkeyの確認には/status、料金の概算には/usageを使用します（リスト価格に基づく。ステップ5の表を参照）。

エラーメッセージとその意味

制限

• カード、Link、またはApple Pay/Google Payでのみ支払えます。QRIS、GoPay、OVO、DANA、ShopeePay、バーチャルアカウント、銀行振込には対応していません。自動チャージは保存済みカードまたはLinkでのみ利用できます。
• Kunavoはいかなる税務書類も発行しません。
• これはトークン単位の従量課金APIであり、Claude ProまたはMaxのサブスクリプションではありません。API keyを使用する場合、Remote Controlと音声ディクテーションは利用できず、/fastは無効で、MCP tool searchはデフォルトで無効になっています。
• 2026年10月3日 あたり Sonnet 5.5 は現在 Kunavo では利用できません。モデルを固定しない場合、組み込みエイリアスが 404 になる可能性があります。
• Claude Code のドキュメントはインドネシア語で利用できますが、Kunavo 統合のドキュメントと、このガイドの英語版（Install Claude Code）はまだインドネシア語で利用できません。

よくある質問