Setup del agente y del IDE¶

Belico Stack es modelo-agnóstico. Esta guía cubre el setup para cada combinación IDE/modelo probada. El stack funciona idéntico en todas — cambia solo el entry point que cada IDE lee al abrir el proyecto.

Decisión rápida: ¿qué IDE/modelo usar?¶

Escenario	Recomendación
Producción profesional (24+ papers/año)	Claude Code + Claude Opus
Presupuesto $0	Qwen local (Ollama) + Cline
Privacidad máxima	Qwen local + Cline
Velocidad API barata	Qwen3-Max + Aider
Multi-modelo paralelo	OpenCode
Google stack	Antigravity + Gemini

Setup por IDE¶

Claude Code (primario)¶

cd mi-paper
claude
# Lee CLAUDE.md automáticamente

MCP Engram en ~/.claude/settings.json:

{
  "mcpServers": {
    "engram": {"command": "engram", "args": ["mcp"]}
  }
}

Google Antigravity + Gemini¶

Abrir el proyecto en Antigravity.
Detecta GEMINI.md automáticamente.
Configurar MCP Engram en settings (igual que Claude Code).

Qwen Code CLI¶

npm install -g @qwenlm/qwen-code
export DASHSCOPE_API_KEY=tu_key
cd mi-paper
qwen   # Lee QWEN.md automáticamente

Aider (CLI, multi-modelo)¶

pip install aider-chat
aider --model claude-opus-4-6   # o qwen3-max, gpt-4o

Aider lee AGENTS_GENERIC.md como contexto. Decile: "Leé CLAUDE.md y aplicá todas sus reglas."

Cursor / Windsurf / OpenCode¶

Nativos. Abren el proyecto y leen CLAUDE.md automáticamente. Soportan Claude y GPT-4o. OpenCode permite cambiar modelo por tarea.

Comparativa por tarea¶

Tarea del stack	Claude Opus	Gemini	Qwen3-Max	Qwen-Coder local
Orquestación	Excelente	Buena	Buena	Aceptable
Delegación sub-agentes	Excelente	Buena	Buena	Aceptable
Generación de código	Excelente	Buena	Buena	Excelente
Verificación VERITAS	Excelente	Buena	Buena	Aceptable
Costo	$$$	$$	$	Gratis
Privacidad	Cloud	Cloud	Cloud	100% Local

Troubleshooting multi-IDE¶

El agente no encuentra el stack

Verificá que CLAUDE.md / QWEN.md / GEMINI.md esté en la raíz. Para IDEs no listados, apuntalos a AGENTS_GENERIC.md.

Engram no responde

engram status en terminal. Verificá la config MCP en ~/.{claude,qwen,gemini}/settings.json. Una sola DB: ~/.engram/engram.db (NUNCA setees ENGRAM_DATA_DIR).

El modelo ignora las reglas de Belico.md

NINGÚN modelo lee Belico.md automáticamente. CLAUDE.md instruye al agente a cargarla vía sub-agente/Engram. Verificá que el entry point correcto esté cargado.

Ver también¶

Primeros pasos — instalación base.
Convenciones de Engram — el bus de memoria.

Fuente canónica

Deriva de docs/shared/AGENT_SETUP.md.