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ục | Yê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ành | macOS 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) |
| Shell | Bash, Zsh, PowerShell hoặc CMD |
| Mạng và khu vực | Kế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.js | Chỉ 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:
# 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.
# 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.cmdLỗ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ọn | Bạn cần gì | Sandbox | Khi nào nên chọn |
|---|---|---|---|
| Windows native | Không cần gì; Git for Windows là tùy chọn | Khô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 1 | Khô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 vanzelfGó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.
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@latestKiể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 sessieclaude 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:
# 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 claudeNế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:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserBắ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 Console | Khóa Kunavo bắt đầu bằng sk-kn- |
| Cách thanh toán | Pro và Max: mức phí cố định mỗi tháng; Console: tính theo token tại Anthropic | Tính theo token, từ số dư trả trước; không có phí hàng tháng |
| Phương thức thanh toán | Trê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ói | Có sẵn: cả hai chỉ hoạt động với thông tin đăng nhập claude.ai | Không có sẵn |
| Thiết lập | Đăng nhập trong trình duyệt | Sá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:
- Tạo tài khoản Kunavo.
- Nạp thêm số dư qua Billing, từ $10 (iDEAL và Bancontact được đề cập ở phần sau).
- 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. - Thiết lập các biến. Trên macOS và Linux, trong
~/.zshrchoặc~/.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-5Trên Windows, để kiểm tra trước trong một cửa sổ 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:
{
"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_URLchỉ 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/messagesvà bạn sẽ nhận lỗi 404.- Sử dụng
ANTHROPIC_AUTH_TOKEN, không phảiANTHROPIC_API_KEY. Theo tài liệu,ANTHROPIC_AUTH_TOKENđược gửi dưới dạng tiêu đềAuthorizationvớiBearerđứng trước và có hiệu lực ngay.ANTHROPIC_API_KEYnằm trong tiêu đềx-api-keyvà 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_MODELvà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í danhopusdành cho người dùng API trỏ đến Opus 5.5, còn bí danhsonnettrỏ đế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ủaopusplanvà các tác tử con dùngmodel: sonnetsẽ thất bại. Hãy cố định bí danhopusvà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ằngclaude update. - Cũng cố định
ANTHROPIC_DEFAULT_HAIKU_MODEL. Bí danhhaikuyê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 haikuvà các tác tử con cómodel: haikusẽ trả về 404. ANTHROPIC_DEFAULT_HAIKU_MODELcũ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í danhhaikuvà 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 đó.
{
"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ình | Kunavo (đầu vào / đầu ra) | Giá niêm yết của Anthropic (input / output) | Khác biệt | Mục đích |
|---|---|---|---|---|
claude-haiku-4-5 | $0,70 / $3,50 | $1,00 / $5,00 | thấ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,00 | thấ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,00 | thấ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 URLphả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_URLchưa được áp dụng cho phiên.Auth tokenphải đề cập đếnANTHROPIC_AUTH_TOKEN. Nếu thay vào đó bạn thấyLogin methodcù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.
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": "."}]}'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 khiANTHROPIC_BASE_URLtrỏ đến địa chỉ bên ngoài Anthropic. /fastthô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_URLtrỏ đến địa chỉ bên ngoài Anthropic. - Các con số trong
/contextchỉ 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/contexthiể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.
- Tạo tài khoản Kunavo.
- 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.
- 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.
- 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 403 | Tệ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 Windows | Bạn đã mở Windows PowerShell (x86). Hãy mở Windows PowerShell thông thường. |
npm.ps1 cannot be loaded | Chí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ện | Thư 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óa | Claude 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 expected | Khó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. |
401 | Khó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. |
404 | ANTHROPIC_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ợ.