Reasonix, il coding agent che DeepSeek raccomanda nella doc API ufficiale

DeepSeek ha aggiunto Reasonix alla sezione "Agent Integrations" della propria documentazione API ufficiale. È sviluppato da esengine, non direttamente da DeepSeek, ma è l'agent che DeepSeek raccomanda nella propria doc: progettato attorno alla meccanica del prefix-cache e pensato per girare nel terminale.

La frase chiave nella documentazione: "talks to api.deepseek.com without a translation shim". Niente layer di compatibilità, niente adapter: il loop è disegnato byte per byte per massimizzare la cache hit.

Cosa fa in pratica

• Coding agent da terminale con filesystem tools, shell e SEARCH/REPLACE con review prima dell'apply
• Di default usa V4-Flash (economico); con /pro si passa a V4-Pro per il turno successivo, con /preset max per tutta la sessione
• MCP first-class: stdio, SSE e streamable HTTP, con i server esterni che mergiano i tool in un unico registry
• Plan mode (/plan): il modello pianifica prima di eseguire, con permessi e sandbox che governano ogni tool call
• Subagent integrati: explore, research, review, security-review, più skill in Markdown con tool isolati
• Funziona come TUI, browser UI locale (reasonix serve), estensione VS Code o via ACP per altri editor

Il punto vero: i costi

Il loop è append-only e allineato al prefix-cache di DeepSeek. In sessioni lunghe la cache hit supera il 90% e i token in input vengono fatturati a circa un quinto del prezzo pieno.

Dalla case study pubblicata nel repository (utente reale, singolo giorno, 2026-05-01):

• 435 milioni di token in input
• 99,82% di cache hit
• Costo effettivo: ~$12
• Stesso workload senza cache su V4-Flash: ~$61

Cinque volte meno. E non è un benchmark sintetico: è un log di utilizzo reale.

Installazione e requisiti

Si entra nella directory del progetto e si lancia npx reasonix code. Al primo avvio chiede la API key di DeepSeek (da platform.deepseek.com) e la salva in ~/.reasonix/config.json, senza variabili d'ambiente da configurare. Esiste anche un alias più corto: npx dsnix code.

Richiede Node >= 22 e funziona su macOS, Linux e Windows (PowerShell, Git Bash, Windows Terminal).

Stato del progetto

Il repo GitHub (esengine/deepseek-reasonix) ha due linee di sviluppo:

• main: versione TypeScript originale (0.x), in maintenance mode, solo bugfix
• main-v2: rewrite in Go, single binary CGO-free cross-compilato per darwin/linux/windows su amd64 e arm64; è il nuovo default e non richiede Node a runtime

C'è anche un desktop client in Tauri in prerelease: multi-tab, pannello file, metriche su costi, cache e token. Stessa config, stesso loop, ma non è ancora code-signed.

Cosa lo differenzia dagli altri agent CLI

Claude Code è Anthropic-only, Codex CLI è OpenAI-only, Aider è multi-provider. Reasonix è DeepSeek-only, ma la differenza non è solo il vendor lock-in: l'intero loop è progettato come invariante di cache. Non è un agent generico con un adapter DeepSeek sopra; ogni layer (append-only history, tool-call repair, flash-first routing) esiste per mantenere il prefix stabile e massimizzare la hit rate.

Il risultato è che su sessioni lunghe il costo crolla, mentre un agent generico che chiama DeepSeek via shim non ottiene lo stesso risparmio. Il fatto che sia nella doc ufficiale sotto "Agent Integrations" gli dà uno status particolare: non è un esperimento community, è l'integrazione raccomandata dal provider stesso.

Limiti attuali

• Solo modelli DeepSeek: niente OpenAI, Anthropic o provider terzi
• La versione Go (v2) è in sviluppo attivo, quella TypeScript è in maintenance
• Il desktop client è prerelease e non firmato
• I benchmark nella doc usano il loro harness, non ancora pubblico

Fonti

• Integrate with Reasonix — DeepSeek API Docs
• Reasonix.io — sito ufficiale
• GitHub: esengine/deepseek-reasonix

Lo avete già provato, o per il lavoro quotidiano preferite restare sugli agent multi-provider?

📌 Questo articolo riassume una discussione su r/vibecodingitalia. Leggi il post originale.