安装 Claude Code：Windows、macOS 和 Linux 的命令、无需订阅的 API 密钥，以及使用 iDEAL 支付

Claude Code 可通过一条官方命令安装：在 macOS、Linux 和 WSL 中使用 curl -fsSL https://claude.ai/install.sh | bash，在 Windows PowerShell 中使用 irm https://claude.ai/install.ps1 | iex（在命令提示符 CMD 中使用下面的 install.cmd 命令）。然后选择付款方式。你可以使用 Pro、Max、Team、Enterprise 或 Console 账户登录（免费的 Claude.ai 订阅不包含 Claude Code），也可以在没有订阅的情况下使用 API 密钥：设置 ANTHROPIC_BASE_URL（仅填写域名，不包含 /v1）、ANTHROPIC_AUTH_TOKEN 以及四个模型变量，并使用 /status 检查密钥是否处于活动状态。Kunavo 余额可使用 iDEAL（荷兰）或 Bancontact（比利时）充值，最低 $10，无月费。

命令和变量已根据 2026年10月3日 在Claude Code 官方安装文档和环境变量文档中核查；价格和付款方式已截至 2026年10月10日 核查。荷兰和比利时均在 Anthropic 的支持国家/地区列表中（核查于 2026年10月3日），Claude.ai 和 API 均支持。本指南也提供英文版：安装 Claude Code。

安装前

在 macOS 和 Linux 上安装 Claude Code

打开终端并粘贴以下命令：

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

这是推荐的原生安装方式：一个会在后台自动更新的独立程序。命令 claude 会安装到 ~/.local/bin。已经打开的终端尚未加载新的 PATH，因此测试前请先打开一个新窗口。在 WSL 中，在 WSL 终端内使用完全相同的命令。

在 Windows 上安装 Claude Code

在 Windows 上有两条命令，所需命令仅取决于你打开的窗口。如果提示符以 PS C:\Users\Naam> 开头，则你处于 PowerShell 中；如果只有 C:\Users\Naam> 而没有 PS，则是命令提示符（CMD）。无需以 管理员身份打开窗口：根据官方文档，这不是必需的。

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

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

最常见的错误是将命令粘贴到错误的窗口中。在 PowerShell 中运行 CMD 命令会显示 The token '&&' is not a valid statement separator；在 CMD 中运行 PowerShell 命令会显示 'irm' is not recognized as an internal or external command。在荷兰语版 Windows 上，第二条提示可能以荷兰语显示，但原因相同。此外，在 PowerShell 中运行包含 | bash 的 macOS 命令会显示 bash 未被识别的错误。在这三种情况下：使用与你的窗口对应的命令。

Git for Windows是可选项。如果已安装，Claude Code 会通过随附的 Git Bash 执行命令；如果没有 Git，则会使用 PowerShell。如果已安装 Git，但找不到 Git Bash，请在 ~/.claude/settings.json 的 env 块中，将 CLAUDE_CODE_GIT_BASH_PATH 设置为指向 bash.exe 的路径；文档中的示例路径为 C:\Program Files\Git\bin\bash.exe。

因此，WSL 不是某些旧版指南所声称的必需项，而是一种选择。如果选择 WSL，请在 WSL 终端中运行 macOS/Linux 命令，并在 WSL 中启动 claude，不要从 PowerShell 或 CMD 启动。

通过 Homebrew、WinGet 或 npm

也可以使用这些方式，但有一个重要区别：根据官方文档，Homebrew 和 WinGet 安装不会自动更新。届时需要手动更新：

# Homebrew (macOS)
brew install --cask claude-code
brew upgrade claude-code              # bijwerken gebeurt niet vanzelf

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # bijwerken gebeurt niet vanzelf

npm 软件包需要 Node.js 22 或更高版本，而不是旧版指南仍在写的 Node.js 18。使用旧版 Node.js 时，npm 只会显示 EBADENGINE 警告，安装仍会继续：该软件包安装的是同一个原生程序，运行时不需要 Node.js。绝不要使用 sudo npm install -g：这会导致权限问题并带来安全风险。请使用 @latest 更新，而不是使用 npm update -g。

node -v                                           # moet v22 of hoger zijn
npm install -g @anthropic-ai/claude-code          # nooit met sudo

# later bijwerken: met @latest, niet met npm update -g
npm install -g @anthropic-ai/claude-code@latest

检查安装

claude --version   # toont het versienummer, gevolgd door (Claude Code)
claude doctor      # alleen-lezen diagnose van installatie en instellingen, start geen sessie

claude doctor 不会启动会话，而是显示安装状态和配置文件状态。这样可以快速判断问题出在安装还是配置上。

如果出现 command not found: claude，或者 Windows 提示无法识别 claude，说明安装目录不在 PATH 中。先打开一个新的终端窗口。如果问题仍未解决，请在 macOS 和 Linux 上通过 ~/.zshrc 或 ~/.bashrc 将 ~/.local/bin 添加到 PATH。在 Windows 上，该目录为 %USERPROFILE%\.local\bin；根据官方故障排查文档，请在 PowerShell 中按如下方式检查并添加：

# 1. Staat de installatiemap al in je PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Geen uitvoer? Voeg de map toe aan je gebruikers-PATH en open een nieuw venster
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. In het nieuwe venster: twee paden betekent twee installaties naast elkaar
where.exe claude

如果通过 npm 安装并且 PowerShell 报告 npm.ps1 cannot be loaded because running scripts is disabled on this system，则说明 PowerShell 的执行策略阻止了 npm 的启动脚本。请使用原生安装程序，启动 npm.cmd 并运行 claude.cmd，或者为当前用户允许运行本地脚本：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

首次启动：订阅或 API 密钥

首次启动时，你需要选择 Claude Code 的付款方式。这两种方式互斥：如果设置了 API 密钥，已保存的登录信息将不会使用；如果移除该变量，Claude Code 会回退到登录状态，无需重新安装。

方式 A：使用订阅登录

在项目目录中启动 claude，然后通过浏览器登录。需要注意的一点是：如果已经设置了 ANTHROPIC_API_KEY，Claude Code 会询问一次是否使用该密钥。如果拒绝，之后它会忽略该密钥而不再询问，因此看起来就像变量未被读取。通过 /config → Use custom API key 可以重新启用它。

方式 B：无需订阅，使用 API 密钥

ANTHROPIC_BASE_URL 是 Claude Code 的内置变量。根据官方文档，它会覆盖 API 端点，以便通过代理或网关发送请求。因此，让 Claude Code 指向使用 Anthropic Messages API 的端点属于受支持的配置，无需插件，也无需定制版本。步骤如下：

1. 创建 Kunavo 账户。
2. 通过 Billing 为余额充值，最低 $10（iDEAL 和 Bancontact 见下文）。
3. 在 /app/keys 创建以 sk-kn- 开头的密钥。密钥只会显示一次，因此请立即保存。
4. 设置变量。在 macOS 和 Linux 中，编辑 ~/.zshrc 或 ~/.bashrc：

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # alleen het domein, zonder /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 窗口中测试：

# Geldt alleen voor dit PowerShell-venster
$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）。这些值会在 Claude Code 运行的所有位置生效，包括后台代理。Shell 中的变量仅适用于该终端窗口：从 Dock 或开始菜单打开的编辑器看不到这些变量。如果文件中已有其他设置，只需添加 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"
  }
}

绝不要将密钥放在项目的 .claude/settings.json 中：根据官方网关文档（核查于 2026年10月3日），该文件会被提交，并分享给克隆仓库的所有人。还要注意变量的优先顺序：如果 shell 和设置文件中都设置了同一个变量，则以设置文件中的值为准。如果修改 shell 变量后没有效果，请先检查 settings.json。

每一行都有自己的注意事项：

• ANTHROPIC_BASE_URL 仅包含域名。 Claude Code 会自动在其后添加 /v1/messages；如果末尾已经有 /v1，请求就会发送到 /v1/v1/messages，并返回 404。
• 使用 ANTHROPIC_AUTH_TOKEN，不要使用 ANTHROPIC_API_KEY。 根据文档，ANTHROPIC_AUTH_TOKEN 会作为带有 Authorization 前缀的 Bearer 标头发送，并立即生效。ANTHROPIC_API_KEY 会放在 x-api-key 标头中，在交互模式下必须先批准一次（参见方式 A）。
• 在 ANTHROPIC_MODEL 中准确填写模型名称。 Kunavo 只识别精确名称，不会转换后面带日期的旧名称。
• 还要固定 ANTHROPIC_DEFAULT_OPUS_MODEL 和 ANTHROPIC_DEFAULT_SONNET_MODEL。根据模型配置文档（核查于 2026年10月3日），API 用户的默认设置和别名 opus 指向 Opus 5.5，别名 sonnet 指向 Sonnet 5.5；这些别名会随新版本一同切换。可以使用完整模型名称或 ANTHROPIC_DEFAULT_OPUS_MODEL 等变量来固定版本。Kunavo 目前不提供 Sonnet 5.5，而且新的 Opus 模型不一定会立即上架；所请求的模型不存在时会返回 404。因此，未设置 ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 时，/model sonnet、opusplan 的执行阶段，以及指定为 model: sonnet 的子代理都会失败。请将别名 opus 固定为 Opus 5.5（claude-opus-5-5）；这需要 Claude Code v2.1.280 或更高版本；旧版本可通过运行 claude update 更新。
• 也要固定设置 ANTHROPIC_DEFAULT_HAIKU_MODEL。haiku别名会请求 Kunavo 不提供的 ID：从 v2.1.293 起为 Haiku 5.5，更早版本则是带日期的 Haiku 4.5 ID。没有这一行，/model haiku和设为 model: haiku 的子代理都会返回 404。
• ANTHROPIC_DEFAULT_HAIKU_MODEL 也适用于后台任务。 根据文档，该变量决定别名 haiku 以及后台功能所使用的模型，例如会话标题。使用 Claude Haiku 4.5 可以让这些功能保持低成本。

如果使用 VS Code 扩展，请将变量设置在 claudeCode.environmentVariables 中，即 VS Code 自身的用户设置中（命令 Preferences: Open User Settings (JSON)）。扩展会在启动前检查那里的登录凭据；~/.claude/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" }
  ]
}

每百万 token 的价格来自 Kunavo 目录；Anthropic 的标价来自 claude.com/pricing（核查于 2026年10月3日）：

在会话中使用 /model claude-opus-5-5 切换，或直接使用 claude --model claude-opus-5-5 启动。Claude Code 每月大约需要多少钱，以及何时订阅更划算，请参阅 Claude Code pricing（英文）；你可以使用 Claude token 费用计算器计算自己的用量。所有模型和价格都列在价格页面上。

使用 /status 检查

启动 claude。设置 ANTHROPIC_AUTH_TOKEN 后，不会出现登录界面：该变量会立即生效。如果仍看到登录界面，则说明 Claude Code 没有读取到密钥。请将它设置在 Claude Code 在首次启动向导之前会读取的位置：Shell 中的 export，或 ~/.claude/settings.json 的 env 块。项目的 .claude/settings.json 或 .claude/settings.local.json 中的 env 块，在交互会话中只有在首次启动向导以及询问你是否信任该目录之后才会生效。

在会话中输入 /status，并查看 Status 标签页中的两行内容（来源：官方网关文档，核查于 2026年10月3日）：

• Anthropic base URL 必须显示 https://api.kunavo.com。该行仅在设置了网关地址时出现；如果缺少该行，则表示 ANTHROPIC_BASE_URL 没有作用于该会话。
• Auth token 必须提及 ANTHROPIC_AUTH_TOKEN。如果看到的是带有 claude.ai 账户的 Login method，则说明变量未被读取，会话正在使用你的订阅。

如果你之前使用订阅登录，Claude Code 启动时可能会警告有两个登录来源处于活动状态（提示以 auth may not work as expected 结尾）。此时请求会通过密钥发送；使用 /logout 可以清除旧登录。

想在打开 Claude Code 前测试地址和密钥吗？按照文档的建议，发送一个仅包含一个输出 token 的请求；这会消耗极少量余额。这些命令会从 Shell 中读取变量，因此即使变量已经写在 settings.json 中，也请在 Shell 中设置它们。

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

以 {"id":"msg_ 开头的 JSON 响应表示地址和密钥有效；在 PowerShell 中，你会看到以 msg_ 开头的 id。出现 401 表示密钥被拒绝。

使用 API 密钥时还有哪些功能可用

• 没有 Remote Control，也没有语音听写。 两者都需要 claude.ai 账户，并且只要 ANTHROPIC_AUTH_TOKEN 处于活动状态就不可用；此外，只要 ANTHROPIC_BASE_URL 指向 Anthropic 之外的地址，Remote Control 也会被禁用。
• /fast 报告 fast mode 已关闭。 仅使用 bearer token 时，Claude Code 会将 fast mode 视为已禁用，不会发送检查请求。
• 只要 ANTHROPIC_BASE_URL 指向 Anthropic 之外的地址，MCP 工具搜索默认就会关闭。
• /context 中的数字只是估算值：Kunavo 目前不提供 /v1/messages/count_tokens。根据官方网关兼容性文档（核查于 2026年10月3日），如果该端点不可用，Claude Code 会回退到根据字符数进行估算，因此 /context 显示的是估算数量。

代码、工具、子代理、MCP 服务器、hooks 和提示缓存均照常工作。更多详情请参阅 Claude Code 集成文档（英文）以及 Claude Code without a subscription（英文）。

使用 iDEAL 或 Bancontact 支付

Claude 订阅在网站上只能使用信用卡或借记卡付款（Claude 付费套餐帮助文章，核查于 2026年10月3日）；claude.com/pricing 上的价格不含税。

Kunavo 余额通过 Stripe Checkout 充值。价格以美元计；Stripe 会向荷兰和比利时的买家显示欧元金额。根据Stripe 自适应定价文档（核查于 2026年10月3日），汇率中包含由买家承担的 2–4% 转换加价；以美元付款（使用银行卡、Apple Pay、Google Pay 或 Link）则不会产生这项加价。iDEAL 和 Bancontact 仅支持欧元。付款页面提供以下方式：

• iDEAL，适用于荷兰。该支付方式现名为 iDEAL | Wero（Stripe 要求在 2026 年第一季度采用此名称），因此付款页面上也可能显示这个名称。您会被重定向到自己的银行页面并在那里确认（Stripe 关于 iDEAL 的说明，核查于 2026年10月3日）。
• Bancontact，适用于比利时，可使用 Bancontact 卡或应用（Stripe 关于 Bancontact 的说明，核查于 2026年10月3日）。
• 银行卡（Visa、Mastercard）、Apple Pay、Google Pay 和 Link。

不提供：PayPal、SEPA 直接扣款、Klarna（仅向美国买家提供）、Tikkie、Riverty（原 AfterPay）以及普通银行转账。

1. 创建 Kunavo 账户。
2. 在 Billing 中选择金额，最低 $10。一次充值更多金额可获得额外余额：使用 $100 可获得 $110、使用 $1.000 可获得 $1.200和使用 $5.000 可获得 $6.250。
3. 在 Stripe 支付页面选择 iDEAL 或 Bancontact，并在银行环境中完成支付（iDEAL），或使用 Bancontact 应用或银行卡完成支付。确认前，你会在支付页面看到以欧元显示的金额。
4. 在 /app/keys 创建密钥，并将其填入 ANTHROPIC_AUTH_TOKEN。

余额为预付余额：无月费，余额永不过期，失败的请求不会收费。自动充值只能使用已保存的银行卡或 Link；使用 iDEAL 和 Bancontact 时，每次都必须手动充值。Kunavo 不出具增值税发票；充值历史记录位于 Billing。这些支付方式只能为 Kunavo API 余额充值：不能使用它们支付 Claude Pro 或 Max 订阅。有关以欧元支付的更多信息：使用 iDEAL 支付 Claude。

常见错误

安装后

第一次在项目中启动时，请输入 /init：Claude Code 会读取代码仓库，并根据发现的测试命令和约定创建 CLAUDE.md。请检查该文件并保持简短，因为每个会话都会加载它。在不同的独立任务之间，/clear 会开始新的对话；如果任务变长，/compact 会总结历史记录，然后你可以继续工作。

你需要了解的内容

• 这是按 token 计费的 API，不是 Claude Pro 或 Max 订阅。每天长时间使用 Claude Code 的人通常订阅更划算；按 token 付费适合用量不固定的情况，而且一个月完全不用也不会产生费用。比较信息请参阅 Claude Code pricing（英文）。
• 使用 API 密钥时，Remote Control 和语音听写不可用。
• 通过 Kunavo，你使用的是共享容量，没有预留配额，也没有合同保障；如果你需要这些保障，请直接与 Anthropic 签订合同。
• iDEAL 和 Bancontact 仅用于手动充值；自动充值只能使用银行卡或 Link。
• 欧元金额包含 Stripe 的换汇加价。Kunavo 不出具增值税发票。

常见问题