Cómo Usar DeepSeek-V3.1 en Claude Code: Una Guía Completa

DeepSeek-V3.1 es la última versión del equipo de DeepSeek, que introduce una arquitectura híbrida de razonamiento que permite cambiar entre modos de razonamiento y no razonamiento. Ofrece inferencia más rápida y capacidades mejoradas de Agente, lo que lo hace ideal tanto para tareas rápidas como flujos de trabajo complejos.

Si estás trabajando dentro de Claude Code (el entorno de codificación con IA de Anthropic), puedes integrar DeepSeek-V3.1 sin problemas utilizando su API compatible con OpenAI. Esta guía te mostrará cómo configurarlo, usarlo y algunos consejos prácticos.

1. Requisitos Previos

Antes de comenzar, asegúrate de tener lo siguiente:

• Python ≥ 3.9

• Dependencias instaladas: SDK de openai

• Clave de API de DeepSeek: disponible en la plataforma de DeepSeek

2. Instalar Dependencias

Ejecuta lo siguiente en la terminal de Claude Code:

bash
pip install openai

Luego importa el cliente:

from openai import OpenAI

3. Configurar la Clave de API

Puedes establecer tu clave de API mediante variables de entorno:

bash
export OPENAI_API_KEY="tu-clave-de-api-deepseek"

O directamente en el código (no recomendado para producción):

client = OpenAI(
    api_key="tu-clave-de-api-deepseek",
    base_url="https://api.deepseek.com"
)

4. Llamar a DeepSeek-V3.1

DeepSeek-V3.1 ofrece dos modelos:

• Modo Sin Razonamiento (deepseek-chat): salidas rápidas y concisas

• Modo con Razonamiento (deepseek-reasoner): razonamiento paso a paso con lógica más detallada

Ejemplo de uso:

from openai import OpenAI

# Inicializar el cliente
client = OpenAI(api_key="tu-clave-de-api-deepseek", base_url="https://api.deepseek.com")

# Modo Sin Razonamiento
response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "Eres un asistente útil."},
        {"role": "user", "content": "Explica la diferencia entre hosting VPS y VDS en términos simples."}
    ]
)
print("Salida Sin Razonamiento:")
print(response.choices[0].message.content)

# Modo con Razonamiento
response = client.chat.completions.create(
    model="deepseek-reasoner",
    messages=[
        {"role": "user", "content":