Installation de Claude Code : étape par étape sur Windows, macOS et Linux, clé API sans abonnement et paiement par carte

Réponse courte : Claude Code s’installe avec une seule ligne adaptée à votre terminal. Sur macOS, Linux et WSL, exécutez install.sh, dans Windows PowerShell irm … | iex, et dans l’invite de commandes (CMD) install.cmd ; les trois lignes figurent juste en dessous. Cette méthode ne nécessite pas Node.js ; si vous souhaitez utiliser npm, Node.js 22 ou une version ultérieure est requis. Après l’installation, deux options s’offrent à vous : vous connecter avec un compte Claude (Pro, Max, Team, Enterprise ou Console ; le forfait gratuit n’inclut pas Claude Code) ou utiliser une clé API sans abonnement. Avec la clé, définissez ANTHROPIC_BASE_URL=https://api.kunavo.com (sans ajouter /v1 à la fin), ANTHROPIC_AUTH_TOKEN et les quatre variables qui fixent les modèles ; /status indique dans la session si la clé est active. Seuls les tokens consommés sont facturés. Vous rechargez le solde avec une carte Visa ou Mastercard, Apple Pay, Google Pay ou Link, pour un minimum de 10 USD ; le paiement en plusieurs fois et Papara ne sont pas disponibles.

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

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

:: Windows – Komut İstemi (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Bu satırları ve aşağıdaki değişken adlarını Claude Code'un installation ve connexion à la passerelle belgelerinden 3 octobre 2026 tarihinde aldık. Anthropic bu belgeleri Türkçe yayımlamıyor; hata mesajlarını bu yüzden İngilizce asıllarıyla veriyoruz. Kunavo fiyatlarını ve ödeme yöntemlerini en son 3 octobre 2026 tarihinde kontrol ettik. VPN ya da yurt dışı proxy'si aramanıza gerek yok: page des pays pris en charge par Anthropic Türkiye'yi hem Claude.ai hem API için sayıyor (kontrol: 3 octobre 2026).

Quelle ligne utiliser dans quel terminal ?

La plupart des problèmes d’installation viennent du terminal utilisé, et non de la commande. Le tableau ci-dessous associe votre environnement à la bonne ligne. Si vous utilisez Windows, nous expliquons dans la section suivante comment identifier votre terminal.

Configuration requise

Exigences de la documentation officielle d’installation (à la date du 3 octobre 2026) :

• Système d’exploitation : macOS 13.0 ou version ultérieure ; Windows 10 version 1809 et ultérieure, ou Windows Server 2019 et ultérieur ; sous Linux, Ubuntu 20.04, Debian 10 et Alpine Linux 3.19 ou versions ultérieures.
• Matériel : au moins 4 Go de RAM et un processeur x64 ou ARM64. Windows 32 bits n’est pas pris en charge.
• Shell : Bash, Zsh, PowerShell ou CMD.
• Node.js : inutile pour l’installateur natif ; requis uniquement pour npm, en version 22 ou ultérieure.
• Compte : si vous vous connectez, un compte Pro, Max, Team, Enterprise ou Console. Avec une clé API, ni abonnement ni connexion ne sont nécessaires.

Certaines explications en turc circulant sur Internet recopient une ancienne version de cette liste : certaines indiquent encore Node.js 18 pour npm, Ubuntu 18.04 ou CentOS 7 pour Linux. La documentation actuelle donne Node.js 22 et Ubuntu 20.04 comme versions minimales. L’avertissement selon lequel « chaque étape échoue sans proxy fixe situé aux États-Unis » ne s’applique pas non plus à la Turquie ; au contraire, un VPN ouvert peut provoquer une erreur de région (consultez les erreurs de téléchargement dans la section macOS et Linux).

Installation de Claude Code sous Windows

Sous Windows, vous n’avez besoin ni des droits d’administrateur, ni de WSL, ni de Git. La documentation officielle ne demande pas d’ouvrir le terminal en tant qu’administrateur ; vous pouvez ignorer l’étape « exécutez PowerShell en tant qu’administrateur » présente dans certaines vidéos turques. La seule chose à savoir est le terminal utilisé :

• Si l’invite commence par PS C:\Users\KullaniciAdi>, comme PS, vous êtes dans PowerShell : utilisez la ligne irm … | iex.
• Si elle ne commence pas par PS et affiche uniquement C:\Users\KullaniciAdi>, vous êtes dans l’invite de commandes : utilisez la ligne install.cmd.
• N’ouvrez pas l’entrée « Windows PowerShell (x86) » du menu Démarrer. Comme il s’agit d’un processus 32 bits, elle affiche aussi l’erreur Claude Code does not support 32-bit Windows sur un ordinateur 64 bits ; choisissez « Windows PowerShell » sans suffixe.

Coller la mauvaise ligne dans la mauvaise fenêtre est l’une des principales causes d’erreurs sous Windows, et les messages ne l’indiquent pas clairement. Une ligne CMD collée dans PowerShell renvoie The token '&&' is not a valid statement separator. Une ligne PowerShell collée dans CMD affiche, sous Windows en turc, « 'irm' iç ya da dış komut, çalıştırılabilir program ya da toplu iş dosyası olarak tanınmıyor. » (sur un système en anglais : 'irm' is not recognized as an internal or external command). Si vous essayez la ligne curl … | bash de macOS dans PowerShell, vous verrez A parameter cannot be found that matches parameter name 'fsSL' ou 'bash' is not recognized as the name of a cmdlet ; sur un système en turc, ces messages peuvent être en turc. Dans les trois cas, la solution est la même : utilisez la ligne correspondant au terminal ouvert.

Git for Windows et WSL sont-ils nécessaires ?

İkisi de isteğe bağlı. Git for Windows kuruluysa Claude Code kabuk komutlarını onunla gelen Git Bash'te çalıştırır, değilse PowerShell aracına geçer; belge Git'i öneriyor ama şart koşmuyor. Git kurulu olduğu hâlde Git Bash bulunamıyorsa ~/.claude/settings.json dosyasının env bloğunda CLAUDE_CODE_GIT_BASH_PATH değişkenine bash.exe dosyasının tam yolunu verin (belgedeki örnek: C:\Program Files\Git\bin\bash.exe).

Il y a deux raisons de choisir WSL : avoir besoin d’outils Linux ou vouloir exécuter les commandes dans un environnement isolé (sandbox). L’installation native sous Windows ne dispose pas de sandbox :

Si vous restez dans WSL, effectuez l’installation et l’utilisation dans le terminal WSL : la ligne macOS/Linux y fonctionne, et claude s’y lance également.

La commande « claude » est introuvable

Si, une fois l’installation terminée, vous voyez 'claude' is not recognized (ou command not found: claude sur macOS et Linux), vous travaillez probablement dans une fenêtre ouverte avant l’installation : l’installateur met à jour la variable PATH, mais l’ancien terminal ne la voit pas. Fermez d’abord le terminal et rouvrez-le. Sous Windows, le programme se trouve dans %USERPROFILE%\.local\bin\claude.exe, et sous macOS et Linux dans ~/.local/bin/claude. Si une nouvelle fenêtre ne suffit pas sous Windows, ajoutez le dossier à votre variable utilisateur PATH avec les commandes de la documentation :

# 1. Kurulum klasörü PATH içinde mi?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sonuç yoksa kullanıcı PATH'ine ekleyin, terminali kapatıp yeniden açın
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Yeni terminalde
claude --version

npm.ps1 cannot be loaded

Ce message n’apparaît qu’avec la méthode npm : npm crée un lanceur .ps1 pour PowerShell, que la politique d’exécution des scripts du système bloque. La documentation propose trois solutions : exécuter les commandes sous les noms npm.cmd et claude.cmd, passer à l’installateur natif dans PowerShell, ou autoriser les scripts locaux uniquement pour votre utilisateur :

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Installation sous macOS et Linux

La ligne install.sh ci-dessus figure dans la documentation officielle sous l’onglet « Native Install (Recommended) » et fonctionne également telle quelle dans WSL. Claude Code installé de cette manière télécharge lui-même les nouvelles versions en arrière-plan. Si vous préférez utiliser un gestionnaire de paquets, Homebrew et WinGet sont aussi des options officielles ; toutefois, selon la documentation, ces installations ne se mettent pas à jour automatiquement par défaut, et vous devez obtenir la nouvelle version via le gestionnaire de paquets :

# Homebrew – stable kanalı; varsayılan olarak kendini güncellemez
brew install --cask claude-code

# WinGet (Windows) – varsayılan olarak kendini güncellemez
winget install Anthropic.ClaudeCode

Si vous recevez du HTML ou une erreur 403 à la place du script

syntax error near unexpected token '<' mesajı, bash'e betik yerine bir HTML sayfasının gittiğini gösterir; curl: (22) The requested URL returned error: 403 ise sunucunun indirmeyi reddettiğini. Documentation sur les problèmes d’installation (kontrol: 3 octobre 2026) ikisini de yükleyici adresinin betik döndürmemesine bağlıyor. Sayfada App unavailable in region yazıyorsa istek, belgeye göre Claude Code'un sunulmadığı bir ülkeden gelmiş görünüyor. Türkiye listede olduğuna göre bu mesajı Türkiye'den alıyorsanız trafiğiniz büyük ihtimalle bir VPN ya da proxy üzerinden başka bir ülkeye çıkıyordur; kapatıp yeniden deneyin. İçeriksiz bir 403 genellikle şirket proxy'sinden ya da güvenlik duvarından gelir: başka bir ağdan deneyin veya BT ekibinizden bu adrese izin vermesini isteyin.

Installation avec npm : Node.js 22 requis

npm yolu kaldırılmadı, resmi belgede hâlâ anlatılıyor; ama paketin istediği sürüm artık Node.js 22 ve üstü. node -v daha eski bir sürüm gösteriyorsa npm kurulumu durdurmaz, yalnızca bir EBADENGINE uyarısı basar. Yine de en temizi Node.js'i nodejs.org üzerinden 22 veya üstüne yükseltmek.

node -v                                    # v22 veya üstü olmalı
npm install -g @anthropic-ai/claude-code   # sudo kullanmadan

# güncelleme: npm update -g değil, @latest
npm install -g @anthropic-ai/claude-code@latest

Trois habitudes provoquent des problèmes avec cette méthode :

• Installer avec sudo. La documentation avertit des problèmes de permissions et des risques de sécurité liés à sudo npm install -g.
• Mettre à jour avec npm update -g. La bonne commande est npm install -g @anthropic-ai/claude-code@latest.
• Désactiver les dépendances facultatives. L’exécutable principal est fourni comme dépendance facultative dans un paquet @anthropic-ai/claude-code-* spécifique à la plateforme. L’indicateur --omit=optional ou optional=false dans .npmrc ignore ce paquet : l’installation se termine sans erreur, mais sous macOS et Linux, claude native binary not installed affiche claude au démarrage.

L’installation a-t-elle fonctionné ?

Quelle que soit la méthode choisie, ouvrez un nouveau terminal et exécutez ces deux commandes :

claude --version   # sürüm numarasını yazar, ör. 2.1.211 (Claude Code)
claude doctor      # oturum açmadan kurulum ve ayar teşhisi

Si claude --version affiche un numéro de version, le programme est bien installé. claude doctor répertorie, sans connexion, l’état de l’installation et les problèmes présents dans les fichiers de configuration ; si quelque chose tourne mal à l’étape suivante, vous pourrez ainsi déterminer si le problème vient de l’installation ou de la configuration.

Sans abonnement : définir une clé API pour Claude Code

Au premier lancement, claude demande une authentification. Si vous avez un forfait Claude, connectez-vous et poursuivez ; si vous n’en avez pas ou préférez payer selon votre utilisation plutôt qu’un montant mensuel fixe, exécutez Claude Code avec une clé API. Différence entre les deux méthodes :

La méthode par clé correspond à une configuration prévue par Anthropic : ANTHROPIC_BASE_URL est la variable intégrée à Claude Code, et la documentation officielle de la passerelle explique comment faire fonctionner Claude Code derrière un proxy ou une passerelle avec cette variable. Vous n’installez ni extension, ni correctif, ni client modifié. Sous macOS et Linux, ajoutez les six lignes à votre fichier shell (~/.zshrc ou ~/.bashrc) :

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # yalnızca alan adı, /v1 yok
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

Sous Windows, testez d’abord les paramètres dans une seule session PowerShell avant de les rendre permanents ; lorsque la fenêtre se ferme, les variables disparaissent également :

# Yalnızca bu PowerShell penceresinde geçerli – pencereyi kapatınca kaybolur
$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

Pour les appliquer à chaque terminal, écrivez les mêmes valeurs dans le bloc env du fichier de paramètres utilisateur. Selon la documentation, ce fichier s’applique à tous vos projets ; sous Windows, son emplacement est %USERPROFILE%\.claude\settings.json. Le chemin %APPDATA%\Claude\settings.json mentionné dans certains résumés générés par IA ne correspond pas à la documentation officielle. Si le fichier existe déjà, ajoutez uniquement le bloc env sans supprimer son contenu :

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

Les six variables et les points d’attention

ANTHROPIC_AUTH_TOKEN ou ANTHROPIC_API_KEY ? Kunavo accepte la clé dans les deux en-têtes : Authorization: Bearer et x-api-key. La différence concerne le comportement de Claude Code. ANTHROPIC_AUTH_TOKEN est envoyé dans l’en-tête Bearer et fonctionne sans poser de question. ANTHROPIC_API_KEY, en revanche, est envoyé dans l’en-tête x-api-key et demande votre confirmation la première fois en mode interactif ; si vous répondez « non », la clé est ignorée sans avertissement et vous devez aller dans /config → Use custom API key pour la réactiver. C’est pour cette raison que nous utilisons ANTHROPIC_AUTH_TOKEN dans ce guide.

Pourquoi verrouillons-nous les modèles ? au document de configuration des modèles göre (kontrol: 3 octobre 2026) API ile çalışan Claude Code, hiçbir şey ayarlanmamışsa varsayılan model ve opus takma adı için Opus 5.5'i, sonnet takma adı için Sonnet 5.5'i ister; Anthropic yeni model çıkardıkça bu takma adlar da kayar. Kunavo 3 octobre 2026 itibarıyla Sonnet 5.5'i sunmuyor, dolayısıyla sabitlenmemiş bir sonnet isteği 404 ile döner. Claude Opus 5.5 Kunavo'da çalışıyor, ama tarifesi ($2,80 / $14,00) Claude Sonnet 5 tarifesinden ($1,40 / $7,00) yüksek; sabitlemezseniz farkında olmadan daha pahalı modelle çalışırsınız. Yukarıdaki blokta ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 satırı bu yüzden var: /model sonnet, opusplan'ın yürütme aşaması ve model: sonnet olarak ayarlanmış alt ajanlar Sonnet 5.5 yerine Claude Sonnet 5 ile çalışır. opus takma adını ise Claude Opus 5.5 modeline (claude-opus-5-5) sabitliyoruz; bu model Claude Code v2.1.280 veya üstünü ister, eski bir sürümdeyseniz claude update çalıştırın.

Tarifs de Kunavo (entrée / sortie, par million de tokens) : Claude Sonnet 5 $1,40 / $7,00 (tarifs Anthropic : $2,00 / $10,00) ; Claude Opus 5.5 $2,80 / $14,00 ; Claude Haiku 4.5, qui prend en charge les tâches en arrière-plan, $0,70 / $3,50.

Où ne faut-il pas saisir la clé, et quelle valeur prend-elle ?

Projenin kendi .claude/settings.json dosyası anahtar için yanlış yer: document de la passerelle bu dosyanın depoya commit edildiğini hatırlatıyor, yani anahtar depoyu klonlayan herkese gider. Aynı değişken hem kabukta hem ayar dosyasının env bloğunda tanımlıysa çoğu durumda ayar dosyasındaki geçerli olur; kabukta değiştirdiğiniz bir değer etki etmiyorsa önce oraya bakın. Ayar dosyasındaki model anahtarı bu kuralın dışında: ANTHROPIC_MODEL değişkeni ondan önce gelir, model yalnızca değişken yoksa kullanılır. VS Code eklentisinde değişkenler, VS Code kullanıcı ayarlarındaki claudeCode.environmentVariables alanına girer.

Premier lancement et vérification avec /status

Si les variables sont au bon endroit, la commande claude ouvre la session sans afficher l’écran de connexion ; c’est ainsi que le document de la passerelle (vérification : 3 octobre 2026) décrit le comportement lorsque ANTHROPIC_AUTH_TOKEN est configuré. Si l’écran de connexion apparaît, Claude Code n’a pas vu la clé. La cause la plus fréquente est que la clé se trouve uniquement dans les paramètres du projet : en mode interactif, le bloc env du fichier .claude/settings.json ou .claude/settings.local.json du projet n’est lu qu’après l’assistant de premier démarrage et la question de confiance envers le dossier. La clé doit se trouver à un emplacement lu avant l’assistant : export dans le shell, ~/.claude/settings.json au niveau utilisateur ou dans les paramètres gérés (managed settings).

Une fois connecté, saisissez /status. Deux lignes fournissent les informations essentielles :

• Anthropic base URL : elle n’apparaît que si une adresse personnalisée est définie et doit afficher https://api.kunavo.com. Si la ligne est absente, ANTHROPIC_BASE_URL n’a pas atteint la session.
• Auth token : si le nom ANTHROPIC_AUTH_TOKEN apparaît à côté, les requêtes utilisent la clé API. Si une ligne Login method indiquant votre compte claude.ai apparaît à la place, Claude Code utilise encore la connexion enregistrée ; déconnectez-vous, ouvrez un nouveau terminal et vérifiez où vous avez placé les variables.

Tester sans ouvrir Claude Code

Vous pouvez également tester l’adresse et la clé indépendamment de Claude Code. La méthode du document officiel consiste à envoyer une requête avec un seul token de sortie ; un très petit montant est déduit de votre solde. La commande lit les variables dans le shell actuel ; si la clé se trouve uniquement dans le fichier de paramètres, exécutez d’abord export dans ce terminal. Si la réponse commence par {"id":"msg_, l’adresse et la clé sont valides ; 401 indique 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": "."}]}'

L’équivalent PowerShell est présenté ci-dessous ; en cas de réussite, la réponse contient un champ id commençant 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": "."}]}'

Qu’est-ce qui change avec une clé API ?

• Remote Control et la dictée vocale ne sont pas disponibles. Selon le document, les deux nécessitent une identité claude.ai et ne fonctionnent pas lorsqu’un ANTHROPIC_API_KEY, un ANTHROPIC_AUTH_TOKEN ou un apiKeyHelper est actif. Depuis v2.1.196, Remote Control est également désactivé lorsque ANTHROPIC_BASE_URL pointe vers un serveur autre qu’Anthropic.
• /fast apparaît comme désactivé. Selon le document, lorsque seul un bearer token est défini, Claude Code ne demande pas l’état du mode rapide (fast mode) et le considère comme désactivé.
• La recherche d’outils MCP est désactivée par défaut. document MCP (kontrol: 3 octobre 2026) özel bir ANTHROPIC_BASE_URL ayarını, tool search kullanılmayan yapılandırmalar arasında sayıyor.
• Les chiffres de /context sont approximatifs. Kunavo /v1/messages/count_tokens uç noktasını sunmuyor; bu durumda Claude Code, au document de compatibilité de la passerelle göre (kontrol: 3 octobre 2026) bağlam kullanımını karakter sayısından tahmin eder.

Les détails techniques de l’intégration sont présentés dans le document d’intégration de Claude Code en anglais ; l’équivalent anglais de ce guide est Install Claude Code.

Paiement depuis la Turquie : carte, Apple Pay, Google Pay, Link

Burada ödediğiniz şey bir abonelik değil, Claude Code'un token başına harcadığı ön ödemeli API bakiyesi. Anthropic'in sitesinden alınan Pro ve Max ise yalnızca kredi veya banka kartıyla ödenebiliyor (FAQ des forfaits Claude payants, kontrol: 3 octobre 2026). Kunavo'ya yaptığınız yükleme bu planların yerine geçmez ve onları ödemez. Adımlar:

1. Inscrivez-vous à Kunavo. Une adresse e-mail ou un compte Google suffit ; aucune carte bancaire n’est demandée lors de l’inscription.
2. Sur la page Billing, sélectionnez le montant. Le minimum est de 10 USD ; il n’y a ni abonnement ni frais mensuels. Les montants élevés bénéficient d’un bonus : 100 USD yükleyene 110 USD bakiye, 1.000 USD yükleyene 1.200 USD bakiye, 5.000 USD yükleyene 6.250 USD bakiye.
3. La page de paiement Stripe s’ouvre. Choisissez une carte (Visa, Mastercard), Apple Pay, Google Pay ou Link ; Apple Pay et Google Pay ne sont proposés que sur les appareils et navigateurs qui les prennent en charge.
4. Ensuite, sur la page API Keys, créez une clé commençant par sk-kn-. La clé n’est affichée qu’une seule fois ; copiez-la et saisissez-la immédiatement comme valeur de ANTHROPIC_AUTH_TOKEN.

Le montant s’affiche-t-il en livres turques ou en dollars ?

Kunavo fiyatları dolar cinsinden; ödeme sayfasında hangi para biriminin gösterileceğine Stripe karar verir ve tutar TL olarak da çıkabilir. document de Stripe sur Adaptive Pricing (kontrol: 3 octobre 2026) Türkiye'yi desteklenen pazarlar arasında sayıyor ve bu çevrimde kura %2–4 arası, alıcının ödediği bir ücret eklendiğini yazıyor. Dolarla ödemeyi seçerseniz bu ücret olmaz; o zaman kartınızın bankası kendi döviz kurunu ve varsa yurt dışı işlem ücretini uygular. Para birimi hangisi olursa olsun, kesin tutarı onaylamadan önce ödeme sayfasında görürsünüz.

Paiement échelonné, Papara, virement bancaire et Troy

• Aucun paiement échelonné : le paiement est effectué en une seule fois. Türk kartlarıyla yurt dışı sitelerden yapılan harcamalar sonradan da taksite bölünemiyor (enuygunfinans.com, kontrol: 3 octobre 2026).
• Papara, les virements bancaires/EFT et PayPal ne sont pas disponibles. Ces options n’apparaissent pas sur la page de paiement.
• Troy : Stripe'ın marques de cartes prises en charge sayfasında Troy geçmiyor (kontrol: 3 octobre 2026). Visa ya da Mastercard logolu bir kartla ödeyin.
• Aucune facture. Kunavo n’émet aucune facture, y compris une facture e-Arşiv ; le détail de vos rechargements figure sur la page Billing.

Si la carte est refusée, consultez d’abord l’application mobile de votre banque : la carte doit être autorisée pour les achats en ligne et les opérations internationales. Le rechargement automatique peut être configuré uniquement avec une carte enregistrée ou Link. Le solde n’expire pas et les requêtes échouées ne sont pas facturées. Les tarifs de tous les modèles figurent dans le guide Tarifs de l’API Claude.

Combien coûte une session de travail ?

Avec une clé, le coût dépend entièrement du nombre de tokens. Claude Code renvoie le contexte de la conversation depuis le début à chaque requête ; lorsque la partie initiale inchangée du contexte est lue depuis le cache, elle est facturée à un tarif bien inférieur. Le tableau ci-dessous n’est pas une mesure, mais un calcul fondé sur des hypothèses explicites ; il ne doit pas non plus être considéré comme une limite supérieure. Hypothèses :

• 40.000 tokens d’entrée par requête ; 36.000 de ceux-ci ( 90 %) sont lus depuis le cache et les 4.000 restants sont écrits dans le cache ;
• 1.000 tokens de sortie par requête ;
• 50 requêtes dans la session ; les Claude Haiku 4.5 appels en arrière-plan ne sont pas pris en compte ;
• Pour Claude Sonnet 5, la lecture depuis le cache représente %10 du tarif d’entrée et l’écriture dans le cache représente 1,25 fois ce tarif. Chaque modèle du tableau a été calculé avec ses propres tarifs.

Gerçek tutarı bağlamın uzunluğu, önbellek isabeti, yanıtların uzunluğu ve konu değiştirirken sohbeti temizleyip temizlemediğiniz belirler. Document officiel sur les coûts (kontrol: 3 octobre 2026) iki ayrıntı ekliyor: Claude Code siz bir şey yazmasanız da arka planda az miktarda token harcar, genellikle oturum başına 0,04 dolardan az; API anahtarında önbellek ömrü varsayılan olarak beş dakika, dolayısıyla daha uzun bir aradan sonraki ilk mesaj önbelleği ıskalar ve bağlamın tamamı yeniden işlenir. Konu değiştirirken /clear, uzun oturumlarda /compact bu maliyeti düşürür.

Tous les tarifs figurent sur la page des tarifs. Vous pouvez estimer votre propre utilisation avec le calculateur de coût des tokens Claude (en anglais). Le guide Tarif de Claude Code examine s’il est préférable de choisir un abonnement ou l’API.

Messages d’erreur et solutions

Limites à connaître

• Kunavo n’émet pas de factures ; il n’y a pas non plus de facture e-Arşiv.
• Le paiement est effectué en une seule fois : pas de paiement échelonné, Papara ni virement bancaire/EFT. Un rechargement automatique nécessite une carte enregistrée ou Link.
• Il ne s’agit pas d’un abonnement Claude Pro ou Max, mais d’une API facturée par token. Avec une clé, Remote Control et la dictée vocale ne fonctionnent pas, /fast apparaît comme désactivé et la recherche d’outils MCP est désactivée par défaut.
• Kunavo ne propose pas Sonnet 5.5 au 3 octobre 2026 ; si les modèles ne sont pas verrouillés, l’alias sonnet renvoie 404.
• La documentation officielle de Claude Code et le document d’intégration de Kunavo sont uniquement en anglais (vérification : 3 octobre 2026).

Foire aux questions