安装 Claude Code：Windows、macOS 和 Linux 命令，无需订阅的 API 密钥，以及无需 PayPal 的付款方式

简而言之：您只需在终端中运行一行命令即可安装 Claude Code，无需 Node.js，也无需管理员权限。具体使用哪一行只取决于窗口类型：macOS、Linux 和 WSL 使用 curl -fsSL https://claude.ai/install.sh | bash，Windows PowerShell 使用 irm https://claude.ai/install.ps1 | iex，Windows 命令提示符（CMD）使用下面的第三行。没有 Claude 订阅的用户随后可以通过 API 密钥将 Claude Code 连接到 Kunavo：ANTHROPIC_BASE_URL=https://api.kunavo.com（不带 /v1）、ANTHROPIC_AUTH_TOKEN 以及四个模型变量。/status 会显示是否生效。费用按 token 从余额中扣除，余额起充金额为 $10，可使用借记卡或信用卡（包括 Visa 借记卡和 Mastercard 借记卡）、Apple Pay、Google Pay、Link，或在奥地利使用 EPS 充值。不支持 PayPal 和 SEPA 直接扣款。

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

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

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

Anthropic 提供完整的德语版 Claude Code 文档，因此本指南引用德语页面。上面的命令已于 2026年10月3日 对照Claude Code 设置核实，变量则已与环境变量列表核对。Kunavo 的价格和付款方式信息截至 2026年10月10日。根据 Anthropic 的国家/地区列表，德国、奥地利和瑞士均支持 Claude.ai 和 API（截至 2026年10月3日）。英文版见 安装 Claude Code。

流程概览

1. 安装：运行上方适合您系统的命令，然后打开新的终端窗口。
2. 检查：claude --version 会输出版本号。
3. 选择：使用 Claude 订阅登录，或使用 API 密钥（对比见下文）。
4. 使用 API 密钥：充值、创建密钥、设置六个环境变量。
5. 验证：在会话中输入 /status。

前提条件：当前适用的要求

一些德语指南介绍的是较早版本的 Claude Code。下表将常见说法与 2026年10月3日 当日官方设置页面的要求并列对照。

在 macOS、Linux 和 WSL 上安装

在终端中加入包含 install.sh 的行。官方文档将此方式列在“Native Installation (Recommended)”选项卡中。脚本会将启动程序放在 ~/.local/bin/claude 中，之后安装会在后台自动更新。在 WSL 中同样使用这一行，但要在 WSL 终端中执行。

在 Windows 上安装 Claude Code

在 Windows 上，能否运行取决于当前打开的窗口；查看命令提示符即可判断：PS C:\Users\Name> 表示 PowerShell，C:\Users\Name>（不含 PS）表示命令提示符（CMD）。根据设置页面，这两种方式都不需要管理员权限。安装程序会将 claude.exe 放在 %USERPROFILE%\.local\bin 下。

如果窗口选错，会显示英文提示；在德语版 Windows 上，有时也会显示德语提示。在 PowerShell 中执行 CMD 行会以 The token '&&' is not a valid statement separator 结尾，在 CMD 中执行 PowerShell 行会以 'irm' is not recognized as an internal or external command 结尾。两者表达的是同一件事：窗口不正确，请改用另一行。

请勿使用开始菜单中的“Windows PowerShell (x86)”。根据故障排除说明，它会启动 32 位进程，因此即使在 64 位电脑上，安装程序也会因 Claude Code does not support 32-bit Windows 而中止。如果在该窗口输入 [Environment]::Is64BitOperatingSystem 后显示 True，则 Windows 没有问题；只需打开不带该后缀的“Windows PowerShell”即可。

您无需安装Git for Windows。如果已安装，Claude Code 会在 Git Bash 中运行 shell 命令；否则会使用 PowerShell。如果 Claude Code 找不到已安装的 Git Bash，请将 bash.exe 的路径作为 CLAUDE_CODE_GIT_BASH_PATH 写入 ~/.claude/settings.json 的 env 代码块；默认安装路径为 C:\Program Files\Git\bin\bash.exe。

使用原生方式还是 WSL，取决于项目所在位置：

使用 WSL 时，请在 WSL 终端中安装并启动 claude，不要在 PowerShell 或 CMD 中执行。

替代方式：Homebrew、WinGet 和 npm

如果您更喜欢通过包管理器维护软件，也可以这样做，但有一点需要注意：根据文档，Homebrew 和 WinGet 的安装不会自动更新，因此您需要定期运行 upgrade。Homebrew 提供两个 Cask。claude-code遵循稳定渠道，通常滞后一周左右，并跳过存在重大回归的版本；claude-code@latest则会立即获取每个版本。

# Homebrew (macOS) – stabiler Kanal; claude-code@latest für den neuesten Stand
brew install --cask claude-code
brew upgrade claude-code              # aktualisiert sich nicht von selbst

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # aktualisiert sich nicht von selbst

通过 npm

npm 仍是官方记录的安装方式。前提是 Node.js 22 或更高版本。npm 包会下载与安装程序相同的原生二进制文件，运行时根本不需要 Node.js。因此，即使 Node.js 版本较旧，安装也不会中止，npm 只会显示 EBADENGINE 警告。如果尚未安装 Node.js，原生安装程序是更简便的方式。

node -v                                    # muss v22 oder neuer zeigen
npm install -g @anthropic-ai/claude-code   # niemals mit sudo

# später aktualisieren: mit @latest, nicht mit npm update -g
npm install -g @anthropic-ai/claude-code@latest

设置页面中的三条规则：不要使用 sudo npm install -g，因为这会带来权限问题和安全风险。使用 @latest 更新，因为 npm update -g 会停留在原始版本范围内。不要禁用可选依赖项：二进制文件以平台专用可选依赖项的形式提供；如果在 .npmrc 中设置 --omit=optional 或 optional=false，就会缺少该文件，而 claude 在 macOS 和 Linux 上会报告 Error: claude native binary not installed.。

检查安装

为此，请打开一个新的终端窗口。安装前已经打开的窗口尚未加载更新后的 PATH，因此找不到 claude。

claude --version   # zeigt eine Versionsnummer wie 2.1.211 (Claude Code)
claude doctor      # Diagnose von Installation und Einstellungen, startet keine Sitzung

出现问题时，claude doctor 是排查工具。它不会启动会话，但会列出安装状态、设置文件中的错误以及带有解决建议的警告。这样可以判断问题出在安装还是配置。

安装遇到问题时

下载内容是 HTML 或返回 403

如果输出以 syntax error near unexpected token '<' 开头，或 curl 报告 403，根据故障排除说明（截至 2026年10月3日），这表示返回的是网页或错误状态，而不是脚本。如果页面显示 App unavailable in region，说明 Anthropic 认为连接来自不受支持的国家/地区。从德国、奥地利或瑞士访问时，这通常意味着 VPN 或代理的出口位于国外。没有文本内容的 403 也可能由同一原因导致，或来自公司防火墙。文档建议先检查网络连接，因为其他安装方式也会连接相同的服务器。此时换一个网络或请 IT 部门开放访问，比换用其他安装程序更有效。

找不到“claude”

在 macOS 和 Linux 上出现 command not found: claude，或在 Windows 上出现无法识别的 claude，意味着安装目录不在 PATH 中。通常打开新窗口即可解决。如果 macOS 或 Linux 上仍未解决，请将 ~/.local/bin 添加到 ~/.zshrc 或 ~/.bashrc 中。在 Windows 上，按照故障排除部分所示检查并添加该目录：

# 1. Steht der Installationsordner schon im PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Keine Ausgabe? Ordner zum Benutzer-PATH hinzufügen, dann ein neues Fenster öffnen
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Im neuen Fenster
claude --version

PowerShell 阻止 npm.ps1

这只影响 npm 方案。提示 npm.ps1 cannot be loaded because running scripts is disabled on this system 表示执行策略阻止了 npm 的启动脚本。您可以调用不受该策略影响的 npm.cmd 和 claude.cmd，改用原生安装程序，或允许当前用户运行本地脚本：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

订阅还是 API Key？

首次启动时，Claude Code 会询问由谁付费。您可以使用 Claude 账户登录，也可以通过环境变量提供 API 密钥。根据网关指南，设置了密钥后会优先使用该密钥：已保存的登录信息会暂时搁置，移除该变量后便会重新启用。切换方式无需重新安装。

Claude Code 价格指南会说明从什么时候起 Pro 或 Max 相比 Key 更划算。

设置 API Key（无需订阅）

让 Claude Code 请求另一个端点并非投机取巧。Anthropic 的变量列表中列出了 ANTHROPIC_BASE_URL，其用途正是通过代理或网关转发请求。您不需要安装插件，也不需要使用修改过的 Claude Code 版本。

1. 注册 Kunavo，可使用电子邮件地址或 Google 账号。
2. 在 Billing 中至少充值 $10（支付方式见付款部分）。
3. 在 API-Keys 中生成 Key。它以 sk-kn- 开头且仅显示一次，因此请立即复制。
4. 按下方所示设置变量。

写入 ~/.zshrc 或 ~/.bashrc 后，这些值会对 macOS、Linux 和 WSL 中每个新终端生效：

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # nur die Domain, ohne /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

在 PowerShell 中，$env: 赋值仅对当前打开的窗口有效，适合首次尝试：

# Gilt nur für dieses PowerShell-Fenster
$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）。根据网关指南（截至 2026年10月3日），此文件适用于您的所有项目。如果文件已存在，只需添加 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"
  }
}

VS Code 扩展会从 VS Code 用户设置中的 claudeCode.environmentVariables 读取变量（命令 Preferences: Open User Settings (JSON)）：

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.kunavo.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-kn-..." },
    { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-4-5" }
  ]
}

每个变量的作用

为什么要固定启动模型？根据模型配置文档（截至 2026年10月3日），Opus 5.5 是 API 用户的默认模型，而别名会随着时间推移指向新版本。Kunavo 提供 Opus 5.5，因此在此不设置模型变量启动时会使用 Opus 5.5，该模型 每个 token 的费用是 Claude Sonnet 5 的两倍。使用固定的模型名称，您就能知道回复来自哪个模型以及对应的价格。固定 Opus 可让别名 opus 始终指向 Claude Opus 5.5（claude-opus-5-5），即使 Anthropic 之后将其切换到更新的 Opus 版本。Opus 5.5 在 Kunavo 的每个 token 的费用 低于 Claude Opus 5 的费用（两者每 100 万输入/输出 token 的费用分别为 $2.80 / $14.00 和 $3.50 / $17.50），且要求 Claude Code 版本不低于 2.1.280；较旧的安装版本可通过 claude update 更新到当前版本。固定 Sonnet 则是必须的：对于 API 用户，别名 sonnet 指向 Kunavo 不提供的 Sonnet 5.5；如果没有设置 ANTHROPIC_DEFAULT_SONNET_MODEL，/model sonnet、opusplan 的执行阶段以及使用 model: sonnet 的子代理都会遇到 404。Claude Haiku 4.5 可让后台任务保持低成本，您也可以随时在会话中使用 /model 切换模型。

关于存放位置，有两点需要注意。密钥绝不能放在项目的 .claude/settings.json 中，因为根据网关指南，该文件会被提交到版本库，任何克隆该仓库的人都会获得它。另外，如果 Shell 中的 export 和 env 块设置了同一个变量，设置文件中的值会优先生效。因此，如果您在 Shell 中修改了某个变量却没有效果，旧值很可能仍保存在某个 settings.json 中。

以下为模型对比：Kunavo 价格取自目录，Anthropic 标价取自 claude.com/de/pricing（截至 2026年10月3日），均按每 100 万 token 计：

所有 Claude 模型和费率都列在 Claude API 价格指南和价格页面中。

首次启动：使用 /status 检查

进入项目目录并启动 claude。如果已设置 ANTHROPIC_AUTH_TOKEN，就会直接进入会话，不会显示登录界面。如果登录界面仍然出现，说明 Claude Code 没有找到密钥。根据网关指南，最常见的原因是密钥只写在项目的 .claude/settings.json 或 .claude/settings.local.json 中。Claude Code 只会在交互式会话的设置向导结束、并询问您是否信任该文件夹后，才会读取这类 env 代码块。因此，请将密钥放在 shell 中（export），或写入 ~/.claude/settings.json。

在会话中，/status 的 Status 选项卡会显示 Claude Code 从哪里获取地址和凭据。以下两行尤其重要：

也可以不使用 Claude Code，通过网关指南中的请求测试连接（此处将模型设置为 claude-sonnet-5）。该请求只要求一个输出 Token，因此费用也仅为极小金额。命令会读取 Shell 变量；如果您的值仅写在 settings.json 中，还需额外导出变量以进行测试。

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

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

如果返回的 JSON 以 {"id":"msg_ 开头，或 PowerShell 返回的对象包含以 msg_ 开头的 id，则地址和 Key 正确。出现 401 表示 Key 被拒绝。

使用 API Key 后的变化

大部分功能保持不变：编辑代码、工具、Subagents、MCP 服务器、Hooks 和 Prompt Caching 均照常运行。需要了解以下四点差异：

• 远程控制和语音听写不可用。根据网关指南，两者都需要 claude.ai 身份，并在 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY 启用时被禁用。自版本 2.1.196 起，如果 ANTHROPIC_BASE_URL 指向 Anthropic 之外的主机，远程控制也会被禁用。
• /fast 会报告快速模式不可用。仅使用 Bearer Token 时，Claude Code 会将其视为已禁用，甚至不会发送可用性检查。
• MCP 工具搜索已关闭。根据 MCP 文档（截至 2026年10月3日），一旦 ANTHROPIC_BASE_URL 指向第三方提供商，Claude Code 就会关闭该功能；可通过 ENABLE_TOOL_SEARCH 显式启用。
• /context 显示的是估算值。Kunavo 不提供 /v1/messages/count_tokens。没有此端点时，根据网关兼容性指南（截至 2026年10月3日），Claude Code 会按字符数进行计数。

更多集成信息请参阅Claude Code 集成指南（英文）。

不支持 PayPal 和 SEPA 的付款方式

先说明两者的区别：Kunavo 不销售 Claude 订阅，而是提供 API 访问额度，Claude Code 会按 token 从中扣费。Anthropic 的 Pro 和 Max 订阅：网页端仅支持信用卡或借记卡；应用内付款由 App Store 或 Google Play 处理（账单常见问题）。根据 Anthropic 的银行卡遭拒帮助文章，不接受 PayPal 或 Venmo（信息均截至 2026年10月3日）。

Kunavo 通过 Stripe 结账页面充值。价格以美元计；从德国或奥地利付款时，您会看到以欧元显示的金额。根据Stripe 关于 Adaptive Pricing 的文档（截至 2026年10月3日），该汇率包含 2% 至 4% 的货币兑换费，由买家承担。在结账时选择美元即可免除这项费用；之后由您的银行按其汇率兑换，并可能收取自有费用。结账页面支持：

根据Stripe，EPS 是一种奥地利支付方式，所有奥地利银行均支持。您会被转到银行页面进行确认；该方式仅支持欧元付款。瑞士用户可使用银行卡、Apple Pay、Google Pay 或 Link 付款。

girocard：仅有 girocard 标志（旧称 EC 卡）的银行卡无法在 Kunavo 结账时使用，因为 Stripe 的支持的银行卡品牌列表中没有 girocard（截至 2026年10月3日）。如果您的卡还带有 Visa 或 Mastercard 标志，则付款会通过相应网络处理；Apple Pay 和 Google Pay 也适用。

不支持：PayPal、SEPA 直接借记、手动银行转账（预付款）、giropay 和 Sofort。Klarna 结账仅向美国买家提供；即使人在美国境外切换为美元，也不会看到 Klarna。

1. 创建账号；注册 Kunavo 时不要求提供银行卡。
2. 在 Billing 中选择金额至少为 $10 的充值档位。更高档位会提供赠送余额：$100 可获得 $110、$1,000 可获得 $1,200和$5,000 可获得 $6,250。
3. 在 Stripe 结账页面选择付款方式。确认前可以看到欧元金额；使用 EPS 时，请在网上银行中确认。
4. 在 API-Keys 中创建 Key，并将其填入 ANTHROPIC_AUTH_TOKEN。

余额需预先支付：无月费、不过期，失败的请求不会收费。只有使用已保存的银行卡或 Link 才能自动充值；使用 Apple Pay、Google Pay 和 EPS 时需要手动充值。Kunavo 不提供列明增值税的发票；您可以在 Billing 中查看充值记录。有关付款方式和卡片被拒的更多信息：无需信用卡支付 Claude。

一次会话的费用：计算示例

使用 API Key 时，您按 Token 付费，而 Claude Code 会在每一步发送此前的完整上下文。不过，这些上下文并非每次都按全价计费：未更改的开头由模型从缓存中读取，因此适用较低的缓存读取费率。下表演示一个假设模式，既不是测量值，也不是上限。假设：

• 每次请求 40,000 个输入 Token，其中 36,000（90 %）从缓存读取，4,000 个新 Token 写入缓存；
• 每次请求 1,000 个输出 Token；
• 每个工作会话中有 50 个此类请求，不计后台调用；
• 在 Claude Sonnet 5 中，缓存读取费用为输入费率的 10 %，缓存写入费用为其 1.25 倍；表中的每个模型均按其自身系数计算。

您实际支付的金额取决于上下文长度、缓存命中情况和响应长度，也取决于您是否在两项任务之间使用 /clear 重新开始。要计算您自己的数据，请使用Claude Token 费用计算器（英文）；Claude Code 价格指南会计算与 Pro 和 Max 的比较。

错误消息及其含义

此方式的限制

• 按 Token 付费，而不是统一收费。每天长时间使用 Claude Code 的人，使用 Pro 或 Max 往往更便宜。使用频率不固定时，您只需支付实际产生的费用，一个月不使用也不会收费。
• 没有 claude.ai 账号，就无法使用远程控制和语音听写；/fast 被视为关闭，MCP 的工具搜索默认也处于关闭状态。
• Kunavo 目前不提供 Sonnet 5.5；因此 /model sonnet、opusplan 和 Sonnet Subagents 需要使用上方示例中的 Sonnet 固定值。
• Apple Pay、Google Pay 和 EPS 只能手动充值，自动充值仅支持银行卡或 Link。欧元金额包含 Stripe 的货币转换费。
• Kunavo 不提供列明增值税的发票。
• Anthropic 的 Claude Code 文档提供德语版本，Kunavo 的集成指南仅提供英文版本。

常见问题