Comment utiliser Cline — séparer les modèles pour Plan et Act et calculer le coût d’une tâche

Cline est un agent de programmation IA open source qui fonctionne dans des éditeurs tels que VS Code.Son utilisation se déroule en 3 étapes : installer l’extension, configurer le fournisseur API et la clé (Cline n’inclut aucun modèle), puis planifier en mode Plan avant d’exécuter en mode Act. Le coût dépend des modèles attribués à Plan et Act : activez « Use different models for Plan and Act » dans les paramètres et attribuez claude-opus-5 à Plan et claude-haiku-4-5 à Act avec la même clé ; une tâche de 20 étapes passe ainsi d’environ $2.17 avec Opus 5 partout à environ $0.69 (calculé aux tarifs Kunavo).

La plupart des articles explicatifs en japonais s’arrêtent à l’installation et à la première demande, en conservant un modèle gratuit ou un seul modèle payant. Cette page va plus loin — la configuration qui sépare les modèles de Plan et d’Act et le calcul du coût d’une tâche — avec une seule clé.

Cline — les deux modes Plan et Act

Cline est un agent qui exécute une boucle dans laquelle il lit les fichiers, propose des différences, exécute des commandes dans le terminal, lit les résultats et corrige à nouveau. Il comporte deux modes qui, selon la documentation officielle de Cline, se distinguent ainsi.

• Mode Plan : lire et rechercher dans la base de code et discuter de l’approche. Les fichiers ne peuvent pas être modifiés et les commandes ne peuvent pas être exécutées.
• Mode Act : reprendre le contexte de la conversation du mode Plan, modifier les fichiers et exécuter les commandes.

Cette séparation devient directement une séparation des coûts. Plan comporte peu d’allers-retours, mais la qualité des décisions prises à ce stade influence les douzaines d’étapes suivantes. Act comporte de nombreux allers-retours et renvoie le contexte de la tâche à chaque fois ; le prix des tokens s’accumule donc. Un modèle puissant pour Plan, un modèle moins cher pour Act — la documentation de Cline elle-même recommande un modèle doté d’un raisonnement fort pour la planification et un modèle rapide pour l’implémentation.

Installation et première configuration

1. Dans VS Code, ouvrez la vue des extensions (Ctrl / Cmd + Shift + X), recherchez « Cline » et installez-la. Elle s’installe également dans Cursor, Windsurf et les IDE JetBrains.
2. Ouvrez Cline dans la barre latérale et, dans les paramètres (⚙︎), choisissez « OpenAI Compatible » pour API Provider.
3. Saisissez Base URL, API Key et Model ID, puis remplissez les champs de Model Configuration (longueur du contexte, sortie maximale, prise en charge des images, tarifs d’entrée et de sortie).

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1   # /v1 まで入れる
API Key        sk-kn-...                    # /app/keys で発行（表示は一度きり）
Model ID       claude-opus-5

La Base URL doit inclure /v1.Cline ajoute ensuite uniquement la route ; sans /v1, vous obtiendrez une erreur 404. Si vous recevez 401, l’URL est correcte mais la clé est incorrecte. Plutôt que de confier immédiatement des modifications à l’agent, vérifiez la connexion avec une petite demande telle que « explique ce fichier ». Créez la clé sur /app/keys ; elle n’est affichée qu’une seule fois, alors enregistrez-la immédiatement.

Les champs Input Price / Output Price de Model Configuration servent de base au calcul du coût affiché par Cline pendant une tâche. Ils ne sont pas récupérés automatiquement depuis le point de terminaison ; si vous les laissez vides ou à leur valeur par défaut, le coût affiché sera incorrect. Renseignez le tarif par million de tokens du modèle utilisé. La liste des paramètres figure dans la documentation d’intégration de Cline.

Séparer les modèles de Plan et d’Act

En cochant « Use different models for Plan and Act » dans les paramètres, vous pouvez sélectionner des modèles différents pour Plan et Act. L’URL de base et la clé sont identiques pour les deux ; seuls le Model ID et les tarifs changent.

[✓] Use different models for Plan and Act

── Plan Mode ─────────────────────────────
API Provider       OpenAI Compatible
Base URL           https://api.kunavo.com/v1
API Key            sk-kn-...
Model ID           claude-opus-5
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        3.50      # 1M トークンあたり USD
  Output Price       17.50

── Act Mode ──────────────────────────────
API Provider       OpenAI Compatible
Base URL           https://api.kunavo.com/v1
API Key            sk-kn-...            # Plan と同じキーでよい
Model ID           claude-haiku-4-5
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        0.70
  Output Price       3.50

La raison de placer Opus 5 dans Plan est simple. Plan ne représente qu’une petite partie du total des tokens, mais une mauvaise approche à ce stade peut rendre inutiles toutes les étapes d’Act. Haiku 4.5 convient à Act, car lorsque le plan est concret, le reste consiste surtout en répétitions de modifications et d’exécution ; c’est donc là que le prix des tokens a le plus d’impact.

Lorsque le mode Plan est réglé sur Sonnet 5, une étape coûte environ $0.0434 ; avec Opus 5, environ $0.11.Claude Sonnet 5 coûte $1.40 / $7.00 par million de tokens.

Si Act reste bloqué, passez Act à Opus 5 uniquement pour cette tâche.Après deux répétitions de la même erreur, c’est le signal qu’il faut changer de modèle. Insister avec Haiku et laisser le nombre d’étapes augmenter coûte finalement plus cher. Il suffit de modifier un seul Model ID dans les paramètres ; la clé et le point de terminaison restent identiques.

Calculer le coût d’une tâche

Cline renvoie à chaque étape le prompt système, l’historique de la tâche et les fichiers lus ; le coût dépend donc du nombre d’étapes, pas du temps. Comme dans les autres pages tarifaires de ce site, nous calculons une étape avec 25 000 tokens d’entrée et 1 200 tokens de sortie, et une tâche de 20 étapes (Plan 3 + Act 17).

En séparant Plan et Act, vous obtenez un coût correspondant à environ 32 % de celui d’une exécution entièrement avec Opus 5, tout en conservant la qualité de planification d’Opus 5. Tout faire avec Haiku coûte encore moins cher, mais si l’on tient compte des reprises dues aux erreurs de planification, la différence de $0.26 est une assurance peu coûteuse pour Plan. Voici le seul code nécessaire pour vérifier le calcul.

# 1 タスクの費用を、ステップ数から出す。
# 単価は Kunavo の 1M トークンあたり USD (input, output)。
RATES = {
    "claude-opus-5":    (3.50, 17.50),
    "claude-haiku-4-5": (0.70, 3.50),
}

def step(model, inp=25_000, out=1_200):
    i, o = RATES[model]
    return inp / 1e6 * i + out / 1e6 * o

all_opus = 20 * step("claude-opus-5")
split = 3 * step("claude-opus-5") + 17 * step("claude-haiku-4-5")

print(round(all_opus, 2))   # -> 2.17  全部 Opus 5
print(round(split, 2))      # -> 0.69  Plan = Opus 5 / Act = Haiku 4.5

Comment choisir les modèles

GPT-5.6 Sol facture l’ensemble de la requête avec 2 fois le prix d’entrée et 1,5 fois le prix de sortie lorsque le prompt dépasse 272K tokens. Si vous l’utilisez pour Plan, il est plus prudent de régler Context Window à moins de 272K. Pour en savoir davantage sur la différence entre Opus et Sonnet, consultez Différences entre Claude Opus et Sonnet ; les tarifs de tous les modèles Claude sont regroupés dans Tarifs de Claude.

5 habitudes pour réduire les coûts

1. Ne prolongez pas une tâche ; fractionnez le travail et commencez une nouvelle tâche. Comme tout l’historique est renvoyé à chaque étape, une étape coûte plus cher dans une tâche longue. C’est l’habitude la plus efficace.
2. Si vous utilisez le cache des prompts, passez par le fournisseur Anthropic. Définissez API Provider sur « Anthropic », cochez « Use custom base URL » et indiquez https://api.kunavo.com (/v1 ne doit pas être ajouté ; le client ajoute /v1/messages). La lecture du cache Claude coûte 10 % du tarif d’entrée et son écriture 1,25 fois ce tarif. Le fonctionnement est expliqué dans la documentation du cache.
3. Écrivez les règles dans .clinerules/. Il s’agit d’un fichier Markdown placé à la racine du projet ; ses instructions s’appliquent à toutes les conversations. Comme il est inclus dans chaque requête, restez bref et limitez-vous aux règles (documentation des règles de Cline).
4. Réservez l’approbation automatique aux opérations de lecture. Autoriser la lecture de fichiers et d’autres opérations similaires avec Auto Approve réduit les confirmations. Le mode YOLO, qui approuve tout automatiquement, doit être réservé aux environnements jetables, comme l’indique explicitement la documentation de Cline, car il est dangereux. Les modifications peuvent être annulées avec Checkpoints.
5. Créez une clé dédiée à Cline et définissez une limite mensuelle. Dans /app/keys, vous pouvez définir une limite d’utilisation mensuelle par clé (qui renvoie 402 une fois atteinte) ainsi qu’une liste d’adresses IP autorisées. Lorsque vous souhaitez arrêter l’éditeur, il suffit de désactiver cette clé.

Pour être honnête — quand un abonnement ou un contrat direct est préférable

Si vous avez un abonnement Claude Pro / Max, vous pouvez aussi sélectionner le fournisseur « Claude Code » de Cline. Cette méthode utilise le quota de l’abonnement via le CLI Claude Code installé, plutôt qu’une facturation au token. Selon la documentation de Cline, l’envoi d’images et le cache des prompts sont limités avec cette méthode, et les réponses peuvent ne pas être transmises en continu token par token. La limite du quota est partagée avec le chat et Claude Code ; consultez les limites de Claude Pro pour comprendre ce fonctionnement.

Pour une utilisation avec une clé API, Kunavo fonctionne avec une capacité partagée et ne fournit ni quota dédié ni SLA contractuel. Les équipes ayant besoin de garanties doivent conclure un contrat directement avec Anthropic. Pour les particuliers et les petites équipes qui utilisent Cline, la facturation à l’usage avec une seule clé permettant de séparer Plan et Act est adaptée.

Différences avec l’utilisation de Roo Code

Roo Code est une extension dérivée de Cline et utilise directement la configuration OpenAI Compatible (URL de base, clé et modèle). La différence réside dans la structure des modes : au lieu de Plan / Act, il existe des modes tels que Architect, Code, Ask et Debug, auxquels vous attribuez un profil de configuration API. Le même principe s’applique : Opus 5 pour Architect et un modèle moins cher pour Code. Les instructions figurent dans la documentation de configuration de Roo Code et dans Roo Code + Claude API (en anglais).

Pour une explication encore plus détaillée en anglais, consultez le guide Cline + Claude API ; si vous souhaitez comparer avec des agents de type terminal, consultez Comparaison entre Cline et Claude Code et Comment utiliser Claude Code. Les tarifs de tous les modèles figurent sur la page des tarifs.

Questions fréquentes