如何在 Windows、macOS 和 Linux 上安装 Claude Code——无需订阅的 API 密钥，以及使用 BLIK 付款

Claude Code 只需一个官方命令即可安装（下面分别提供 macOS 和 Linux、PowerShell 以及 CMD 的版本）。Anthropic 推荐使用原生安装程序，而 npm 是需要 Node.js 22 或更高版本的替代方案。无需 Pro/Max 订阅或登录，只需设置 ANTHROPIC_BASE_URL=https://api.kunavo.com（不带 /v1）、带 API key 的 ANTHROPIC_AUTH_TOKEN，以及用于固定模型的四个变量。这样您只需从余额中支付已使用的 token，而余额可使用波兰兹罗提通过 BLIK 充值，最低为 10 USD。最后，在 Claude Code 中输入 /status，检查 key 是否正常工作。

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

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

:: Windows – wiersz polecenia (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

我们于 2026年10月3日 对照了Claude Code 官方安装文档和环境变量文档核实了命令和变量。没有波兰语版文档。我们于 2026年10月10日 核实了价格和支付方式。波兰在Anthropic 支持的国家/地区列表中（核实于 2026年10月3日），Claude.ai 和 API 均支持波兰。

登录还是 API 密钥？

安装 Claude Code 后，必须完成身份验证。有两种方式，本指南详细介绍第二种：

开始之前

方法 1：原生安装程序（推荐）

在官方文档中，此方法的选项卡名称为“Native Install (Recommended)”。命令位于页面开头。在 macOS、Linux 和 WSL 中，使用包含 install.sh 的命令行。在 Windows PowerShell 中使用 irm … | iex，在 CMD 命令提示符中使用包含 install.cmd 的命令行。原生安装会在后台自动更新。也可以通过 Homebrew 或 WinGet 安装 Claude Code，但根据文档，这些安装默认不会自动更新，因此需要在包管理器中手动更新：

# Homebrew – kanał stable; domyślnie nie aktualizuje się sam
brew install --cask claude-code

# WinGet (Windows) – domyślnie nie aktualizuje się sam
winget install Anthropic.ClaudeCode

安装后，打开一个新的终端窗口，因为之前打开的窗口看不到更新后的 PATH 变量。然后检查：

claude --version   # wypisuje numer wersji, np. 2.1.280 (Claude Code)
claude doctor      # diagnostyka instalacji i ustawień, bez otwierania sesji

claude doctor 不会打开会话。它只会输出安装状态和设置文件诊断信息。因此，你可以最快区分安装问题和配置问题。

下载失败时

如果终端显示 syntax error near unexpected token '<' 或 curl: (22) The requested URL returned error: 403，根据官方安装故障排查页面（核实于 2026年10月3日），这表示安装程序地址返回了 HTML 页面或错误代码，而不是脚本。文档说明，显示 App unavailable in region 意味着 Claude Code 在你所在的国家/地区不可用。不过，波兰在支持的国家/地区列表中，因此如果你在波兰看到此提示，请检查连接是否经过 VPN 或代理。没有具体内容的 403 错误也可能来自阻止下载的公司代理或防火墙。文档建议先检查网络连接，因为其他安装方式也会连接到相同服务器。请尝试使用其他网络，或请管理员解除对这些地址的阻止。

方法 2：npm（Node.js 22 或更高版本）

npm 仍是官方文档所述的安装方式之一。该软件包要求使用 Node.js 22 或更高版本。一些波兰语指南仍建议使用 Node.js 18，这已经过时。在较旧版本的 Node.js 上，npm 会显示 EBADENGINE 警告，但不会中止安装；claude 仍可运行，因为该软件包会下载一个运行时不依赖 Node.js 的原生程序。如果你没有安装 Node.js，请从 nodejs.org 页面安装 22 或更高版本。

node -v                                    # potrzebna wersja v22 lub nowsza
npm install -g @anthropic-ai/claude-code   # bez sudo

# aktualizacja: @latest, a nie npm update -g
npm install -g @anthropic-ai/claude-code@latest

• 绝不要使用 sudo npm install -g。 文档警告称，这会导致权限问题并带来安全风险。
• 通过 @latest 更新。 更新时请使用 npm install -g @anthropic-ai/claude-code@latest，而不是 npm update -g。
• 不要跳过可选依赖。 正确的程序会作为可选依赖安装，也就是适用于你平台的 @anthropic-ai/claude-code-* 包。使用 --omit=optional，或在 .npmrc 中设置 optional=false 后，在 macOS 或 Linux 上安装会以 claude native binary not installed 消息结束。

Windows 上的 Claude Code：PowerShell、CMD、WSL 和 PATH

Windows 有两个不同的安装命令，选择哪个只取决于终端。如果命令行以 PS C:\Users\TwojaNazwa> 开头，你使用的是 PowerShell。如果只看到 C:\Users\TwojaNazwa> 而没有 PS，则是命令提示符（CMD）。根据文档，无需以管理员身份运行终端，尽管某些指南会这样建议。

最常见的错误是将命令粘贴到错误的终端中。将 CMD 命令行粘贴到 PowerShell 会产生 The token '&&' is not a valid statement separator。将 PowerShell 命令行粘贴到 CMD 会产生 'irm' is not recognized as an internal or external command。在波兰语 Windows 中，同一消息为：“irm”不被识别为内部或外部命令、可运行程序或批处理文件。另一方面，将 macOS 的 curl … | bash 命令行粘贴到 PowerShell 会以 A parameter cannot be found that matches parameter name 'fsSL' 或 'bash' is not recognized as the name of a cmdlet 错误结束。在所有这些情况下，只需使用适用于你所用终端的命令行即可。

开始菜单中有两个条目：“Windows PowerShell”和“Windows PowerShell (x86)”。后者作为 32 位进程运行，因此即使在 64 位计算机上也会产生 Claude Code does not support 32-bit Windows 错误。请打开不带 (x86) 后缀的条目。

Git for Windows 是可选的，但建议安装。安装后，Claude Code 会通过随附的 Git Bash 执行命令；未安装时则通过 PowerShell 执行。如果已安装 Git，但 Claude Code 找不到 Git Bash，请在 ~/.claude/settings.json 文件的 env 区块中设置 CLAUDE_CODE_GIT_BASH_PATH 变量，并将其值设为 bash.exe 的路径。文档中的示例路径为 C:\Program Files\Git\bin\bash.exe。

如果选择 WSL，请在 WSL 终端中运行适用于 macOS 和 Linux 的命令行，并在那里启动 claude，不要在 PowerShell 或 CMD 中启动。

执行策略错误（PowerShell 中的 npm）

在通过 npm 安装或启动时出现 npm.ps1 cannot be loaded because running scripts is disabled on this system 消息，表示 PowerShell 的执行策略阻止了 npm 生成的启动脚本 .ps1。根据文档，你可以允许当前用户运行本地脚本（使用下面的命令）、使用 npm.cmd 和 claude.cmd，或改用 PowerShell 原生安装程序。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

安装后无法识别“claude”命令

command not found: claude 或 'claude' is not recognized 表示安装目录不在 PATH 中。原生安装程序会在 macOS 和 Linux 上将程序放入 ~/.local/bin/claude，在 Windows 上放入 %USERPROFILE%\.local\bin\claude.exe。首先打开新的终端。如果 Windows 上仍无法运行，请按照文档中的方法在 PowerShell 中检查并添加路径：

# 1. Sprawdź, czy katalog instalacji jest już w PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Brak wyniku? Dopisz go do PATH użytkownika, zamknij i otwórz terminal
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. W nowym terminalu
claude --version

使用 API 密钥而非登录（无需订阅）

ANTHROPIC_BASE_URL 是 Claude Code 的内置变量。根据官方文档，它会覆盖 API 端点，以便通过代理或网关（gateway）转发请求。因此，将 Claude Code 连接到兼容 Anthropic Messages API 的服务是 Anthropic 预期支持的配置。不需要插件或修改后的程序。在 macOS 和 Linux 上，将变量添加到 Shell 配置文件（~/.zshrc 或 ~/.bashrc）中：

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # sama domena, bez /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 窗口中检查配置：

# Działa tylko w tym oknie PowerShella – po zamknięciu znika
$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"
  }
}

这六行中的每一行都容易出错：

• ANTHROPIC_BASE_URL 只应包含域名。 Claude Code 会自动追加 /v1/messages。如果末尾带有 /v1，请求会发送到 /v1/v1/messages，并返回 404。
• 使用 ANTHROPIC_AUTH_TOKEN，不要使用 ANTHROPIC_API_KEY。 ANTHROPIC_AUTH_TOKEN 的值会在前面加上 Bearer 前缀后发送到 Authorization 请求头，并立即生效。ANTHROPIC_API_KEY 会发送到 x-api-key 请求头，在交互模式下必须先确认一次。如果当时拒绝，密钥将被静默忽略。你可以在 /config → Use custom API key 中重新启用它。
• ANTHROPIC_MODEL 用于选择主模型。 此处为 Claude Sonnet 5（claude-sonnet-5）。名称必须与 Kunavo 模型列表中的名称完全一致。Kunavo 无法识别末尾带日期的旧名称。
• ANTHROPIC_DEFAULT_OPUS_MODEL 和 ANTHROPIC_DEFAULT_SONNET_MODEL 用于指定别名 opus 和 sonnet。根据官方模型配置文档（核实于 2026年10月3日），对于 API 用户，默认模型和别名 opus 指向 Opus 5.5，而别名 sonnet 指向 Sonnet 5.5。别名会随时间变化，可通过完整模型名称或这两个变量等方式固定版本。在 Kunavo 上不存在的模型请求会返回 404。我们将别名 opus 固定为 Claude Opus 5.5（claude-opus-5-5），因为 Anthropic 发布的下一款 Opus 不一定会立即在 Kunavo 上提供。Opus 5.5 要求 Claude Code 版本为 2.1.280 或更高；旧版本可通过命令 claude update 更新。截至 2026年10月3日，Kunavo 目前不提供 Sonnet 5.5，因此如果不将别名 sonnet 固定为 claude-sonnet-5，/model sonnet、opusplan 模式下的执行阶段以及设置为 model: sonnet 的子代理都会返回 404 错误。
• 也要固定设置 ANTHROPIC_DEFAULT_HAIKU_MODEL。haiku别名会请求 Kunavo 不支持的模型 ID：从 Claude Code 2.1.293 起是 Haiku 5.5，更早版本则是带日期的 Haiku 4.5 ID。如果没有此变量，/model haiku和设为 model: haiku 的子代理都会收到 404。
• ANTHROPIC_DEFAULT_HAIKU_MODEL 也处理后台任务。 根据文档，此变量会为 haiku 别名和后台运行的功能选择模型。在 Kunavo 中，Claude Haiku 4.5 的输入令牌每百万个收费 0.70 USD，输出令牌每百万个收费 3.50 USD。主模型 Claude Sonnet 5 的价格为 1.40 USD / 7.00 USD （Anthropic 价格：2.00 美元 / 10.00 美元），而 Claude Opus 5.5 的价格为 2.80 USD / 14.00 USD（输入 / 输出，每百万令牌）。

不要将密钥写入项目的 .claude/settings.json。根据网关连接文档，此文件会进入代码仓库，因此任何克隆该仓库的人都能获取它。还要注意优先级顺序。当同一个变量同时在 shell 和设置文件的 env 块中设置时，大多数会话会采用设置文件中的值。设置文件中的 model 键适用另一条规则：变量 ANTHROPIC_MODEL 的优先级高于该键，而 model 仅在该变量不存在时生效。如果在 shell 中所做的更改没有生效，请先检查设置文件。在适用于 VS Code 的 Claude Code 扩展中，变量通过 VS Code 自身用户设置中的 claudeCode.environmentVariables 设置。

首次启动和 /status

根据网关连接文档（已于 2026年10月3日 检查），设置 ANTHROPIC_AUTH_TOKEN 后，claude 命令会立即打开 无需登录界面的 会话。该变量会立即生效，不像 ANTHROPIC_API_KEY 那样需要确认。如果你看到的是登录界面，说明 Claude Code 没有读取到密钥。

密钥必须位于 Claude Code 在首次配置前读取的位置，即通过 Shell 中的 export 命令设置，或位于用户文件 ~/.claude/settings.json 的 env 块中。在交互模式下，项目 .claude/settings.json 或 .claude/settings.local.json 中的 env 块只有在首次启动向导和询问是否信任文件夹后才会生效。如果密钥只位于项目设置中，首次启动时仍会看到登录界面。

在会话中输入 /status，然后检查两行：

• 仅在设置了网关地址时才会出现 Anthropic base URL。它应显示 https://api.kunavo.com。如果没有这一行，说明 ANTHROPIC_BASE_URL 没有传递到会话中。
• Auth token 显示名称 ANTHROPIC_AUTH_TOKEN，表示使用的是 API 密钥，而不是已保存的 claude.ai 登录信息。如果看到带有 claude.ai 账户的 Login method，说明变量未生效。

也可以在启动 Claude Code 前按照官方文档中的方法检查地址和密钥。该方法会发送一个请求，只生成 1 个输出令牌，并从余额中扣除象征性金额。命令会读取当前 Shell 中的变量，因此即使密钥位于设置文件中，也要先在此终端中使用 export 命令设置变量。以 {"id":"msg_ 开头的 JSON 响应表示地址和密钥有效。代码 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 中，同样的检查如下所示。如果一切正常，响应中会看到以 msg_ 开头的 id 字段：

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": "."}]}'

API 密钥下的不同功能

• Remote Control 和语音听写不可用。 根据文档，它们需要 claude.ai 身份，并且在 ANTHROPIC_AUTH_TOKEN 处于启用状态时无法运行。从 2.1.196 版本起，当 ANTHROPIC_BASE_URL 指向不同于 api.anthropic.com 的主机时，Remote Control 也会被禁用。
• /fast 会显示快速模式已关闭。 根据文档，当只有 bearer 令牌时，Claude Code 会将快速模式视为关闭状态，并且不会请求检查其可用性。
• MCP 工具搜索默认处于关闭状态。 当 ANTHROPIC_BASE_URL 指向非 Anthropic 主机时会出现这种情况。
• /context 中的数值是估算值。Kunavo 不提供 /v1/messages/count_tokens 端点。根据网关兼容性文档（核实于 2026年10月3日），Claude Code 在这种情况下会根据字符数在本地计算 token 数量。

完整的集成说明请参阅 Claude Code 集成文档（英文），本指南的英文版本请参阅文章 Install Claude Code。

BLIK 付款：充值余额和 API 密钥

通过 Anthropic 网站购买的 Claude 订阅只能使用信用卡或借记卡支付（Claude账单常见问题，核实于 2026年10月3日）。Pro 或 Max 订阅不能用 BLIK 支付。在 Kunavo 上，BLIK 可用于为预付 API 余额充值；像上文所述设置密钥后，Claude Code 会从该余额中支付 token 费用。所有支付步骤都在如何使用 BLIK 支付 Claude 费用指南中说明，简要流程如下：

1. 通过电子邮件或 Google 账户注册 Kunavo 账户。注册时无需提供银行卡。
2. 在 账单（Billing）选项卡中选择充值金额。最低金额为 10 USD，无月费。充值金额较高时可获得奖励：100 美元 → 余额中的 110 美元、1000 美元 → 余额中的 1200 美元和5000 美元 → 余额中的 6250 美元。
3. Stripe 支付页面以兹罗提显示金额。选择 BLIK，在银行应用中生成六位数代码，输入代码，然后在应用中确认付款。根据Stripe 文档（核实于 2026年10月3日），BLIK 代码有效期为 2 分钟，开始付款后有 60 秒时间批准付款。
4. 在 API 密钥选项卡中创建一个以 sk-kn- 开头的密钥。密钥只显示一次，因此请立即保存，并将其填入 ANTHROPIC_AUTH_TOKEN。

在以兹罗提显示的支付页面上，除 BLIK 外，还提供银行卡（Visa、Mastercard）、受支持设备上的 Apple Pay 和 Google Pay，以及 Link。页面不支持 Przelewy24、PayU、PayPal 或普通银行转账。价格以美元设定，Stripe 会将其换算成兹罗提。根据 Stripe 关于 Adaptive Pricing 的文档（核实于 2026年10月3日），汇率包含 2–4% 的货币兑换费，由买家承担。使用银行卡以美元付款可避免这笔费用，不过此时将采用你所在银行的汇率和手续费；BLIK 仅支持兹罗提。确认付款前，你可以在支付页面查看准确的兹罗提金额。

BLIK 仅适用于手动充值。自动充值需要已保存的银行卡或 Link。余额不会过期，失败的请求不会收费。Kunavo 不提供增值税发票，充值历史记录可在“账单（Billing）”选项卡中查看。请注意，这是 Kunavo API 余额充值，不是 Claude Pro 或 Max 的订阅费用。

费用是多少（示例计算）

在 Claude Code 中，你按令牌付费。每次请求时，Claude Code 都会重新发送完整的对话上下文，但重复的上下文开头部分可能按缓存读取费率计费。下面是基于令牌的示例账单。这不是测量值，也不是费用上限。所有假设如下：

• 每个请求包含 40,000 个输入令牌，其中 36,000（90%）按缓存读取计费，其余 4000 个按缓存写入计费；
• 每个请求返回 1000 个输出令牌；
• 一次工作会话包含 50 个此类请求，不包括后台 Claude Haiku 4.5 调用；
• 在 Kunavo 中，缓存读取费用为输入费率的 10%，缓存写入费用为输入费率的 1.25×。这些比例适用于 Claude Sonnet 5，列表中的每个模型都按自己的比例计算。

实际费用取决于上下文长度、缓存命中次数、响应长度，以及你是否在任务之间使用 /clear 命令清除对话。所有模型的费率请参阅定价页面。你可以使用Claude 令牌费用计算器（英文）估算自己的用量。何时订阅更划算、何时使用 API，本指南Claude Code 的费用对此进行了说明。

最常见的错误

限制

• Kunavo 不提供增值税发票。
• BLIK 仅适用于手动充值。自动充值需要已保存的银行卡或 Link。
• 这是按令牌计费的 API，而不是 Claude Pro 或 Max 订阅。使用 API 密钥时，Remote Control 和语音听写无法运行，/fast 模式已关闭，MCP 工具搜索默认也处于关闭状态。
• Kunavo 目前（截至 2026年10月3日）不提供 Sonnet 5.5，因此上面的配置会将 sonnet 别名固定为 claude-sonnet-5。如果不固定模型，默认别名可能返回 404。Claude Opus 5.5 固定到 opus 别名，需要 Claude Code 2.1.280 或更高版本。
• Claude Code 官方文档和 Kunavo 集成文档 目前仅提供英文版本。

常见问题