Claude Code 安装方法【Windows・Mac】——无需订阅的 API 密钥设置及使用 JCB・Apple Pay 支付

安装 Claude Code 只需运行一行官方原生安装程序。Mac、Linux 和 WSL 使用 install.sh，Windows 使用 PowerShell 时使用 install.ps1，CMD 时使用 install.cmd（也可以通过 npm 安装，但要求 Node.js 22 或更高版本）。通常之后会使用 Pro、Max 等套餐登录；如果不订阅，请设置 ANTHROPIC_BASE_URL=https://api.kunavo.com（不要添加 /v1）、包含 API 密钥的 ANTHROPIC_AUTH_TOKEN，以及用于固定模型的 4 个变量，即可无需登录启动。可通过 /status 确认是否正常运行。API 余额可使用 JCB 等卡、Apple Pay、Google Pay 和 Link，从 $10 起预先充值，结账页面会以日元显示。

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

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

:: Windows コマンドプロンプト（CMD）
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

安装步骤的第一手信息来自 Anthropic 的日文官方文档（设置、安装故障排除、2026年10月3日核查）。本页不重复这些内容，而是重点说明日文解说文章中不一致的地方（Node.js 版本、Windows 管理员权限和 Git），以及官方文档未涉及的内容——无需登录、改用 API 密钥运行的设置，以及从日本付款。价格和付款方式的信息截至 2026年10月10日。日本同时列在 Anthropic 的 Claude.ai 和 API 支持国家列表中（2026年10月3日核查）。

先决定：使用订阅登录，还是通过 API 密钥运行

安装本身无论选择哪种方式都相同，区别在首次启动之后。Claude Code 启动后会要求进行身份验证。如果不确定，可以根据以下 3 点判断。

• 已经订阅 Pro、Max、Team 或 Enterprise，或拥有 Console 账户：直接登录即可使用。无需设置本页的 API 密钥。免费套餐不包含 Claude Code。
• 不想每月支付固定费用，或者每月用量差异很大：适合使用 API 密钥运行，并按已使用的 token 付费。供参考，Claude 订阅中，Pro 每月 $20（按年付费为 $200，相当于每月 $17），Max 起价为每月 $100，两者均不含税（Claude 价格页面，2026年10月3日核查）。我们在Claude Code 费用中计算了哪种方案更便宜的临界点。
• 想使用 Remote Control 或语音输入：两者都要求 claude.ai 账户，因此不能使用 API 密钥。请选择登录。

付款方式也有所不同。在 Anthropic 网站上购买的订阅仅支持信用卡或借记卡；通过 iPhone 或 Android 应用订阅时，则由 App Store 或 Google Play 处理付款（Anthropic 帮助中心，英文版，截至 2026年10月3日核查）。Kunavo 的 API 余额可使用银行卡（包括 JCB）、Apple Pay、Google Pay 和 Link 充值（详情见后文的付款章节）。

安装前检查

条件与官方文档（2026年10月3日确认）一致。右侧一列说明如何在本地确认。

选择安装方式

官方文档标注“推荐”的是原生安装程序。它与其他方式的主要区别在于更新方式。

# Homebrew（既定では自動更新されない）
brew install --cask claude-code

# WinGet（Windows・既定では自動更新されない）
winget install Anthropic.ClaudeCode

无论采用哪种方式，完成后都要重新打开终端再进行确认。安装前已打开的窗口可能尚未加载新的 PATH。claude doctor 只显示安装和设置状态，不会开始会话，因此可用于排查无法正常运行的问题。

claude --version   # 2.1.211 (Claude Code) のようなバージョン番号が出れば OK
claude doctor      # セッションを開かずに、インストールと設定を診断する

通过 npm 安装时的注意事项

日文解说文章中仍常见“Node.js 18 或更高版本”的说法，但官方文档要求的是Node.js 22 或更高版本（官方文档，2026年10月3日核查）。使用较旧的 Node.js 时，npm 只会发出 EBADENGINE 警告，不会停止安装，claude 也会启动；不过看到警告后，最好升级 Node.js。如果你使用 nvm 或 Volta 等工具切换版本，请在安装所用的 shell 中检查 node -v。

node -v                                    # v22 以上であること
npm install -g @anthropic-ai/claude-code   # sudo は付けない

# 更新は @latest で（npm update -g は使わない）
npm install -g @anthropic-ai/claude-code@latest

官方文档明确要求不要使用 sudo npm install -g。此外，由于主体二进制文件会作为可选依赖安装，如果 --omit=optional 或 .npmrc 的 optional=false 省略了可选依赖，在 Mac、Linux 上会显示 claude native binary not installed，无法启动。

在 Windows 上安装时的要点

首先，网上常见的两种操作都不需要。“以管理员身份运行 PowerShell”和“先安装 Git for Windows”都不是官方文档的要求。无需管理员权限，Git for Windows 是可选项；如果未安装，Claude Code 会在 PowerShell 中执行命令（Windows 设置，2026年10月3日核查）。

在粘贴命令之前，请先确认两点。

1. 当前打开的是 PowerShell 还是 CMD。如果提示符是 PS C:\Users\ユーザー名>，请使用 PowerShell 的 irm 行；如果是没有 PS 的 C:\Users\ユーザー名>，请使用 CMD 的 install.cmd 行。弄错后，PowerShell 会报错，表示无法将 && 识别为分隔符；CMD 会报错，表示无法识别 irm（日语版 Windows 可能会以日语显示消息）。
2. 是否打开了“Windows PowerShell (x86)”。开始菜单中带有 (x86) 的版本以 32 位进程运行，因此即使电脑为 64 位，也会因 Claude Code does not support 32-bit Windows 而停止。

在 Windows 上有 3 种运行方式。如果不确定，可以从原生方式开始。

如果已安装 Git for Windows，但 Claude Code 找不到 Git Bash，请在用户配置文件的 env 中，将 bash.exe 的位置写入 CLAUDE_CODE_GIT_BASH_PATH。

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

安装后 claude 无法运行时

'claude' is not recognized（Mac、Linux 上为 command not found: claude）表示安装位置不在 PATH 中。原生安装程序的位置在 Windows 上为 %USERPROFILE%\.local\bin\claude.exe，Mac、Linux 上为 ~/.local/bin/claude。重新打开终端后仍未解决时，请按照官方文档中的步骤，从 PowerShell 检查并添加。

# 1. インストール先が PATH に入っているか確認する
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. 何も出なければユーザーの PATH に追加し、ターミナルを開き直す
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. 新しいターミナルで
claude --version

如果通过 npm 安装时出现 npm.ps1 cannot be loaded because running scripts is disabled on this system（启动时则出现 claude.ps1），这是因为 PowerShell 执行策略阻止了 npm 的 .ps1 脚本（官方文档，2026年10月3日核查）。运行下面的命令，只为当前用户允许本地脚本执行即可解决。如果不想更改策略，可以使用 npm.cmd、claude.cmd，或者切换到适用于 PowerShell 的原生安装程序。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

不登录、使用 API 密钥运行的设置

Kunavo 并非 Anthropic，而是一家独立的 API 网关，提供对 Claude 等模型的预付费 API 访问。Claude Code 提供了官方变量 ANTHROPIC_BASE_URL，用于更换请求的目标地址；官方文档也有“将 Claude Code 连接到 LLM 网关”页面。无需使用插件或修改版。此变量只更改目标地址，实际作答的模型由另一个变量决定（模型设置，2026年10月3日核查）。

需要设置以下 6 项。

在 Mac、Linux 上，将其追加到 shell 配置文件（~/.zshrc 或 ~/.bashrc），然后重新打开终端。

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # ドメインだけ。/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 窗口中运行以下命令。关闭窗口后设置会消失。

# このウィンドウの中だけで有効（閉じると消える）
$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（Windows 为 %USERPROFILE%\.claude\settings.json）的 env 中。它会对所有项目生效，Mac 和 Windows 使用相同写法即可。如果文件中已有其他设置，只添加 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"
  }
}

关于放置位置，有 3 点需要注意。

• 请不要将密钥写入项目的 .claude/settings.json。密钥会被提交到代码仓库，并提供给所有克隆仓库的人（官方文档）。
• 如果 shell 和配置文件中都有相同变量，将使用配置文件中的值。即使重新执行 export 后仍未改变，也请检查配置文件。
• 通过 VS Code 扩展使用时，将相同变量添加到 VS Code 用户设置的 claudeCode.environmentVariables 中。

使用 ANTHROPIC_AUTH_TOKEN 的原因

ANTHROPIC_AUTH_TOKEN 会通过 Authorization: Bearer 标头发送，设置后立即生效。另一方面，ANTHROPIC_API_KEY 会通过 x-api-key 标头发送，在交互模式下首次会请求一次授权。若在此处拒绝，密钥之后会在没有任何提示的情况下被忽略，直到在 /config 的 Use custom API key 中重新启用。Kunavo 接受通过两种标头发送的密钥，因此ANTHROPIC_API_KEY也能运行，但由于没有这个陷阱，ANTHROPIC_AUTH_TOKEN更可靠。官方文档也建议，在未指定密钥类型时使用 ANTHROPIC_AUTH_TOKEN。

固定模型的原因（截至 2026年10月3日）

根据官方文档（2026年10月3日核查），使用 API 密钥时，默认模型和 opus 别名指向 Opus 5.5，sonnet 别名指向 Sonnet 5.5。每次发布新模型时，别名的指向都会改变，但 Kunavo 未必能在同一天提供该模型。事实上，截至 2026年10月3日，Kunavo 尚未提供 Sonnet 5.5，因此如果不固定模型而选择 /model sonnet，就会收到 404 错误。opusplan 执行阶段以及指定了 model: sonnet 的子智能体也会遇到同样的问题。因此，上述设置通过 ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 固定了 sonnet 别名。opus 别名也通过 ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5 固定为 Claude Opus 5.5，这样即使它的指向改为下一个 Opus，也不会造成问题。Claude Opus 5.5 需要 Claude Code v2.1.280 或更高版本；如果版本较旧，请使用 claude update 更新。

固定模型也能让费用更容易预估。如果不指定模型，默认模型会是 Claude Opus 5.5，每个 token 的单价会高于以 Claude Sonnet 5 为主模型时的单价。Kunavo 的单价（每 1M 个 token，输入 / 输出）为：Claude Haiku 4.5 $0.70 / $3.50，Claude Sonnet 5 $1.40 / $7.00（Anthropic 官方价格为 $2.00 / $10.00），以及 Claude Opus 5.5 $2.80 / $14.00。如果不设置 ANTHROPIC_DEFAULT_HAIKU_MODEL，通过 ANTHROPIC_AUTH_TOKEN 连接的会话中，供 claude --resume 使用的对话摘要等后台处理也会由主模型运行（网关兼容性指南，2026年10月3日核查）。另外，在 Anthropic 的价格页面中，设为主模型的 Sonnet 5 已被移至“旧版模型”栏目（2026年10月3日核查）。

分 3 个阶段确认运行状态

1. 启动前，仅测试 URL 和密钥

这是与官方文档相同的请求，只输出 1 个令牌（会从余额中扣除极少量）。它会读取 shell 变量，因此如果密钥只写在配置文件中，请先在此终端中执行 export，然后再运行。若返回以 {"id":"msg_ 开头的 JSON 和 200，则 URL 和密钥均正常；若返回 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": "."}]}'

2. 启动 claude，确认不会出现登录界面

首次会显示首次运行向导和文件夹信任确认，但之后不会要求在浏览器中登录。如果要求登录，说明密钥没有传递到位。

常见原因是只将密钥写入项目的 .claude/settings.json 或 .claude/settings.local.json。在交互式会话中，项目设置中的 env 会在向导和文件夹信任确认完成后才读取，因此首次启动时会被视为没有密钥。请将其移到 shell 的 export 或用户的 ~/.claude/settings.json 中。

3. 查看 /status 中的两行

在会话中运行 /status，并查看 Status 选项卡（官方文档，2026年10月3日核查）。

• Anthropic base URL 中应显示 https://api.kunavo.com。只有在设置网关时才会出现此行，因此如果整行不存在，说明 ANTHROPIC_BASE_URL 没有传递到会话。
• Auth token 中应显示 ANTHROPIC_AUTH_TOKEN。如果显示的是 claude.ai 账户的 Login method，则表示正在使用已保存的登录信息。

使用 API 密钥运行时会发生的变化

• Remote Control 和语音输入不可用。两者都以 claude.ai ID 为前提，因此在 ANTHROPIC_AUTH_TOKEN 等网关凭据生效期间会被禁用。从 v2.1.196 起，只要 ANTHROPIC_BASE_URL 指向 Anthropic 以外的主机，Remote Control 就会被禁用。
• 会显示 /fast 已禁用。仅使用 bearer token 进行身份验证时，Claude Code 不会查询是否可以使用快速模式，而是将其视为禁用，并显示 Fast mode has been disabled by your organization。
• /context 中显示的数字是估算值。由于 Kunavo 不提供 /v1/messages/count_tokens，Claude Code 会改用基于字符数的估算方式（网关兼容性指南，2026年10月3日核查）。

Kunavo 端的详细设置见Claude Code 集成文档和 ANTHROPIC_BASE_URL 文档（两者均为英文）。

API 余额支付：JCB・Apple Pay・Google Pay・Link

下面先汇总从日本付款时常见的问题。

步骤共有 4 个。首先注册 Kunavo（使用电子邮件地址或 Google 账户；注册时不会要求提供卡片信息）。然后在控制面板的 Billing 中选择充值金额。最低为 $10，无月费，大额充值会获得奖励（$100 可充值为 $110 余额、$1,000 可充值为 $1,200 余额和$5,000 可充值为 $6,250 余额）。在 Stripe 结账页面选择上述方式付款后，最后在 API Keys 中创建 sk-kn- 密钥，并将其填入 ANTHROPIC_AUTH_TOKEN。密钥只会在创建时显示一次，请立即复制。

余额没有有效期，失败的请求不会收费。关于在日本支付 Claude 订阅时可使用哪些方式（包括通过 App Store、Google Play），我们已在带有来源的Claude 支付方式中汇总。

费用参考（估算）

通过 API 密钥运行的 Claude Code 按令牌使用量计费。Claude Code 会在每次请求中整体发送对话上下文，但与上次相同的开头部分可能按缓存读取单价计费。下表假设每个请求的输入为 40,000 个令牌，其中 36,000 = 90% 为缓存读取，剩余 4,000 为缓存写入；输出为 1,000 个令牌，并假设一次工作包含 50 个请求。不包括后台的 Claude Haiku 4.5 调用。对于 Claude Sonnet 5，Kunavo 的缓存价格为：读取费用是输入单价的 10%，写入费用是 1.25 倍（表中各模型均按各自比例计算）。这不是实测值，也不是上限。

实际金额会因上下文长度、缓存命中情况、响应长度，以及是否在每项工作中执行 /clear 而变化。所有模型的单价可在价格页面查看，按照自身使用方式估算可使用 Claude 令牌费用计算器（英文），各模型的 API 单价可在Claude API 价格中确认。

常见错误及处理方法

不适合使用此方法的情况

• 报销必须提供合格发票。Kunavo 的结账不会开具发票，也不会开具带注册号的合格发票。
• 想使用便利店付款或 PayPay。两者都不支持，银行转账和运营商计费也不支持。自动充值只能使用已保存的卡或 Link。
• 要使用 Remote Control 或语音输入。API 密钥无法使用这些功能，且 /fast 也会显示为已禁用。请使用订阅登录。
• 想使用 Sonnet 5.5。截至 2026年10月3日，Kunavo 尚未提供该模型。
• 希望仅通过日语文档完成设置。Claude Code 本体的官方文档可以用日语阅读，但 Kunavo 的集成文档仅提供英文。

接下来要做什么

通过 /status 确认后，在要处理的项目目录中启动 claude，首先使用 /init 创建 CLAUDE.md。CLAUDE.md 应写入哪些内容、如何减少确认对话框，以及如何创建自定义命令，将在Claude Code 使用方法中依次说明。

常见问题