Blog Artículo

DeepSeek CLI: Guía de instalación, comandos y uso en terminal (Linux/macOS)

29 abr 2026

5 min de lectura

Si estás buscando una forma rápida, potente y nativa de ejecutar DeepSeek directamente desde tu consola, en esta guía tienes todo lo necesario: desde la instalación en 5 segundos hasta los comandos más útiles para el día a día.

⚡ Quickstart: Cómo empezar en 3 pasos

Para los que tienen prisa y la terminal abierta, aquí está la instalación directa:

1. Instalar la herramienta

El instalador oficial descarga el binario estático precompilado en Rust para tu arquitectura (Linux x86_64/ARM64, macOS Apple Silicon/Intel o Android Termux):

curl -fsSL https://raw.githubusercontent.com/sluisr/corex/main/install.sh | sh

(Si prefieres npm, puedes instalarlo globalmente con npm install -g @sluisr/corex o probarlo con npx @sluisr/corex).

2. Configurar tu API Key de DeepSeek

Obtén tu clave en platform.deepseek.com/api_keys y expórtala en tu terminal:

export DEEPSEEK_API_KEY="sk-tu-api-key"

(Tip: agrégala a tu ~/.bashrc o ~/.zshrc para tenerla persistente).

3. Iniciar la sesión interactiva

cx

¡Listo! Ya tienes un agente autónomo conversando en streaming con DeepSeek en tu línea de comandos.

De DeepSeek CLI a Corex (`cx`): ¿Qué herramienta estás usando?

Originalmente, este proyecto nació bajo el nombre de DeepSeek CLI como un fork de Gemini CLI (la herramienta de Google) adaptado a la API de DeepSeek mediante Node.js y TypeScript.

Aunque sirvió como prueba de concepto inicial, mantener un fork sobre el runtime de Node.js tenía dos problemas críticos para el uso diario:

Consumo de memoria desmedido: Levantar el motor V8 de Node consumía entre 150 y 200 MB de RAM en reposo.
Latencia de arranque: Tardaba más de un segundo en abrirse, además de arrastrar problemas constantes de dependencias de upstream.

Por esa razón, el fork en Node.js fue retirado y completamente reconstruido desde cero en Rust nativo bajo el nombre de Corex (cx).

El resultado actual es un binario único de ~6.6 MB, con arranque instantáneo en menos de 10 milisegundos y un consumo mínimo de apenas ~11.9 MB de memoria RAM.

🚀 Guía de comandos esenciales

Corex puede utilizarse de dos formas: en modo interactivo (TUI conversacional) o en modo no interactivo directamente desde tus scripts y flujos de trabajo en Bash.

1. Tareas rápidas en una sola línea (Modo Scripting)

Puedes lanzar tareas directamente sin entrar en la interfaz interactiva con el flag -p (prompt):

# Analizar el estado actual de tu repo git y sugerir mejoras
cx -p "Revisa el git diff actual y redacta un commit convencional"

# Realizar una búsqueda web en vivo usando el motor nativo de DeepSeek
cx -w "Novedades y cambios recientes en la API de DeepSeek"

# Modo YOLO (ejecutar tareas y aplicar parches automáticamente)
cx -y -p "Ejecuta los tests del proyecto y soluciona cualquier fallo encontrado"

# Forzar un modelo específico en caliente
cx -m deepseek-v4-pro -p "Explica la complejidad temporal de este algoritmo"

2. Comandos dentro del modo interactivo (Slash Commands)

Dentro de la sesión interactiva de cx, escribe / para acceder a los comandos integrados:

Comando	Acción
`/model`	Selector visual de modelos (DeepSeek Flash, V4 Pro, Claude, Gemini, Local).
`/auth`	Configurar o cambiar credenciales de API interactivamente.
`/balance`	Consultar el saldo restante y consumo de tokens de tu cuenta en tiempo real.
`/web <query>`	Realizar búsquedas en internet y extraer contenido en markdown limpio.
`/yolo`	Alternar entre modo seguro (pide confirmación) y modo autónomo total.
`/fim <archivo>`	Autocompletado de código contextual (Fill-in-the-Middle).
`/local`	Conectar con un LLM local offline vía `llama.cpp` u Ollama ($0.00 coste).
`/compact`	Comprimir el historial de la sesión para ahorrar tokens y optimizar contexto.
`/stats`	Ver telemetría forense: tokens/segundo, coste en USD y porcentaje de acierto de KV Cache.
`/exit`	Salir guardando el estado de la sesión.

⚙️ Archivo de configuración persistente

Si prefieres no exportar variables de entorno en cada terminal, Corex almacena su configuración global en ~/.corex/settings.json:

{
  "active_provider": "deepseek",
  "model": "deepseek-flash",
  "temperature": 0.7,
  "reasoning_effort": "high",
  "auto_compact": true,
  "compact_threshold_tokens": 95000,
  "allowed_commands": [
    "git status",
    "git diff",
    "cargo test"
  ]
}

🔒 Privacidad total: Modo Offline Soberano (Local LLM)

Si trabajas con código confidencial y no quieres enviar datos a servidores externos, Corex permite conectarte directamente a modelos GGUF ejecutados en tu propia máquina mediante llama-server (llama.cpp) u Ollama:

# Iniciar llama-server en local
llama-server -m models/Llama-3.2-3B-Instruct-Q4_K_M.gguf --port 8080 -c 8192

Y en Corex simplemente alternas al modo local con /local o configurando "local_llm_url": "http://127.0.0.1:8080/v1". Obtienes 0 bytes de salida a internet y coste $0.00.

📦 Todos los métodos de instalación disponibles

Además del script oficial curl, Corex cuenta con soporte para múltiples gestores de paquetes y flujos de trabajo:

1. Script oficial precompilado (Recomendado para Linux, macOS y Android)

Descarga e instala de forma desatendida el binario estático optimizado para tu arquitectura:

curl -fsSL https://raw.githubusercontent.com/sluisr/corex/main/install.sh | sh

2. Homebrew (macOS & Linuxbrew)

Disponible a través del tap oficial:

brew install sluisr/tap/cx

3. Cargo (Crates.io)

Para entornos de desarrollo con toolchain de Rust:

cargo install corex-cli

4. Nix Flake (NixOS / Flakes)

Ejecútalo directamente o levanta una subshell sin necesidad de instalar dependencias globales:

# Ejecutar en caliente sin instalar
nix run github:sluisr/corex

# O entrar a una shell temporal con cx en el PATH
nix shell github:sluisr/corex

5. NPM / NPX (Ecosistema JavaScript)

Ideal si ya tienes Node.js en tu entorno o quieres probarlo sin instalar nada:

# Probar de inmediato sin instalación
npx @sluisr/corex

# O instalarlo globalmente
npm install -g @sluisr/corex

6. Compilar desde el código fuente

Si deseas compilar con tus propios flags de CPU o contribuir al proyecto:

git clone https://github.com/sluisr/corex.git
cd corex
cargo build --release
sudo cp target/release/cx /usr/local/bin/

7. Binarios estáticos precompilados (Descarga directa)

Descarga manual con hashes SHA-256 verificables directamente desde GitHub Releases y corex.sluisr.com:

Linux: x86_64 (x86_64-unknown-linux-gnu), ARM64 (aarch64-unknown-linux-gnu)
macOS: Apple Silicon M1/M2/M3/M4 (aarch64-apple-darwin), Intel (x86_64-apple-darwin)
Android: Termux (aarch64-linux-android)
Windows: x86_64 (x86_64-pc-windows-msvc)

Nota sobre el paquete antiguo `@sluisr/deepseek-cli`

El paquete npm original @sluisr/deepseek-cli está oficialmente deprecado y ya no recibe soporte. Toda la comunidad, mantenimiento y nuevas versiones continúan activamente en el proyecto Corex.

🌐 Web oficial: corex.sluisr.com
📦 Repositorio GitHub: github.com/sluisr/corex
💬 Discord de la comunidad: discord.gg/MGMt6M6Yx