Claude Code con DeepSeek V4: 10 veces más barato y el mismo rendimiento

Claude Code es increíble, pero el costo se ha disparado. Opus 4.7 cuesta $25 por cada millón de tokens de salida. Sonnet 4.6, $15. Una sesión intensa de desarrollo puede dejarte fácilmente entre $5 y $15 USD. Y si te aparece el mensajito de “has llegado al límite, vuelve en tantas horas”, sabes de lo que hablo.

Hace unos días salió DeepSeek V4 Pro y los benchmarks de programación lo ponen a la par de Opus 4.6 — con un costo de $1.74 por millón de tokens. Y si hablamos del modelo Flash, son apenas $0.07. Literalmente 10 veces más barato.

En esta guía te enseño cómo conectar DeepSeek con Claude Code usando el proxy free-claude-code y el atajo claudeds que tengo en mi terminal. Skills, MCPs, subagentes, memoria — todo sigue funcionando igual.

Cómo funciona: el adaptador universal

Imagina que viajas a otro país y llevas tu laptop. El enchufe es distinto — no encaja. Necesitas un adaptador entre la clavija y la toma de corriente.

Claude Code es la clavija. DeepSeek es la toma de pared. Tienen protocolos distintos y no se conectan directamente. El proxy free-claude-code es el adaptador que va en medio: recibe la señal de Claude Code en formato Anthropic, la traduce al formato de DeepSeek, obtiene la respuesta y se la devuelve a Claude Code en el formato que espera.

Claude Code ni se entera del cambio. Skills, MCPs, subagentes, memoria — todo sigue funcionando exactamente igual, porque el adaptador solo traduce la corriente, no cambia lo que puedes hacer con ella.

Claude Code CLI / IDE
        │
        │ Anthropic Messages API
        ▼
free-claude-code proxy (localhost:8082)
        │
        │ DeepSeek Anthropic-compatible endpoint
        ▼
DeepSeek V4 Pro / Flash

DeepSeek V4 Pro vs Flash: cuál usar

DeepSeek tiene dos modelos que valen la pena:

Regla práctica: empieza siempre con V4 Pro. Cuando la tarea esté clara y acotada, cambia a Flash. El proxy te permite alternar entre modelos con /model desde Claude Code.

Comparativa de precios real

Con $5 USD de saldo en DeepSeek puedes trabajar semanas o incluso meses, dependiendo de la intensidad. El mismo uso en Opus te habría costado $50 o más.

Paso 1: Crear cuenta en DeepSeek y obtener API Key

Ve a platform.deepseek.com y crea una cuenta. Es gratis.

Una vez dentro, ve a Top Up y recarga $5 USD — yo lo hice con PayPal. Sin saldo la API no funciona.

Luego ve a API Keys en el menú lateral, crea una nueva key y guárdala:

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Importante: no compartas esta key ni la subas a repositorios públicos.

Paso 2: Instalar uv y Python 3.14

El proxy free-claude-code usa uv como gestor de paquetes y Python 3.14. En Arch Linux:

sudo pacman -S uv
uv self update
uv python install 3.14

En Ubuntu:

curl -LsSf https://astral.sh/uv/install.sh | sh
uv self update
uv python install 3.14

Paso 3: Clonar y configurar free-claude-code

Clona el repositorio:

git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code
cp .env.example .env

Edita el archivo .env con los datos de DeepSeek:

nano .env

Configura solo estas variables:

DEEPSEEK_API_KEY="sk-tu-api-key-de-deepseek"
MODEL="deepseek/deepseek-v4-flash"
ANTHROPIC_AUTH_TOKEN="freecc"

Puedes elegir el modelo que quieras como fallback: deepseek/deepseek-v4-flash o deepseek/deepseek-v4-pro. Luego desde Claude Code podrás alternar entre ambos con /model.

Paso 4: Iniciar el proxy

uv run uvicorn server:app --host 0.0.0.0 --port 8082

Déjalo corriendo. El proxy escucha en localhost:8082 y traduce todo el tráfico de Anthropic a DeepSeek.

Paso 5: Lanzar Claude Code contra el proxy

Abre otra terminal y ejecuta:

ANTHROPIC_AUTH_TOKEN="freecc" \
ANTHROPIC_BASE_URL="http://localhost:8082" \
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 \
claude

Claude Code arranca normalmente, pero todo el tráfico pasa por el proxy hacia DeepSeek. Para verificar, escribe /model y verás los modelos de DeepSeek disponibles:

• deepseek/deepseek-v4-pro
• deepseek/deepseek-v4-pro (no thinking)
• deepseek/deepseek-v4-flash
• deepseek/deepseek-v4-flash (no thinking)

Mi atajo: claudeds

Para no escribir todo eso cada vez, tengo una función en mi .bashrc que automatiza el proceso. Si el proxy no está corriendo, lo arranca automáticamente:

claudeds() {
    local args=()
    local voice=0

    for arg in "$@"; do
        if [[ "$arg" == "--voice" ]]; then
            voice=1
        else
            args+=("$arg")
        fi
    done

    if ! ss -tlnp | grep -q 8082; then
        echo "Arrancando proxy DeepSeek..."
        nohup uv --directory /home/vhs/tmp/free-claude-code run python \
            /home/vhs/tmp/free-claude-code/server.py \
            > /tmp/free-claude-code.log 2>&1 &
        sleep 2
    fi

    if [[ "$voice" == "1" ]]; then
        env CLAUDE_VOICE=1 ANTHROPIC_AUTH_TOKEN="freecc" \
            ANTHROPIC_BASE_URL="http://localhost:8082" \
            CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 \
            claude "${args[@]}"
    else
        env ANTHROPIC_AUTH_TOKEN="freecc" \
            ANTHROPIC_BASE_URL="http://localhost:8082" \
            CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 \
            claude "${args[@]}"
    fi
}

Así de simple. Abro la terminal, escribo claudeds, y ya estoy usando Claude Code con DeepSeek V4. También tengo el modo voz con claudeds --voice.

Seguridad: qué NO enviar a DeepSeek

DeepSeek es un modelo chino. No tenemos control sobre dónde van los datos ni qué hacen con ellos. Sin caer en la paranoia, hay que usar criterio:

No envíes nunca:

• API Keys de ningún servicio (o usa keys temporales de una hora)
• Contraseñas ni tokens de acceso
• Datos personales de clientes (rompes compliance con RGPD)
• Datos sensibles de salud, finanzas o legales
• Propiedad intelectual de clientes
• Conversaciones privadas con información regulada

Sí puedes enviar:

• Código de tus proyectos personales para MVPs
• Boilerplates genéricos
• Frameworks open source (React, Nest, FastAPI, etc.)
• Tests sin datos reales
• Documentación técnica
• Algoritmos genéricos

Si manejas datos regulados de clientes, usa Claude o GPT con acuerdo empresarial y sé compliant.

Conclusión

Hace 3 años hablar con un modelo de IA decente costaba miles de dólares al mes. Hoy, con $5 de saldo y 10 minutos de configuración, tienes en tu terminal un modelo que empata con lo mejor del planeta para programar.

El cuello de botella en 2026 no es la tecnología ni el costo — es si decides empezar o no.

Con DeepSeek V4 y free-claude-code, Claude Code sigue siendo la misma herramienta de siempre. Solo que ahora la electricidad es mucho, mucho más barata.