Claude Codeのインストール：WindowsとmacOSのインストールコマンド、Pro/Maxプラン不要のAPIキー設定、カードまたはLinkでの支払い

Claude CodeをPro/Maxプランなしで使うには、3つの作業を行います。まず公式のnativeコマンドでインストールします（ターミナルごとに1行ずつ、直下に記載）。次にANTHROPIC_BASE_URL=https://api.kunavo.com（/v1は付けません）とANTHROPIC_AUTH_TOKEN、および4つのモデル固定用変数を設定し、/statusを入力してClaude Codeがkeyで実行されていることを確認します。トークン料金は前払い残高から差し引かれます。10 USDからVisa/MastercardまたはLinkで入金できます。MoMo、ZaloPay、VNPayは利用できません。npmでインストールする場合、Node.js 22以降が必要です。

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

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

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

Lệnh cài và tên biến trong bài lấy từ tài liệu chính thức của Claude Code, gồm インストールページ và 環境変数の一覧, đọc lại ngày 2026年10月3日. Anthropic chưa có bản tiếng Việt của các trang này (đường dẫn /docs/vi/setup báo 404 cùng ngày), nên thông báo lỗi trong bài được giữ nguyên tiếng Anh để bạn tìm cho dễ. Giá và cách thanh toán của Kunavo được kiểm tra ngày 2026年10月3日.

開いているターミナルに応じてインストールコマンドを選択

すべてのインストール方法で同じプログラムclaudeになります。違いは、更新を誰が担当するかです。公式ドキュメントではnative方式を「Native Install (Recommended)」タブに掲載しており、何もしなくても自動的に最新版へ更新される唯一の方法です。

# Homebrew (macOS, Linux) – mặc định không tự cập nhật
brew install --cask claude-code

# WinGet (Windows) – mặc định không tự cập nhật
winget install Anthropic.ClaudeCode

マシンには次の条件が必要です（インストールページ、2026年10月3日時点）：

• OS：macOS 13.0以降、Windows 10 version 1809以降またはWindows Server 2019以降、Ubuntu 20.04+、Debian 10+、またはAlpine Linux 3.19+。
• 最低4 GBのRAM、CPUはx64またはARM64。Windows 32-bitはサポートされません。
• ShellはBash、Zsh、PowerShell、またはCMDで、インターネット接続が必要です。
• Node.jsはnpm経由でインストールする場合のみ必要で、version 22以降でなければなりません。

インストール後、古いウィンドウですぐにclaudeを入力しないでください。そのウィンドウには新しいPATHがまだ反映されていません。別のターミナルを開いて次を実行します。

claude --version   # in ra số phiên bản, kèm chữ (Claude Code)
claude doctor      # chẩn đoán cài đặt và file cấu hình, không mở phiên làm việc

claude --versionでバージョン番号が表示されれば、インストールは完了しています。それ以降のエラーはすべて設定の問題です。claude doctorは、問題の場所が分からない場合に役立ちます。セッションを開始せずに、インストールとsettingsファイルの両方を確認するためです。

Windows：つまずきやすい5つのポイント

1. コマンドを誤って貼り付けた。 PowerShellでCMDの行を実行するとThe token '&&' is not a valid statement separator、CMDでPowerShellの行を実行すると'irm' is not recognized as an internal or external commandと表示されます。プロンプトを確認し、PSがあればirmの行を、なければinstall.cmdの行を使用してください。
2. 「Windows PowerShell (x86)」を開いてしまった。 Startメニューのこの項目は32-bitプロセスなので、64-bitマシンでもClaude Code does not support 32-bit Windowsと表示されます。「(x86)」のない項目を選択してください。
3. Administrator権限で実行する必要はありません。公式ドキュメントでも要求されておらず、native版はユーザーのディレクトリにインストールされます：%USERPROFILE%\.local\bin\claude.exe。
4. claudeを入力すると「not recognized」と表示される。上記のディレクトリがPATHに追加されていません。まず新しいターミナルを試してください。それでも解決しない場合は、下記のPowerShellスニペットで確認してパスを追加します。macOS/Linuxでの同等のエラーはcommand not found: claudeで、プログラムは~/.local/bin/claudeにあります。
5. npmがnpm.ps1 cannot be loaded because running scripts is disabled on this systemを表示する。 PowerShellの実行ポリシーが、npmが作成した.ps1スクリプトをブロックしています。ドキュメントでは、下記のSet-ExecutionPolicyコマンドで現在のユーザーにローカルスクリプトの実行を許可する、.ps1版の代わりにnpm.cmdとclaude.cmdを呼び出す、またはnpmをやめてネイティブコマンドを使う、という3つの解決策を示しています。

# 1. Kiểm tra thư mục cài đặt đã có trong PATH chưa
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Không có kết quả nào? Thêm vào PATH của người dùng, rồi đóng và mở lại terminal
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Trong terminal mới
claude --version

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

NativeとWSL、どちらを選ぶべきですか？ Dự án sống trên Windows thì chạy native là đủ. Lúc đó Git for Windows là tùy chọn: có nó, Claude Code chạy lệnh qua Git Bash; không có, nó dùng PowerShell. Nếu Git đã cài mà Claude Code không thấy Git Bash, khai báo CLAUDE_CODE_GIT_BASH_PATH trong khối env của ~/.claude/settings.json, trỏ tới bash.exe (tài liệu lấy ví dụ C:\Program Files\Git\bin\bash.exe). Chọn WSL 2 khi bạn cần công cụ Linux hoặc muốn lệnh chạy trong sandbox, vì sandbox chỉ có trên WSL 2; Windows native và WSL 1 đều không có. WSL 1 chỉ là phương án khi máy không bật được WSL 2. Đã chọn WSL thì cài bằng dòng install.sh và chạy claude hoàn toàn trong terminal WSL.

npm経由のインストール：条件と3つの注意点

npm hợp lý khi bạn đã quản lý công cụ dòng lệnh bằng Node, hoặc khi mạng công ty chỉ cho tải gói qua registry npm. Điều kiện là Node.js 22以降; con số Node 18 trong nhiều bài cũ không còn đúng. Đáng chú ý là Node cũ hơn không làm hỏng việc cài: npm chỉ in cảnh báo EBADENGINE, vì thứ thật sự chạy là một chương trình native mà gói npm tải về, không phụ thuộc Node. Máy chưa có Node thì lấy bản 22+ ở nodejs.org.

node -v                                    # cần v22 trở lên
npm install -g @anthropic-ai/claude-code   # không dùng sudo

# nâng cấp bằng @latest, không dùng npm update -g
npm install -g @anthropic-ai/claude-code@latest

• sudo npm install -gは使用しないでください。公式ドキュメントでは、権限エラーの原因となり、セキュリティリスクになると警告しています。
• npm install -g @anthropic-ai/claude-code@latestで最新版に更新します。npm update -gは推奨されていません。
• nativeプログラムはオプション依存関係（お使いのプラットフォームに対応する@anthropic-ai/claude-code-*パッケージ）から提供されます。--omit=optionalフラグ、.npmrc内のoptional=false行、または--ignore-scriptsを使用するとこれが欠落し、macOS/Linuxではclaude native binary not installedが表示されます。

VPNは必要ですか？インストールスクリプトのダウンロードエラー

Không cần. Việt Nam nằm trong Anthropicがサポートする国の一覧 cho cả Claude.ai lẫn API (kiểm tra ngày 2026年10月3日). Chính VPN mới hay gây chuyện: theo インストールのトラブルシューティングページ (đọc ngày 2026年10月3日), khi địa chỉ cài đặt trả về App unavailable in region, Claude Code không khả dụng ở nơi mà kết nối của bạn được nhìn thấy. Ở Việt Nam mà gặp dòng này thì tắt VPN hoặc proxy đặt ở nước khác rồi chạy lại.

残りの2つのエラーは同じ原因です。syntax error near unexpected token '<'またはcurl: (22) The requested URL returned error: 403は、スクリプトの代わりにHTMLページまたはエラーコードを受け取ったことを意味します。proxyやファイアウォールによってファイルのダウンロードがブロックされる企業ネットワークが、最初に疑うべき原因です。すぐにHomebrew、WinGet、npmへ切り替えないでください。公式ドキュメントでは、代替方法も同じサーバーからダウンロードするため、まずネットワーク接続を確認するよう推奨しています。別のネットワークを試すか、IT部門にブロック解除を依頼してください。

API keyの設定：Pro/MaxプランなしでClaude Codeを実行する

Claude Codeは2つの方法のいずれかで認証します。下表で概要を比較します。記事の続きは右列の方法に沿って説明します。

Claude CodeをAnthropic以外のサービスに向けることは裏技ではありません。公式ドキュメントでは、ANTHROPIC_BASE_URLをproxyまたはgateway経由でAPI endpointを上書きする変数として説明しています。KunavoはAnthropic Messages APIと同じプロトコルを使用するため、pluginもパッチ版も必要なく、標準のClaude Codeをそのまま使えます。必要な変数は正確に6つです。

変数を設定する場所

長期的に使う最も簡単な方法は、ユーザーのsettingsファイル内のenvブロック、つまり~/.claude/settings.json（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"
  }
}

shellに設定したい場合は、~/.zshrcまたは~/.bashrcに追加します。Windowsでは、下記の2つ目の方法（$env:行）が簡単なテストに適していますが、PowerShellウィンドウを閉じると変数は失われます。

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # chỉ tên miền, không thêm /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

# Chỉ có hiệu lực trong cửa sổ PowerShell này, đóng cửa sổ là mất
$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

問題が起きる前に知っておくべき3つのこと：

• プロジェクトの.claude/settings.jsonにkeyを設定しないでください。 gateway接続ドキュメント nhắc rằng file này được commit, ai clone repo cũng có.
• settingsファイルがshellより優先されます。同じ変数が両方にある場合、settingsファイルのenvブロックの値が使用されます。shellで変更しても反映されない場合は、まずsettingsファイルを確認してください。
• 初回実行時にはユーザーレベルのkeyが必要です。対話モードでは、プロジェクトのenv（.claude/settings.jsonまたは.claude/settings.local.json）内のブロックは、初回セットアップウィザードとディレクトリを信頼するかどうかの質問が完了した後にのみ有効になります。そこにしかkeyがない場合、初回起動時にはログイン画面が表示されます。

ANTHROPIC_AUTH_TOKENかANTHROPIC_API_KEYか、そして「403エラー」の問題

Kunavo đọc key ở cả Authorization: Bearer lẫn x-api-key, nên biến nào cũng kết nối được. Khác biệt nằm ở phía Claude Code. Theo 環境変数のドキュメント (đọc ngày 2026年10月3日), ANTHROPIC_AUTH_TOKEN đi vào header Authorization với tiền tố Bearer và có hiệu lực ngay. ANTHROPIC_API_KEY đi vào header X-Api-Key, và ở chế độ tương tác Claude Code hỏi bạn một lần có dùng key này thay cho gói đăng ký không. Trả lời “không” thì key bị bỏ qua mà không hỏi lại; muốn bật lại thì vào /config, mục カスタムAPIキーを使用. Bài này chọn ANTHROPIC_AUTH_TOKEN chỉ để bỏ được bước hỏi đó.

Vài hướng dẫn tiếng Việt viết rằng ANTHROPIC_API_KEY khiến Claude Code phớt lờ ANTHROPIC_BASE_URL, gọi thẳng api.anthropic.com và nhận 403. Cả tài liệu biến môi trường lẫn ゲートウェイ接続のドキュメント (đọc ngày 2026年10月3日) đều không nói vậy: hai biến là hai cách đưa key tới cùng một gateway trong ANTHROPIC_BASE_URL. Nếu bạn thật sự gặp 403 sau khi đổi biến, hãy kiểm tra lại base URL và key thay vì đổi qua đổi lại tên biến.

モデルを固定する理由と各モデルの料金

Alias của Claude Code không đứng yên. Theo モデル設定のドキュメント (đọc ngày 2026年10月3日), với người dùng API, mô hình mặc định và alias opus đang trỏ tới Opus 5.5, alias sonnet trỏ tới Sonnet 5.5; tài liệu cũng nói alias “được cập nhật theo thời gian” và khuyên dùng tên đầy đủ hoặc các biến ANTHROPIC_DEFAULT_*_MODEL khi cần cố định. Tính đến ngày 2026年10月3日, Kunavo có Opus 5.5 nhưng không có Sonnet 5.5. Hệ quả nếu bỏ qua bước ghim: phiên mặc định chạy Opus 5.5, đắt hơn Claude Sonnet 5; /model sonnet, giai đoạn thực thi của opusplan và subagent đặt model: sonnet trả về 404; và lần tới alias opus nhảy sang bản Opus mới, bản đó chưa chắc đã có trên Kunavo. Vì vậy đoạn cấu hình ở trên ghim alias sonnet vào claude-sonnet-5 bằng ANTHROPIC_DEFAULT_SONNET_MODEL, và ghim alias opus vào Opus 5.5 (claude-opus-5-5). Opus 5.5 cần Claude Code v2.1.280 trở lên; bản cũ hơn thì chạy claude update.

Kunavoの料金（100万tokenあたり、入力 / 出力）：Claude Sonnet 5 1,40 USD / 7,00 USD （Anthropicの料金表：2,00 USD / 10,00 USD）、Claude Opus 5.5 2,80 USD / 14,00 USD、Claude Haiku 4.5 0,70 USD / 3,50 USD。

/statusで確認

ANTHROPIC_AUTH_TOKENが読み込まれると、claudeコマンドは直接セッションを開始し、ログイン画面は表示されません（gateway接続ドキュメント、2026年10月3日時点）。初回にはディレクトリを信頼するかどうかの質問など、いくつかの設定手順が残っています。ログイン画面が表示される場合、keyが届いていません。セッション内で/statusを入力し、次を探してください。

• Anthropic base URL：https://api.kunavo.com。gatewayアドレスがある場合にのみ表示されます。表示されない場合、ANTHROPIC_BASE_URLがセッションに反映されていません。
• Auth token：ANTHROPIC_AUTH_TOKEN。ここがLogin methodとclaude.aiアカウントになっている場合、セッションは保存済みのログインを使用しています。

Claude Codeを開く前にkeyとアドレスが正しいことを確認するには、出力を正確に1 tokenだけ要求するrequestを送信します（残高からごく少額が差し引かれます）。このコマンドは現在のshellから変数を読み取るため、keyがsettingsファイルにしかない場合は、先にこのターミナルでexportしてください。{"id":"msg_で始まる結果なら正常で、401はkeyが拒否されたことを示します。

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

API keyで実行すると失われるもの

• Remote Controlと音声入力にはclaude.aiのidentityが必要なため、ANTHROPIC_AUTH_TOKENが有効な場合は動作しません。また、ANTHROPIC_BASE_URLがapi.anthropic.com以外のサーバーを指している場合もRemote Controlは無効になります。
• /fastはFast mode has been disabled by your organizationと表示されます。gatewayプロトコルのドキュメントによると、fast modeの確認にはclaude.aiへのログインまたはAnthropicのAPI keyが必要です。そのため、bearer tokenではClaude Codeが無効と判断し、サーバーに問い合わせません。
• MCP tool searchは、base URLがAnthropicのものではない場合、デフォルトで無効です。
• /contextの数値 là ước tính: Kunavo không có endpoint /v1/messages/count_tokens, và theo gatewayプロトコルのドキュメント (đọc ngày 2026年10月3日), khi thiếu endpoint này Claude Code đếm token dựa trên số ký tự.

統合の詳細はClaude Code統合ドキュメント（英語）にあります。対応する英語記事はInstall Claude Codeです。

ベトナムからの入金：カードまたはLink、国内電子ウォレットには非対応

先に明確にお伝えすると、KunavoはMoMo、ZaloPay、VNPay、銀行振込に対応していません。Napasネットワークのみの国内ATMカードも、VisaやMastercardではないため利用できません。KunavoのStripe決済ページでは、ベトナムの購入者に次の選択肢があります。

• VisaまたはMastercard。国際クレジットカードとデビットカードのどちらも利用できます。
• Link, ví của Stripe, lưu phương thức thanh toán để lần sau trả nhanh hơn (Linkのドキュメント, đọc ngày 2026年10月3日).
• Apple PayまたはGoogle Pay, chỉ xuất hiện trên thiết bị và trình duyệt đã thiết lập ví, vì chúng trả bằng thẻ có trong ví. Apple Pay có mặt ở Việt Nam từ 08/08/2023 và dùng được khi mua hàng trực tuyến (Apple Newsroomベトナム, đọc ngày 2026年10月3日).

Phía Anthropic cũng vậy: gói Claude mua trên web chỉ nhận thẻ tín dụng hoặc ghi nợ (Claudeの決済FAQ, đọc ngày 2026年10月3日), nên ví điện tử Việt Nam không trả trực tiếp được ở đó; gói mua trong ứng dụng iOS hay Android thì đi theo phương thức của App Store hoặc Google Play. Khác ở chỗ, tiền nạp vào Kunavo thành số dư API, và Claude Code trừ dần theo token sau khi bạn cấu hình key như trên.

VNDまたはUSDで支払う

Kunavo niêm yết giá bằng USD. Vì Việt Nam nằm trong các thị trường của Stripe Adaptive Pricing (đọc ngày 2026年10月3日), trang thanh toán có thể hiện số tiền đã quy đổi sang VND, và con số chính xác luôn hiện ra trước khi bạn bấm xác nhận. Tỷ giá Stripe đưa ra đã cộng phí chuyển đổi 2–4%, người mua chịu. Chọn trả bằng USD thì không có khoản đó, nhưng ngân hàng phát hành thẻ có thể áp tỷ giá và phí của họ.

Trả bằng VND cũng chưa chắc rẻ hơn: một số ngân hàng thu phí khi thẻ thanh toán bằng VND cho đơn vị bán hàng đăng ký ở nước ngoài. Chẳng hạn Techcombank thu “phí giao dịch nội tệ ở nước ngoài” 1,1% số tiền giao dịch (đã gồm VAT) với thẻ ghi nợ Visa, áp dụng từ 13/08/2023 (TechcombankのFAQ, đọc ngày 2026年10月3日). Đây chỉ là ví dụ của một ngân hàng, và Kunavo chưa xác minh được ngân hàng có xếp giao dịch của mình vào loại này hay không; xem biểu phí thẻ của bạn rồi hãy chọn VND hay USD.

カードが拒否される原因は、銀行アプリでオンライン決済または国際決済が有効になっていないことが一般的です。有効にして再試行するか、Link、またはそのウォレットが対応するカードでApple Pay/Google Payに切り替えてください。

登録からkey取得まで

1. Kunavoに登録します。メールアドレスまたはGoogleアカウントを使用でき、この段階ではカード情報を求められません。
2. Billingを開き、入金額を選択します（最低額は10 USD）。高額の入金額には追加分があります：nạp 100 USD được 110 USD vào số dư; nạp 1.000 USD được 1.200 USD vào số dư; nạp 5.000 USD được 6.250 USD vào số dư。
3. Stripeページでカード、Link、またはデバイスで利用可能なウォレットを選択し、金額を確認して確定します。
4. API Keysを開き、key sk-kn-…を作成します。keyは一度しか表示されないため、すぐにANTHROPIC_AUTH_TOKENへコピーしてください。

残高が少なくなったときに自動入金するには、保存済みカードまたはLinkを使用する必要があります。残高に有効期限はなく、失敗したrequestは課金されません。KunavoはVAT請求書を発行しません。ベトナムの規定に基づく電子請求書も含まれます。入金履歴はBillingで確認できます。この残高はKunavo API専用で、Claude Pro、Claude Max、ChatGPT Plusの支払いには使用できません。

1回のコーディングセッションには、どのくらいの費用がかかりますか？

Claude Codeは各回のrequestで会話コンテキスト全体を再送するため、費用はcacheに大きく左右されます。繰り返し使用されるコンテキスト部分は、かなり安いcache読み取り料金で計算されます。次の表は、明示した仮定に基づく机上計算であり、実測値でも上限値でもありません。

• 各requestで40.000入力token：36.000token（90%）をcacheから読み取り、4.000tokenをcacheに書き込み。
• 各requestで1.000出力token。
• 1セッションあたり50リクエスト。Claude Haiku 4.5のバックグラウンド実行分は含みません。
• KunavoのClaude Sonnet 5では、cache読み取りは入力料金の10%、cache書き込みは入力料金の1,25倍です。表内の各モデルにはそれぞれの料率が適用されます。

最後の列はcacheがどれほど重要かを示しています。長いコンテキスト、長い回答、異なる作業の間に/clearを忘れることは、いずれも金額を押し上げます。サブスクリプションとAPIの比較、月額見積もりについてはClaude Codeの料金の記事をご覧ください。モデルごとの料金はClaude APIの料金表または料金ページで確認できます。自分の数値を入力する場合はClaude tokenコスト計算ツール（英語）を使用してください。

メッセージ別のトラブルシューティング

入金前に

• Visa/Mastercard、Link、カード上で動作するウォレットのみ利用できます。MoMo、ZaloPay、VNPay、銀行振込には対応していません。
• 自動入金は保存済みカードまたはLinkでのみ動作します。KunavoはVAT請求書を発行しません。
• これはClaude Pro/Maxプランではなく、token単位で支払うAPIです。Remote Controlと音声入力は利用できず、/fastは無効と表示され、MCP tool searchもデフォルトで無効です。
• 2026年10月3日時点でKunavoにはSonnet 5.5がないため、固定されていないalias sonnetは404を返します。
• Claude CodeのドキュメントとKunavoの統合ドキュメントは現在英語のみです。

よくある質問