DeepCode V4

DeepSeek V4 Pro + Claude Code + Visión Local. Un solo comando. El proxy que hace funcionar DeepSeek como si fuera Claude — con tools nativas, 1 millón de tokens de contexto, y soporte de imágenes vía LLM local. Todo por una fracción del costo.

✨ ¿Qué hace especial a DeepCode?

• 👁️ Visión con DeepSeek — DeepSeek no soporta imágenes. DeepCode sí. Auto-detecta Ollama o LM Studio y le da ojos a DeepSeek usando un modelo de visión local. Sin configurar nada.
• 🧠 Soporte Nativo Thinking Mode — Renderiza el razonamiento (R1) de DeepSeek directamente en el bloque colapsable ∴ Thinking… de Claude Code. Soporta tool-calls encadenadas sin perder contexto.
• 🎛️ Control de Esfuerzo Nativo — Usa el comando /effort low o /effort max en la consola; el proxy traduce en tiempo real los tokens al motor de DeepSeek.
• 🔧 100% compatible con Claude Code — Mismos flags, mismas tools, mismo entorno. Usa deepcode igual que usarías claude.
• 💰 95% más barato — DeepSeek V4 Pro cuesta ~$0.04 por cada $0.90 de Claude Sonnet.
• 🔄 Continúa sesiones de Claude — ¿Se te acabaron los tokens? deepcode --resume y sigues donde lo dejaste.
• 📊 Statusline en tiempo real — Tokens consumidos y costo directo en la barra inferior de Claude Code.

📦 Requisitos Previos

Antes de instalar DeepCode, asegúrate de tener:

1. Claude Code instalado y funcionando en tu sistema. Puedes instalarlo siguiendo la guía oficial de Anthropic.
2. API Key de DeepSeek V4 — Obtén tu clave en platform.deepseek.com. DeepCode usa esta API key para enrutar las peticiones hacia DeepSeek V4 Pro.

[!IMPORTANT] Sin Claude Code instalado, deepcode no podrá ejecutarse. Sin una API key de DeepSeek válida, no se podrán procesar las peticiones.

🚀 Instalación

npm install -g deepcode-v4

📋 Uso

deepcode                              # Nueva sesión
deepcode --resume                     # Continuar sesión anterior
deepcode --dangerously-skip-permissions  # Modo autónomo
deepcode "crea una API REST con Express" # Prompt directo
deepcode --no-vision                  # Desactiva la visión auto-detectada

Cualquier flag de claude funciona con deepcode.

Comandos nativos dentro de la consola:

• /effort low o /effort max: Controla el tiempo y la profundidad del pensamiento de DeepSeek en tiempo real.
• /model sonnet: Cambia al instante a la versión ultra-rápida deepseek-v4-flash.

⚙️ Configuración

Configura tu DEEPSEEK_API_KEY de una de estas formas:

• Archivo .env en tu carpeta de trabajo
• Variable de entorno del sistema
• ~/.deepcode-v4/.env (recomendado para uso global)

Revisa .env.example para ver todas las opciones disponibles.

⚠️ Seguridad: Tu API key se queda en tu máquina local. Si creas el .env dentro de un proyecto, recuerda agregar .env a tu .gitignore.

👁️ Visión Local (Auto-detectada)

DeepSeek no puede ver imágenes. DeepCode le da ojos.

Al ejecutar deepcode, el proxy detecta automáticamente si tienes un LLM de visión local corriendo. Si lo encuentra, intercepta las imágenes, las convierte en descripciones textuales detalladas y se las pasa a DeepSeek para que razone sobre ellas. Si no encuentra un LLM local, funciona normal en modo texto.

Activar visión (3 pasos):

1. Instala Ollama
2. ollama pull qwen2-vl:7b
3. Ejecuta deepcode — la visión se activa sola

Modelos recomendados:

También soporta LM Studio (localhost:1234).

📜 Licencia

MIT