Pour utiliser Claude Code sans acheter de forfait Pro/Max, effectuez trois opérations : installez-le avec la commande native officielle (une ligne par type de terminal, juste en dessous), définissez ANTHROPIC_BASE_URL=https://api.kunavo.com (sans /v1) ainsi que ANTHROPIC_AUTH_TOKEN et les quatre variables de verrouillage des modèles, puis saisissez /status pour vérifier que Claude Code utilise bien la clé. Le coût des tokens est déduit du solde prépayé, rechargé à partir de 10 USD avec une carte Visa/Mastercard ou Link ; MoMo, ZaloPay et VNPay ne sont pas disponibles. Pour une installation avec npm, la machine doit disposer de Node.js 22 ou d’une version ultérieure.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows Command Prompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdLệnh cài và tên biến trong bài lấy từ tài liệu chính thức của Claude Code, gồm page d’installation và liste des variables d’environnement, đọc lại ngày 3 octobre 2026. Anthropic chưa có bản tiếng Việt của các trang này (đường dẫn /docs/vi/setup báo 404 cùng ngày), nên thông báo lỗi trong bài được giữ nguyên tiếng Anh để bạn tìm cho dễ. Giá và cách thanh toán của Kunavo được kiểm tra ngày 3 octobre 2026.
Choisissez la commande d’installation selon le terminal ouvert
Toutes les méthodes d’installation aboutissent au même programme claude ; la différence concerne la personne ou l’outil chargé des mises à jour. La documentation officielle place la méthode native dans l’onglet « Native Install (Recommended) », qui est également la seule méthode à se mettre automatiquement à jour sans intervention de votre part.
| Vous êtes dans | Utiliser la commande | Mise à jour |
|---|---|---|
| macOS, Linux ou terminal WSL | install.sh (première ligne ci-dessus) | Automatique, en arrière-plan |
Windows PowerShell, avec une invite de la forme PS C:\Users\TenBan> | irm https://claude.ai/install.ps1 | iex | Automatique, en arrière-plan |
Windows CMD, avec une invite de la forme C:\Users\TenBan> (sans PS) | La ligne contenant install.cmd | Automatique, en arrière-plan |
| Vous utilisez déjà Homebrew ou WinGet | brew install --cask claude-code, winget install Anthropic.ClaudeCode | Pas de mise à jour automatique par défaut ; mettez à niveau avec le gestionnaire de paquets lui-même |
| Passage obligatoire par npm | npm install -g @anthropic-ai/claude-code, nécessite Node.js 22+ | Réexécutez avec @latest |
# Homebrew (macOS, Linux) – mặc định không tự cập nhật
brew install --cask claude-code
# WinGet (Windows) – mặc định không tự cập nhật
winget install Anthropic.ClaudeCodeLa machine doit respecter les conditions suivantes (selon la page d’installation consultée le 3 octobre 2026) :
- Système d’exploitation : macOS 13.0 ou version ultérieure ; Windows 10 version 1809 ou ultérieure, ou Windows Server 2019 ou ultérieur ; Ubuntu 20.04+, Debian 10+ ou Alpine Linux 3.19+.
- Au moins 4 Go de RAM, processeur x64 ou ARM64. Windows 32 bits n’est pas pris en charge.
- Le shell doit être Bash, Zsh, PowerShell ou CMD, et une connexion Internet est nécessaire.
- Node.js n’est nécessaire qu’en cas d’installation via npm, et doit être en version 22 ou ultérieure.
Après l’installation, ne saisissez pas claude immédiatement dans l’ancienne fenêtre : celle-ci n’a pas encore pris en compte le nouveau PATH. Ouvrez un autre terminal, puis exécutez :
claude --version # in ra số phiên bản, kèm chữ (Claude Code)
claude doctor # chẩn đoán cài đặt và file cấu hình, không mở phiên làm việcSi claude --version affiche un numéro de version, l’installation est terminée ; toutes les erreurs ultérieures relèvent de la configuration. claude doctor est utile lorsque vous ne savez pas où se situe l’erreur, car il vérifie à la fois l’installation et les fichiers de paramètres sans ouvrir de session de travail.
Windows : cinq pièges fréquents
- Vous avez collé la mauvaise ligne de commande. PowerShell affiche
The token '&&' is not a valid statement separatorlorsqu’il reçoit la ligne de CMD ; CMD affiche'irm' is not recognized as an internal or external commandlorsqu’il reçoit celle de PowerShell. Regardez l’invite : si elle contientPS, utilisez la ligneirm; sinon, utilisez la ligneinstall.cmd. - Vous avez ouvert par erreur « Windows PowerShell (x86) ». Cette entrée du menu Démarrer est un processus 32 bits ; même sur une machine 64 bits, elle affiche donc
Claude Code does not support 32-bit Windows. Choisissez l’entrée qui ne contient pas (x86). - Les droits d’administrateur sont superflus. La documentation ne les exige pas et la version native s’installe dans le dossier de l’utilisateur :
%USERPROFILE%\.local\bin\claude.exe. - La saisie de
claudeaffiche « not recognized ». Le dossier précédent n’a pas été ajouté auPATH. Essayez d’abord un nouveau terminal ; si l’erreur persiste, utilisez le bloc PowerShell ci-dessous pour vérifier et ajouter le chemin. Sous macOS/Linux, l’erreur équivalente estcommand not found: claude, et le programme se trouve dans~/.local/bin/claude. - npm affiche
npm.ps1 cannot be loaded because running scripts is disabled on this system. La stratégie d’exécution de PowerShell bloque le script.ps1créé par npm. La documentation propose trois solutions : autoriser l’utilisateur actuel à exécuter localement les scripts avec la commandeSet-ExecutionPolicyci-dessous, appelernpm.cmdetclaude.cmdau lieu de la version.ps1, ou abandonner npm au profit de la commande native.
# 1. Kiểm tra thư mục cài đặt đã có trong PATH chưa
$env:PATH -split ';' | Select-String '\.local\\bin'
# 2. Không có kết quả nào? Thêm vào PATH của người dùng, rồi đóng và mở lại terminal
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
# 3. Trong terminal mới
claude --versionSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserNatif ou WSL ? Dự án sống trên Windows thì chạy native là đủ. Lúc đó Git for Windows là tùy chọn: có nó, Claude Code chạy lệnh qua Git Bash; không có, nó dùng PowerShell. Nếu Git đã cài mà Claude Code không thấy Git Bash, khai báo CLAUDE_CODE_GIT_BASH_PATH trong khối env của ~/.claude/settings.json, trỏ tới bash.exe (tài liệu lấy ví dụ C:\Program Files\Git\bin\bash.exe). Chọn WSL 2 khi bạn cần công cụ Linux hoặc muốn lệnh chạy trong sandbox, vì sandbox chỉ có trên WSL 2; Windows native và WSL 1 đều không có. WSL 1 chỉ là phương án khi máy không bật được WSL 2. Đã chọn WSL thì cài bằng dòng install.sh và chạy claude hoàn toàn trong terminal WSL.
Installation via npm : conditions et trois remarques
npm hợp lý khi bạn đã quản lý công cụ dòng lệnh bằng Node, hoặc khi mạng công ty chỉ cho tải gói qua registry npm. Điều kiện là Node.js 22 ou version ultérieure; con số Node 18 trong nhiều bài cũ không còn đúng. Đáng chú ý là Node cũ hơn không làm hỏng việc cài: npm chỉ in cảnh báo EBADENGINE, vì thứ thật sự chạy là một chương trình native mà gói npm tải về, không phụ thuộc Node. Máy chưa có Node thì lấy bản 22+ ở nodejs.org.
node -v # cần v22 trở lên
npm install -g @anthropic-ai/claude-code # không dùng sudo
# nâng cấp bằng @latest, không dùng npm update -g
npm install -g @anthropic-ai/claude-code@latest- N’utilisez pas
sudo npm install -g: la documentation avertit que cette méthode provoque des erreurs de permissions et constitue un risque de sécurité. - Passez à la dernière version avec
npm install -g @anthropic-ai/claude-code@latest;npm update -gn’est pas la méthode recommandée. - Le programme natif provient d’une dépendance facultative (le paquet
@anthropic-ai/claude-code-*correspondant à votre plateforme). L’option--omit=optional, la ligneoptional=falsedans.npmrcou--ignore-scriptsle rendront indisponible ; sous macOS/Linux, vous obtiendrezclaude native binary not installed.
Faut-il un VPN ? Erreur lors du téléchargement du script d’installation
Không cần. Việt Nam nằm trong liste des pays pris en charge par Anthropic cho cả Claude.ai lẫn API (kiểm tra ngày 3 octobre 2026). Chính VPN mới hay gây chuyện: theo page de résolution des problèmes d’installation (đọc ngày 3 octobre 2026), khi địa chỉ cài đặt trả về App unavailable in region, Claude Code không khả dụng ở nơi mà kết nối của bạn được nhìn thấy. Ở Việt Nam mà gặp dòng này thì tắt VPN hoặc proxy đặt ở nước khác rồi chạy lại.
Les deux erreurs restantes ont la même origine : syntax error near unexpected token '<' ou curl: (22) The requested URL returned error: 403 signifie qu’au lieu du script, vous avez reçu une page HTML ou un code d’erreur. Un réseau d’entreprise avec un proxy ou un pare-feu qui bloque le téléchargement de fichiers est le premier suspect. Ne passez pas immédiatement à Homebrew, WinGet ou npm : la documentation recommande d’abord de vérifier la connexion réseau, car les méthodes d’installation alternatives téléchargent elles aussi les fichiers depuis les mêmes serveurs. Essayez un autre réseau ou demandez au service informatique d’autoriser le téléchargement.
Configuration de la clé API : exécuter Claude Code sans forfait Pro/Max
Claude Code s’authentifie de l’une des deux manières suivantes. Le tableau ci-dessous propose une comparaison rapide ; la suite de l’article suit la colonne de droite.
| Connexion au compte Claude | Clé API Kunavo | |
|---|---|---|
| Conditions | Forfait Pro, Max, Team, Enterprise ou compte Console. Le forfait gratuit Claude.ai n’inclut pas Claude Code. | Une clé sk-kn-… placée dans une variable d’environnement. Aucun forfait à acheter, aucune connexion. |
| Facturation | Theo tháng: Pro 20 USD/tháng (17 USD/tháng nếu trả năm, tức 200 USD một lần), Max từ 100 USD/tháng, chưa gồm thuế (claude.com/pricing, đọc ngày 3 octobre 2026). | Selon les tokens réellement utilisés, déduits du solde prépayé à partir de 10 USD. Aucun frais mensuel, solde sans expiration, les requêtes en erreur ne sont pas facturées. |
| Paiement par | Mua trên web của Anthropic thì chỉ thẻ tín dụng hoặc ghi nợ (FAQ sur le paiement de Claude, đọc ngày 3 octobre 2026). | Cartes Visa, Mastercard, Link ; Apple Pay ou Google Pay si l’appareil les prend en charge. MoMo, ZaloPay et VNPay ne sont pas disponibles. |
| Ce qui manque | — | Remote Control et saisie vocale. Aucune facture TVA. |
Rediriger Claude Code vers un service autre qu’Anthropic n’est pas une astuce : la documentation officielle décrit ANTHROPIC_BASE_URL comme la variable permettant de remplacer le point de terminaison de l’API lors du passage par un proxy ou une passerelle. Kunavo utilise exactement le protocole Anthropic Messages API ; vous utilisez donc Claude Code tel quel, sans plugin ni correctif. Les six variables requises sont les suivantes :
| Variable | Valeur | À quoi cela sert, où est l’erreur |
|---|---|---|
ANTHROPIC_BASE_URL | https://api.kunavo.com | Uniquement le nom de domaine. Claude Code ajoute automatiquement /v1/messages ; si vous ajoutez /v1, la requête devient /v1/v1/messages et renvoie 404. |
ANTHROPIC_AUTH_TOKEN | Clé sk-kn-… | À envoyer dans l’en-tête Authorization: Bearer, actif immédiatement, sans étape de confirmation. |
ANTHROPIC_MODEL | claude-sonnet-5 | Modèle principal (Claude Sonnet 5). Le nom doit correspondre caractère par caractère à la liste de Kunavo ; les anciens noms avec un suffixe de date ne sont pas convertis automatiquement. |
ANTHROPIC_DEFAULT_OPUS_MODEL | claude-opus-5-5 | Épinglez l’alias opus (et opusplan en mode plan) vers Claude Opus 5.5, afin qu’il ne suive pas la dernière version d’Opus. Claude Code v2.1.280 ou ultérieur est requis ; avec une version antérieure, exécutez claude update. |
ANTHROPIC_DEFAULT_SONNET_MODEL | claude-sonnet-5 | Par défaut, l’alias sonnet pointe vers Sonnet 5.5, un modèle que Kunavo ne fournit pas. Sans épinglage, /model sonnet, la phase d’exécution de opusplan et le sous-agent défini avec model: sonnet renvoient tous 404. |
ANTHROPIC_DEFAULT_HAIKU_MODEL | claude-haiku-4-5 | L’alias haiku et les tâches d’arrière-plan de Claude Code utilisent tous ce modèle. |
Où définir les variables
La manière la plus simple de l’utiliser durablement est le bloc env dans le fichier de paramètres utilisateur, ~/.claude/settings.json (Windows : %USERPROFILE%\.claude\settings.json). Ce fichier s’applique à tous les projets ; s’il contient déjà des données, ajoutez uniquement le bloc 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"
}
}Si vous préférez le shell, ajoutez-les à ~/.zshrc ou ~/.bashrc. Sous Windows, le second extrait ci-dessous (les lignes $env:) convient pour un essai rapide, mais les variables disparaissent dès que vous fermez la fenêtre PowerShell.
export ANTHROPIC_BASE_URL=https://api.kunavo.com # chỉ tên miền, không thêm /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5# Chỉ có hiệu lực trong cửa sổ PowerShell này, đóng cửa sổ là mất
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claudeTrois choses à savoir avant de rencontrer un problème :
- Ne placez pas la clé dans le
.claude/settings.jsondu projet. Documentation de connexion à la passerelle nhắc rằng file này được commit, ai clone repo cũng có. - Le fichier de paramètres prime sur le shell. Si une variable existe aux deux endroits, la valeur du bloc
envdu fichier de paramètres est utilisée. Si une modification du shell ne produit aucun effet, vérifiez d’abord le fichier de paramètres. - La première exécution nécessite une clé au niveau utilisateur. En mode interactif, le bloc
envdans.claude/settings.jsonou.claude/settings.local.jsondu projet n’est pris en compte qu’après l’assistant initial et la question de confiance envers le dossier. Si la clé s’y trouve uniquement, l’écran de connexion s’affiche toujours au premier démarrage.
ANTHROPIC_AUTH_TOKEN ou ANTHROPIC_API_KEY, et le problème de « l’erreur 403 »
Kunavo đọc key ở cả Authorization: Bearer lẫn x-api-key, nên biến nào cũng kết nối được. Khác biệt nằm ở phía Claude Code. Theo documentation des variables d’environnement (đọc ngày 3 octobre 2026), ANTHROPIC_AUTH_TOKEN đi vào header Authorization với tiền tố Bearer và có hiệu lực ngay. ANTHROPIC_API_KEY đi vào header X-Api-Key, và ở chế độ tương tác Claude Code hỏi bạn một lần có dùng key này thay cho gói đăng ký không. Trả lời “không” thì key bị bỏ qua mà không hỏi lại; muốn bật lại thì vào /config, mục Utiliser une clé API personnalisée. Bài này chọn ANTHROPIC_AUTH_TOKEN chỉ để bỏ được bước hỏi đó.
Vài hướng dẫn tiếng Việt viết rằng ANTHROPIC_API_KEY khiến Claude Code phớt lờ ANTHROPIC_BASE_URL, gọi thẳng api.anthropic.com và nhận 403. Cả tài liệu biến môi trường lẫn documentation sur la connexion à une passerelle (đọc ngày 3 octobre 2026) đều không nói vậy: hai biến là hai cách đưa key tới cùng một gateway trong ANTHROPIC_BASE_URL. Nếu bạn thật sự gặp 403 sau khi đổi biến, hãy kiểm tra lại base URL và key thay vì đổi qua đổi lại tên biến.
Pourquoi épingler le modèle, et quel est le prix de chaque modèle
Alias của Claude Code không đứng yên. Theo documentation sur la configuration des modèles (đọc ngày 3 octobre 2026), với người dùng API, mô hình mặc định và alias opus đang trỏ tới Opus 5.5, alias sonnet trỏ tới Sonnet 5.5; tài liệu cũng nói alias “được cập nhật theo thời gian” và khuyên dùng tên đầy đủ hoặc các biến ANTHROPIC_DEFAULT_*_MODEL khi cần cố định. Tính đến ngày 3 octobre 2026, Kunavo có Opus 5.5 nhưng không có Sonnet 5.5. Hệ quả nếu bỏ qua bước ghim: phiên mặc định chạy Opus 5.5, đắt hơn Claude Sonnet 5; /model sonnet, giai đoạn thực thi của opusplan và subagent đặt model: sonnet trả về 404; và lần tới alias opus nhảy sang bản Opus mới, bản đó chưa chắc đã có trên Kunavo. Vì vậy đoạn cấu hình ở trên ghim alias sonnet vào claude-sonnet-5 bằng ANTHROPIC_DEFAULT_SONNET_MODEL, và ghim alias opus vào Opus 5.5 (claude-opus-5-5). Opus 5.5 cần Claude Code v2.1.280 trở lên; bản cũ hơn thì chạy claude update.
Prix sur Kunavo, par million de tokens (entrée / sortie) : Claude Sonnet 5 1,40 USD / 7,00 USD (tarifs d’Anthropic : 2,00 USD / 10,00 USD) ; Claude Opus 5.5 2,80 USD / 14,00 USD ; Claude Haiku 4.5 0,70 USD / 3,50 USD.
Vérification avec /status
Une fois ANTHROPIC_AUTH_TOKEN lu, la commande claude ouvre directement la session de travail, sans écran de connexion (selon la documentation de connexion à la passerelle, consultée le 3 octobre 2026) ; quelques étapes de configuration subsistent la première fois, comme la question de confiance envers le dossier. Si l’écran de connexion apparaît, la clé n’a pas été transmise. Dans la session, saisissez /status et recherchez :
Anthropic base URL:https://api.kunavo.com. Cette ligne n’apparaît que lorsqu’une adresse de passerelle est présente ; son absence signifie queANTHROPIC_BASE_URLn’a pas été transmis à la session.Auth token:ANTHROPIC_AUTH_TOKEN. Si cette section contientLogin methodavec un compte claude.ai, la session utilise toujours la connexion enregistrée.
Pour vérifier que la clé et l’adresse sont correctes avant d’ouvrir Claude Code, envoyez une requête test demandant exactement 1 token de sortie (cela coûte une très petite somme sur le solde). La commande lit les variables du shell actuel ; si la clé se trouve uniquement dans le fichier de paramètres, exécutez d’abord export dans ce terminal. Un résultat commençant par {"id":"msg_ est correct ; 401 signifie que la clé a été refusée.
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": "."}]}'Version PowerShell du même test ; en cas de succès, le champ id du résultat commence par 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": "."}]}'Ce que l’utilisation d’une clé API implique
- Remote Control et la saisie vocale nécessitent une identité claude.ai et ne fonctionnent donc pas lorsque
ANTHROPIC_AUTH_TOKENest actif. Remote Control est également désactivé lorsqueANTHROPIC_BASE_URLpointe vers un autre serveur queapi.anthropic.com. /fastindiqueFast mode has been disabled by your organization: selon la documentation de connexion à la passerelle, la vérification du mode rapide nécessite une connexion claude.ai ou une clé API Anthropic ; avec un bearer token, Claude Code considère donc la fonction comme désactivée et n’interroge pas le serveur.- MCP tool search est désactivé par défaut lorsque l’URL de base n’est pas celle d’Anthropic.
- Métriques dans
/contextlà ước tính: Kunavo không có endpoint/v1/messages/count_tokens, và theo documentation du protocole de passerelle (đọc ngày 3 octobre 2026), khi thiếu endpoint này Claude Code đếm token dựa trên số ký tự.
Les détails de l’intégration se trouvent dans la documentation d’intégration de Claude Code (en anglais) ; l’article correspondant en anglais est Install Claude Code.
Ajouter des fonds depuis le Vietnam : carte ou Link, pas de portefeuille électronique local
Soyons directs : Kunavo n’accepte pas MoMo, ZaloPay, VNPay ni les virements bancaires. Les cartes ATM nationales fonctionnant uniquement sur le réseau Napas ne sont pas acceptées non plus, car ce ne sont pas des cartes Visa ou Mastercard. La page de paiement Stripe de Kunavo propose les options suivantes aux acheteurs au Vietnam :
- Carte Visa ou Mastercard, de crédit ou de débit international.
- Link, ví của Stripe, lưu phương thức thanh toán để lần sau trả nhanh hơn (documentation de Link, đọc ngày 3 octobre 2026).
- Apple Pay ou Google Pay, chỉ xuất hiện trên thiết bị và trình duyệt đã thiết lập ví, vì chúng trả bằng thẻ có trong ví. Apple Pay có mặt ở Việt Nam từ 08/08/2023 và dùng được khi mua hàng trực tuyến (Apple Newsroom Vietnam, đọc ngày 3 octobre 2026).
Phía Anthropic cũng vậy: gói Claude mua trên web chỉ nhận thẻ tín dụng hoặc ghi nợ (FAQ sur le paiement de Claude, đọc ngày 3 octobre 2026), nên ví điện tử Việt Nam không trả trực tiếp được ở đó; gói mua trong ứng dụng iOS hay Android thì đi theo phương thức của App Store hoặc Google Play. Khác ở chỗ, tiền nạp vào Kunavo thành số dư API, và Claude Code trừ dần theo token sau khi bạn cấu hình key như trên.
Payer en VND ou en USD
Kunavo niêm yết giá bằng USD. Vì Việt Nam nằm trong các thị trường của Stripe Adaptive Pricing (đọc ngày 3 octobre 2026), trang thanh toán có thể hiện số tiền đã quy đổi sang VND, và con số chính xác luôn hiện ra trước khi bạn bấm xác nhận. Tỷ giá Stripe đưa ra đã cộng phí chuyển đổi 2–4%, người mua chịu. Chọn trả bằng USD thì không có khoản đó, nhưng ngân hàng phát hành thẻ có thể áp tỷ giá và phí của họ.
Trả bằng VND cũng chưa chắc rẻ hơn: một số ngân hàng thu phí khi thẻ thanh toán bằng VND cho đơn vị bán hàng đăng ký ở nước ngoài. Chẳng hạn Techcombank thu “phí giao dịch nội tệ ở nước ngoài” 1,1% số tiền giao dịch (đã gồm VAT) với thẻ ghi nợ Visa, áp dụng từ 13/08/2023 (FAQ de Techcombank, đọc ngày 3 octobre 2026). Đây chỉ là ví dụ của một ngân hàng, và Kunavo chưa xác minh được ngân hàng có xếp giao dịch của mình vào loại này hay không; xem biểu phí thẻ của bạn rồi hãy chọn VND hay USD.
Une carte refusée signifie généralement que les paiements en ligne ou internationaux ne sont pas activés dans l’application bancaire. Activez-les puis réessayez, ou passez à Link ou à Apple Pay/Google Pay avec une carte prise en charge par le portefeuille.
De l’inscription à l’obtention d’une clé
- Inscrivez-vous à Kunavo avec une adresse e-mail ou un compte Google ; cette étape ne demande pas de carte.
- Ouvrez Billing, puis choisissez le montant à ajouter (minimum 10 USD). Les montants supérieurs bénéficient d’un bonus : nạp 100 USD được 110 USD vào số dư; nạp 1.000 USD được 1.200 USD vào số dư; nạp 5.000 USD được 6.250 USD vào số dư.
- Sur la page Stripe, choisissez une carte, Link ou un portefeuille disponible sur votre appareil, vérifiez le montant et confirmez.
- Accédez à API Keys et créez une clé
sk-kn-…. La clé n’est affichée qu’une seule fois ; copiez-la donc immédiatement dansANTHROPIC_AUTH_TOKEN.
Pour ajouter automatiquement des fonds lorsque le solde devient faible, vous devez utiliser une carte enregistrée ou Link. Le solde n’expire pas et les requêtes échouées ne sont pas facturées. Kunavo n’émet pas de facture de TVA, y compris de facture électronique conforme à la réglementation vietnamienne ; l’historique des rechargements est disponible dans Billing. Ce solde est utilisable uniquement pour l’API Kunavo ; il ne permet pas de payer Claude Pro, Claude Max ou ChatGPT Plus.
Combien coûte environ une session de code ?
À chaque requête, Claude Code renvoie également tout le contexte de la conversation ; le coût dépend donc largement du cache : le contexte répété est facturé au tarif de lecture du cache, nettement moins élevé. Le tableau suivant est un calcul théorique fondé sur les hypothèses indiquées, et non une mesure réelle ni un plafond :
- 40.000 tokens d’entrée par requête : 36.000 tokens (90 %) lus depuis le cache, 4.000 tokens écrits dans le cache ;
- 1.000 tokens de sortie par requête ;
- une session de 50 requêtes, sans compter les exécutions en arrière-plan de Claude Haiku 4.5 ;
- avec Claude Sonnet 5 sur Kunavo, la lecture du cache coûte 10% du prix d’entrée et son écriture 1,25 fois le prix d’entrée ; chaque modèle du tableau utilise son propre taux.
| Modèle | Une requête | 50 requêtes | 50 requêtes, sans aucun accès au cache |
|---|---|---|---|
| Claude Sonnet 5 | 0,019 USD | 0,95 USD | 3,15 USD |
| Claude Opus 5.5 | 0,033 USD | 1,65 USD | 6,30 USD |
La dernière colonne montre l’importance du cache. Un contexte long, une réponse longue ou l’oubli de /clear entre deux tâches différentes font augmenter le montant. Comparez les abonnements à l’API et consultez les estimations mensuelles dans l’article Combien coûte Claude Code ; pour le prix de chaque modèle, consultez le tarif de l’API Claude ou la page des tarifs ; pour saisir vos propres données, utilisez l’outil de calcul du coût des tokens Claude (en anglais).
Diagnostiquer selon le message
| Quand | Ce qui s’affiche | Solution |
|---|---|---|
| Installation | The token '&&' is not a valid statement separator | Vous êtes dans PowerShell et avez collé une ligne CMD. Utilisez irm … | iex. |
| Installation | 'irm' is not recognized as an internal or external command | Vous êtes dans CMD et avez collé une ligne PowerShell. Utilisez la ligne install.cmd. |
| Installation | syntax error near unexpected token '<', 403, App unavailable in region | Vous recevez une page HTML au lieu du script. Désactivez le VPN/proxy situé dans un autre pays et essayez d’abord un autre réseau avant de changer de méthode d’installation (les autres méthodes téléchargent depuis le même serveur). |
| Installation | Claude Code does not support 32-bit Windows | PowerShell (x86) est ouvert. Ouvrez plutôt « Windows PowerShell ». |
| Installation (npm) | Avertissement EBADENGINE | Node.js est antérieur à 22. L’installation se termine, mais il est recommandé de mettre Node à niveau. |
| Installation (npm) | claude native binary not installed | Dépendance facultative manquante à cause de --omit=optional, optional=false ou --ignore-scripts. Supprimez ce paramètre, puis réinstallez. |
| Installation (npm) | npm.ps1 cannot be loaded | La stratégie d’exécution bloque le script. Exécutez Set-ExecutionPolicy ci-dessus, utilisez npm.cmd ou passez à la commande native. |
| Après l’installation | command not found: claude, 'claude' is not recognized | Le dossier d’installation n’est pas présent dans PATH. Ouvrez un nouveau terminal ; sous Windows, exécutez également l’extrait PowerShell PATH. |
| Configuration | L’écran de connexion s’affiche toujours | La clé n’a pas été lue. Placez-la dans le shell ou dans le ~/.claude/settings.json de l’utilisateur, et pas uniquement dans la configuration du projet ; ouvrez un nouveau terminal. |
| Configuration | 401 | Clé refusée : copie incomplète, espaces superflus, clé supprimée dans /app/keys ou placée dans la mauvaise variable. |
| Configuration | 404 | L’URL de base contient un /v1 superflu, ou le modèle n’existe pas sur Kunavo (généralement parce que l’alias sonnet n’est pas épinglé et pointe vers Sonnet 5.5). |
| Ajouter des fonds | Carte refusée | Activez les paiements en ligne et internationaux dans l’application bancaire ; les cartes uniquement compatibles avec Napas ne fonctionnent pas. Vous pouvez aussi essayer Link, Apple Pay ou Google Pay. |
Avant d’ajouter des fonds
- Seules les cartes Visa/Mastercard, Link et les portefeuilles utilisant une carte sont acceptés ; pas de MoMo, ZaloPay, VNPay ni de virement.
- L’ajout automatique ne fonctionne qu’avec une carte enregistrée ou Link. Kunavo n’émet pas de facture de TVA.
- Il s’agit d’une API facturée au token, et non d’un abonnement Claude Pro/Max : Remote Control et la saisie vocale ne sont pas disponibles,
/fastindique que le mode est désactivé et MCP tool search est désactivé par défaut. - À la date du 3 octobre 2026, Kunavo ne propose pas Sonnet 5.5 ; l’alias
sonnetnon épinglé renverra donc 404. - La documentation de Claude Code et la documentation d’intégration de Kunavo sont actuellement disponibles uniquement en anglais.
Foire aux questions
Claude Code est-il gratuit ? Que signifie « Claude Code ne nécessite pas de forfait » ?
Le téléchargement et l’installation de Claude Code sont gratuits, mais pour qu’il puisse répondre, vous avez besoin de l’une des deux options suivantes : vous connecter avec un forfait Claude payant (Pro, Max, Team, Enterprise) ou un compte Console, ou utiliser une clé API. Le forfait gratuit Claude.ai n’inclut pas Claude Code. « Ne nécessite pas de forfait » désigne la deuxième option : définir ANTHROPIC_BASE_URL=https://api.kunavo.com et ANTHROPIC_AUTH_TOKEN ; Claude Code ignore l’étape de connexion et déduit du solde Kunavo prépayé le montant correspondant aux tokens réellement utilisés, avec un minimum de 10 USD, sans frais mensuels.
Quelle est la commande d’installation de Claude Code sous Windows ? Faut-il installer WSL ou l’exécuter avec les droits d’administrateur ?
Ouvrez PowerShell (l’invite commence par PS) et exécutez irm https://claude.ai/install.ps1 | iex ; si vous êtes dans CMD, utilisez curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Les droits d’administrateur, WSL et Git ne sont pas nécessaires. Si Git for Windows est installé, Claude Code exécute les commandes via Git Bash ; sinon, via PowerShell. WSL 2 ne vaut la peine d’être installé que si vous avez besoin d’outils Linux ou souhaitez exécuter les commandes dans un bac à sable. Pensez à ouvrir « Windows PowerShell », et non l’entrée contenant (x86), car Claude Code ne fonctionne pas sous Windows 32 bits.
Quelle version de Node.js faut-il pour installer Claude Code avec npm ?
Node.js 22 ou une version ultérieure, selon la documentation officielle d’installation consultée le 3 octobre 2026. De nombreux anciens articles indiquent encore Node 18, mais ce nombre est obsolète. Une ancienne version de Node fait uniquement afficher l’avertissement EBADENGINE par npm ; l’installation réussit néanmoins, car le paquet npm télécharge en réalité un programme natif qui n’a pas besoin de Node pour fonctionner. La commande d’installation est npm install -g @anthropic-ai/claude-code (sans sudo) ; pour passer à la dernière version, réexécutez-la avec @latest plutôt que d’utiliser npm update -g. Si vous n’avez pas de raison particulière d’utiliser npm, la commande native reste plus simple.
Où saisir la clé API pour Claude Code ? ANTHROPIC_BASE_URL doit-elle inclure /v1 ?
L’emplacement le plus durable est le bloc env du fichier utilisateur ~/.claude/settings.json (Windows : %USERPROFILE%\.claude\settings.json), qui s’applique à tous les projets ; vous pouvez également l’exporter dans ~/.zshrc, ~/.bashrc ou $PROFILE de PowerShell. La base URL est uniquement https://api.kunavo.com, sans /v1, car Claude Code ajoute automatiquement /v1/messages ; un /v1 supplémentaire produirait /v1/v1/messages et une 404. Ne placez pas la clé dans le .claude/settings.json du projet : ce fichier se trouve dans le dépôt et est récupéré à chaque clonage.
Certains articles indiquent que l’utilisation de ANTHROPIC_API_KEY entraîne une 403. Est-ce exact ?
Non, ce n’est pas exact selon la documentation officielle. ANTHROPIC_API_KEY et ANTHROPIC_AUTH_TOKEN sont tous deux envoyés à l’adresse indiquée dans ANTHROPIC_BASE_URL ; la différence concerne l’en-tête (X-Api-Key contre Authorization: Bearer) et le fait que ANTHROPIC_API_KEY doit être autorisée une fois par l’utilisateur en mode interactif. Kunavo lit la clé dans les deux en-têtes. Cet article recommande ANTHROPIC_AUTH_TOKEN uniquement parce qu’il peut être utilisé immédiatement. Si vous avez refusé lors de cette demande, la clé est ignorée sans nouvelle question ; accédez à /config, puis à l’option Use custom API key pour la réactiver.
Quel modèle Claude Code utilise-t-il si ANTHROPIC_MODEL n’est pas défini ?
Il utilise un alias, et les alias évoluent progressivement avec le temps. La documentation de configuration des modèles (consultée le 3 octobre 2026) indique que, pour les utilisateurs de l’API, le modèle par défaut et l’alias opus sont actuellement Opus 5.5, tandis que l’alias sonnet est Sonnet 5.5. Kunavo propose Opus 5.5 mais pas Sonnet 5.5 ; une session non verrouillée utilisera donc Opus 5.5 à un tarif supérieur de Claude Sonnet 5, tandis que /model sonnet, la phase d’exécution d’opusplan et les sous-agents configurés avec model: sonnet renverront tous une 404. En définissant ANTHROPIC_MODEL=claude-sonnet-5, ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5, ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 et ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5, vous savez exactement quel modèle est facturé à chaque tour. Pour verrouiller l’alias opus sur Opus 5.5, il faut Claude Code v2.1.280 ou une version ultérieure ; avec une version plus ancienne, exécutez claude update.
Que signifie l’affichage de /status lorsqu’il est exécuté avec une clé API ?
Deux lignes : « Anthropic base URL » vaut https://api.kunavo.com et « Auth token » indique ANTHROPIC_AUTH_TOKEN. Si vous voyez à la place « Login method » avec un compte claude.ai, la session utilise encore l’ancienne connexion ; quittez Claude Code, ouvrez un nouveau terminal et vérifiez où la variable a été définie. Vous pouvez tester la clé avant même d’ouvrir Claude Code avec une commande curl envoyée à /v1/messages, avec max_tokens à 1 : si le JSON renvoyé commence par {"id":"msg_, tout est en ordre ; 401 signifie que la clé a été refusée.
Au Vietnam, faut-il un VPN pour installer ou utiliser Claude Code ?
Non. Le Vietnam figure dans la liste des pays pris en charge par Anthropic pour Claude.ai comme pour l’API (vérifiée le 3 octobre 2026). À l’inverse, si le VPN fait passer la connexion par un pays non pris en charge, l’adresse d’installation peut renvoyer une page « App unavailable in region » au lieu du script. Si cette erreur survient alors que vous êtes au Vietnam, désactivez le VPN ou le proxy, puis relancez la commande d’installation.
Peut-on recharger avec MoMo, ZaloPay ou VNPay ? Des factures TVA sont-elles émises ?
Ni l’un ni l’autre. La page de paiement Stripe de Kunavo permet aux acheteurs au Vietnam de choisir une carte Visa, Mastercard ou Link, ainsi qu’Apple Pay ou Google Pay si l’appareil les a configurés ; MoMo, ZaloPay, VNPay et le virement bancaire ne sont pas disponibles. Le montant peut être affiché en VND ; dans ce cas, le taux de change de Stripe inclut les frais de conversion de 2–4 % à la charge de l’acheteur. Si vous choisissez de payer en USD, ces frais ne s’appliquent pas, mais votre banque peut appliquer son propre taux et ses propres frais. Recharge minimale de 10 USD, solde sans expiration ; la recharge automatique ne fonctionne qu’avec une carte enregistrée ou Link. Kunavo n’émet pas de facture TVA, y compris de facture électronique.