Reasonix : un agent de codage façon Claude Code sur DeepSeek

Si vous aimez la façon de travailler de Claude Code — un agent de codage qui vit dans votre terminal, lit des fichiers, exécute des commandes, corrige ses propres erreurs — mais que vous préféreriez payer des fractions de centime par tâche plutôt qu'un abonnement mensuel, voici la recette : Reasonix, un agent CLI façon Claude Code, pointé vers l'API de DeepSeek.

Ce que vous obtenez

Vous ouvrez un terminal dans un projet, tapez reasonix, et décrivez ce que vous voulez : « ajoute un drapeau --dry-run à ce script et mets à jour le README ». L'agent lit les fichiers concernés, les modifie, exécute le script pour vérifier son travail, puis fait son rapport — la même boucle que connaissent les utilisateurs de Claude Code. Les différences se situent dans la plomberie :

• Le cerveau, c'est DeepSeek, facturé au jeton. Deux niveaux couvrent tout : un modèle flash pour les modifications quotidiennes et les tâches de liaison, et un modèle de raisonnement pro pour les refontes coriaces et le débogage. Ma pile d'agents toujours actifs tourne sur ces deux mêmes niveaux et est revenue à 24,08 $ pour un mois complet (9,54 $ flash + 14,54 $ pro) — la même charge de travail chiffrée à environ 475–915 $ sur les API haut de gamme.
• Vous le planifiez comme bon vous semble. Comme il n'y a pas de licence par poste, vous pouvez le laisser tourner sur de longues corvées — refontes en lot, rédaction de tests, passes de documentation — sans surveiller un compteur d'usage.
• L'état vit dans votre répertoire personnel. Reasonix garde un dossier caché (~/.reasonix/) avec son fichier de configuration, plus l'historique de session et la mémoire par projet, si bien qu'il se souvient du contexte de chaque dépôt d'une exécution à l'autre.

Étape 1 : installation

C'est un paquet npm global :

npm install -g reasonix
reasonix --version

C'est toute l'installation. Si vous gardez Node sous un préfixe non standard, notez le chemin complet vers npm — vous en aurez de nouveau besoin pour le programme de mise à jour à l'étape 4.

Étape 2 : le pointer vers DeepSeek

Créez une clé API sur le site de la plateforme DeepSeek (paiement à l'usage ; les onze premiers jours de juillet pour toute ma pile d'agents sont revenus à 2,23 $). Ensuite, donnez à Reasonix trois informations dans son fichier de configuration ~/.reasonix/config.toml :

# ~/.reasonix/config.toml — the shape, not a paste of mine
[api]
base_url = "https://api.deepseek.com"
api_key  = "sk-..."             # your key; or reference an env var / key file

[models]
default = "deepseek-v4-flash"   # everyday tier
smart   = "deepseek-v4-pro"     # reasoning tier for hard tasks

Les noms de clés varient d'un CLI d'agent à l'autre, mais chacun se ramène au même triplet : URL de base, clé, identifiant(s) de modèle. Deux règles d'hygiène valables quel que soit l'outil :

• chmod 600 sur tout ce qui contient la clé, et ne jamais la passer sur une ligne de commande (elle finit dans l'historique du shell et la sortie de ps).
• Configurez les deux niveaux. « Flash par défaut, pro pour le difficile » résume toute l'histoire des coûts : la plupart des échanges sont bon marché, et vous n'escaladez que lorsque le modèle peine visiblement.

Étape 3 : sous-agents et compétences

Les sous-agents sont des travailleurs à portée limitée que l'agent principal fait naître — « cherche dans le code tous les appelants de cette fonction » — et sur une facturation au jeton, ils sont aussi le levier de coût, puisque les travailleurs peuvent tourner sur le niveau flash pendant que l'orchestrateur réfléchit sur le niveau pro. Les compétences sont des fichiers d'instructions que l'agent charge à la demande, si bien qu'une procédure de déploiement ou une convention de rédaction de tests s'écrit une fois pour toutes au lieu d'être réexpliquée à chaque session.

Étape 4 : le maintenir à jour selon un calendrier

Les CLI d'agents évoluent vite, et un CLI obsolète rate des corrections d'outils. Plutôt que de se souvenir de mettre à jour, planifiez-le. Le mien tourne un jour sur deux à 6 h depuis un planificateur ; le script est la partie intéressante, parce qu'un npm update -g naïf dans cron a deux modes de défaillance qui méritent d'être parés :

#!/usr/bin/env bash
set -euo pipefail
LOG="$HOME/logs/update-reasonix.log"
NPM="$(command -v npm)"

# 1. Lock guard — two overlapping npm runs corrupt the install
exec 9>"${LOG%.log}.lock"
flock -n 9 || { echo "update already running"; exit 0; }

# 2. Log rotation — cron logs grow forever unless you trim them
[ -f "$LOG" ] && tail -n 5000 "$LOG" > "$LOG.tmp" && mv "$LOG.tmp" "$LOG"

echo "before: $("$NPM" list -g reasonix --depth=0 | grep reasonix)" >> "$LOG"
"$NPM" update -g reasonix >> "$LOG" 2>&1
echo "after:  $("$NPM" list -g reasonix --depth=0 | grep reasonix)" >> "$LOG"

Branchez-le sur cron ou sur un minuteur systemd — les deux fonctionnent. Consigner la version avant et après compte plus qu'il n'y paraît : quand le comportement de l'agent change du jour au lendemain, le journal vous dit si une mise à jour en est la cause.

Bonus : l’intégrer à votre application de chat

Un agent de terminal n'est pas obligé de rester dans un terminal. Comme Reasonix n'est qu'un CLI sur un PTY, vous pouvez le diffuser dans une interface web avec xterm.js et l'utiliser depuis n'importe quel appareil de votre réseau. Mon application de chat auto-hébergée fait exactement ça — Reasonix apparaît comme un « bot terminal » aux côtés des agents de chat habituels, avec des contrôles start/restart/stop. L'ensemble de la mise en place est décrit dans DisPatch : un chat IA auto-hébergé.

Pièges à éviter

• Les modèles de raisonnement ont l'air bloqués avant de répondre. Le niveau pro diffuse sa réflexion avant la réponse ; si un wrapper ou une passerelle autour de l'agent a un délai d'inactivité court, les longues réflexions se font tuer en plein milieu. Augmentez le délai, n'accusez pas le modèle.
• Ne mettez jamais la clé dans argv. Uniquement le fichier de configuration (chmod 600) ou un fichier d'environnement. Les drapeaux en ligne de commande fuient via l'historique et les listes de processus.
• Figez le chemin de npm dans le programme de mise à jour. Cron tourne avec un PATH minimal ; npm peut se résoudre différemment dans un shell interactif et dans cron. Codez-le en dur ou résolvez-le explicitement dans le script.
• Verrouillez votre tâche de mise à jour. Sans flock, un registre npm lent combiné à un calendrier trop zélé finit par produire deux installations globales concurrentes et un CLI cassé.
• Surveillez l'habitude d'escalade. Le paiement au jeton ne reste bon marché que si flash est le niveau par défaut. Si chaque tâche tourne sur pro « au cas où », vous avez réinventé l'abonnement — suivez les dépenses pendant la première semaine.
• Les dossiers de session grossissent. L'historique par projet est formidable jusqu'à ce qu'un agent bavard en accumule des mois ; élaguez de temps en temps les données de session du dossier caché.

Lecture complémentaire : le guide plus général DeepSeek partout explique comment pointer le vrai CLI Claude Code vers l'endpoint compatible Anthropic de DeepSeek — la même idée dans l'autre sens.