如何安装 Claude Code：Windows、macOS 和 Linux 官方命令、无需订阅的 API 密钥、检查 /status，以及使用银行卡或 Link 付款

简而言之：使用一个官方命令安装 Claude Code（在下面选择适用于 macOS/Linux、PowerShell 或 CMD 的命令行），然后使用 API key 而不是登录进行连接。只需设置六个变量：ANTHROPIC_BASE_URL=https://api.kunavo.com（不包含 /v1）、包含 key 的 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

本文中的所有命令和变量名称均与 Claude Code 官方文档保持一致，核对日期为2026年10月3日。该文档已提供印度尼西亚语版本，包括安装页面和LLM 网关连接页面，您可以自行对照。Kunavo 的价格和付款方式核实于2026年10月10日。

从零开始运行 Claude Code 的六个步骤

1. 确认笔记本电脑满足要求，并决定使用 Claude 账户登录还是 API key。
2. 根据所使用的终端运行相应的 native 安装程序。
3. 打开新终端，检查 claude --version，如有需要修复 PATH。
4. 设置 API key 并固定模型。
5. 打开第一个会话，并通过 /status 确认使用的是你的 key。
6. 使用银行卡或 Link 充值，然后开始工作。

步骤 1：检查要求，然后选择登录或 API key

安装完成后，Claude Code 需要知道由谁付费。第一种方式是登录 Claude 账户，这要求您拥有 Pro、Max、Team、Enterprise 或 Console 账户；Claude.ai 免费计划不包含 Claude Code。根据Claude 价格页面（核实日期：2026年10月3日），Pro 每月收费 20 美元，按年付费时每月 17 美元（预付 200 美元），Max 起价为每月 100 美元，所有价格均不含税费。通过网站购买的订阅，Anthropic 只接受信用卡或借记卡；通过 iOS 或 Android 应用购买的订阅则通过 App Store 或 Google Play 付款（Claude 账单常见问题，核实日期：2026年10月3日）。登录方法见官方身份验证页面。

第二种方式，也是本指南详细介绍的方式，是 API key：无需订阅，也无需登录界面。您只需为实际使用的 token 付费，因此在使用量较低的月份，费用也会相应降低。唯一缺少的是与 claude.ai 账户绑定的两个功能，即 Remote Control 和语音听写；完整差异列表见第 5 步。

第一次打开终端？Anthropic 为初学者提供了印度尼西亚语终端指南。

第 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 行。
• 不带 PS 的提示符 C:\Users\NamaAnda> 表示命令提示符（CMD）。使用 install.cmd 行。
• 在“开始”菜单中选择“Windows PowerShell”，不要选择“Windows PowerShell (x86)”。x86 版本以 32 位运行，最终会显示 Claude Code does not support 32-bit Windows，即使笔记本电脑是 64 位的。

终端命令用错时，提示信息会直接显示出来，例如 The token '&&' is not a valid statement separator（在 PowerShell 中运行 CMD 行）或 'irm' is not recognized as an internal or external command（在 CMD 中运行 PowerShell 行）。在印度尼西亚语 Windows 中，提示信息可能会以翻译后的形式显示。完整列表见下方的错误表。

Git 不是必需的。如果已安装Git for Windows，Claude Code 的 Bash 工具会使用 Git Bash；如果未安装，命令会通过 PowerShell 运行。如果已安装 Git，但找不到 Git Bash，请在env~/.claude/settings.json的区块中填写CLAUDE_CODE_GIT_BASH_PATH，指向bash.exe所在位置，例如C:\Program Files\Git\bin\bash.exe。以下情况适合使用 WSL：

选择 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 安装方式，但要求使用Node.js 22 或更高版本（可从nodejs.org下载）。在较旧版本的 Node.js 上，npm 只会发出EBADENGINE警告，仍会继续安装，因为该软件包实际下载的是一个原生程序，运行时不依赖 Node.js。

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 进行更新，以及通过 --omit=optional 或 optional=false 在 .npmrc 中禁用可选依赖。最后一种做法会阻止为您的平台下载 @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

如果下载一开始就失败，请留意错误消息。根据安装故障排查页面（核实日期：2026年10月3日），出现syntax error near unexpected token '<'或curl: (22) The requested URL returned error: 403表示下载到的是 HTML 页面或错误代码，而非脚本。出现App unavailable in region表示您的连接显示为来自不受支持的国家/地区；印度尼西亚受支持，因此首要怀疑对象是 VPN 或代理。没有任何正文内容的 403 错误也常由公司代理或校园防火墙导致。Homebrew、WinGet 和 npm 都从同一主机下载，因此请先尝试更换网络，或请网络管理员开放访问权限，再更换安装方式。

第 4 步：无需订阅即可设置 API key

Claude Code 内置了 ANTHROPIC_BASE_URL 变量，用于将请求发送到 Anthropic 以外的网关，官方文档也有专门的页面介绍这一点。因此，这是受支持的配置，而不是修改或插件。先获取 sk-kn-… key（列表和充值方式见第 6 步），然后选择一个位置保存它。

macOS 和 Linux：将这六行添加到 ~/.zshrc（Zsh，macOS 的默认 shell）或 ~/.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

所有操作系统，永久设置：将其放入用户设置文件 ~/.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"
  }
}

关于上述六个变量，需要注意：

为什么要固定模型？根据模型配置文档（核实日期：2026年10月3日），对于 API 用户，默认模型和别名opus当前指向 Opus 5.5，别名sonnet指向 Sonnet 5.5。每次发布新版本时，这些别名都会变化。截至2026年10月3日，Kunavo 尚未提供 Sonnet 5.5，后续模型也未必能立即上线；向不存在的模型发送请求会返回 404。因此，上述配置也会通过ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5固定别名sonnet：如果不固定，/model sonnet、opusplan的执行阶段以及使用sonnet模型的子代理都会返回 404。别名opus会固定到Claude Opus 5.5（claude-opus-5-5），该模型要求 Claude Code v2.1.280 或更高版本；如果您的版本较旧，请运行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。

还有两个容易忽略的地方。首先，切勿将密钥放入项目中的.claude/settings.json：根据网关文档，该文件会提交到代码库，任何获取仓库的人都能克隆到它。其次，如果同一个变量同时存在于 shell 和设置文件的env区块中，通常会优先采用设置文件中的值；因此，如果更改~/.zshrc后似乎没有生效，请检查设置文件。VS Code 扩展用户应在 VS Code 用户设置的claudeCode.environmentVariables中填写相同的变量。

第 5 步：打开第一个会话并检查 /status

进入项目文件夹并输入 claude。如果 key 已被读取，会直接打开会话，无需登录界面。如果出现登录界面，说明 key 尚未传入。最常见的原因是 key 只存在于.claude/settings.json或.claude/settings.local.json项目中。在交互模式下，项目文件中的 env 代码块要等初始向导和“是否信任此文件夹”的问题完成后才会读取，因此 Claude Code 在首次启动时仍会要求登录。请将 key 移到 shell 或 ~/.claude/settings.json 中。

会话打开后，输入 /status。以下情况表示配置正确：

• 存在一行 Anthropic base URL，其内容为 https://api.kunavo.com（只有在设置了网关时才会显示此行；没有此行表示未读取 ANTHROPIC_BASE_URL），并且
• 存在提到 ANTHROPIC_AUTH_TOKEN 的 Auth token 行。如果显示的是带 claude.ai 账户的 Login method，Claude Code 仍在使用旧的登录方式。

想在打开 Claude Code 之前测试 key？官方文档使用只请求 1 个输出 token 的请求，因此扣除的余额非常少。该命令会从当前活动 shell 读取变量；如果 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 会按 token 从该余额中扣费。流程如下：

1. 使用电子邮箱或 Google 账户创建 Kunavo 账户。注册时无需提供银行卡。
2. 打开 Billing 并选择金额。最低金额为 $10，无月费。充值金额越大，余额奖励越多：支付 $100 → 余额增加 $110、支付 $1.000 → 余额增加 $1.200和支付 $5.000 → 余额增加 $6.250。
3. 在 Stripe 结账页面，您可以使用银行卡（Visa、Mastercard 等）、Link，或者在设备和浏览器已设置相应钱包时使用 Apple Pay/Google Pay。Link会保存付款信息，因此下次充值只需点击几次。
4. 打开 API Keys 并创建 key。以 sk-kn- 开头的 key 只显示一次，因此请立即将其复制到 ANTHROPIC_AUTH_TOKEN。

不支持 QRIS、GoPay、OVO、DANA、ShopeePay、虚拟账户和银行转账。如果没有可进行国际在线交易的银行卡，目前无法在 Kunavo 充值。带有 Visa 或 Mastercard 标志的借记卡也属于银行卡；如果被拒，通常是因为银行应用中尚未启用在线交易或境外交易，最终决定权在发卡银行。

Kunavo 以美元标价。如果结账页面显示印尼盾，汇率由 Stripe 决定，并已包含由购买者承担的 2–4% 货币换算费（Stripe Adaptive Pricing 文档，核实日期：2026年10月3日）。选择以美元付款可以避免这笔费用，但您自己的银行汇率和费用仍可能适用。

余额永不过期，失败的请求也不会扣除余额。自动充值仅适用于已保存的银行卡或 Link。Kunavo 不开具任何税务文件。该余额也不能用于支付 Claude Pro 或 Max。所有 Claude 模型的费率详情以及从印度尼西亚付款的方式见Claude API 价格；专门针对 Claude Code 的订阅与 API key 费用比较见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 检查网关和 key；使用 /usage 估算费用（按列表价格，见第 5 步的表格）。

错误信息及其含义

限制

• 只能使用银行卡、Link 或 Apple Pay/Google Pay 付款。不支持 QRIS、GoPay、OVO、DANA、ShopeePay、虚拟账户或银行转账；自动充值仅支持已保存的银行卡或 Link。
• Kunavo 不开具任何税务文件。
• 这是按 token 付费的 API，不是 Claude Pro 或 Max 订阅。使用 API key 时，Remote Control 和语音听写不可用，/fast 处于停用状态，MCP 工具搜索默认关闭。
• 截至 2026年10月3日，Kunavo 尚未提供 Sonnet 5.5；未固定模型时，默认别名可能返回 404。
• Claude Code 文档提供印度尼西亚语版本，但Kunavo 集成文档以及本指南的英语版本（Install Claude Code）尚未提供印度尼西亚语版本。

常见问题