Cómo usar los modelos de DeepSeek en Claude Code

Cómo configurar Claude Code con DeepSeek

1. Consigue una clave de API de DeepSeek

   Créala en platform.deepseek.com, en API keys, y añade saldo a la cuenta; el uso se factura por token.

2. Instala Claude Code si aún no lo tienes

   La guía de DeepSeek lo instala con npm: Node.js 18 o posterior, Git for Windows en Windows, y después npm install -g @anthropic-ai/claude-code y claude --version para comprobarlo.

3. Define las variables de entorno (macOS y Linux)

   Apuntan Claude Code al endpoint compatible con Anthropic de DeepSeek, usan deepseek-flash con su contexto de 1M para el modelo principal y los subagentes, y suben el nivel de esfuerzo y la ventana de compactación automática. Ponlas en el perfil de tu shell para conservarlas.

   export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
   export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API Key>
   export ANTHROPIC_MODEL=deepseek-flash[1m]
   export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-flash[1m]
   export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-flash[1m]
   export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-flash
   export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-flash
   export CLAUDE_CODE_EFFORT_LEVEL=max
   export CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432

4. O en Windows (PowerShell)

   La misma configuración como variables de entorno de PowerShell para la sesión actual.

   $env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
   $env:ANTHROPIC_AUTH_TOKEN="<your DeepSeek API Key>"
   $env:ANTHROPIC_MODEL="deepseek-flash[1m]"
   $env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash[1m]"
   $env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash[1m]"
   $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
   $env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash"
   $env:CLAUDE_CODE_EFFORT_LEVEL="max"
   $env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432"

5. Inicia Claude Code en tu proyecto

   Entra en el proyecto con cd y ejecuta claude. Todo lo demás, como CLAUDE.md, skills, hooks y servidores MCP, se configura como siempre.

Fuente: documentación de la API de DeepSeek, Integrate with Claude Code

Cómo se mapean los nombres de modelos de Claude a los de DeepSeek

Cuando Claude Code (o la app de escritorio de Claude) envía un nombre de modelo de Claude al endpoint de DeepSeek, DeepSeek lo mapea así. Por eso la configuración de arriba fija todas las variables de modelo en deepseek-flash: si no, todo lo que pida Opus se factura a precios de V4 Pro.

Cuánto cuesta

Precios de la API de DeepSeek en dólares estadounidenses por millón de tokens a 6 de noviembre de 2026. Las tarifas fuera de hora punta (fuera de 01:00–04:00 y 06:00–10:00 UTC en días laborables) son la mitad de las de hora punta. La búsqueda web de Claude Code también funciona con la API de DeepSeek, pero cada búsqueda añade tokens del modelo para resumir los resultados y se factura según la Search API de DeepSeek.

Usar DeepSeek en Codex

DeepSeek también es compatible con Codex, a través de la Responses API. Su guía ofrece un script de configuración que hace una copia de seguridad de ~/.codex/config.toml, escribe un catálogo ~/.codex/models.json con deepseek-flash y deepseek-v4-pro y añade un proveedor DeepSeek; con una sola configuración quedan cubiertos la CLI de Codex, la app de escritorio de ChatGPT y la extensión de VS Code. Lee el script antes de ejecutarlo, o sigue los pasos manuales de la misma guía. El script desactiva la búsqueda web integrada, que solo está disponible con deepseek-v4-pro. Para los archivos de instrucciones propios de Codex, consulta la guía de AGENTS.md en Codex.

Claude Code con DeepSeek vs DeepSeek Harness

• Claude Code con DeepSeek: conservas la interfaz y las costumbres de Claude Code, incluidos CLAUDE.md, skills, hooks y plugins, y pagas los precios por token de DeepSeek en lugar de un plan de Claude.
• DeepSeek Harness: la app de agentes de código abierto de la propia DeepSeek, construida en torno a plugins, con app de escritorio e interfaz web; también puede ejecutar Claude Code o Codex como subagentes. Consulta la guía de DeepSeek Harness.
• En ambos casos, los modelos son los mismos deepseek-flash y deepseek-v4-pro, facturados por DeepSeek.
• Para volver a los modelos de Anthropic, elimina las variables (o abre una shell nueva sin ellas) e inicia sesión en Claude Code como siempre.

Modelos baratos, trabajando todo el día

Con los precios de DeepSeek, mantener ocupados a los agentes de Claude Code o DeepSeek Harness sale asequible. Crewmark convierte esas sesiones en empleados de IA con un rol, un objetivo y un horario, y despierta a cada uno con un latido (heartbeat) para que tome la siguiente issue de un tablero.

1. Usa la configuración que ya tienes

   Un empleado funciona en una sesión de Claude Code, Codex, DeepSeek Harness u OpenCode en tu equipo, con tu entorno y tus claves.

2. Deja que el latido inicie el trabajo

   Durante su horario se despierta cada 15, 30 o 60 minutos en la misma conversación y toma la siguiente issue; consulta cómo hacer proactivo a Claude Code.

3. Mantén la factura bajo control

   El horario y una issue cada vez hacen que el consumo sea previsible; consulta cómo reducir el consumo de tokens de Claude Code.

Preguntas frecuentes sobre Claude Code con DeepSeek