Reasonix: um Agente de Codificação no Estilo Claude Code Rodando no DeepSeek

Se você gosta do jeito de trabalhar do Claude Code — um agente de codificação morando no seu terminal, lendo arquivos, rodando comandos, corrigindo os próprios erros — mas prefere pagar frações de centavo por tarefa a uma assinatura mensal, esta é a receita: o Reasonix, uma CLI agente no estilo Claude Code, apontada para a API do DeepSeek.

O que você ganha

Você abre um terminal num projeto, digita reasonix e descreve o que quer: "adicione uma flag --dry-run a este script e atualize o README." O agente lê os arquivos relevantes, edita-os, roda o script para conferir o próprio trabalho e reporta de volta — o mesmo ciclo que os usuários do Claude Code já conhecem. As diferenças estão na encanação:

• O cérebro é o DeepSeek, cobrado por token. Dois níveis cobrem tudo: um modelo flash para edições do dia a dia e trabalho de cola, e um modelo de raciocínio pro para refatorações complicadas e depuração. Minha stack de agentes sempre ativos roda nesses mesmos dois níveis e custou $24,08 num mês inteiro ($9,54 de flash + $14,54 de pro) — a mesma carga de trabalho sairia por algo entre $475 e $915 nas APIs de ponta.
• É seu para agendar. Como não há licença por assento, você pode deixá-lo moendo trabalho braçal longo — refatorações em lote, escrita de testes, passadas de documentação — sem ficar de olho num medidor de uso.
• O estado vive no seu diretório home. O Reasonix mantém uma pasta oculta (~/.reasonix/) com seu arquivo de configuração mais o histórico de sessão e a memória por projeto, então ele lembra o contexto de cada repositório entre execuções.

Passo 1: instalar

É um pacote global do npm:

npm install -g reasonix
reasonix --version

É essa a instalação inteira. Se você mantém o Node num prefixo fora do padrão, anote o caminho completo do npm — você vai precisar dele de novo no atualizador do passo 4.

Passo 2: apontar para o DeepSeek

Crie uma chave de API no site da plataforma do DeepSeek (pagamento por uso; os primeiros onze dias de julho de toda a minha stack de agentes deram $2,23). Depois informe ao Reasonix três fatos no seu arquivo de configuração em ~/.reasonix/config.toml:

# ~/.reasonix/config.toml — o formato, não uma cópia do meu
[api]
base_url = "https://api.deepseek.com"
api_key  = "sk-..."             # sua chave; ou referencie uma variável de ambiente / arquivo de chave

[models]
default = "deepseek-v4-flash"   # nível do dia a dia
smart   = "deepseek-v4-pro"     # nível de raciocínio para tarefas difíceis

Os nomes das chaves variam entre CLIs de agente, mas todas se resumem ao mesmo trio: URL base, chave, id(s) de modelo. Duas regras de higiene, independente da ferramenta:

• chmod 600 em qualquer coisa que contenha a chave, e nunca a passe numa linha de comando (ela acaba no histórico do shell e na saída do ps).
• Configure os dois níveis. Flash-por-padrão, pro-para-o-difícil é toda a história do custo: a maioria dos turnos sai barata, e você só escala quando o modelo está visivelmente patinando.

Passo 3: subagentes e skills

Subagentes são workers com escopo limitado que o agente principal gera — "procure no código-base cada chamador desta função" — e, no faturamento por token, também são a alavanca de custo, já que os workers podem rodar no nível flash enquanto o orquestrador pensa no pro. Skills são arquivos de instrução que o agente carrega sob demanda, então um procedimento de deploy ou uma convenção de escrita de teste fica registrado uma vez, em vez de reexplicado a cada sessão.

Passo 4: manter atualizado com um agendamento

As CLIs de agente evoluem rápido, e uma versão desatualizada perde correções de ferramentas. Em vez de lembrar de atualizar, agende. A minha roda a cada dois dias às 6h a partir de um agendador; o script é a parte interessante, porque um npm update -g ingênuo no cron tem dois modos de falha que vale a pena vigiar:

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

Conecte a um cron ou a um timer do systemd — os dois funcionam. Registrar a versão antes e depois importa mais do que parece: quando o comportamento do agente muda da noite para o dia, o log te diz se foi uma atualização que fez isso.

Bônus: coloque no seu app de chat

Um agente de terminal não precisa ficar preso a um terminal. Como o Reasonix é só uma CLI sobre um PTY, dá para transmiti-lo para uma interface web com xterm.js e usá-lo de qualquer dispositivo na sua rede. Meu aplicativo de chat autogerenciado faz exatamente isso — o Reasonix aparece como um "bot de terminal" ao lado dos agentes de chat normais, com controles de iniciar/reiniciar/parar. A configuração completa está descrita em DisPatch: um chat de IA autogerenciado.

Pegadinhas

• Modelos de raciocínio parecem travados antes de responder. O nível pro transmite o próprio pensamento antes da resposta; se um wrapper ou gateway em volta do agente tem um timeout de inatividade curto, pensamentos longos são derrubados no meio. Aumente o timeout, não culpe o modelo.
• Nunca coloque a chave no argv. Só arquivo de configuração (chmod 600) ou arquivo de ambiente. Flags de linha de comando vazam pelo histórico e por listagens de processo.
• Fixe o caminho do npm no atualizador. O cron roda com um PATH mínimo; o npm num shell interativo e no cron pode resolver para caminhos diferentes. Fixe o caminho ou resolva-o explicitamente no script.
• Trave sua tarefa de atualização. Sem flock, um registro npm lento somado a um agendamento entusiasmado eventualmente te dá duas instalações globais concorrentes e uma CLI quebrada.
• Fique de olho no hábito de escalar. Pagar por token só continua barato se o flash for o padrão. Se toda tarefa roda no pro "só por garantia", você reinventou a assinatura — acompanhe o gasto na primeira semana.
• Pastas de sessão crescem. Histórico por projeto é ótimo até um agente tagarela acumular meses dele; limpe os dados de sessão da pasta oculta de vez em quando.

Leitura relacionada: o guia mais amplo DeepSeek em todo lugar cobre como apontar a própria CLI do Claude Code para o endpoint compatível com Anthropic do DeepSeek — a mesma ideia, na direção oposta.