Reasonix: ein Coding-Agent im Claude-Code-Stil auf DeepSeek

Wer die Arbeitsweise von Claude Code mag — ein Coding-Agent, der im Terminal lebt, Dateien liest, Befehle ausführt und eigene Fehler selbst korrigiert —, aber lieber Bruchteile eines Cents pro Aufgabe zahlt als ein monatliches Abo, für den ist hier das Rezept: Reasonix, ein CLI-Agent im Claude-Code-Stil, ausgerichtet auf DeepSeeks API.

Was am Ende dabei herauskommt

Man öffnet ein Terminal in einem Projekt, tippt reasonix und beschreibt, was man will: „Füge diesem Skript ein --dry-run-Flag hinzu und aktualisiere die README.” Der Agent liest die relevanten Dateien, bearbeitet sie, führt das Skript aus, um seine Arbeit zu prüfen, und meldet sich zurück — dieselbe Schleife, die Claude-Code-Nutzer kennen. Die Unterschiede liegen in der Verrohrung dahinter:

• Das Gehirn ist DeepSeek, abgerechnet pro Token. Zwei Stufen decken alles ab: ein flash-Modell für alltägliche Änderungen und Klebearbeit, und ein pro-Reasoning-Modell für harte Refactorings und Debugging. Mein rund um die Uhr laufender Agenten-Stack läuft auf genau diesen beiden Stufen und kostete für einen vollen Monat 24,08 $ (9,54 $ flash + 14,54 $ pro) — dasselbe Arbeitspensum käme bei den Flaggschiff-APIs auf etwa 475–915 $.
• Der Zeitplan gehört Ihnen. Weil es keine Sitzlizenz gibt, kann man es lange Fleißarbeit durchackern lassen — Batch-Refactorings, Tests schreiben, Dokumentationsdurchgänge — ohne dabei einen Verbrauchszähler im Blick behalten zu müssen.
• Der Zustand lebt im Home-Verzeichnis. Reasonix hält einen Dotfolder (~/.reasonix/) mit seiner Konfigurationsdatei sowie projektbezogener Sitzungshistorie und Gedächtnis, sodass es den Kontext pro Repository über mehrere Läufe hinweg behält.

Schritt 1: Installation

Es ist ein globales npm-Paket:

npm install -g reasonix
reasonix --version

Das ist die gesamte Installation. Wer Node unter einem nicht standardmäßigen Präfix hält, sollte sich den vollständigen Pfad zu npm notieren — den braucht man in Schritt 4 für den Updater wieder.

Schritt 2: auf DeepSeek ausrichten

Einen API-Key auf DeepSeeks Plattform-Website erstellen (Pay-as-you-go; die ersten elf Juli-Tage meines gesamten Agenten-Stacks kamen auf 2,23 $). Dann Reasonix drei Fakten in seiner Konfigurationsdatei unter ~/.reasonix/config.toml mitteilen:

# ~/.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

Die Namen der Schlüssel unterscheiden sich zwischen Agenten-CLIs, aber am Ende läuft jede auf dasselbe Tripel hinaus: Basis-URL, Key, Modell-ID(s). Zwei Hygiene-Regeln, unabhängig vom Tool:

• chmod 600 auf alles setzen, was den Key enthält, und ihn nie über eine Kommandozeile übergeben (er landet sonst in der Shell-History und in der ps-Ausgabe).
• Beide Stufen einrichten. „Flash als Default, pro für Schwieriges” ist die ganze Kostengeschichte: Die meisten Turns sind billig, und man eskaliert nur, wenn das Modell sichtbar kämpft.

Schritt 3: Subagenten und Skills

Subagenten sind eng umrissene Worker, die der Hauptagent erzeugt — „durchsuche die Codebasis nach jedem Aufrufer dieser Funktion” — und bei Pro-Token-Abrechnung sind sie auch der Kostenhebel, weil Worker auf der flash-Stufe laufen können, während der Orchestrator auf pro nachdenkt. Skills sind Anleitungsdateien, die der Agent bei Bedarf lädt, sodass ein Deploy-Ablauf oder eine Konvention zum Schreiben von Tests einmal aufgeschrieben wird, statt in jeder Sitzung neu erklärt zu werden.

Schritt 4: nach Zeitplan aktuell halten

Agenten-CLIs entwickeln sich schnell, und eine veraltete verpasst Tool-Fixes. Statt sich das Aktualisieren zu merken, plant man es. Meine läuft alle zwei Tage um 6 Uhr morgens über einen Scheduler; das Skript ist der interessante Teil, denn ein naives npm update -g in cron hat zwei Fehlerarten, vor denen man sich absichern sollte:

#!/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"

Ob man es an cron oder einen systemd-Timer hängt, ist egal — beides funktioniert. Die Version vorher und nachher zu loggen ist wichtiger, als es aussieht: Wenn sich das Verhalten des Agenten über Nacht ändert, verrät das Log, ob ein Update daran schuld war.

Bonus: in die eigene Chat-App einbinden

Ein Terminal-Agent muss nicht im Terminal bleiben. Weil Reasonix nur eine CLI auf einem PTY ist, kann man es mit xterm.js in eine Web-UI streamen und von jedem Gerät im eigenen Netzwerk aus benutzen. Genau das macht meine selbstgehostete Chat-App — Reasonix taucht dort als „Terminal-Bot” neben den regulären Chat-Agenten auf, mit Start-/Neustart-/Stopp-Steuerung. Der gesamte Aufbau ist unter DisPatch: ein selbstgehosteter KI-Chat beschrieben.

Stolperfallen

• Reasoning-Modelle wirken hängen geblieben, bevor sie antworten. Die pro-Stufe streamt ihr Nachdenken vor der eigentlichen Antwort; hat ein Wrapper oder Gateway um den Agenten herum einen kurzen Idle-Timeout, werden lange Denkphasen mitten im Gedanken abgebrochen. Den Timeout erhöhen, nicht dem Modell die Schuld geben.
• Den Key niemals im argv unterbringen. Nur Konfigurationsdatei (chmod 600) oder Umgebungsdatei. Kommandozeilen-Flags lecken über die History und Prozesslisten.
• Den npm-Pfad im Updater festnageln. Cron läuft mit einem minimalen PATH; npm kann sich in einer interaktiven Shell und in cron unterschiedlich auflösen. Im Skript hart codieren oder explizit auflösen.
• Den Update-Job sperren. Ohne flock ergeben eine langsame npm-Registry plus ein ehrgeiziger Zeitplan irgendwann zwei gleichzeitige globale Installationen und eine kaputte CLI.
• Auf die Eskalationsgewohnheit achten. Pay-per-Token bleibt nur billig, wenn flash der Default ist. Läuft jede Aufgabe „sicherheitshalber” auf pro, hat man das Abo neu erfunden — die Ausgaben in der ersten Woche im Blick behalten.
• Sitzungsordner wachsen. Projektbezogene Historie ist großartig, bis ein geschwätziger Agent Monate davon angesammelt hat; die Sitzungsdaten im Dotfolder gelegentlich ausdünnen.

Verwandte Lektüre: Der umfassendere DeepSeek-überall-Verkabelungsguide behandelt, wie man die echte Claude-Code-CLI auf DeepSeeks Anthropic-kompatiblen Endpunkt ausrichtet — dieselbe Idee aus der anderen Richtung.