Tutoriel Claude Code — utilisation quotidienne avec une clé facturée à l'usage : changer de modèle, calculer les coûts et gérer le contexte

Claude Code s’utilise en quatre étapes : exécutez claude dans le dossier du projet, lancez une fois /init pour générer CLAUDE.md, décrivez la tâche en chinois en indiquant le chemin du fichier, puis examinez les modifications proposées avant de décider de les accepter. C’est un assistant de programmation dans le terminal : il lit et modifie les fichiers et exécute les tests, en vous demandant votre accord avant d’agir. Vous pouvez vous connecter avec un abonnement Pro/Max ou configurer une clé API facturée à l’usage ; avec une clé, chaque étape est facturée selon les tokens, et l’usage quotidien repose donc sur trois principes : changer de modèle selon la tâche, connaître le coût d’une session et garder le contexte concis.

Les tutoriels Claude Code en ligne supposent presque tous une connexion par abonnement. Cette page s’adresse à un autre profil : les personnes sans abonnement ou qui ne veulent pas être limitées par une fenêtre d’utilisation de 5 heures et préfèrent une clé facturée à l’usage. Si vous ne l’avez pas encore installé, consultez d’abord le tutoriel d’installation de Claude Code, puis revenez ici après l’installation et la connexion.

Première prise en main : quatre actions

# 1. 一定要在專案資料夾裡啟動——它能看、能改的範圍就是這個資料夾
cd ~/work/my-app
claude

# 2. 第一個指令：讀過整個 repo，產生 CLAUDE.md
> /init

# 3. 之後直接用中文交代任務，附上檔案路徑最準
> 把 src/api/user.ts 的輸入驗證改用 zod，測試也一起修好

# 4. 牽涉很多檔案的任務，先按 Shift+Tab 切到計畫模式，確認做法再動手

Il vous demande confirmation chaque fois qu’il doit modifier un fichier ou exécuter une commande. Si la direction est mauvaise, appuyez sur Échap pour l’arrêter, puis utilisez /rewind pour revenir au point de contrôle précédent ; le code et la conversation sont restaurés ensemble. Le CLAUDE.md généré par /init n’est qu’un brouillon ; une section ci-dessous explique comment le raccourcir.

Facturation d’une session avec une clé API

À chaque requête, Claude Code renvoie l’instruction système, CLAUDE.md, toute la conversation et le contenu des fichiers déjà lus, puis ajoute le nouveau contenu à la fin. La partie inchangée passe par le cache : les lectures du cache sont facturées à 10 % du prix d’entrée et les écritures à 1,25 fois ce prix. Dans une session, la majeure partie de la facture provient donc souvent de la « relecture de l’ancienne conversation ».

Le tableau ci-dessous reprend une session d’exemple issue de la documentation officielle des coûts d’Anthropic — 1 200 tokens d’entrée, 5 300 de sortie, 940 000 lus depuis le cache et 50 000 écrits dans le cache — et la calcule avec les tarifs Kunavo pour chacun des quatre modèles :

Sur Claude Sonnet 5, environ 85 % de la facture de cette session correspondent aux lectures et écritures du cache. Autrement dit, le coût dépend de la longueur de la conversation et non du nombre de caractères saisis — c’est la raison de la section suivante sur l’« hygiène du contexte ».

Pour consulter vos propres chiffres, exécutez /usage dans Claude Code (/cost est son alias) ; les quatre nombres de tokens seront affichés. Le montant indiqué à côté est une estimation locale de Claude Code fondée sur les tarifs Anthropic. Avec Kunavo, le débit réel figure dans la page d’utilisation du tableau de bord, avec le nombre de tokens de chaque modèle (lectures et écritures du cache incluses) et le montant facturé.

Changer de modèle selon la tâche

Commencez par associer chaque alias au modèle réel dans la section ~/.claude/settings.json de env. Écrivez cela dans ce fichier afin que les extensions de l’éditeur et les processus en arrière-plan puissent également le lire ; ne l’écrivez pas dans .claude/settings.json, qui est susceptible d’être commit dans le projet. Les alias doivent impérativement correspondre : le modèle par défaut de Claude Code et l’alias opus pointent tous deux vers la dernière version d’Opus ; si Kunavo ne la propose pas encore, l’absence de cette configuration provoquera un 404 dès la première requête. L’alias sonnet pointe vers Sonnet 5.5, que Kunavo ne propose pas ; sans ANTHROPIC_DEFAULT_SONNET_MODEL, /model sonnet, la phase d’exécution de opusplan et les sous-agents configurés sur model: sonnet recevront tous un 404. La configuration ci-dessous associe l’alias opus à Claude Opus 5.5 (claude-opus-5-5) ; Claude Code v2.1.280 ou une version ultérieure est requis. Si la version est plus ancienne, exécutez d’abord claude update.

{
  "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",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5"
  }
}

Une fois configuré, le changement tient en une ligne :

# 工作階段裡切換（別名會對應到上面設定的模型）
> /model haiku
> /model sonnet
> /model opus

# 也可以直接打完整名稱
> /model claude-fable-5

# 或在啟動時指定
claude --model claude-opus-5-5

/model enregistre le choix comme valeur par défaut des prochaines sessions ; pour ne changer que cette fois, exécutez /model sans argument et appuyez sur s dans le menu. ANTHROPIC_DEFAULT_HAIKU_MODEL contrôle également les résumés et titres générés en arrière-plan par Claude Code lui-même ; le pointer vers le modèle le moins cher est le réglage le plus économique.

Chez Kunavo, Claude Opus 5.5 coûte $2.80 / $14.00, et Claude Sonnet 5 coûte $1.40 / $7.00 ; le tarif unitaire de Claude Haiku 4.5 représente environ 1/2 de celui de Claude Sonnet 5, tandis que celui de Claude Fable 5 représente 5 fois ce tarif de référence. Par rapport au tarif officiel : Claude Sonnet 5 Environ 30 % moins cher que le tarif officiel d’Anthropic, Claude Opus 5.5 Environ 30 % moins cher que le tarif officiel d’Anthropic, Claude Haiku 4.5 Environ 30 % moins cher que le tarif officiel d’Anthropic, Claude Fable 5 Environ 30 % moins cher que le tarif officiel d’Anthropic.

Changez de modèle entre les tâches, pas au milieu d’une tâche. Le cache est séparé pour chaque modèle : si vous /model en cours de tâche, la requête suivante doit relire toute la conversation au tarif non mis en cache (tant que le cache est valide, Claude Code vous demandera confirmation). Faites d’abord /clear, puis changez de modèle ; seule la nouvelle conversation, très courte, sera relue. Les tokens de réflexion sont facturés au tarif de sortie ; pour une tâche simple, vous pouvez réduire le niveau de réflexion avec /effort — à définir également au début de la tâche, car modifier l’effort en cours de route invalide aussi le cache pour la plupart des modèles.

CLAUDE.md : n’écrivez que ce que vous répétez régulièrement

# CLAUDE.md — 放在專案根目錄，commit 進 git

## 指令
- 測試：npm test（只跑一個檔：npm test -- path/to/file）
- 型別檢查：npx tsc --noEmit
- Lint：npm run lint

## 規則
- 日期一律用 date-fns，不用 moment。
- API handler 只放在 app/api/**/route.ts。
- commit 訊息用繁體中文，前綴 feat / fix / docs。

## 不要動的地方
- db/migrations/ —— 產生出來的檔案，不要手改。

CLAUDE.md est chargé au début de chaque session, puis joint à chaque requête (généralement au tarif de lecture du cache). Anthropic recommande de limiter un fichier à 200 lignes : plus il est long, plus il consomme de contexte et moins il est respecté. Les informations déductibles du code (structure des répertoires, description des fonctions) sont inutiles ; les notes destinées uniquement aux humains peuvent être placées dans <!-- -->, et seront supprimées avant l’envoi au contexte.

Autre malentendu fréquent : modifier CLAUDE.md au milieu d’une session ne prend pas effet immédiatement ; la nouvelle version ne sera lue qu’après /clear, /compact ou un redémarrage.

Hygiène du contexte : rendre chaque étape moins chère

• Entre deux tâches sans rapport, utilisez /clear. Cela ouvre une conversation entièrement nouvelle, sans coût ; vous pourrez retrouver l’ancienne avec /resume.
• Si une même tâche devient trop longue, utilisez /compact. Vous pouvez indiquer les points à conserver, par exemple /compact 保留測試輸出和改過的檔案. Une requête de résumé est envoyée ; faites-le tant que le cache est valide pour minimiser le coût. Si vous attendez trop longtemps, la requête doit relire tout l’historique au tarif non mis en cache.
• Si vous partez dans la mauvaise direction, utilisez /rewind. Le retour porte sur la partie déjà mise en cache et coûte moins cher que compact.
• En mode clé, le cache reste par défaut actif pendant 5 minutes. Si vous revenez après plus de 5 minutes, la première étape réécrit tout le contexte précédent dans le cache (à 1,25 fois le prix d’entrée). Avant une réunion ou une pause repas, terminez avec /compact ou /clear.
• Utilisez /context pour voir ce qui occupe le contexte. Avec Kunavo, ce nombre est une estimation locale ; Kunavo ne fournit actuellement pas /v1/messages/count_tokens, et la compression automatique ainsi que la session elle-même ne sont pas affectées.
• Désactivez les serveurs MCP inutilisés dans /mcp. La documentation Anthropic précise que la définition d’un ANTHROPIC_BASE_URL personnalisé désactive la recherche d’outils (tool search) ; les définitions des outils MCP ne sont alors pas chargées à la demande et occupent directement chaque requête.
• Indiquez les chemins de fichiers dans la tâche. « Modifie la validation » le poussera à chercher partout et à lire beaucoup de fichiers ; « remplace la validation de src/api/user.ts par zod » limite la lecture aux fichiers nécessaires.

Pour réduire les demandes répétées « puis-je exécuter cette commande ? », n’autorisez que les commandes de lecture et de vérification. Le paramètre qui ignore toutes les confirmations ne doit être utilisé que dans un environnement qu’il est acceptable de jeter entièrement ; voir l’explication de --dangerously-skip-permissions (anglais). Pour la facturation du cache, consultez la documentation du cache.

Plafonds de dépenses et paiement

Dans la page de gestion des clés, créez une clé dédiée à Claude Code et définissez un plafond mensuel. Une fois atteint, les requêtes de cette clé renvoient 402, aucun débit supplémentaire n’est effectué et même une boucle incontrôlée ne peut dépasser ce plafond. La même page permet également de définir une liste blanche IP.

Le compte est prépayé : recharge minimale de $10, solde sans expiration et requêtes échouées non facturées. À Taïwan, vous pouvez recharger avec une carte de crédit internationale (Visa, Mastercard, Amex, JCB, UnionPay) ou Apple Pay et Google Pay ; il n’existe actuellement pas de moyens locaux tels que Jko ou LINE Pay. Pour plus de détails, consultez les tarifs de Claude Code.

Quand l’abonnement est-il plus avantageux ?

Pour les personnes qui interagissent longtemps chaque jour et effectuent de nombreuses étapes par mois, l’abonnement à prix fixe est généralement moins cher que la facturation à l’usage. Un seul calcul suffit : abonnement mensuel ÷ coût par étape = nombre d’étapes au seuil d’équilibre. En estimant chaque étape à environ $0.043 avec Claude Sonnet 5 (hors cache), la facturation à l’usage est plus économique si vous effectuez moins d’étapes par mois ; les mois sans travail coûtent également 0 $. Les tarifs mensuels actuels et le calcul complet sont indiqués sur la page Coût de Claude Code ; nous ne les répétons pas ici.

Il faut aussi préciser le compromis : via Kunavo, vous utilisez une capacité partagée, sans quota dédié ni SLA contractuel. Les équipes ayant besoin d’un quota ou d’un SLA garantis devraient acheter directement auprès d’Anthropic. Les instructions complètes de connexion figurent dans la documentation d’intégration de Claude Code (anglais).

Questions fréquentes