Reasonix: un agente de codificación al estilo Claude Code sobre DeepSeek

Si te gusta la forma de trabajar de Claude Code — un agente de codificación que vive en tu terminal, lee archivos, ejecuta comandos, corrige sus propios errores — pero prefieres pagar fracciones de centavo por tarea en vez de una suscripción mensual, esta es la receta: Reasonix, un agente CLI al estilo Claude Code, apuntado a la API de DeepSeek.

Lo que obtienes

Abres una terminal en un proyecto, escribes reasonix, y describes lo que quieres: «añade una opción --dry-run a este script y actualiza el README». El agente lee los archivos relevantes, los edita, ejecuta el script para comprobar su propio trabajo, y reporta — el mismo ciclo que ya conocen los usuarios de Claude Code. Las diferencias están en la fontanería:

• El cerebro es DeepSeek, facturado por token. Dos niveles cubren todo: un modelo flash para ediciones del día a día y trabajo de pegamento, y un modelo de razonamiento pro para refactors complicados y depuración. Mi stack de agentes siempre activos corre sobre estos mismos dos niveles y costó $24.08 en un mes completo ($9.54 flash + $14.54 pro) — la misma carga de trabajo sale a un precio de entre $475 y $915 en las APIs insignia.
• El horario es cosa tuya. Como no hay licencia por puesto, puedes dejarlo trabajando en tareas largas y tediosas — refactors por lotes, escritura de tests, pasadas de documentación — sin vigilar un medidor de uso.
• El estado vive en tu directorio home. Reasonix guarda una carpeta oculta (~/.reasonix/) con su archivo de configuración más el historial de sesión y la memoria por proyecto, así que recuerda el contexto de cada repositorio entre ejecuciones.

Paso 1: instalar

Es un paquete global de npm:

npm install -g reasonix
reasonix --version

Eso es toda la instalación. Si tienes Node bajo un prefijo no estándar, apunta la ruta completa a npm — la vas a necesitar de nuevo para el actualizador del paso 4.

Paso 2: apúntalo a DeepSeek

Crea una clave de API en el sitio de la plataforma de DeepSeek (pago por uso; los primeros once días de julio de todo mi stack de agentes costaron $2.23). Después dale a Reasonix tres datos en su archivo de configuración en ~/.reasonix/config.toml:

# ~/.reasonix/config.toml — la forma, no un pegado literal del mío
[api]
base_url = "https://api.deepseek.com"
api_key  = "sk-..."             # tu clave; o una referencia a una variable de entorno / archivo de clave

[models]
default = "deepseek-v4-flash"   # nivel del día a día
smart   = "deepseek-v4-pro"     # nivel de razonamiento para tareas difíciles

Los nombres de las claves varían entre CLIs de agentes, pero todas se reducen al mismo trío: URL base, clave, id(s) de modelo. Dos reglas de higiene sin importar la herramienta:

• chmod 600 a cualquier cosa que contenga la clave, y nunca la pases en una línea de comandos (termina en el historial de la shell y en la salida de ps).
• Configura ambos niveles. «Flash por defecto, pro para lo difícil» es toda la historia del costo: la mayoría de los turnos son baratos, y solo escalas cuando el modelo está visiblemente atascado.

Paso 3: subagentes y skills

Los subagentes son trabajadores de alcance acotado que el agente principal lanza — «busca en todo el código cada llamador de esta función» — y con facturación por token también son la palanca de costo, porque los trabajadores pueden correr en el nivel flash mientras el orquestador piensa en pro. Las skills son archivos de instrucciones que el agente carga bajo demanda, así que un procedimiento de despliegue o una convención para escribir tests se escribe una sola vez en vez de volver a explicarse en cada sesión.

Paso 4: mantenlo actualizado con un horario

Los CLI de agentes avanzan rápido, y uno desactualizado se pierde correcciones de herramientas. En vez de acordarte de actualizar, prográmalo. El mío corre día por medio a las 6 de la mañana desde un scheduler; lo interesante es el script, porque un npm update -g ingenuo en cron tiene dos modos de fallo que vale la pena cubrir:

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

# 1. Protección de bloqueo — dos ejecuciones de npm solapadas corrompen la instalación
exec 9>"${LOG%.log}.lock"
flock -n 9 || { echo "update already running"; exit 0; }

# 2. Rotación de logs — los logs de cron crecen para siempre si no los recortas
[ -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"

Conéctalo a cron o a un timer de systemd — cualquiera de los dos funciona. Registrar la versión antes y después importa más de lo que parece: cuando el comportamiento del agente cambia de un día para otro, el log te dice si fue una actualización.

Extra: ponlo en tu app de chat

Un agente de terminal no tiene por qué quedarse en la terminal. Como Reasonix es solo un CLI sobre un PTY, puedes transmitirlo a una interfaz web con xterm.js y usarlo desde cualquier dispositivo de tu red. Mi app de chat autoalojada hace justo eso — Reasonix aparece como un «bot de terminal» junto a los agentes de chat normales, con controles de iniciar/reiniciar/detener. Toda la configuración está escrita en DisPatch: un chat de IA autoalojado.

Trampas comunes

• Los modelos de razonamiento parecen atascados antes de responder. El nivel pro transmite su pensamiento antes de la respuesta; si un wrapper o gateway alrededor del agente tiene un timeout de inactividad corto, los pensamientos largos se matan a mitad de camino. Sube el timeout, no le eches la culpa al modelo.
• Nunca pongas la clave en el argv. Solo archivo de configuración (chmod 600) o archivo de entorno. Los flags de línea de comandos se filtran por el historial y los listados de procesos.
• Fija la ruta de npm en el actualizador. Cron corre con un PATH mínimo; npm puede resolverse distinto en una shell interactiva que en cron. Fíjala a mano o resuélvela explícitamente en el script.
• Bloquea tu tarea de actualización. Sin flock, un registro de npm lento más un horario demasiado entusiasta eventualmente te da dos instalaciones globales concurrentes y un CLI roto.
• Vigila el hábito de escalar. El pago por token solo se mantiene barato si flash es el nivel por defecto. Si cada tarea corre en pro «por si acaso», has reinventado la suscripción — registra el gasto durante la primera semana.
• Las carpetas de sesión crecen. El historial por proyecto es genial hasta que un agente hablador acumula meses de él; poda de vez en cuando los datos de sesión de la carpeta oculta.

Lectura relacionada: la guía más amplia de DeepSeek en todas partes cubre cómo apuntar el CLI real de Claude Code al endpoint de DeepSeek compatible con Anthropic — la misma idea desde la otra dirección.