Cách cài đặt Claude Code trên Windows, macOS và Linux — khóa API không cần đăng ký và thanh toán bằng BLIK

Claude Code được cài đặt bằng một lệnh chính thức (bên dưới là các phiên bản dành cho macOS và Linux, PowerShell và CMD). Anthropic khuyến nghị trình cài đặt native, còn npm là lựa chọn thay thế yêu cầu Node.js 22 trở lên. Không cần gói đăng ký Pro/Max hay đăng nhập; chỉ cần đặt ANTHROPIC_BASE_URL=https://api.kunavo.com (không có /v1), ANTHROPIC_AUTH_TOKEN với API key và bốn biến ghim model. Khi đó bạn chỉ trả tiền cho số token đã sử dụng từ số dư được nạp bằng BLIK theo đơn vị złoty, từ 10 USD. Cuối cùng, nhập /status trong Claude Code để kiểm tra key có hoạt động hay không.

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

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

:: Windows – wiersz polecenia (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Các lệnh và biến đã được kiểm tra vào 3 tháng 10, 2026 trong 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. Không có phiên bản tiếng Ba Lan của tài liệu này. Giá và phương thức thanh toán đã được kiểm tra vào 10 tháng 10, 2026. Ba Lan nằm trong danh sách quốc gia được Anthropic hỗ trợ (được kiểm tra vào 3 tháng 10, 2026), cho cả Claude.ai và API.

Đăng nhập hay API key?

Sau khi cài đặt, Claude Code phải xác thực. Có hai cách, và hướng dẫn này mô tả chi tiết cách thứ hai:

Trước khi bắt đầu

Phương pháp 1: trình cài đặt native (được khuyến nghị)

Trong tài liệu chính thức, phương pháp này có tab “Native Install (Recommended)”. Bạn sẽ tìm thấy các lệnh ở đầu trang. Trên macOS, Linux và WSL, dùng dòng có install.sh. Trong Windows PowerShell, dùng irm … | iex, còn trong dấu nhắc lệnh CMD, dùng dòng có install.cmd. Cài đặt native tự động cập nhật trong nền. Claude Code cũng có thể được cài đặt qua Homebrew hoặc WinGet, nhưng theo tài liệu, các cách cài đặt này mặc định không tự cập nhật, vì vậy bạn phải cập nhật thủ công trong trình quản lý gói:

# Homebrew – kanał stable; domyślnie nie aktualizuje się sam
brew install --cask claude-code

# WinGet (Windows) – domyślnie nie aktualizuje się sam
winget install Anthropic.ClaudeCode

Sau khi cài đặt, mở cửa sổ terminal mới vì cửa sổ đã mở trước đó không thấy biến PATH đã được cập nhật. Sau đó kiểm tra:

claude --version   # wypisuje numer wersji, np. 2.1.280 (Claude Code)
claude doctor      # diagnostyka instalacji i ustawień, bez otwierania sesji

claude doctor không mở phiên. Lệnh này chỉ hiển thị trạng thái cài đặt và chẩn đoán các tệp cài đặt. Nhờ đó, bạn có thể nhanh chóng phân biệt vấn đề cài đặt với vấn đề cấu hình.

Khi tải xuống thất bại

Nếu terminal hiển thị syntax error near unexpected token '<' hoặc curl: (22) The requested URL returned error: 403, theo trang chính thức về khắc phục sự cố cài đặt (được kiểm tra vào 3 tháng 10, 2026), địa chỉ trình cài đặt đã trả về trang HTML hoặc mã lỗi thay vì tập lệnh. Theo tài liệu, trang có dòng chữ App unavailable in region nghĩa là Claude Code không khả dụng ở quốc gia của bạn. Tuy nhiên, Ba Lan nằm trong danh sách quốc gia được hỗ trợ, vì vậy nếu bạn thấy dòng chữ này tại Ba Lan, hãy kiểm tra xem kết nối có đi qua VPN hoặc proxy hay không. Lỗi 403 không có nội dung cũng có thể xuất phát từ proxy hoặc tường lửa của công ty chặn tải xuống. Trong trường hợp đó, tài liệu khuyên bạn nên kiểm tra kết nối mạng trước, vì các phương thức cài đặt khác cũng kết nối với cùng các máy chủ. Hãy thử dùng mạng khác hoặc nhờ quản trị viên bỏ chặn các địa chỉ đó.

Phương pháp 2: npm (Node.js 22 trở lên)

npm vẫn là một trong những phương thức được nêu trong tài liệu chính thức. Gói này yêu cầu Node.js 22 trở lên. Một số hướng dẫn bằng tiếng Ba Lan vẫn đề cập đến Node.js 18, nhưng thông tin đó đã lỗi thời. Trên phiên bản Node.js cũ hơn, npm sẽ hiển thị cảnh báo EBADENGINE nhưng không dừng cài đặt; claude vẫn hoạt động vì gói này tải chương trình native, vốn không dùng Node.js khi chạy. Nếu chưa có Node.js, hãy cài phiên bản 22 trở lên từ trang nodejs.org.

node -v                                    # potrzebna wersja v22 lub nowsza
npm install -g @anthropic-ai/claude-code   # bez sudo

# aktualizacja: @latest, a nie npm update -g
npm install -g @anthropic-ai/claude-code@latest

• Không bao giờ sử dụng sudo npm install -g. Tài liệu cảnh báo rằng cách này dẫn đến các vấn đề về quyền và gây rủi ro bảo mật.
• Cập nhật bằng @latest. Để cập nhật, hãy dùng npm install -g @anthropic-ai/claude-code@latest, không dùng npm update -g.
• Không bỏ qua các phần phụ thuộc tùy chọn. Chương trình thực tế được cài đặt dưới dạng phần phụ thuộc tùy chọn, tức là gói @anthropic-ai/claude-code-* dành cho nền tảng của bạn. Với cờ --omit=optional hoặc với optional=false trong .npmrc, quá trình cài đặt trên macOS hoặc Linux sẽ kết thúc bằng thông báo claude native binary not installed.

Claude Code trên Windows: PowerShell, CMD, WSL và PATH

Windows có hai lệnh cài đặt khác nhau và lựa chọn chỉ phụ thuộc vào terminal. Nếu dòng lệnh bắt đầu bằng PS C:\Users\TwojaNazwa>, bạn đang làm việc trong PowerShell. Nếu chỉ thấy C:\Users\TwojaNazwa>, không có PS, đó là dấu nhắc lệnh (CMD). Theo tài liệu, không cần chạy terminal với quyền quản trị viên, dù một số hướng dẫn khuyên như vậy.

Lỗi thường gặp nhất là dán lệnh vào sai terminal. Dòng dành cho CMD dán vào PowerShell sẽ cho The token '&&' is not a valid statement separator. Dòng dành cho PowerShell dán vào CMD sẽ cho 'irm' is not recognized as an internal or external command. Trên Windows tiếng Ba Lan, thông báo tương tự là: “irm” không được nhận diện là lệnh nội bộ hoặc bên ngoài, chương trình thực thi hoặc tệp batch. Ngược lại, dòng curl … | bash dành cho macOS dán vào PowerShell sẽ kết thúc bằng lỗi A parameter cannot be found that matches parameter name 'fsSL' hoặc 'bash' is not recognized as the name of a cmdlet. Trong mọi trường hợp, chỉ cần sử dụng dòng dành cho terminal của bạn.

Trong menu Start có hai mục: “Windows PowerShell” và “Windows PowerShell (x86)”. Mục thứ hai chạy dưới dạng tiến trình 32-bit, nên ngay cả trên máy tính 64-bit cũng sẽ gặp lỗi Claude Code does not support 32-bit Windows. Hãy mở mục không có hậu tố (x86).

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

Nếu chọn WSL, hãy chạy dòng dành cho macOS và Linux trong terminal WSL và cũng khởi động claude tại đó, không phải trong PowerShell hoặc CMD.

Lỗi chính sách thực thi tập lệnh (npm trong PowerShell)

Thông báo npm.ps1 cannot be loaded because running scripts is disabled on this system khi cài đặt hoặc chạy qua npm có nghĩa là chính sách thực thi (execution policy) của PowerShell đang chặn tập lệnh khởi động .ps1 do npm tạo ra. Theo tài liệu, bạn có thể cho phép người dùng hiện tại chạy các tập lệnh cục bộ (lệnh bên dưới), sử dụng npm.cmd và claude.cmd, hoặc chuyển sang trình cài đặt native dành cho PowerShell.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Lệnh “claude” không được nhận diện sau khi cài đặt

command not found: claude hoặc 'claude' is not recognized có nghĩa là thư mục cài đặt không nằm trong PATH. Trình cài đặt native đặt chương trình tại ~/.local/bin/claude trên macOS và Linux, và tại %USERPROFILE%\.local\bin\claude.exe trên Windows. Trước tiên hãy mở terminal mới. Nếu trên Windows vẫn không hoạt động, hãy kiểm tra và thêm đường dẫn trong PowerShell theo hướng dẫn của tài liệu:

# 1. Sprawdź, czy katalog instalacji jest już w PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Brak wyniku? Dopisz go do PATH użytkownika, zamknij i otwórz terminal
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. W nowym terminalu
claude --version

API key thay cho đăng nhập (không cần gói đăng ký)

ANTHROPIC_BASE_URL là 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 để định tuyến request qua proxy hoặc gateway. Vì vậy, kết nối Claude Code với một dịch vụ tương thích Anthropic Messages API là cấu hình được Anthropic dự kiến. Bạn không cần plugin hay chương trình đã sửa đổi. Trên macOS và Linux, thêm các biến vào tệp cấu hình shell (~/.zshrc hoặc ~/.bashrc):

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # sama domena, bez /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, trước tiên bạn có thể kiểm tra cấu hình trong một cửa sổ PowerShell:

# Działa tylko w tym oknie PowerShella – po zamknięciu znika
$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

Tốt nhất là nhập các biến cố định vào khối env trong tệp cài đặt người dùng ~/.claude/settings.json (trên Windows là %USERPROFILE%\.claude\settings.json). Theo tài liệu, tệp này áp dụng cho tất cả dự án của bạn. Nếu tệp đã có các cài đặt khác, chỉ thêm khối env vào đó:

{
  "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"
  }
}

Bạn rất dễ nhầm lẫn ở bất kỳ dòng nào trong sáu dòng này:

• ANTHROPIC_BASE_URL chỉ là tên miền. Claude Code tự thêm /v1/messages. Nếu có /v1 ở cuối, request sẽ đi đến /v1/v1/messages và trả về 404.
• ANTHROPIC_AUTH_TOKEN, chứ không phải ANTHROPIC_API_KEY. Giá trị ANTHROPIC_AUTH_TOKEN được đưa vào tiêu đề Authorization với tiền tố Bearer và có hiệu lực ngay. ANTHROPIC_API_KEY được đưa vào tiêu đề x-api-key và trong chế độ tương tác, bạn phải phê duyệt một lần. Nếu từ chối, khóa sẽ âm thầm bị bỏ qua. Bạn có thể bật lại trong /config → Sử dụng khóa API tùy chỉnh.
• ANTHROPIC_MODEL chọn mô hình chính. Ở đây là Claude Sonnet 5 (claude-sonnet-5). Tên phải khớp chính xác với danh sách mô hình của Kunavo. Kunavo không nhận diện các tên cũ có ngày tháng ở cuối.
• ANTHROPIC_DEFAULT_OPUS_MODEL và ANTHROPIC_DEFAULT_SONNET_MODEL cố định các bí danh opus và sonnet. Theo tài liệu cấu hình mô hình chính thức (được kiểm tra vào 3 tháng 10, 2026), với người dùng API, mô hình mặc định và bí danh opus trỏ đến Opus 5.5, còn bí danh sonnet trỏ đến Sonnet 5.5. Các bí danh thay đổi theo thời gian; để cố định phiên bản, hãy dùng tên mô hình đầy đủ hoặc các biến như hai biến này. Yêu cầu dùng một mô hình không có trong Kunavo sẽ trả về lỗi 404. Chúng tôi cố định bí danh opus thành Claude Opus 5.5 (claude-opus-5-5), vì phiên bản Opus tiếp theo do Anthropic phát hành có thể chưa có ngay trên Kunavo. Opus 5.5 yêu cầu Claude Code phiên bản 2.1.280 trở lên; hãy cập nhật phiên bản cũ hơn bằng lệnh claude update. Sonnet 5.5 hiện không khả dụng trên Kunavo (tính đến 3 tháng 10, 2026), vì vậy nếu không cố định bí danh sonnet thành claude-sonnet-5, các mục sau sẽ trả về lỗi 404: /model sonnet, giai đoạn thực thi ở chế độ opusplan và các tác nhân con được đặt thành model: sonnet.
• Cũng cố định ANTHROPIC_DEFAULT_HAIKU_MODEL. Bí danh haiku gửi yêu cầu đến một ID mà Kunavo không hỗ trợ: từ Claude Code 2.1.293, đó là Haiku 5.5; trước đó là ID Haiku 4.5 có hậu tố ngày tháng. Nếu thiếu biến này, /model haiku và các tác tử con được đặt dùng model: haiku sẽ nhận lỗi 404.
• ANTHROPIC_DEFAULT_HAIKU_MODEL cũng xử lý các tác vụ chạy nền. Theo tài liệu, biến này chọn mô hình cho bí danh haiku và các tính năng chạy nền. Tại Kunavo, Claude Haiku 4.5 có giá 0,70 USD cho mỗi triệu token đầu vào và 3,50 USD cho mỗi triệu token đầu ra. Mô hình chính Claude Sonnet 5 có giá 1,40 USD / 7,00 USD (bảng giá Anthropic: 2,00 USD / 10,00 USD), còn Claude Opus 5.5 có giá 2,80 USD / 14,00 USD (đầu vào / đầu ra, cho mỗi triệu token).

Không nhập khóa vào tệp .claude/settings.json của dự án. Theo tài liệu kết nối cổng, tệp này được đưa vào kho mã, vì vậy bất kỳ ai sao chép kho mã đều có thể truy cập tệp. Cũng cần lưu ý thứ tự ưu tiên. Khi cùng một biến được đặt cả trong shell lẫn trong khối env của tệp cài đặt, giá trị trong tệp cài đặt được áp dụng trong phần lớn các phiên. Có một quy tắc riêng đối với khóa model trong tệp cài đặt: biến ANTHROPIC_MODEL được ưu tiên hơn khóa này, còn model chỉ có hiệu lực khi biến đó không tồn tại. Nếu thay đổi trong shell không có hiệu lực, trước tiên hãy kiểm tra tệp cài đặt. Trong tiện ích mở rộng Claude Code dành cho VS Code, các biến được đặt trong claudeCode.environmentVariables, thuộc phần cài đặt người dùng của chính VS Code.

Lần chạy đầu tiên và /status

Theo tài liệu kết nối gateway (đã kiểm tra 3 tháng 10, 2026), khi ANTHROPIC_AUTH_TOKEN được thiết lập, lệnh claude sẽ mở ngay một phiên không có màn hình đăng nhập. Biến này có hiệu lực ngay và không cần phê duyệt như ANTHROPIC_API_KEY. Nếu thay vào đó bạn thấy màn hình đăng nhập, Claude Code chưa đọc được khóa.

Khóa phải được đặt ở nơi Claude Code đọc trước khi cấu hình lần đầu, tức là được thiết lập bằng lệnh export trong shell hoặc trong khối env của tệp ~/.claude/settings.json dành cho người dùng. Trong chế độ tương tác, khối env từ .claude/settings.json hoặc .claude/settings.local.json của dự án chỉ bắt đầu có hiệu lực sau trình hướng dẫn chạy lần đầu và câu hỏi về việc tin cậy thư mục. Nếu khóa chỉ nằm trong cài đặt dự án, lần khởi động đầu tiên vẫn hiển thị màn hình đăng nhập.

Trong phiên, nhập /status và kiểm tra hai dòng:

• Anthropic base URL chỉ xuất hiện khi địa chỉ gateway được thiết lập. Dòng này phải hiển thị https://api.kunavo.com. Nếu không có dòng này, ANTHROPIC_BASE_URL chưa đến được phiên.
• Auth token với tên ANTHROPIC_AUTH_TOKEN cho biết khóa API đang hoạt động, không phải thông tin đăng nhập claude.ai đã lưu. Nếu bạn thấy Login method cùng tài khoản claude.ai, biến này chưa có hiệu lực.

Bạn cũng có thể kiểm tra địa chỉ và khóa trước khi chạy Claude Code bằng phương pháp trong tài liệu chính thức. Phương pháp này gửi yêu cầu cho 1 token đầu ra và trừ một khoản tượng trưng khỏi số dư. Lệnh đọc các biến từ shell hiện tại, vì vậy ngay cả khi khóa nằm trong tệp cài đặt, trước tiên hãy thiết lập các biến bằng lệnh export trong terminal này. Phản hồi JSON bắt đầu bằng {"id":"msg_ cho biết địa chỉ và khóa hoạt động. Mã 401 cho biết khóa đã bị từ chối.

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

Trong PowerShell, việc kiểm tra tương tự như sau. Nếu mọi thứ hoạt động, phản hồi sẽ có trường id bắt đầu bằng 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": "."}]}'

Khóa API hoạt động khác như thế nào

• Remote Control và tính năng đọc chính tả bằng giọng nói không khả dụng. Theo tài liệu, chúng yêu cầu danh tính claude.ai và không hoạt động khi ANTHROPIC_AUTH_TOKEN đang hoạt động. Từ phiên bản 2.1.196, Remote Control cũng bị tắt khi ANTHROPIC_BASE_URL trỏ đến máy chủ khác với api.anthropic.com.
• /fast hiển thị chế độ nhanh là đã tắt. Theo tài liệu, khi chỉ có bearer token, Claude Code coi chế độ nhanh là đã tắt và không gửi yêu cầu kiểm tra tính khả dụng.
• Tính năng tìm kiếm công cụ MCP bị tắt theo mặc định. Điều này xảy ra khi ANTHROPIC_BASE_URL trỏ đến máy chủ khác Anthropic.
• Các con số trong /context chỉ là ước tính. Kunavo không cung cấp endpoint /v1/messages/count_tokens. Theo tài liệu tương thích gateway (được kiểm tra vào 3 tháng 10, 2026), Claude Code sẽ tính token cục bộ dựa trên số ký tự.

Bạn có thể xem mô tả đầy đủ về quá trình tích hợp trong tài liệu tích hợp Claude Code (bằng tiếng Anh), còn phiên bản tiếng Anh của hướng dẫn này có trong bài viết Cài đặt Claude Code.

Thanh toán bằng BLIK: nạp số dư và khóa API

Các gói thuê bao Claude mua qua trang web của Anthropic chỉ có thể được thanh toán bằng thẻ tín dụng hoặc thẻ ghi nợ (Câu hỏi thường gặp về thanh toán Claude, được kiểm tra vào 3 tháng 10, 2026). Bạn không thể dùng BLIK để thanh toán Pro hoặc Max. Trên Kunavo, BLIK dùng để nạp số dư API trả trước; sau khi thiết lập khóa như hướng dẫn ở trên, Claude Code sẽ dùng số dư đó để thanh toán token. Hướng dẫn cách thanh toán Claude bằng BLIK mô tả đầy đủ các bước thanh toán; tóm tắt như sau:

1. Tạo tài khoản Kunavo bằng email hoặc tài khoản Google. Bạn không cần cung cấp thẻ khi đăng ký.
2. Trong tab Thanh toán (Billing), chọn số tiền cần nạp. Mức tối thiểu là 10 USD và không có phí hàng tháng. Với số tiền lớn hơn, bạn sẽ nhận được tiền thưởng: 100 USD → 110 USD trong số dư, 1000 USD → 1200 USD trong số dư và 5000 USD → 6250 USD trong số dư.
3. Trang thanh toán Stripe hiển thị số tiền bằng złoty. Chọn BLIK, tạo mã sáu chữ số trong ứng dụng ngân hàng, nhập mã rồi xác nhận thanh toán trong ứng dụng. Theo tài liệu Stripe (được kiểm tra vào 3 tháng 10, 2026), mã BLIK có hiệu lực trong 2 phút và sau khi bắt đầu thanh toán, bạn có 60 giây để xác nhận.
4. Trong tab Khóa API, tạo khóa bắt đầu bằng sk-kn-. Khóa chỉ hiển thị một lần, vì vậy hãy lưu ngay và nhập vào ANTHROPIC_AUTH_TOKEN.

Trên trang thanh toán bằng złoty, ngoài BLIK còn có thẻ (Visa, Mastercard), Apple Pay và Google Pay trên các thiết bị được hỗ trợ, cùng Link. Trang này không có Przelewy24, PayU, PayPal hay chuyển khoản ngân hàng thông thường. Giá được đặt bằng đô la và Stripe quy đổi sang złoty. Theo tài liệu Stripe về Adaptive Pricing (được kiểm tra vào 3 tháng 10, 2026), tỷ giá bao gồm phí chuyển đổi tiền tệ 2–4% do người mua trả. Thanh toán bằng thẻ bằng đô la giúp bạn tránh khoản phí này, nhưng khi đó tỷ giá và phí của ngân hàng sẽ được áp dụng; BLIK chỉ hoạt động bằng złoty. Bạn sẽ thấy chính xác số tiền bằng złoty trên trang thanh toán trước khi xác nhận.

BLIK chỉ hoạt động khi nạp tiền thủ công. Tính năng nạp tiền tự động yêu cầu thẻ hoặc Link đã lưu. Số dư không hết hạn và bạn không phải trả phí cho các yêu cầu thất bại. Kunavo không phát hành hóa đơn VAT; bạn có thể xem lịch sử nạp tiền trong tab Thanh toán (Billing). Hãy nhớ rằng đây là khoản nạp vào số dư API Kunavo, không phải phí cho Claude Pro hay Max.

Chi phí là bao nhiêu (ví dụ tính toán)

Trong Claude Code, bạn trả tiền cho token. Với mỗi yêu cầu, Claude Code gửi lại toàn bộ ngữ cảnh cuộc trò chuyện, nhưng phần đầu ngữ cảnh lặp lại có thể được tính theo mức giá đọc từ bộ nhớ đệm. Dưới đây là ví dụ tính toán dựa trên token. Đây không phải phép đo hay giới hạn chi phí tối đa. Tất cả giả định đều được nêu rõ:

• mỗi yêu cầu có 40.000 token đầu vào, trong đó 36.000 (90%) được tính là đọc từ bộ nhớ đệm, còn 4000 còn lại được tính là ghi vào bộ nhớ đệm;
• mỗi yêu cầu trả về 1000 token đầu ra;
• một phiên làm việc có 50 yêu cầu như vậy, không có lệnh gọi Claude Haiku 4.5 chạy nền;
• tại Kunavo, đọc từ bộ nhớ đệm có giá bằng 10% mức giá đầu vào, còn ghi vào bộ nhớ đệm có giá bằng 1,25× mức giá đầu vào. Đây là các tỷ lệ dành cho Claude Sonnet 5; mỗi mô hình trong bảng được tính theo tỷ lệ riêng.

Chi phí thực tế phụ thuộc vào độ dài ngữ cảnh, số lần truy cập bộ nhớ đệm, độ dài phản hồi và việc bạn có xóa cuộc trò chuyện giữa các tác vụ bằng lệnh /clear hay không. Bạn có thể xem mức giá của tất cả mô hình trong bảng giá. Hãy ước tính mức sử dụng của riêng bạn bằng máy tính chi phí token Claude (bằng tiếng Anh). Hướng dẫn Claude Code có giá bao nhiêu giải thích khi nào gói đăng ký có lợi hơn và khi nào API có lợi hơn.

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

Hạn chế

• Kunavo không phát hành hóa đơn VAT.
• BLIK chỉ hoạt động khi nạp tiền thủ công. Tính năng nạp tiền tự động yêu cầu thẻ hoặc Link đã lưu.
• Đây là API tính phí theo token, không phải gói đăng ký Claude Pro hoặc Max. Khi dùng khóa API, Remote Control và tính năng đọc chính tả bằng giọng nói không hoạt động, chế độ /fast bị tắt và tính năng tìm kiếm công cụ MCP bị tắt theo mặc định.
• Hiện tại Kunavo (tính đến 3 tháng 10, 2026) chưa cung cấp Sonnet 5.5, vì vậy cấu hình ở trên ghim bí danh sonnet vào claude-sonnet-5. Nếu không ghim mô hình, các bí danh mặc định có thể trả về 404. Claude Opus 5.5, được ghim vào bí danh opus, yêu cầu Claude Code phiên bản 2.1.280 trở lên.
• Tài liệu chính thức về Claude Code và tài liệu tích hợp Kunavo chỉ có bằng tiếng Anh.

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