Quay lại hướng dẫn
Cài đặt·3 tháng 10, 2026·Cập nhật 10 tháng 10, 2026·Đọc 12 phút

Cài đặt Claude Code: lệnh cho Windows, macOS và Linux, khóa API không cần gói đăng ký và thanh toán bằng iDEAL

Bạn cài đặt Claude Code bằng một lệnh. Thông thường, bạn chỉ gặp khó khăn sau đó: ở sai cửa sổ Windows, với PATH hoặc phiên bản Node.js khi dùng npm. Sau đó vẫn cần thiết lập khóa API không cần gói đăng ký và biết cách thanh toán bằng euro.

Bạn cài đặt Claude Code bằng một lệnh chính thức: trên macOS, Linux và WSL bằng curl -fsSL https://claude.ai/install.sh | bash, trên Windows trong PowerShell bằng irm https://claude.ai/install.ps1 | iex (trong Command Prompt, CMD, bằng dòng install.cmd bên dưới). Sau đó, chọn cách thanh toán. Bạn đăng nhập bằng tài khoản Pro, Max, Team, Enterprise hoặc Console (gói Claude.ai miễn phí không bao gồm Claude Code), hoặc sử dụng khóa API mà không cần gói đăng ký: đặt ANTHROPIC_BASE_URL (chỉ tên miền, không có /v1), ANTHROPIC_AUTH_TOKEN và bốn biến mô hình, rồi kiểm tra bằng /status xem khóa có hoạt động không. Bạn nạp số dư Kunavo bằng iDEAL (Hà Lan) hoặc Bancontact (Bỉ), từ $10, không có phí hàng tháng.

Các lệnh và biến đã được đối chiếu vào 3 tháng 10, 2026 với tài liệu cài đặt chính thức của Claude Code và tài liệu về biến môi trường; giá và phương thức thanh toán đã được kiểm tra vào 10 tháng 10, 2026. Cả Hà Lan và Bỉ đều có trong danh sách quốc gia được Anthropic hỗ trợ (được kiểm tra vào 3 tháng 10, 2026), áp dụng cho cả Claude.ai lẫn API. Hướng dẫn này cũng có bản tiếng Anh: Cài đặt Claude Code.

Trước khi cài đặt

Hạng mụcYêu cầu (tài liệu cài đặt chính thức, được kiểm tra vào 3 tháng 10, 2026)
Hệ điều hànhmacOS 13.0 trở lên; Windows 10 1809 trở lên hoặc Windows Server 2019 trở lên; Ubuntu 20.04+; Debian 10+; Alpine Linux 3.19+
Phần cứngÍt nhất 4 GB RAM, bộ xử lý x64 hoặc ARM64 (không hỗ trợ Windows 32 bit)
ShellBash, Zsh, PowerShell hoặc CMD
Mạng và khu vựcKết nối Internet, tại quốc gia được Anthropic hỗ trợ (Hà Lan và Bỉ nằm trong danh sách)
Tài khoảnĐể đăng nhập, bạn cần Pro, Max, Team, Enterprise hoặc Console; gói Claude.ai miễn phí không bao gồm Claude Code. Với khóa API, bạn không cần gói đăng ký và không cần đăng nhập.
Node.jsChỉ cần Node.js khi cài đặt qua npm, và khi đó cần phiên bản 22 trở lên; trình cài đặt native không cần Node.js

Cài đặt Claude Code trên macOS và Linux

Mở Terminal và dán dòng này:

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

Đây là phương thức cài đặt native được khuyến nghị: một chương trình độc lập tự cập nhật trong nền. Lệnh claude được đặt trong ~/.local/bin. Terminal đã mở từ trước chưa biết PATH mới, vì vậy hãy mở cửa sổ mới trước khi kiểm tra. Trong WSL, bạn sử dụng chính xác dòng này trong terminal WSL.

Cài đặt Claude Code trên Windows

Trên Windows có hai dòng lệnh, và dòng bạn cần chỉ phụ thuộc vào cửa sổ đang mở. Nếu lời nhắc bắt đầu bằng PS C:\Users\Naam>, bạn đang ở PowerShell; nếu chỉ hiển thị C:\Users\Naam> mà không có PS, đó là Command Prompt (CMD). Bạn không cần mở cửa sổ với quyền quản trị viên: theo tài liệu chính thức, việc đó không cần thiết.

PowerShell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
cmd.exe
:: Windows Opdrachtprompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Lỗi thường gặp nhất là dán dòng lệnh vào sai cửa sổ. Dòng CMD trong PowerShell trả về The token '&&' is not a valid statement separator; dòng PowerShell trong CMD trả về 'irm' is not recognized as an internal or external command. Trên Windows tiếng Hà Lan, thông báo thứ hai có thể xuất hiện bằng tiếng Hà Lan nhưng nguyên nhân vẫn giống nhau. Ngoài ra, dòng macOS có | bash trong PowerShell sẽ báo lỗi rằng bash không được nhận dạng. Trong cả ba trường hợp, hãy sử dụng dòng phù hợp với cửa sổ của bạn.

Git for Windows là tùy chọn. Nếu đã cài đặt, Claude Code chạy lệnh qua Git Bash đi kèm; nếu không có Git, công cụ dùng PowerShell. Nếu đã cài Git nhưng không tìm thấy Git Bash, hãy đặt CLAUDE_CODE_GIT_BASH_PATH trong khối env của ~/.claude/settings.json thành đường dẫn đến bash.exe; đường dẫn ví dụ trong tài liệu là C:\Program Files\Git\bin\bash.exe.

Tùy chọnBạn cần gìSandboxKhi nào nên chọn
Windows nativeKhông cần gì; Git for Windows là tùy chọnKhông được hỗ trợCác dự án và công cụ chạy trực tiếp trên Windows
WSL 2Đã bật WSL 2Được hỗ trợCần công cụ Linux hoặc chạy lệnh trong sandbox
WSL 1Đã bật WSL 1Không được hỗ trợKhi WSL 2 không khả dụng

Vì vậy, WSL không phải là yêu cầu bắt buộc như một số hướng dẫn cũ tuyên bố, mà là một lựa chọn. Nếu chọn WSL, hãy chạy dòng dành cho macOS/Linux trong terminal WSL và cũng khởi chạy claude ở đó, không phải từ PowerShell hay CMD.

Qua Homebrew, WinGet hoặc npm

Bạn cũng có thể làm vậy, với một điểm khác biệt quan trọng: theo tài liệu chính thức, các bản cài đặt bằng Homebrew và WinGet không tự động cập nhật. Khi đó, bạn phải tự cập nhật:

# 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

Gói npm yêu cầu Node.js 22 trở lên, không phải Node.js 18 như các hướng dẫn cũ vẫn ghi. Với Node.js cũ hơn, npm chỉ hiển thị cảnh báo EBADENGINE rồi vẫn tiếp tục cài đặt: gói này cài cùng một chương trình native, vốn không cần Node.js để chạy. Không bao giờ sử dụng sudo npm install -g: lệnh này gây ra vấn đề về quyền và là rủi ro bảo mật. Hãy cập nhật bằng @latest, không phải npm update -g.

Terminal
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

Kiểm tra cài đặt

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

claude doctor không khởi chạy phiên mà hiển thị trạng thái cài đặt và các tệp cài đặt của bạn. Nhờ đó, bạn có thể nhanh chóng xác định vấn đề nằm ở quá trình cài đặt hay cấu hình.

Nếu gặp command not found: claude hoặc Windows báo không nhận ra claude, thư mục cài đặt chưa có trong PATH. Trước tiên, hãy mở một cửa sổ terminal mới. Nếu vẫn không được, trên macOS và Linux, hãy thêm ~/.local/bin vào PATH thông qua ~/.zshrc hoặc ~/.bashrc. Trên Windows, thư mục đó là %USERPROFILE%\.local\bin; theo hướng dẫn khắc phục sự cố chính thức, hãy kiểm tra và thêm thư mục này bằng PowerShell như sau:

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

Nếu bạn cài đặt qua npm và PowerShell hiển thị npm.ps1 cannot be loaded because running scripts is disabled on this system, chính sách thực thi của PowerShell đang chặn các tập lệnh khởi động của npm. Hãy sử dụng trình cài đặt native, khởi chạy npm.cmd và claude.cmd, hoặc cho phép các tập lệnh cục bộ dành cho người dùng của bạn:

PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Bắt đầu lần đầu: gói đăng ký hoặc khóa API

Khi bắt đầu lần đầu, bạn chọn cách thanh toán cho Claude Code. Hai tùy chọn loại trừ lẫn nhau: nếu đã thiết lập khóa API thì thông tin đăng nhập đã lưu sẽ không được dùng; nếu xóa biến này, Claude Code sẽ quay lại dùng thông tin đăng nhập mà không cần cài đặt lại.

Tùy chọn A: đăng nhập bằng gói đăng kýTùy chọn B: khóa API, không cần gói đăng ký
Bạn cần gìTài khoản Pro, Max, Team, Enterprise hoặc ConsoleKhóa Kunavo bắt đầu bằng sk-kn-
Cách thanh toánPro và Max: mức phí cố định mỗi tháng; Console: tính theo token tại AnthropicTính theo token, từ số dư trả trước; không có phí hàng tháng
Phương thức thanh toánTrên website chỉ có thẻ tín dụng hoặc thẻ ghi nợiDEAL, Bancontact, thẻ, Apple Pay, Google Pay hoặc Link
Remote Control và đọc chính tả bằng giọng nóiCó sẵn: cả hai chỉ hoạt động với thông tin đăng nhập claude.aiKhông có sẵn
Thiết lậpĐăng nhập trong trình duyệtSáu biến môi trường

Tùy chọn A: đăng nhập bằng gói đăng ký của bạn

Khởi chạy claude trong thư mục dự án và đăng nhập qua trình duyệt. Có một điểm dễ mắc lỗi: nếu ANTHROPIC_API_KEY đã được thiết lập, Claude Code sẽ hỏi một lần xem có sử dụng khóa đó hay không. Nếu bạn từ chối, sau đó nó sẽ bỏ qua khóa mà không hỏi lại, khiến bạn có cảm giác biến này không được đọc. Bật lại qua /config → Use custom API key.

Tùy chọn B: không cần gói đăng ký, sử dụng khóa API

ANTHROPIC_BASE_URL là một biến tích hợp của Claude Code. Theo tài liệu chính thức, biến này ghi đè endpoint API để gửi yêu cầu qua proxy hoặc gateway. Vì vậy, trỏ Claude Code đến một endpoint sử dụng Anthropic Messages API là cấu hình được hỗ trợ, không cần plugin hay phiên bản tùy chỉnh. Các bước:

  1. Tạo tài khoản Kunavo.
  2. Nạp thêm số dư qua Billing, từ $10 (iDEAL và Bancontact được đề cập ở phần sau).
  3. Tạo khóa tại /app/keys bắt đầu bằng sk-kn-. Khóa chỉ được hiển thị một lần, vì vậy hãy lưu ngay.
  4. Thiết lập các biến. Trên macOS và Linux, trong ~/.zshrc hoặc ~/.bashrc:
~/.zshrc
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

Trên Windows, để kiểm tra trước trong một cửa sổ PowerShell:

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

Để sử dụng cố định, khối env trong tệp cài đặt người dùng là vị trí tốt nhất: ~/.claude/settings.json (trên Windows là %USERPROFILE%\.claude\settings.json). Các giá trị này áp dụng ở mọi nơi Claude Code chạy, kể cả các tác nhân chạy nền. Các biến từ shell chỉ áp dụng cho cửa sổ terminal đó: trình chỉnh sửa được mở từ Dock hoặc menu Start sẽ không nhìn thấy chúng. Nếu tệp đã có các cài đặt khác, chỉ thêm khối env:

~/.claude/settings.json
{
  "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"
  }
}

Tuyệt đối không đặt khóa trong .claude/settings.json của dự án: theo tài liệu cổng kết nối chính thức (được kiểm tra vào 3 tháng 10, 2026), tệp này sẽ được commit và chia sẻ với tất cả những ai sao chép kho lưu trữ. Cũng cần lưu ý thứ tự ưu tiên: nếu cùng một biến được đặt trong shell và trong tệp cài đặt, giá trị trong tệp cài đặt sẽ được ưu tiên. Nếu biến shell đã thay đổi nhưng không có tác dụng, trước tiên hãy kiểm tra settings.json.

Mỗi dòng đều có một điểm dễ mắc lỗi riêng:

  • ANTHROPIC_BASE_URL chỉ là miền. Claude Code tự thêm /v1/messages; nếu kết thúc bằng /v1, yêu cầu sẽ được gửi đến /v1/v1/messages và bạn sẽ nhận lỗi 404.
  • Sử dụng ANTHROPIC_AUTH_TOKEN, không phải ANTHROPIC_API_KEY. Theo tài liệu, ANTHROPIC_AUTH_TOKEN được gửi dưới dạng tiêu đề Authorization với Bearer đứng trước và có hiệu lực ngay. ANTHROPIC_API_KEY nằm trong tiêu đề x-api-key và trong chế độ tương tác, trước tiên phải được phê duyệt một lần (xem tùy chọn A).
  • Ghi chính xác tên mô hình trong ANTHROPIC_MODEL. Kunavo chỉ nhận diện tên chính xác và không chuyển đổi các tên cũ có ngày tháng ở phía sau.
  • Đồng thời cố định cả ANTHROPIC_DEFAULT_OPUS_MODEL và ANTHROPIC_DEFAULT_SONNET_MODEL. Theo tài liệu cấu hình mô hình (được kiểm tra vào 3 tháng 10, 2026), cài đặt mặc định và bí danh opus dành cho người dùng API trỏ đến Opus 5.5, còn bí danh sonnet trỏ đến Sonnet 5.5; các bí danh này thay đổi theo phiên bản mới. Có thể cố định bằng tên mô hình đầy đủ hoặc các biến như ANTHROPIC_DEFAULT_OPUS_MODEL. Hiện Kunavo không cung cấp Sonnet 5.5 và mô hình Opus mới có thể chưa xuất hiện ngay; mô hình không có sẵn sẽ trả về lỗi 404. Vì vậy, nếu không có ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5, /model sonnet, giai đoạn thực thi của opusplan và các tác tử con dùng model: sonnet sẽ thất bại. Hãy cố định bí danh opus vào Opus 5.5 (claude-opus-5-5); yêu cầu Claude Code v2.1.280 trở lên. Cập nhật phiên bản cũ hơn bằng claude update.
  • Cũng cố định ANTHROPIC_DEFAULT_HAIKU_MODEL. Bí danh haiku yêu cầu một ID mà Kunavo không cung cấp: từ v2.1.293 là Haiku 5.5, trước đó là một ID Haiku 4.5 có hậu tố ngày tháng. Nếu thiếu dòng này, /model haiku và các tác tử con có model: haiku sẽ trả về 404.
  • ANTHROPIC_DEFAULT_HAIKU_MODEL cũng áp dụng cho các tác vụ chạy nền. Theo tài liệu, biến này xác định bí danh haiku và mô hình cho các chức năng chạy nền, chẳng hạn như tiêu đề phiên. Dùng Claude Haiku 4.5 để giữ chi phí ở mức thấp.

Nếu sử dụng tiện ích mở rộng VS Code, hãy đặt các biến trong claudeCode.environmentVariables, trong phần cài đặt người dùng của chính VS Code (lệnh Preferences: Open User Settings (JSON)). Tiện ích mở rộng đã kiểm tra thông tin đăng nhập ở đó trước khi khởi động; các giá trị từ ~/.claude/settings.json vẫn đến được tiến trình đã khởi động, nhưng không được dùng cho lần kiểm tra đó.

VS Code 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" }
  ]
}

Giá mỗi triệu token lấy từ danh mục Kunavo; giá niêm yết của Anthropic lấy từ claude.com/pricing (được kiểm tra vào 3 tháng 10, 2026):

Mô hìnhKunavo (đầu vào / đầu ra)Giá niêm yết của Anthropic (input / output)Khác biệtMục đích
claude-haiku-4-5$0,70 / $3,50$1,00 / $5,00thấp hơn khoảng ~30%Các tác vụ nền của chính Claude Code và công việc đơn giản
claude-sonnet-5$1,40 / $7,00$2,00 / $10,00thấp hơn khoảng ~30%Mô hình mặc định cho công việc hằng ngày
claude-opus-5-5$2,80 / $14,00$4,00 / $20,00thấp hơn khoảng ~30%Các lần tái cấu trúc lớn và lập kế hoạch

Trong một phiên, bạn chuyển đổi bằng /model claude-opus-5-5, hoặc khởi chạy ngay với claude --model claude-opus-5-5. Chi phí ước tính mỗi tháng của Claude Code và thời điểm gói đăng ký có lợi hơn được nêu trong Claude Code pricing (tiếng Anh); bạn có thể tính mức sử dụng của mình bằng Claude-tokencalculator. Tất cả mô hình và giá được liệt kê trên trang giá.

Kiểm tra bằng /status

Khởi chạy claude. Khi đã thiết lập ANTHROPIC_AUTH_TOKEN, bạn sẽ không thấy màn hình đăng nhập: biến này có hiệu lực ngay. Nếu vẫn thấy màn hình đăng nhập, Claude Code chưa đọc được khóa. Khi đó, hãy đặt khóa ở vị trí Claude Code đọc trước trình hướng dẫn bắt đầu lần đầu: một export trong shell hoặc khối env của ~/.claude/settings.json. Khối env trong .claude/settings.json hoặc .claude/settings.local.json của dự án chỉ có hiệu lực trong phiên tương tác sau trình hướng dẫn bắt đầu lần đầu và câu hỏi xác nhận bạn có tin cậy thư mục hay không.

Trong phiên làm việc, nhập /status và tìm hai dòng trong thẻ Status (nguồn: tài liệu gateway chính thức, được kiểm tra vào 3 tháng 10, 2026):

  • Anthropic base URL phải hiển thị https://api.kunavo.com. Dòng này chỉ xuất hiện khi đã thiết lập địa chỉ gateway; nếu không có, ANTHROPIC_BASE_URL chưa được áp dụng cho phiên.
  • Auth token phải đề cập đến ANTHROPIC_AUTH_TOKEN. Nếu thay vào đó bạn thấy Login method cùng tài khoản claude.ai, biến chưa được đọc và phiên đang chạy bằng gói đăng ký của bạn.

Nếu trước đó bạn đã đăng nhập bằng gói đăng ký, Claude Code có thể cảnh báo khi khởi động rằng có hai nguồn đăng nhập đang hoạt động (thông báo kết thúc bằng auth may not work as expected). Khi đó, các yêu cầu sẽ đi qua khóa; dùng /logout để xóa thông tin đăng nhập cũ.

Bạn muốn kiểm tra địa chỉ và khóa trước khi mở Claude Code? Hãy gửi một yêu cầu với một output token, như tài liệu đề xuất; thao tác này chỉ tốn một lượng số dư rất nhỏ. Các lệnh đọc biến từ shell, vì vậy hãy đặt chúng ở đó ngay cả khi chúng đã nằm trong settings.json.

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

Một phản hồi JSON bắt đầu bằng {"id":"msg_ có nghĩa là địa chỉ và khóa hoạt động; trong PowerShell, bạn sẽ thấy id bắt đầu bằng msg_. 401 có nghĩa là khóa đã bị từ chối.

Những gì khác hoạt động với khóa API

  • Không có Remote Control và không có đọc chính tả bằng giọng nói. Cả hai đều cần tài khoản claude.ai và không khả dụng khi ANTHROPIC_AUTH_TOKEN đang hoạt động; ngoài ra, Remote Control bị tắt khi ANTHROPIC_BASE_URL trỏ đến địa chỉ bên ngoài Anthropic.
  • /fast thông báo rằng fast mode đã tắt. Chỉ với bearer token, Claude Code xem fast mode là đã tắt mà không gửi yêu cầu kiểm tra.
  • Tìm kiếm công cụ MCP mặc định bị tắt ngay khi ANTHROPIC_BASE_URL trỏ đến địa chỉ bên ngoài Anthropic.
  • Các con số trong /context chỉ là ước tính: Kunavo hiện không cung cấp /v1/messages/count_tokens. Theo tài liệu tương thích gateway chính thức (được kiểm tra vào 3 tháng 10, 2026), Claude Code sẽ chuyển sang ước tính dựa trên số ký tự nếu không có endpoint đó, vì vậy /context hiển thị số lượng gần đúng.

Code, công cụ, subagent, máy chủ MCP, hook và bộ nhớ đệm prompt hoạt động như bình thường. Xem thêm chi tiết trong tài liệu tích hợp Claude Code (tiếng Anh) và Claude Code without a subscription (tiếng Anh).

Thanh toán bằng iDEAL hoặc Bancontact

Bạn chỉ có thể thanh toán gói thuê bao Claude qua trang web bằng thẻ tín dụng hoặc thẻ ghi nợ (bài viết trợ giúp của Claude về các gói trả phí, được kiểm tra vào 3 tháng 10, 2026); giá trên claude.com/pricing chưa bao gồm thuế.

Bạn nạp tiền vào số dư Kunavo qua Stripe Checkout. Giá được niêm yết bằng đô la Mỹ; Stripe hiển thị số tiền bằng euro cho người mua ở Hà Lan và Bỉ. Theo tài liệu Stripe về Adaptive Pricing (được kiểm tra vào 3 tháng 10, 2026), tỷ giá này bao gồm khoản phụ phí chuyển đổi 2–4% do người mua trả; người thanh toán bằng đô la (qua thẻ, Apple Pay, Google Pay hoặc Link) không phải trả khoản phụ phí đó. iDEAL và Bancontact chỉ hoạt động bằng euro. Các phương thức được cung cấp trên trang thanh toán gồm:

  • iDEAL, dành cho Hà Lan. Phương thức này hiện có tên là iDEAL | Wero (Stripe yêu cầu áp dụng tên này trong quý đầu tiên của năm 2026), vì vậy bạn cũng có thể thấy tên đó trên trang thanh toán. Bạn sẽ được chuyển đến môi trường của ngân hàng mình và xác nhận tại đó (Stripe về iDEAL, được kiểm tra vào 3 tháng 10, 2026).
  • Bancontact, dành cho Bỉ, bằng thẻ Bancontact hoặc ứng dụng (Stripe về Bancontact, được kiểm tra vào 3 tháng 10, 2026).
  • Thẻ (Visa, Mastercard), Apple Pay, Google Pay và Link.

Không được cung cấp: PayPal, ghi nợ SEPA, Klarna (chỉ dành cho người mua ở Hoa Kỳ), Tikkie, Riverty (trước đây là AfterPay) và chuyển khoản ngân hàng thông thường.

  1. Tạo tài khoản Kunavo.
  2. Chọn một số tiền tại Billing, tối thiểu $10. Nếu nạp nhiều hơn trong một lần, bạn sẽ nhận thêm số dư: với $100, bạn nhận được $110, với $1.000, bạn nhận được $1.200 và với $5.000, bạn nhận được $6.250.
  3. Trên trang thanh toán Stripe, chọn iDEAL hoặc Bancontact và hoàn tất thanh toán trong môi trường ngân hàng của bạn (iDEAL) hoặc bằng ứng dụng hay thẻ Bancontact. Số tiền bằng euro được hiển thị trên trang thanh toán trước khi bạn xác nhận.
  4. Tạo khóa tại /app/keys và nhập khóa đó vào ANTHROPIC_AUTH_TOKEN.

Số dư được trả trước: không có phí hàng tháng, số dư không hết hạn và các yêu cầu thất bại không bị tính phí. Chỉ có thể tự động nạp thêm bằng thẻ hoặc Link đã lưu; với iDEAL và Bancontact, bạn luôn phải nạp thủ công. Kunavo không phát hành hóa đơn VAT; lịch sử nạp tiền nằm trong Billing. Các phương thức thanh toán này chỉ nạp số dư API Kunavo: bạn không thể dùng chúng để thanh toán gói đăng ký Claude Pro hoặc Max. Tìm hiểu thêm về thanh toán bằng euro: Claude betalen met iDEAL.

Các lỗi thường gặp

Bạn nhìn thấy gìNguyên nhân và cách khắc phục
The token '&&' is not a valid statement separatorĐã dán dòng lệnh CMD vào PowerShell. Hãy dùng irm … | iex.
'irm' is not recognized as an internal or external command (hoặc phiên bản tiếng Hà Lan của thông báo đó)Đã dán dòng PowerShell vào CMD. Hãy dùng dòng install.cmd.
'bash' is not recognized as the name of a cmdletĐã dán dòng macOS/Linux vào Windows. Hãy dùng dòng PowerShell.
Lệnh hiển thị nội dung tập lệnh nhưng không cài đặt gìThiếu nửa sau. Trong PowerShell, đó là toàn bộ dòng irm … | iex; trong CMD, là lệnh đầy đủ với -o install.cmd.
syntax error near unexpected token '<' hoặc 403Tệp tải xuống trả về một trang web hoặc mã lỗi thay vì tập lệnh. Theo hướng dẫn khắc phục sự cố chính thức, nguyên nhân có thể là vấn đề mạng, định tuyến khu vực, sự cố tạm thời hoặc (với lỗi 403 trống) proxy doanh nghiệp hay tường lửa. Hãy thử lại sau vài phút, hoặc cài đặt trên macOS bằng Homebrew và trên Windows bằng WinGet.
Claude Code does not support 32-bit WindowsBạn đã mở Windows PowerShell (x86). Hãy mở Windows PowerShell thông thường.
npm.ps1 cannot be loadedChính sách thực thi của PowerShell đang chặn npm. Chạy dòng Set-ExecutionPolicy hoặc sử dụng trình cài đặt native.
command not found: claude hoặc claude không được nhận diệnThư mục cài đặt chưa có trong PATH. Hãy mở một cửa sổ mới; trên Windows, dùng phần PATH ở trên.
Hiển thị màn hình đăng nhập dù đã thiết lập khóaClaude Code chưa đọc được khóa. Đặt các biến trong shell hoặc trong ~/.claude/settings.json, không chỉ trong cài đặt dự án, rồi mở một cửa sổ mới.
Cảnh báo kết thúc bằng auth may not work as expectedKhóa và thông tin đăng nhập cũ đều đang hoạt động. Dùng /logout để chỉ giữ lại khóa, hoặc xóa biến để sử dụng thông tin đăng nhập.
401Khóa không được nhận diện: hãy kiểm tra rằng bạn đã sao chép toàn bộ khóa sk-kn-, không có khoảng trắng, khóa chưa bị xóa tại /app/keys và khóa nằm trong ANTHROPIC_AUTH_TOKEN.
404ANTHROPIC_BASE_URL kết thúc bằng /v1, hoặc mô hình được yêu cầu không có tại Kunavo (ví dụ vì thiếu bốn biến mô hình).

Sau khi cài đặt

Khi bắt đầu lần đầu trong một dự án, hãy nhập /init: Claude Code sẽ đọc repository và tạo một CLAUDE.md với các lệnh kiểm thử và quy ước mà nó tìm thấy. Kiểm tra tệp đó và giữ cho ngắn gọn, vì tệp được tải trong mọi phiên. Giữa các tác vụ riêng lẻ, /clear bắt đầu một cuộc trò chuyện mới; nếu một tác vụ kéo dài, /compact tóm tắt lịch sử để bạn tiếp tục làm việc.

Những điều bạn cần biết

  • Đây là API tính phí theo token, không phải gói đăng ký Claude Pro hoặc Max. Nếu sử dụng Claude Code nhiều giờ mỗi ngày, gói đăng ký thường có giá rẻ hơn; trả theo token phù hợp với việc sử dụng không cố định, và một tháng không sử dụng thì không mất phí. So sánh được nêu trong Claude Code pricing (tiếng Anh).
  • Remote Control và đọc chính tả bằng giọng nói không khả dụng khi dùng khóa API.
  • Qua Kunavo, bạn sử dụng năng lực dùng chung, không có hạn ngạch được dành riêng và không có bảo đảm theo hợp đồng; nếu cần những điều đó, hãy ký hợp đồng trực tiếp với Anthropic.
  • iDEAL và Bancontact chỉ dùng để nạp thủ công; tự động nạp thêm chỉ có thể thực hiện bằng thẻ hoặc Link.
  • Các khoản tiền bằng euro bao gồm phụ phí quy đổi của Stripe. Kunavo không phát hành hóa đơn VAT.

Câu hỏi thường gặp

Làm cách nào để cài đặt Claude Code?

Bằng một lệnh chính thức. Trên macOS, Linux và WSL: curl -fsSL https://claude.ai/install.sh | bash. Trên Windows trong PowerShell: irm https://claude.ai/install.ps1 | iex. Trong Windows Command Prompt (CMD): curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Đây là phương thức cài đặt native được Anthropic khuyến nghị; chương trình tự cập nhật trong nền. Sau đó, mở cửa sổ terminal mới, kiểm tra bằng claude --version và khởi chạy bằng claude.

Tôi có cần WSL hoặc quyền quản trị viên để cài đặt Claude Code trên Windows không?

Không. Theo tài liệu cài đặt chính thức, bạn chạy lệnh cài đặt trong PowerShell hoặc CMD mà không cần mở cửa sổ với quyền quản trị viên. Git for Windows là tùy chọn: nếu đã cài đặt, Claude Code thực thi lệnh qua Git Bash; nếu không, chương trình sử dụng PowerShell. WSL 2 chỉ là một lựa chọn khi bạn cần công cụ Linux hoặc sandbox; khi đó hãy cài đặt và khởi chạy Claude Code bên trong terminal WSL. Không mở Windows PowerShell (x86): Claude Code không hỗ trợ Windows 32 bit.

Tôi có cần Node.js cho Claude Code không?

Chỉ khi bạn cài đặt qua npm, và khi đó cần Node.js 22 trở lên. Trình cài đặt native, Homebrew và WinGet không cần Node.js. Với Node.js cũ hơn, npm chỉ hiển thị cảnh báo EBADENGINE rồi vẫn tiếp tục cài đặt. Không bao giờ sử dụng sudo npm install -g; hãy cập nhật bằng npm install -g @anthropic-ai/claude-code@latest thay vì npm update -g.

Tôi có thể sử dụng Claude Code mà không cần gói đăng ký không?

Có. Để đăng nhập, bạn cần tài khoản Pro, Max, Team, Enterprise hoặc Console; gói Claude.ai miễn phí không bao gồm Claude Code. Không cần gói đăng ký, hãy đặt ANTHROPIC_BASE_URL=https://api.kunavo.com và ANTHROPIC_AUTH_TOKEN bằng khóa Kunavo; Claude Code sẽ bỏ qua màn hình đăng nhập và bạn trả tiền cho số token đã sử dụng từ số dư Kunavo trả trước, từ $10, không có phí hàng tháng. Remote Control và tính năng đọc chính tả bằng giọng nói không khả dụng theo cách này vì chúng yêu cầu tài khoản claude.ai.

Làm cách nào để thiết lập khóa API cho Claude Code?

Đặt các biến trong khối env của ~/.claude/settings.json (trên Windows là %USERPROFILE%\.claude\settings.json) hoặc dưới dạng các dòng export trong ~/.zshrc, ~/.bashrc hay PowerShell-$PROFILE. Sử dụng ANTHROPIC_AUTH_TOKEN, không phải ANTHROPIC_API_KEY: biến đầu tiên được gửi dưới dạng Authorization: Bearer và có hiệu lực ngay, còn biến thứ hai đi vào tiêu đề x-api-key và phải được phê duyệt một lần trước. ANTHROPIC_BASE_URL chỉ là tên miền, https://api.kunavo.com, không có /v1: Claude Code tự thêm /v1/messages, vì vậy nếu có /v1, bạn sẽ nhận /v1/v1/messages và 404. Không bao giờ đặt khóa trong .claude/settings.json của dự án vì tệp đó sẽ được commit. Nếu shell và tệp cài đặt đặt cùng một biến, tệp cài đặt sẽ được ưu tiên.

Tại sao Claude Code qua khóa API cần bốn biến mô hình?

Nếu không ghim mô hình, Claude Code sử dụng các bí danh thay đổi theo các phiên bản Anthropic mới. Theo tài liệu chính thức về cấu hình mô hình (được kiểm tra vào 3 tháng 10, 2026), cài đặt mặc định và bí danh opus dành cho người dùng API trỏ đến Opus 5.5, còn bí danh sonnet trỏ đến Sonnet 5.5. Hiện Kunavo chưa cung cấp Sonnet 5.5, và mô hình không tồn tại sẽ trả về 404: nếu không có biến sonnet cố định, /model sonnet, giai đoạn thực thi của opusplan và các subagent với model: sonnet sẽ thất bại. Với ANTHROPIC_MODEL=claude-sonnet-5, ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5, ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 và ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5, mỗi yêu cầu sẽ dùng một mô hình Kunavo cung cấp và bạn biết mình đang trả bao nhiêu. Opus 5.5 yêu cầu Claude Code v2.1.280 trở lên; hãy cập nhật phiên bản cũ bằng claude update. Biến haiku cũng xác định mô hình cho các tác vụ nền của Claude Code.

Làm cách nào để kiểm tra Claude Code có đang sử dụng khóa API của tôi không?

Nhập /status trong Claude Code. Trên tab Status, dòng Anthropic base URL phải hiển thị https://api.kunavo.com và dòng Auth token phải nêu ANTHROPIC_AUTH_TOKEN. Nếu thay vào đó bạn thấy Login method cùng tài khoản claude.ai, biến này chưa được đọc và phiên đang chạy bằng gói đăng ký của bạn. Nếu màn hình đăng nhập xuất hiện khi khởi động, Claude Code hoàn toàn chưa đọc được khóa.

Tôi có thể thanh toán cho Claude Code bằng iDEAL hoặc Bancontact không?

Có, đối với số dư API Kunavo. Trang thanh toán Stripe cung cấp iDEAL (Hà Lan) và Bancontact (Bỉ), cùng với thẻ, Apple Pay, Google Pay và Link. Giá được niêm yết bằng đô la và Stripe hiển thị số tiền bằng euro; theo Stripe, tỷ giá này bao gồm khoản chênh lệch quy đổi 2–4%. Mức tối thiểu là $10, không có phí hàng tháng và số dư không hết hạn. iDEAL và Bancontact chỉ dùng để nạp tiền thủ công; nạp tiền tự động chỉ có thể thực hiện bằng thẻ hoặc Link đã lưu. PayPal và ghi nợ trực tiếp SEPA không được cung cấp, và Kunavo không phát hành hóa đơn VAT. Bạn không thể dùng khoản này để thanh toán gói Claude Pro hoặc Max; claude.ai chỉ thanh toán gói đó trên trang web bằng thẻ tín dụng hoặc thẻ ghi nợ.