Claude Codeのインストールチュートリアル：Windows・macOSのインストールコマンド、ログインせずAPI keyで設定、Alipay・WeChat Payでチャージ

Claude CodeはAnthropic公式のネイティブインストールコマンドでのインストールが推奨され、npmはNode.js 22以上が必要な公式の代替方法です。ClaudeアカウントにログインしなくてもClaude Codeを使えます。ANTHROPIC_BASE_URL（ドメインまで記述し、/v1は付けない）、ANTHROPIC_AUTH_TOKEN、およびモデルを固定する4行を設定すれば、トークン従量課金のAPI keyに切り替えられます。KunavoのAPI残高にはAlipayまたはWeChat Payでチャージでき、最低額は$10です。最後にClaude Codeで/statusを実行して接続を確認してください。

# 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

命令和环境变量核对于 2026年10月3日，依据 Claude Code公式インストールドキュメント和 公式環境変数ドキュメント；价格和付款方式核对于 2026年10月3日。先说明一个事实：Anthropicのサポート対象国・地域一覧（核对于 2026年10月3日）中没有中国大陆、香港和澳门，Claude Code 安装文档的系统要求里也有一行「所在地区：Anthropic 支持的国家」。本页只讲官方文档写明的安装和配置方法，不提供任何绕过地区限制的办法。Kunavo 没有在中国大陆做过网络连通性测试，下面提到的下载地址、npm 源和 api.kunavo.com 能否在你的网络里访问，需要你自己确认。

インストール前の確認

方法1：公式ネイティブインストール（推奨）

公式インストールドキュメントではネイティブインストールを推奨しており、コマンドはこのページ冒頭の3つです。macOS、Linux、WSLではinstall.shの行、Windows PowerShellではirm … | iex、Windows CMDではinstall.cmdの行を使用します。ネイティブインストールはバックグラウンドで最新バージョンに自動更新されます。公式ドキュメントには、HomebrewとWinGetによるインストールはデフォルトで自動更新されないとも記載されています。

インストール後、新しいターミナルウィンドウを開き（開いたままのウィンドウは新しいPATHを読み取れません）、次を確認します。

claude --version   # 正常会打印版本号，后面跟着 (Claude Code)
claude doctor      # 只读的安装与设置诊断，不会开启会话

claude doctorはセッションを開始せず、インストール状態と設定ファイルの診断情報だけを表示します。「インストールの問題」か「設定の問題」かを切り分けるために使用できます。

ダウンロードエラーが発生した場合

如果终端里出现 syntax error near unexpected token '<' 或 curl: (22) The requested URL returned error: 403，按 公式インストールトラブルシューティングドキュメント（核对于 2026年10月3日）的说法，这表示安装地址返回的是一个网页或错误状态码，而不是安装脚本。如果返回的网页写着 App unavailable in region，官方的解释是：Claude Code 在你所在的国家或地区不可用。不带网页内容的 403 也可能来自公司代理或防火墙拦截下载；官方建议，在支持地区内仍然遇到 403 时，先排查网络连接，再考虑其他安装方式。

方法2：npmインストール（Node.js 22以上が必要）

npm 仍是官方文档列出的安装方式。官方文档写明 npm 包需要 Node.js 22 或更高版本；版本较旧时 npm 会打印 EBADENGINE 警告但不会失败，安装照样完成，因为这个包下载的是一个运行时不依赖 Node.js 的原生程序。没有 Node.js 的话，从 Node.js公式サイト安装 22 或更高版本。

node -v                                    # 需要 v22 或更高
npm install -g @anthropic-ai/claude-code   # 不要加 sudo

公式ドキュメントでは、sudo npm install -gを使用しないよう明記しています。権限の問題とセキュリティリスクにつながるためです。アップグレードにはnpm install -g @anthropic-ai/claude-code@latestを使用し、npm update -gは使用しないでください。

デフォルトのレジストリからのダウンロードに失敗する、または遅い場合：npmmirror

如果从 npm 默认源下载失败或很慢，可以改用 npmmirror。npmmirrorトップページ（核对于 2026年10月3日）说明它是「完整 npmjs.com 镜像」，只读，会「尽量与官方服务实时同步」，并给出了 registry 地址和设置命令。首页没有写明具体同步频率。

# 只在这一次安装时使用 npmmirror
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 或者把 npmmirror 设为 npm 的默认源（之后所有 npm 安装都会走它）
npm config set registry https://registry.npmmirror.com

# 以后升级用 @latest，不要用 npm update -g
npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com

ミラーを使ってClaude Codeをインストールする際に見落としやすい条件が2つあります。いずれも公式トラブルシューティングドキュメントに基づくものです。

• ミラーは8つのプラットフォームパッケージをすべて提供する必要があります。npmパッケージ自体は外側のラッパーにすぎず、実際のプログラムは@anthropic-ai/claude-code-*プラットフォームパッケージとしてオプション依存関係でダウンロードされます。ミラーにプラットフォームパッケージがない場合、インストール後にmacOSまたはLinuxでclaudeを実行するとclaude native binary not installedと表示されます（WindowsではPowerShellまたはCMDがこのファイルを実行できないと報告します）。2026年10月3日にKunavoが中国本土外のネットワークから確認したところ、npmmirror上のメインパッケージとWindows x64、macOS ARM64、Linux x64の3つのプラットフォームパッケージはnpmjsの最新バージョンと一致していました。その他のプラットフォームパッケージ（ARM64 Windows、Intel Mac、ARM64 Linux、2つのmuslバージョン）は確認していません。
• オプション依存関係を省略してはいけません。インストールコマンドに--omit=optionalを付けず、.npmrcにoptional=falseが設定されていないことも確認してください。

Windows固有の事項

Windowsには異なるインストールコマンドが2つあり、違いは開いているターミナルの種類だけです。プロンプトがPS C:\Users\你的用户名>ならPowerShell、PSがなくC:\Users\你的用户名>だけならコマンドプロンプト（CMD）です。公式ドキュメントによると、インストールに管理者権限は必要ありません。

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」と「Windows PowerShell (x86)」の2つの入口があります。後者は32ビットプロセスで、Claude Code does not support 32-bit Windowsと表示されるため、(x86)のない方を開いてください。

Git for Windows 是可选的：装了以后 Claude Code 用它附带的 Git Bash 执行命令；没装时改用 PowerShell 工具执行。装了却找不到 Git Bash 时，在 ~/.claude/settings.json 的 env 里设置 CLAUDE_CODE_GIT_BASH_PATH，指向 bash.exe，官方示例路径是 C:\Program Files\Git\bin\bash.exe。

WSLを選ぶ場合は、WSLターミナルでmacOS／Linux用の行を実行し、PowerShellやCMDではなくWSL内でclaudeを起動してください。

npm方式で実行ポリシーエラーが発生する場合

PowerShellでnpmを使ってインストールまたは実行した際にnpm.ps1 cannot be loaded because running scripts is disabled on this systemが表示される場合、PowerShellの実行ポリシーがnpmによって生成された.ps1起動スクリプトをブロックしています。公式には3つの解決方法があります。現在のユーザーによるローカルスクリプトの実行を許可する（下の行）、npm.cmdとclaude.cmdを使う、またはPowerShellのネイティブインストールコマンドを使う方法です。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

インストール後にclaudeが見つからない場合

command not found: claudeまたは'claude' is not recognizedが表示される場合、インストールディレクトリがPATHに含まれていません。まず新しいターミナルを開いて再試行してください。それでもWindowsで解決しない場合は、公式トラブルシューティングドキュメントに従い、PowerShellで確認してユーザーPATHに追加します。macOS／Linuxでは~/.local/bin/claude、Windowsでは%USERPROFILE%\.local\bin\claude.exeです。

# 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

API keyの設定：Claudeアカウントにログインしない

ANTHROPIC_BASE_URLはClaude Codeに組み込まれた環境変数です。公式ドキュメントでは、APIエンドポイントを上書きし、リクエストをプロキシまたはゲートウェイ経由にするものと説明されています。したがって、Claude CodeをAnthropic Messages APIを提供するエンドポイントに向けることは、プラグインや改変プログラムを必要としない公式サポートの設定方法です。macOS／Linuxではshellの設定ファイルに記述します。

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ウィンドウ内で試す場合：

# 只对当前 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の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"
  }
}

この6行には、それぞれ設定を誤りやすい点があります。

• 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は対話モードで一度確認する必要があります。確認時に拒否すると、その後このキーは黙って無視されます（/configのUse custom API keyで再度有効にできます）。
• ANTHROPIC_MODELがメインモデルを決定します。ここではClaude Sonnet 5（claude-sonnet-5）に固定します。モデル名はKunavoのモデル一覧と完全に一致する必要があり、日付サフィックス付きの古い名前は自動対応されません。
• ANTHROPIC_DEFAULT_OPUS_MODELがopus別名を決定します。按 公式モデル設定ドキュメント（核对于 2026年10月3日），API 用户的默认模型和 opus 别名指向最新的 Opus（目前是 Opus 5.5），sonnet 别名指向 Sonnet 5.5，而且别名会跟着 Anthropic 的新版本移动。官方文档写明别名「会随时间更新」，要固定版本，就写完整模型名或设置 ANTHROPIC_DEFAULT_OPUS_MODEL 这类变量。Kunavo 目前没有提供 Sonnet 5.5，Anthropic 以后发布新 Opus 时 Kunavo 也不一定已经上架，没上架的模型会返回 404。这就是要把主模型、opus 和 sonnet 别名都固定下来的原因。这里 opus 别名固定为 Claude Opus 5.5（claude-opus-5-5），需要 Claude Code v2.1.280 或更高版本，旧版本先运行 claude update 升级。
• ANTHROPIC_DEFAULT_SONNET_MODELがsonnet別名を決定します。公式ドキュメントによると、この変数はsonnet別名がどのモデルを指すかを決定し、opusplanの計画モード外（実行フェーズ）で使用するモデルも決定します。sonnet別名はデフォルトでSonnet 5.5をリクエストしますが、Kunavoは現在提供していません。そのためこの行を設定しないと、/model sonnet、opusplanの実行フェーズ、model: sonnetを指定したサブエージェントはすべて404を返します。ここでもClaude Sonnet 5（claude-sonnet-5）に固定します。
• ANTHROPIC_DEFAULT_HAIKU_MODELはバックグラウンドタスクも管理します。公式ドキュメントによると、この変数はhaiku別名を決定し、バックグラウンド機能にも使用されます。Claude Haiku 4.5のKunavoにおける100万入力トークンあたりの料金は$0.70、出力は$3.50です。メインモデルClaude Sonnet 5は$1.40 / $7.00（Anthropic公式価格 $2.00 / $10.00）、opus別名のClaude Opus 5.5は$2.80 / $14.00です。

キーをプロジェクト内の.claude/settings.jsonに書き込まないでください。公式ドキュメントは、このファイルがコミットされ、クローンしたすべてのリポジトリ利用者に共有される可能性があると注意しています。また、優先順位にも注意してください。shellとsettingsファイルで同じ変数を設定した場合、settingsファイルの値が優先されます。shell変数を変更しても反映されない場合は、まずsettingsファイルを確認してください。

初回実行時に起こること

按官方的 ゲートウェイ接続ドキュメント（核对于 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を実行し、Statusページで次の2行を確認します。

• Anthropic base URL：ゲートウェイアドレスを設定した場合のみ表示され、https://api.kunavo.comとなっているはずです。この行がない場合、ANTHROPIC_BASE_URLがこのセッションに渡っていません。
• Auth token：ANTHROPIC_AUTH_TOKENと表示されていれば、保存済みのclaude.aiログインではなくAPI keyを使用しています。Login methodとclaude.aiアカウントが表示される場合は、変数が有効になっていません。

Claude Codeを開く前にアドレスとキーを個別にテストしたい場合は、公式ドキュメントの方法に従い、出力トークン1個だけを要求するリクエストを送信できます（トークン分のごく少額が差し引かれます）。このコマンドはshellの変数を読み取るため、キーをsettingsファイルに書いた場合でも、現在のターミナルで先にexportを実行する必要があります。{"id":"msg_で始まるJSONが返れば、アドレスとキーは問題ありません。401が返る場合は、キーが認識されていません。

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

API keyを使う場合の違い

• Remote Controlと音声入力は利用できません。公式ドキュメントによると、これら2つはclaude.aiの認証情報に依存しており、ANTHROPIC_AUTH_TOKENを設定すると利用できません。ANTHROPIC_BASE_URLがAnthropic以外のアドレスを指している場合、Remote Controlも無効になります。
• /fastにはfastモードが無効と表示されます。公式ドキュメントによると、bearer tokenのみの場合、Claude Codeはfastモードを直接無効として扱い、可用性チェックを送信しません。
• MCPツール検索はデフォルトで無効です。公式ドキュメントによると、ANTHROPIC_BASE_URLがAnthropic以外のアドレスを指している場合、MCP tool searchはデフォルトで無効になります。
• /contextの数値はローカルでの推定値です。Kunavo 目前不提供 /v1/messages/count_tokens。按 公式ゲートウェイ互換性ドキュメント（核对于 2026年10月3日），网关没有这个端点时，Claude Code 改用按字符估算，/context 显示的是近似值。

完全な接続手順はClaude Code接続ドキュメント（英語）をご覧ください。

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICが無効にするもの

按 公式環境変数ドキュメント（核对于 2026年10月3日），它的作用是关闭 Claude Code 的非必要网络流量，官方列出的内容是：

• 自動更新、テレメトリ、エラーレポート。
• /feedbackコマンドとClaudeが作成するフィードバック。
• リリースノート、PR／MRステータスバッジの確認。
• fastモードなどの可用性チェック。
• 機能フラグ（feature flag）の取得。そのためRemote Controlなど、機能フラグに依存する機能は利用できません。
• プラグインcommandソースのバックグラウンド再実行（これはネットワーク通信ではなく、依存関係のインストールを引き起こす可能性があるローカルコマンドです）。

公式に記載された詳細がさらにあります。0またはfalseに設定しても有効とみなされます。多くのスイッチ変数とは異なり、変数を削除した場合のみ元に戻ります。公式プラグインマーケットプレイスの自動インストールは対象外です。ゲートウェイのモデル検出にも影響しません。公式ゲートウェイドキュメントでは、WebFetchツールのドメイン安全性チェックにも影響せず、このチェックは引き続きapi.anthropic.comへアクセスすると補足しています。無効にするには、設定にskipWebFetchPreflight: trueを別途追加します。公式ドキュメントは、この変数をアカウントのリスク管理に関係する設定とは説明していません。

Kunavo 不要求设置它，它也不影响发往 Kunavo 的模型请求。什么时候值得开启，官方 ゲートウェイ接続ドキュメント（核对于 2026年10月3日）给了一个场景：即使 ANTHROPIC_BASE_URL 指向网关，Claude Code 仍会向 Anthropic 和 GitHub 等第三方发送版本检查、遥测、发布说明之类的后台请求；如果你的网络只允许访问网关地址，这些请求会失败，并可能在出站监控里显示为被拦截的连接，官方的做法就是和网关变量一起设置这个变量。

有効にすると自動更新されなくなるため、公式は別の更新手段を用意するよう推奨しています。npmでインストールした場合は@latestを使って手動でアップグレードします（上のnpmmirrorの最後の行を参照）。

# 可选：关闭 Claude Code 的非必要网络流量（会同时关闭自动更新）
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# 想恢复时删掉这个变量；设成 0 或 false 仍然算开启
unset CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

AlipayまたはWeChat Payでチャージしてキーを取得する

Anthropic 官方的网页订阅只收信用卡或借记卡（Claude有料プランの請求に関するFAQ，核对于 2026年10月3日）。在 Kunavo 充值可以用支付宝或微信支付，步骤概要如下，完整步骤见 Claude APIのAlipay・WeChat Payチャージガイド：

1. Kunavoアカウントを作成します。メールアドレスまたはGoogleアカウントを使用でき、登録時にカードを登録する必要はありません。
2. 請求でチャージ額を選択します。最低$10で、月額料金はありません。多くチャージするとボーナスがあります：充 $100 到账 $110、充 $1000 到账 $1200、充 $5000 到账 $6250。
3. Stripeの決済ページでAlipayまたはWeChat Payを選択し、QRコードをスキャンして支払います。中国本土から開く場合、金額は人民元で表示されるため、決済ページの表示額を基準にしてください。
4. /app/keysでsk-kn-から始まるキーを作成し（1回しか表示されないため、すぐに保存してください）、上記のANTHROPIC_AUTH_TOKENに入力します。

AlipayとWeChat Payは手動チャージのみ利用できます。自動チャージには銀行カードまたはLinkの登録が必要です。Kunavoは中国の付加価値税請求書を発行しておらず、チャージ履歴はBillingページで確認できます。

おおよその費用（説明用の計算）

Claude Codeはトークン単位で課金され、リクエストごとに会話コンテキストが再送信されます。同じ前置き部分はキャッシュ読み取りとして課金できます。以下は説明用のトークン計算の一例であり、実際の請求額でも費用上限でもありません。前提条件をすべて示します。

• 各リクエストの入力は40,000トークンで、そのうち36,000（90%）はキャッシュ読み取りとして課金され、残りの4,000はキャッシュ書き込みとして課金されます。
• 各リクエストの出力は1,000トークン。
• 一定の作業時間にこのようなリクエストを50回送信し、Claude Haiku 4.5のバックグラウンド呼び出しは含めません。
• Kunavoの料金：キャッシュ読み取りは入力料金の10%、キャッシュ書き込みは入力料金の1.25倍です（Claude Sonnet 5の比率。表では各モデルの比率を使用して計算します）。

実際の費用は、コンテキストの長さ、キャッシュヒット数、出力の長さ、タスク間で/clearを使って会話を消去するかどうかによって異なります。Claude CodeのサブスクリプションとAPIのどちらを選ぶか、月額のおおよその費用についてはClaude Codeの料金をご覧ください。各モデルの完全な料金はClaude APIの料金と料金ページに掲載されています。自分の使用量で見積もる場合はClaudeトークンコスト計算ツール（英語）を使用できます。

よくあるエラーの対応表

知っておくべき制限

• Kunavoは中国の付加価値税請求書を発行していません。
• AlipayとWeChat Payは手動チャージのみ利用できます。自動チャージには銀行カードまたはLinkの登録が必要です。
• これはトークン従量課金のAPIであり、Claude Pro／Maxのサブスクリプションではありません。API keyを使用する場合、Remote Controlと音声入力は利用できません。両者の選び方はClaude Codeの料金をご覧ください。
• Kunavoは中国本土でネットワーク接続テストを実施していません。claude.aiのインストール先、npmレジストリ、npmmirror、api.kunavo.comに現在のネットワークからアクセスできるか、速度はどうかは、ご自身で確認する必要があります。
• Anthropicのサポート対象国・地域一覧（2026年10月3日を基準）に中国本土、香港、マカオは含まれておらず、Claude Codeの公式インストールドキュメントでは地域がシステム要件の一つに指定されています。

よくある質問