Cómo Usar DeepSeek-V3.1 en Claude Code

Alrededor de 1 min

Cómo Usar DeepSeek-V3.1 en Claude Code

Claude Code es un asistente de codificación ligero que normalmente se conecta a los modelos Claude de Anthropic. Gracias a la API compatible con Anthropic de DeepSeek, también puedes ejecutar Claude Code sobre DeepSeek V3.1 con solo unas pocas variables de entorno.

Esta guía te lleva paso a paso por la instalación, configuración y uso.

1. Instalar Claude Code

Claude Code puede instalarse de dos maneras:

Opción A (instalador curl):

curl -fsSL https://claude.ai/install.sh | bash

Opción B (npm):

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

2. Configurar para DeepSeek V3.1

Claude Code depende de variables de la API de Anthropic. Para redirigirlo al endpoint compatible con Anthropic de DeepSeek, configura estas variables de entorno:

# Apuntar al endpoint compatible con Anthropic de DeepSeek
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

# Tu clave API de DeepSeek
export ANTHROPIC_AUTH_TOKEN="TU_CLAVE_API_DEEPSEEK"

# Usar DeepSeek V3.1 como modelo principal
export ANTHROPIC_MODEL="deepseek-chat"

# Usar DeepSeek V3.1 también como modelo pequeño/rápido
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-chat"

Notas:

deepseek-chat = DeepSeek V3.1 (modo sin razonamiento)
deepseek-reasoner = DeepSeek V3.1 modo razonamiento (soporta trazas detalladas de “pensamiento”, pero uso limitado de herramientas)

Si quieres el modelo de razonamiento, reemplaza deepseek-chat por deepseek-reasoner.

3. Script de Inicio con Un Solo Clic

Para simplificar el uso, puedes crear un script shell llamado start-claude-deepseek.sh:

#!/bin/bash
# DeepSeek V3.1 con Claude Code

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="TU_CLAVE_API_DEEPSEEK"
export ANTHROPIC_MODEL="deepseek-chat"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-chat"

# Lanzar Claude Code
claude "$@"

Hazlo ejecutable:

chmod +x start-claude-deepseek.sh

Ahora ejecuta Claude Code con:

./start-claude-deepseek.sh

4. Uso

Navega a la carpeta de tu proyecto y ejecuta el script:

cd tu-proyecto
../start-claude-deepseek.sh

A partir de aquí, Claude Code se comporta exactamente igual—excepto que ahora está potenciado por DeepSeek V3.1.

5. Solución de Problemas

Error de token inválido → verifica que ANTHROPIC_AUTH_TOKEN esté configurado con tu clave API real de DeepSeek.
Sin respuesta → confirma que ANTHROPIC_BASE_URL sea correcto (https://api.deepseek.com/anthropic).
Llamadas a herramientas/funciones → soportadas en deepseek-chat; deepseek-reasoner puede volver a deepseek-chat.

✅ Ya estás listo para usar Claude Code con DeepSeek V3.1 como tu asistente de codificación AI.