Cómo Instalar Claude Code y Usarlo con DeepSeek V4 — Guía Paso a Paso (Actualizado 2026)

Si eres desarrollador y quieres potenciar tu productividad con inteligencia artificial, has llegado al lugar indicado. En esta guía te mostraré cómo instalar Claude Code y configurarlo con DeepSeek V4 (la última versión) paso a paso, en cuestión de minutos.

⚠️ Importante: DeepSeek ha lanzado su versión V4 con cambios muy importantes. Los modelos anteriores deepseek-chat y deepseek-reasoner serán deprecados el 24 de julio de 2026. Esta guía usa los modelos V4 actuales.

Claude Code es la herramienta de terminal de Anthropic que te permite interactuar con modelos de IA directamente desde tu flujo de desarrollo. DeepSeek V4, por su parte, es la nueva generación del potente modelo de IA de código abierto. La combinación de ambos te dará un asistente de codificación de última generación.

¿Qué es Claude Code?

Claude Code es una herramienta de terminal creada por Anthropic que permite a los desarrolladores interactuar con modelos de lenguaje directamente desde la línea de comandos. Con ella puedes:

• Generar y refactorizar código
• Depurar errores de manera interactiva
• Analizar y documentar tu código base
• Ejecutar comandos y scripts asistidos por IA

Y lo mejor: puedes usarla con diferentes proveedores de modelos, como DeepSeek V4.

¿Qué hay de nuevo en DeepSeek V4?

DeepSeek V4 es un salto generacional. DeepSeek ha reemplazado completamente sus modelos anteriores con dos nuevas opciones:

⚠️ Los modelos anteriores deepseek-chat y deepseek-reasoner dejarán de funcionar el 24 de julio de 2026. Si todavía los usas, migra a deepseek-v4-flash o deepseek-v4-pro cuanto antes.

Requisitos Previos

Antes de empezar, asegúrate de tener instalado Node.js 18 o superior en tu sistema. Puedes verificarlo con:

node -v

Si no lo tienes, descárgalo desde nodejs.org.

Paso 1: Instalar Claude Code

1.1 Instalación global

Ejecuta el siguiente comando en tu terminal:

npm install -g @anthropic-ai/claude-code

Nota: Si tienes problemas de permisos en macOS/Linux, usa sudo npm install -g @anthropic-ai/claude-code.

1.2 Verificar la instalación

claude --version

Deberías ver una salida similar a:

claude-code 1.0.37

Paso 2: Obtener tu API Key de DeepSeek

1. Ve a https://platform.deepseek.com
2. Inicia sesión o crea una cuenta
3. En el panel de control, ve a API Keys y crea una nueva clave
4. Copia la clave (comienza con sk-)

Paso 3: Configurar Claude Code con DeepSeek V4 (NUEVO MÉTODO)

¡Esto ha cambiado por completo con DeepSeek V4! Ahora la forma recomendada de integrar Claude Code con DeepSeek es usando la API de Anthropic de DeepSeek. Ya no se usa claude config ni el formato OpenAI.

3.1 Configurar variables de entorno

DeepSeek V4 ofrece un endpoint compatible con Anthropic, lo que permite una integración mucho más limpia con Claude Code.

Linux / Mac:

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN="sk-tu-api-key-de-deepseek"
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

Windows (PowerShell):

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="sk-tu-api-key-de-deepseek"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"

3.2 (Opcional) Guardar permanentemente

Añade las variables de Linux/Mac a tu ~/.bashrc o ~/.zshrc:

# DeepSeek V4 para Claude Code
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN="sk-tu-api-key-de-deepseek"
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

Luego recarga con source ~/.bashrc o source ~/.zshrc.

Paso 4: ¡Usar Claude Code con DeepSeek V4!

4.1 Iniciar Claude Code

cd /ruta/de/tu-proyecto
claude

4.2 Verificar la conexión

Una vez iniciado, ejecuta /status y deberías ver:

✓ Conectado a DeepSeek V4
Modelo: deepseek-v4-pro (o deepseek-v4-flash)

4.3 Probar con un ejemplo

Prueba haciendo una pregunta como:

> Explica cómo funciona la atención multi-cabeza

DeepSeek V4 responderá con su modo de pensamiento (thinking) activado por defecto, dándote respuestas más razonadas y precisas.

¿Qué modelo elegir? deepseek-v4-flash vs deepseek-v4-pro

• deepseek-v4-flash ⚡ — Ideal para el día a día. Es súper rápido y económico ($0.14/M input, $0.28/M output). Perfecto para tareas cotidianas de codificación, refactorización y depuración. Además, el cache contextual reduce drásticamente los costos (solo $0.0028/M con cache hit).
• deepseek-v4-pro 🚀 — Mayor capacidad de razonamiento. Recomendado para tareas complejas, análisis profundos de código, y cuando necesitas la máxima calidad. Más caro ($1.74/M input, $3.58/M output) pero con un 75% de descuento en cache hit.

DeepSeek recomienda usar deepseek-v4-flash como modelo por defecto (Haiku) y deepseek-v4-pro para tareas que requieran Opus/Sonnet.

Comandos Útiles en Claude Code

• /help — Ver todos los comandos disponibles
• /status — Ver tu configuración actual y modelo activo
• /context — Gestionar el contexto de la conversación

Solución de Problemas

Conclusión

¡Ya tienes Claude Code funcionando con DeepSeek V4! 🎉 Ahora puedes:

• Escribir y refactorizar código con IA de última generación (1M de contexto)
• Depurar errores de forma conversacional directamente en tu terminal
• Documentar tu código base en segundos
• Aprovechar el modo thinking de DeepSeek V4 para respuestas más profundas
• Disfrutar de precios imbatibles con deepseek-v4-flash

DeepSeek V4 representa un salto generacional. Si venías usando deepseek-chat, migra ahora — el modelo anterior será deprecado el 24 de julio de 2026.

Enlaces Útiles

• Documentación oficial de Claude Code
• Documentación oficial de DeepSeek API
• DeepSeek Platform — Consola de API
• Novedades de DeepSeek V4