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

Để cài đặt Claude Code chỉ cần một lệnh, tùy theo terminal: dòng có install.sh trên macOS, Linux và WSL, irm … | iex trong PowerShell, dòng có install.cmd trong Command Prompt. Đây là phương thức Anthropic khuyến nghị; npm vẫn có thể dùng nhưng yêu cầu Node.js 22 trở lên. Gói miễn phí của Claude không bao gồm Claude Code, vì vậy cần gói thuê bao Pro trở lên hoặc khóa API. Ở đây, bạn sẽ theo lựa chọn thứ hai: ANTHROPIC_BASE_URL=https://api.kunavo.com (không có /v1), khóa trong ANTHROPIC_AUTH_TOKEN, bốn biến cố định các mô hình và /status để kiểm tra lần cuối. Tín dụng được nạp bằng Satispay bằng euro từ $10 và bạn chỉ trả tiền cho số token đã sử dụng.

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

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

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

Nguồn của các lệnh này: tài liệu Claude Code cũng có bản tiếng Ý và chúng tôi đã đọc lại vào 3 tháng 10, 2026, đặc biệt là các trang về cài đặt và gateway LLM. Giá và phương thức thanh toán của Kunavo được cập nhật đến 10 tháng 10, 2026. Anthropic cung cấp dịch vụ tại Ý qua cả Claude.ai lẫn API (các quốc gia được hỗ trợ, đã đọc vào 3 tháng 10, 2026).

Yêu cầu

Các yêu cầu trong tài liệu chính thức (đã đọc vào 3 tháng 10, 2026) không cao:

• 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+ hoặc Alpine Linux 3.19+.
• Ít nhất 4 GB RAM và bộ xử lý x64 hoặc ARM64. Windows 32 bit không được hỗ trợ.
• Một shell trong số Bash, Zsh, PowerShell và CMD.
• Kết nối từ quốc gia được Anthropic hỗ trợ: Ý được hỗ trợ.
• Chỉ cần Node.js nếu bạn chọn npm; trong trường hợp đó, phiên bản phải từ 22 trở lên.

Lệnh nào, trong terminal nào

Không cần quyền quản trị viên và không cần WSL: tài liệu chính thức nêu rõ điều này, dù nhiều hướng dẫn trên mạng cho rằng ngược lại. Sau khi cài đặt, Claude Code tự cập nhật trong nền. Nếu muốn dùng trình quản lý gói, bạn có thể sử dụng Homebrew hoặc WinGet, nhưng khi đó bạn phải tự khởi chạy các bản cập nhật:

# Homebrew – canale stable; non si aggiorna da solo
brew install --cask claude-code

# WinGet (Windows) – non si aggiorna da solo
winget install Anthropic.ClaudeCode

Trước khi thử, hãy đóng terminal và mở một terminal mới: chỉ cửa sổ mới mới đọc lại PATH. Sau đó hãy kiểm tra. claude doctor cũng sẽ hữu ích về sau, vì công cụ này kiểm tra cài đặt và thiết lập mà không mở phiên, đồng thời cho biết ngay lỗi nằm ở phần nào.

claude --version   # stampa la versione, ad esempio 2.1.284 (Claude Code)
claude doctor      # diagnostica di installazione e impostazioni, senza aprire una sessione

Tải xuống bị chặn: 403 hoặc nhận được trang HTML thay vì script

Khi không tải được tập lệnh, terminal không hiển thị thông báo rõ ràng: bash báo lỗi syntax error near unexpected token '<' (do đang cố chạy một trang web), hoặc curl dừng lại ở curl: (22) The requested URL returned error: 403. Trang chính thức về sự cố cài đặt (bằng tiếng Anh, đã đọc vào 3 tháng 10, 2026) phân biệt hai trường hợp. Nếu trang được tải xuống ghi App unavailable in region, máy chủ cho rằng bạn đang kết nối từ quốc gia bị loại trừ: từ Ý, điều này hầu như luôn xảy ra do VPN hoặc proxy có điểm thoát ở nước ngoài. Lỗi 403 không có nội dung thường do proxy của công ty hoặc tường lửa gây ra. Đổi phương thức cài đặt không giúp ích vì Homebrew và WinGet tải xuống từ cùng các máy chủ: hãy thử dùng mạng khác hoặc nhờ bộ phận CNTT bỏ chặn các tên miền đó.

Với npm: Node.js 22, không phải 18

Nếu bạn dùng Node.js hằng ngày, npm có vẻ là lựa chọn hợp lý. Phương thức này hoạt động và nằm trong số các phương thức được tài liệu hướng dẫn, nhưng có một điều kiện mà nhiều hướng dẫn tiếng Ý chưa cập nhật: cần Node.js 22 trở lên. Với phiên bản Node cũ hơn, bạn sẽ thấy cảnh báo EBADENGINE, nhưng quá trình cài đặt vẫn hoàn tất và claude vẫn khởi chạy (tài liệu chính thức, đã đọc vào 3 tháng 10, 2026). Các phiên bản Node mới nhất có tại nodejs.org.

node -v                                    # serve v22 o successiva
npm install -g @anthropic-ai/claude-code   # senza sudo

# aggiornamento: @latest, non npm update -g
npm install -g @anthropic-ai/claude-code@latest

Ba thói quen cần tránh:

• sudo trước npm install -g. Tài liệu không khuyến nghị cách này, cả vì vấn đề quyền bị chồng chéo lẫn lý do bảo mật.
• npm update -g để cập nhật. Thay vào đó, hãy lặp lại quá trình cài đặt với @latest, như ở dòng cuối phía trên.
• Bỏ qua các phần phụ thuộc tùy chọn. Tệp nhị phân của Claude Code được phân phối dưới dạng một phần phụ thuộc tùy chọn, với một gói @anthropic-ai/claude-code-* cho mỗi nền tảng. Với --omit=optional hoặc với optional=false trong tệp .npmrc, gói này sẽ không được tải xuống; trên macOS hoặc Linux, claude sẽ trả về claude native binary not installed (sự cố cài đặt, bằng tiếng Anh, đã đọc vào 3 tháng 10, 2026).

Claude Code trên Windows: các điểm dễ gặp sự cố

Claude Code chạy trực tiếp trên Windows và bản thân việc cài đặt khá dễ. Sự cố phát sinh từ môi trường. Trước tiên là terminal: nếu dán dòng lệnh dành cho CMD vào PowerShell, PowerShell sẽ báo lỗi về &&; nếu dán dòng lệnh dành cho PowerShell vào CMD, CMD không biết irm là gì; còn dòng lệnh curl … | bash dành cho Mac thì hoàn toàn không hoạt động trong PowerShell. Trên Windows tiếng Ý, một số thông báo này có thể được dịch. Dù thế nào, cách giải quyết là quay lại bảng ở trên và chọn dòng lệnh dành cho terminal bạn đang dùng (các thông báo lỗi bằng tiếng Anh nằm trong bảng lỗi ở cuối; nguồn: tài liệu, đã đọc vào 3 tháng 10, 2026).

Cũng cần chú ý đến menu Start: “Windows PowerShell (x86)” mở một tiến trình 32 bit và Claude Code dừng với Claude Code does not support 32-bit Windows, ngay cả khi máy tính là 64 bit. Hãy chọn mục không có (x86).

Git for Windows không bắt buộc. Nếu đã cài đặt, Claude Code chạy các lệnh thông qua Git Bash; nếu chưa, Claude Code dùng PowerShell. Khi đã cài Git nhưng Claude Code không tìm thấy bash.exe, hãy chỉ định đường dẫn bằng CLAUDE_CODE_GIT_BASH_PATH trong khối env của ~/.claude/settings.json, thường là C:\Program Files\Git\bin\bash.exe. Còn WSL? Chỉ cần trong một trường hợp cụ thể:

Với WSL, mọi thứ diễn ra bên trong Linux: dòng install.sh phải được thực thi trong shell WSL, và từ đó bạn chạy claude.

Không tìm thấy “claude”

Nếu sau khi cài đặt terminal trả về command not found: claude hoặc 'claude' is not recognized, chương trình đã tồn tại nhưng thư mục của chương trình chưa nằm trong PATH. Trình cài đặt native sao chép chương trình vào ~/.local/bin/claude trên macOS và Linux, và vào %USERPROFILE%\.local\bin\claude.exe trên Windows. Thử trước: mở một terminal mới. Nếu trên Windows vẫn chưa đủ, đây là các lệnh PowerShell trong tài liệu để kiểm tra và thêm thư mục vào PATH của người dùng:

# 1. Controlla se la cartella di installazione è già nel PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Nessun risultato? Aggiungila al PATH utente, poi chiudi e riapri il terminale
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Nel nuovo terminale
claude --version

npm.ps1 cannot be loaded trong PowerShell

Chỉ áp dụng cho người cài đặt bằng npm: chính sách thực thi (execution policy) của PowerShell chặn script .ps1 do npm tạo, và thông báo đầy đủ có chứa running scripts is disabled on this system. Tài liệu đưa ra ba cách xử lý: cho phép người dùng hiện tại chạy các script cục bộ bằng lệnh bên dưới, chạy npm.cmd và claude.cmd thay cho các script PowerShell, hoặc bỏ qua npm và sử dụng trình cài đặt native.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Không cần gói thuê bao: tài khoản Claude hoặc khóa API

Đã cài đặt không có nghĩa là đã sẵn sàng: khi khởi chạy lần đầu, Claude Code yêu cầu bạn xác thực, và gói miễn phí của Claude.ai là không đủ (tài liệu, đã đọc vào 3 tháng 10, 2026). So sánh hai cách:

Ngoài ra còn có khóa của Anthropic Console, cũng được tính phí theo mức sử dụng. Tuy nhiên, tín dụng trả trước ở đó sẽ hết hạn sau một năm và không được hoàn lại (bộ phận hỗ trợ Anthropic, đã đọc vào 3 tháng 10, 2026); thanh toán bằng thẻ, còn chuyển khoản ACH chỉ dành cho tài khoản API được thanh toán hằng tháng (bộ phận hỗ trợ Anthropic). Tín dụng Kunavo không hết hạn.

Cấu hình khóa API: sáu biến

Việc Claude Code kết nối với endpoint khác endpoint của Anthropic là điều được hỗ trợ: tài liệu chính thức có một trang, cũng được dịch sang tiếng Ý, hướng dẫn cách kết nối Claude Code với gateway LLM. Không cần plugin hay phiên bản đã chỉnh sửa. Chỉ cần các biến sau:

Trên macOS và Linux, hãy thêm chúng vào cuối ~/.zshrc hoặc ~/.bashrc:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # solo il dominio, senza /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, để thử nhanh và chỉ có hiệu lực trong thời gian cửa sổ PowerShell đang mở:

# Vale solo in questa finestra di PowerShell: chiusa la finestra, sparisce
$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

Để không phải thiết lập lại mỗi lần, vị trí phù hợp là khối env trong ~/.claude/settings.json (trên Windows là %USERPROFILE%\.claude\settings.json): có hiệu lực cho tất cả dự án của bạn. Nếu tệp đã có các thiết lập khác, chỉ cần thêm 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"
  }
}

AUTH_TOKEN hay API_KEY?

Kunavo đọc khóa từ cả hai tiêu đề, Authorization: Bearer và x-api-key, nên về lý thuyết, dùng biến nào cũng được. Khác biệt nằm ở Claude Code. Với ANTHROPIC_API_KEY, được gửi dưới dạng x-api-key, phiên tương tác hỏi bạn một lần có phê duyệt khóa hay không; nếu bạn trả lời không, khóa sẽ bị bỏ qua mà không có thông báo cho đến khi bạn bật lại qua /config → Dùng khóa API tùy chỉnh. ANTHROPIC_AUTH_TOKEN không hỏi gì và cũng là biến được tài liệu về gateway (đã đọc vào 3 tháng 10, 2026) đề xuất khi bạn không biết nên chọn biến nào.

Tại sao cần cố định các mô hình

Nếu không đặt biến, Claude Code hoạt động theo bí danh và các bí danh theo các bản phát hành của Anthropic. Hiện nay, theo tài liệu về cấu hình mô hình (đã đọc vào 3 tháng 10, 2026), với người dùng API, opus tương ứng với Opus 5.5 và sonnet tương ứng với Sonnet 5.5. Tính đến 3 tháng 10, 2026, Kunavo không cung cấp Sonnet 5.5: nếu không đặt ANTHROPIC_DEFAULT_SONNET_MODEL, /model sonnet, giai đoạn thực thi của opusplan và các tác tử con dùng model: sonnet sẽ yêu cầu một mô hình không có trên Kunavo và nhận lỗi 404. Khi đặt claude-sonnet-5 vào biến đó, bí danh sẽ trỏ đến Claude Sonnet 5, cùng mô hình với ANTHROPIC_MODEL. Trong khi đó, biến này chọn mô hình cho phiên: nếu không đặt, Claude Code sẽ dùng mô hình mặc định của nó, hiện là Opus 5.5. Opus 5.5 hiện có sẵn; việc cố định opus thành claude-opus-5-5 nhằm mục đích khác: tránh để mô hình và mức giá thay đổi qua đêm khi bí danh chuyển sang một Opus mới hơn. Claude Opus 5.5 yêu cầu Claude Code phiên bản 2.1.280 trở lên; nếu dùng phiên bản cũ hơn, hãy chạy claude update trước.

Mức giá Kunavo của ba mô hình trong cấu hình, trên mỗi triệu token (đầu vào / đầu ra): Claude Sonnet 5 $1,40 / $7,00 (bảng giá Anthropic: $2,00 / $10,00); Claude Opus 5.5 $2,80 / $14,00; Claude Haiku 4.5 $0,70 / $3,50, cũng hoạt động ngầm.

Không nên đặt khóa ở đâu và thiết lập nào được ưu tiên

Tệp .claude/settings.json trong dự án sẽ được commit: nếu ghi khóa ở đó, khóa sẽ vào kho lưu trữ và được chuyển đến bất kỳ ai sao chép kho lưu trữ (tài liệu về gateway). Nếu một biến xuất hiện cả trong shell lẫn khối env của tệp cài đặt, tệp sẽ được ưu tiên: khi thay đổi ~/.zshrc dường như không có tác dụng, nguyên nhân hầu như luôn nằm ở đây. Ngược lại, trường model trong tệp cài đặt sẽ nhường quyền ưu tiên cho ANTHROPIC_MODEL. Trong tiện ích mở rộng Claude Code dành cho VS Code, hãy đặt các biến tương tự trong claudeCode.environmentVariables, phần cài đặt người dùng của VS Code. Ứng dụng Claude dành cho máy tính để bàn không nằm trong các thiết lập này: ứng dụng không đọc ANTHROPIC_BASE_URL cũng như settings.json (tài liệu về gateway, đã đọc vào 3 tháng 10, 2026).

Khởi chạy lần đầu và kiểm tra bằng /status

Nếu khóa đã được đặt đúng chỗ, claude sẽ khởi chạy mà không hiện màn hình đăng nhập: chỉ còn cấu hình ban đầu và câu hỏi bạn có tin cậy thư mục hay không. Nếu màn hình đăng nhập xuất hiện, Claude Code chưa tìm thấy khóa. Trường hợp thường gặp là khóa chỉ được ghi trong .claude/settings.json hoặc .claude/settings.local.json của dự án: ở chế độ tương tác, khối env chỉ có hiệu lực sau cấu hình ban đầu và xác nhận tin cậy (tài liệu về gateway, được xem ngày 3 tháng 10, 2026), nên lúc khởi chạy lần đầu thì chưa có. Hãy chuyển khóa vào shell hoặc tệp người dùng. Đăng nhập Pro hoặc Max cũ không gây trở ngại vì biến môi trường được ưu tiên hơn thông tin đăng nhập đã lưu; nếu muốn xóa thông tin đó, hãy dùng /logout.

Trong phiên, nhập /status. Có hai dòng cần chú ý:

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

Bạn muốn kiểm tra trước cả khi mở Claude Code? Tài liệu đề xuất một yêu cầu tối thiểu với 1 token đầu ra, chỉ trừ một khoản không đáng kể từ tín dụng. Lệnh đọc các biến của shell hiện tại: nếu khóa chỉ nằm trong settings.json, hãy xuất khóa trước trong terminal này. Nếu nhận được JSON bắt đầu bằng {"id":"msg_ thì mọi thứ đã ổn; 401 có nghĩa là 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, cùng phép thử được thực hiện như sau, và phản hồi hợp lệ chứa một 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": "."}]}'

Những gì bạn mất khi sử dụng khóa API

• Remote Control và đọc chính tả bằng giọng nói. Các tính năng này yêu cầu danh tính claude.ai và không hoạt động với ANTHROPIC_AUTH_TOKEN hoặc ANTHROPIC_API_KEY; từ phiên bản 2.1.196, Remote Control cũng bị tắt khi ANTHROPIC_BASE_URL trỏ đến một máy chủ không thuộc Anthropic.
• Chế độ /fast. Chỉ với bearer token Claude Code sẽ coi chế độ này là đã tắt và thậm chí không thử yêu cầu.
• Tìm kiếm công cụ MCP ngay từ đầu. Với ANTHROPIC_BASE_URL tùy chỉnh, tính năng này mặc định tắt (tài liệu MCP, bằng tiếng Anh, được xem ngày 3 tháng 10, 2026). Có thể bật lại bằng ENABLE_TOOL_SEARCH=true nếu gateway chuyển tiếp các khối tool_reference; chúng tôi chưa thử nghiệm tính năng này với Kunavo.
• Độ chính xác của /context. Kunavo không cung cấp /v1/messages/count_tokens, một endpoint tùy chọn theo đặc tả gateway (được xem ngày 3 tháng 10, 2026); nếu không có endpoint này, Claude Code ước tính số token dựa trên số ký tự.

Để tìm hiểu thêm, bằng tiếng Anh: tài liệu tích hợp với Claude Code, trang về các trường hợp đặc biệt của ANTHROPIC_BASE_URL và hướng dẫn Install Claude Code.

Thanh toán bằng Satispay, không cần thẻ tín dụng

Trước hết cần làm rõ một điểm vì đây là câu hỏi thường gặp nhất: Satispay không thanh toán gói đăng ký Claude. Với Pro và Max mua trên web, Anthropic chỉ chấp nhận thẻ tín dụng hoặc thẻ ghi nợ (bộ phận hỗ trợ Anthropic) và không chấp nhận PayPal (bộ phận hỗ trợ Anthropic), cả hai được xem ngày 3 tháng 10, 2026. Trên Kunavo, Satispay nạp số dư API mà Claude Code sử dụng bằng khóa đã cấu hình ở trên. Hướng dẫn thanh toán Claude bằng Satispay có đầy đủ chi tiết, bao gồm cả phí nạp số dư. Quy trình cho Claude Code như sau:

1. Đăng ký Kunavo bằng email hoặc tài khoản Google: không yêu cầu thẻ.
2. Mở Thanh toán và chọn số tiền cần nạp: tối thiểu $10, không có phí duy trì. Trên một số ngưỡng nhất định có tiền thưởng: $100 trở thành $110, $1.000 trở thành $1.200 và $5.000 trở thành $6.250 tín dụng.
3. Trong trang thanh toán Stripe, nơi hiển thị số tiền bằng euro, hãy chọn Satispay. Bạn sẽ được chuyển đến trang Satispay (tài liệu Stripe): nhập số điện thoại hoặc quét mã QR trong ứng dụng, sau đó xác nhận bằng nút Gửi (bộ phận hỗ trợ Satispay, được xem ngày 3 tháng 10, 2026). Tốt nhất hãy đảm bảo số dư đã đủ trước khi bắt đầu.
4. Tín dụng xuất hiện trong Billing ngay khi Stripe xác nhận thanh toán. Nếu chưa thấy ngay, hãy tải lại trang thay vì thanh toán lần nữa: khoản thanh toán thứ hai sẽ cộng vào tín dụng, không thay thế khoản đầu tiên.
5. Trong Khóa API, tạo khóa sk-kn-… và sao chép ngay vào ANTHROPIC_AUTH_TOKEN: khóa chỉ được hiển thị một lần duy nhất.

Kunavo niêm yết giá bằng đô la và Stripe chuyển đổi sang euro với phí chuyển đổi tiền tệ 2–4% do người thanh toán chịu (Stripe, Adaptive Pricing, được xem ngày 3 tháng 10, 2026): với mức nạp tối thiểu $10, phí này là từ $0,20 đến $0,40. Thanh toán bằng đô la sẽ không mất phí chuyển đổi, nhưng Satispay cũng không khả dụng vì chỉ có trong trang thanh toán bằng euro; nếu trang thanh toán hiển thị bằng đô la, nguyên nhân thường là VPN. Số tiền chính xác bằng euro là số tiền bạn thấy trên trang thanh toán trước khi xác nhận.

Với Satispay, bạn phải tự nạp tiền: tính năng tự động nạp của Kunavo chỉ trừ tiền từ thẻ đã lưu hoặc Link. Nếu có thẻ Satispay, một thẻ ghi nợ Mastercard dành cho các gói Plus, Metal và Velvet (bộ phận hỗ trợ Satispay, được xem ngày 3 tháng 10, 2026), bạn có thể lưu thẻ và sử dụng như bất kỳ thẻ nào khác. 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í. Kunavo không phát hành hóa đơn, dù có VAT hay hóa đơn điện tử qua SDI; lịch sử nạp tiền nằm trong Billing.

Một ghi chú trung thực: Satispay có mặt trong trang thanh toán của Kunavo từ ngày 3 tháng 10 năm 2026 và Stripe cung cấp tùy chọn này cho các khoản thanh toán bằng euro, nhưng chưa có khoản nạp nào được thực hiện qua đó. Nếu không tìm thấy, thẻ, Apple Pay, Google Pay và Link vẫn thực hiện cùng chức năng.

Một phiên làm việc có giá bao nhiêu

Với khóa API, chi phí nằm ở token, và Claude Code gửi khá nhiều token: ở mỗi bước, nó gửi lại toàn bộ ngữ cảnh. Tuy nhiên, phần không thay đổi có thể được đọc từ bộ nhớ đệm với mức phí thấp hơn nhiều. Dưới đây là một ví dụ được dựng sẵn, với các giả định được nêu rõ: đây không phải phép đo và cũng không phải mức giới hạn chi tiêu.

• 40.000 token đầu vào cho mỗi yêu cầu, trong đó 36.000 (90%) được đọc từ bộ nhớ đệm và 4.000 được ghi vào bộ nhớ đệm;
• 1.000 token đầu ra cho mỗi yêu cầu;
• 50 yêu cầu trong một phiên, không tính các lệnh gọi Claude Haiku 4.5 chạy nền;
• đọc từ bộ nhớ đệm ở mức 10% mức phí đầu vào và ghi ở mức 1,25× mức phí đầu vào: đây là các tỷ lệ Kunavo cho Claude Sonnet 5, và mỗi dòng trong bảng sử dụng tỷ lệ của chính mô hình đó.

Ngữ cảnh dài, ít lượt đọc từ bộ nhớ đệm và câu trả lời dài sẽ làm tăng chi phí; một /clear giữa các tác vụ sẽ làm giảm chi phí. Bạn có thể xem gói đăng ký hay API phù hợp hơn tại Claude Code có giá bao nhiêu; mức phí của tất cả các mô hình Claude có trong giá API Claude và trang giá. Để tính lại theo số liệu của bạn, hãy dùng máy tính chi phí token Claude (bằng tiếng Anh).

Lỗi: thông báo, nguyên nhân, cách khắc phục

Cấu hình này không thực hiện được gì

• Không kích hoạt gói Claude Pro hoặc Max: tín dụng Kunavo thanh toán cho API và Claude Code bằng khóa, không phải claude.ai hay ứng dụng Claude.
• Không tạo hóa đơn: cả hóa đơn có VAT lẫn hóa đơn điện tử qua SDI đều không được tạo.
• Không tự động nạp tiền bằng Satispay: tính năng nạp tự động yêu cầu thẻ đã lưu hoặc Link.
• Không hoạt động nếu thiếu các biến mô hình cho đến khi Kunavo cung cấp Sonnet 5.5 (tình trạng tính đến 3 tháng 10, 2026): bí danh sonnet sẽ trả về 404, cùng với /model sonnet, giai đoạn thực thi của opusplan và các subagent sử dụng model: sonnet.
• Không có tài liệu Kunavo bằng tiếng Ý: hướng dẫn tích hợp và trang về số dư và thanh toán bằng tiếng Anh, trong khi tài liệu của Anthropic về Claude Code đã được dịch.

Để có cái nhìn tổng quan về việc phát triển với Claude từ Ý, hãy xem hướng dẫn API Claude tại Ý. Bắt đầu từ đâu: tạo tài khoản, nạp $10 bằng Satispay, thiết lập sáu biến và kiểm tra bằng /status.

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