如何安裝 Claude Code：Windows、macOS 與 Linux 的官方指令、無需訂閱的 API 金鑰、檢查 /status，以及使用信用卡或 Link 付款

簡而言之：使用一個官方指令安裝 Claude Code（在下方選擇 macOS/Linux、PowerShell 或 CMD 的指令列），然後連接 API 金鑰，而不是登入。只需六個變數：ANTHROPIC_BASE_URL=https://api.kunavo.com（不含 /v1）、ANTHROPIC_AUTH_TOKEN 填入金鑰，以及四個用來固定模型的變數。使用 /status 檢查結果。不需要訂閱 Pro 或 Max；您從預付餘額中支付 token 費用，最低從 $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 執行的六個步驟

1. 確認筆記型電腦符合條件，並決定使用 Claude 帳戶登入或 API 金鑰。
2. 依照您的 terminal 執行原生 installer。
3. 開啟新的 terminal，檢查 claude --version，必要時修正 PATH。
4. 設定 API 金鑰並固定模型。
5. 開啟第一個工作階段，透過 /status 確認使用的是您的金鑰。
6. 使用卡片或 Link 加值，然後開始工作。

步驟 1：檢查條件，然後選擇登入或 API 金鑰

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 billing 常見問題, dicek 2026年10月3日). Cara login dijelaskan di 官方驗證頁面.

第二種方式，也就是本指南完整介紹的方式，是使用 API 金鑰：不需訂閱，也不會出現登入畫面。您只需為實際使用的 token 付費，因此在工作量少的月份，費用也會相應降低。唯一缺少的是兩項綁定 claude.ai 帳戶的功能，也就是 Remote Control 和語音聽寫；完整差異清單請見步驟 5。

Baru pertama kali membuka terminal? Anthropic menyediakan 印尼語 terminal 指南 untuk pemula.

步驟 2：執行 installer

macOS、Linux 和 WSL

將頁面開頭的 install.sh 那一行貼到 Terminal，按下 Enter，然後等待完成。該 script 會直接從 claude.ai 取得，將程式安裝到 ~/.local/bin/claude，之後 Claude Code 會在背景自動更新。在官方文件中，此方法標示為「建議」。

Windows：先確認您的 terminal

許多舊教學會要求先開啟 PowerShell 的「Run as Administrator」並安裝 WSL。兩者都不需要：官方印尼語文件表示 Windows 安裝可在一般 terminal 中執行，不需要 Administrator 權限，而 WSL 只是選項。要使用哪個指令取決於提示字元的外觀：

• 提示字元 PS C:\Users\NamaAnda> 表示 PowerShell。請使用 irm … | iex 那一行。
• 沒有 PS 的提示字元 C:\Users\NamaAnda> 表示 Command Prompt (CMD)。請使用 install.cmd 那一行。
• 在開始功能表中選擇「Windows PowerShell」，不要選擇「Windows PowerShell (x86)」。x86 版本以 32 位元執行，最後會顯示 Claude Code does not support 32-bit Windows，即使筆記型電腦是 64 位元。

從訊息通常可以立即看出 terminal 指令是否用錯，例如 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 terminal 中執行 install.sh 那一行，並且始終從同一個 WSL terminal 開啟 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（文件稱其為權限問題和安全風險的來源）、使用 npm update -g 而不是 @latest 進行更新，以及在 .npmrc 中透過 --omit=optional 或 optional=false 停用選用 dependency。最後一項會導致不下載適用於您平台的 @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

再提醒一次：請忽略教學中流傳的第三方 .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 金鑰

Claude Code 內建 ANTHROPIC_BASE_URL 變數，可將要求傳送至 Anthropic 以外的閘道，官方文件也有專門的頁面說明。因此這是受支援的設定，而不是修改或外掛程式。請先取得 sk-kn-… 金鑰（清單及儲值方式請參閱步驟 6），然後選擇以下其中一個位置儲存。

macOS 和 Linux： 將這六行加入 ~/.zshrc（macOS 的預設 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

所有作業系統，永久設定： 將內容放入使用者設定檔的 env 區塊 ~/.claude/settings.json（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 萬個 token 的費率（輸入 / 輸出）：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 第一次啟動時仍會要求登入。請將金鑰移至 shell 或 ~/.claude/settings.json。

工作階段開啟後，輸入 /status。設定正確時：

• 有一行 Anthropic base URL，其內容為 https://api.kunavo.com（只有在設定閘道時才會顯示此行；若沒有，表示未讀取 ANTHROPIC_BASE_URL），而且
• 有一行 Auth token 提到 ANTHROPIC_AUTH_TOKEN。如果顯示的是使用 claude.ai 帳戶的 Login method，Claude Code 仍在使用舊的登入方式。

想在開啟 Claude Code 前測試金鑰嗎？官方文件使用只要求 1 個輸出 token 的要求，因此扣除的餘額非常少。指令會從目前作用中的 shell 讀取變數；如果您的金鑰儲存在設定檔中，請先在此終端機執行 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 會按 token 從此餘額扣款。流程如下：

1. 使用電子郵件或 Google 帳戶建立 Kunavo 帳戶。註冊時不需要信用卡。
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 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 價格；訂閱與 API 金鑰的比較，且專門針對 Claude Code 的內容，請參閱 Claude Code 價格。

大約會用掉多少費用？

每個 Claude Code 要求都會重新傳送對話內容，但每次要求中相同的開頭部分會以低得多的快取讀取費率計價。以下計算純粹是依照所列假設進行的 token 算術，不是實際測量結果，也不是上限：

• 一次要求 = 40.000 個輸入 token；其中 36.000（90%）從快取讀取，其餘 4.000 寫入快取；
• 一次要求產生 1.000 個輸出 token；
• 一次工作階段 = 50 次要求，不包括背景中的 Claude Haiku 4.5 呼叫；
• 快取讀取費率為 10%，快取寫入費率為輸入費率的 1,25 倍（Kunavo 中 Claude Sonnet 5 的比例；表格中的每個模型都有自己的比例）。

您的實際數字會隨著上下文長度、快取命中頻率、回覆長度，以及在切換工作時是否使用 /clear 清除對話而上下波動。根據 Anthropic 的費用文件，Claude Code 本身的背景處理費用通常每個工作階段低於 $0.04（查核日期：2026年10月3日）。完整費率請參閱價格頁面；若要估算自己的使用模式，可使用Claude token 費用計算機（英文）。

日常使用 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：舊的歷史記錄不會再次傳送，因此每次要求的 token 會減少。
• 使用 /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 不會核發任何稅務文件。
• 這是按 token 計費的付費 API，不是 Claude Pro 或 Max 訂閱。使用 API 金鑰時，Remote Control 和語音聽寫無法使用，/fast 會停用，MCP 工具搜尋預設關閉。
• 截至 2026年10月3日，Kunavo 尚未提供 Sonnet 5.5；未固定模型時，內建別名可能會以 404 結束。
• Claude Code 文件提供印尼文版本，但Kunavo 整合文件以及本指南的英文版本（Install Claude Code）尚未提供印尼文版本。

常見問題