⚡ Resumen rápido
Puedes usar Claude Code con DeepSeek V4 por debajo y pagar aproximadamente 10 veces menos en tareas de código rutinario. Se hace con un proxy gratuito llamado free-claude-code, dos prompts que pegas en Claude Code (no escribes ni un comando), y dos atajos de terminal: ds y dsdanger. Lectura: 6 minutos. Instalación real: 15 minutos.
📑 Lo que vas a encontrar
- El problema que probablemente ya tienes
- Qué vas a montar exactamente
- Comparativa de coste real: Claude Opus vs DeepSeek V4
- Paso 1: API key de DeepSeek
- Paso 2: Instalar el proxy con un solo prompt
- Paso 3: Crear los atajos de terminal
- 6 errores comunes y cómo resolverlos
- Cuándo usar DeepSeek y cuándo Claude Opus
- Aviso importante sobre privacidad y RGPD
- Latencia y diferencias reales de calidad
El problema que probablemente ya tienes con Claude Code
Si usas Claude Code casi todos los días, sabes que la potencia de Claude Opus está bien justificada cuando la aprovechas de verdad. Pero también sabes que la mayor parte del tiempo lo usas para tareas que no necesitan tanta potencia: refactorizar funciones, formatear código, generar tests repetitivos, limpiar errores de sintaxis. Y eso, multiplicado por todos los días del mes, se nota en la factura.
Hay una alternativa rara que casi nadie cuenta bien: dejar Claude Code exactamente como está y cambiarle el motor por dentro. Mismo terminal, misma interfaz, mismos comandos. Solo que cuando le pides ayuda con código, en lugar de hablar con los servidores de Anthropic, habla con DeepSeek V4 a través de un proxy local llamado free-claude-code.
El resultado: aproximadamente diez veces más barato para el tipo de tareas en las que la diferencia de calidad es prácticamente invisible.
En este artículo te dejo el paso a paso completo, los dos prompts que hacen el trabajo sucio, y los seis errores que te puedes encontrar con su solución exacta. Yo lo abrí, lo probé, funciona. No llevo tres meses con esto en producción, así que te lo cuento como lo veo, sin venderte humo.
Qué vas a montar exactamente
Antes de meterte en harina, conviene que entiendas qué piezas componen el sistema. Son tres y trabajan coordinadas:
🔧 Las tres piezas del sistema
Pieza uno — Tu Claude Code de siempre. No lo tocas. Sigue funcionando exactamente igual que hasta ahora.
Pieza dos — El proxy free-claude-code. Es un pequeño servicio que arranca en tu máquina, escucha en el puerto 8082 y hace de traductor entre Claude Code y DeepSeek. Es de código abierto y gratuito.
Pieza tres — Tu cuenta en DeepSeek con saldo cargado. Es lo único que pagas. Y muy poco.
Cuando los tres elementos están en su sitio, le dices a Claude Code mediante una variable de entorno que apunte al proxy local en lugar de a los servidores de Anthropic. El resto es transparente para ti: escribes ds en tu terminal y todo funciona como siempre, solo que con DeepSeek por debajo.
Comparativa de coste real: Claude Opus vs DeepSeek V4
Para que te hagas una idea de la diferencia económica, estos son los precios oficiales por millón de tokens en mayo de 2026:
| Modelo | Tokens entrada (1M) | Tokens salida (1M) | Tarea refactor 80 líneas |
|---|---|---|---|
| Claude Opus 4.7 | $5,00 | $25,00 | ~$0,40 |
| DeepSeek V4 Pro | $1,74 | $3,48 | ~$0,04 |
Una tarea típica de refactor de un script Python de unas 80 líneas me cuesta 40 céntimos con Claude Opus y 4 céntimos con DeepSeek V4. Si haces este tipo de tareas diez veces al día, hablamos de 15 euros la semana solo en refactor que se convierten en menos de dos. Multiplicado por el mes, la diferencia es real.
Paso 1: Conseguir tu API key de DeepSeek
Tiempo: 3 minutosLo primero es tener una cuenta en DeepSeek y una clave API válida con saldo cargado. Es lo único de todo el proceso que cuesta dinero.
- Entra en platform.deepseek.com y regístrate. Puedes usar tu correo o una cuenta de Google.
- Una vez dentro, ve al menú lateral y busca la sección API Keys.
- Pulsa Create new API key, dale un nombre que reconozcas (por ejemplo, claude-code-proxy), y cópiala inmediatamente. Esa clave solo se muestra una vez.
- Ve a la sección Top up y carga el mínimo, que son 5 dólares. Con eso tienes para muchísimas sesiones de uso intensivo.
Guarda la API key en un sitio seguro. La vas a usar en el siguiente paso.
Paso 2: Que Claude Code se instale el proxy a sí mismo
Tiempo: 5 minutosAquí está la parte bonita del método: en lugar de pelearte con la consola, abres tu Claude Code de siempre y le pegas un prompt que le pide que haga todo el trabajo sucio por ti. Clona el repositorio del proxy, instala las dependencias, configura las variables y arranca el servicio.
Clona el repositorio https://github.com/Alishahryar1/free-claude-code en mi carpeta de proyectos. Después conéctalo a DeepSeek usando esta API key: sk-... (sustituye por la tuya). Configura el archivo .env con el endpoint correcto, instala las dependencias con npm install, y arranca el proxy en background en el puerto 8082. Cuando termine, dime si está corriendo y en qué URL responde.
Pegas eso en tu Claude Code, sustituyes sk-... por tu clave real, y dejas que trabaje. Te irá mostrando lo que hace en tiempo real. Cuando termine, debería decirte algo como «el proxy está corriendo en http://localhost:8082».
Paso 3: Crear los dos atajos de terminal
Tiempo: 2 minutosEl proxy ya está funcionando en tu máquina, pero cada vez que abras Claude Code tendrías que exportar manualmente las variables de entorno para que apunte al proxy. Eso es un coñazo y se te va a olvidar la mitad de las veces.
La solución es crear dos atajos permanentes en tu terminal: uno para uso normal y otro para sesiones donde no quieras que Claude Code te pida confirmación cada dos por tres.
Una vez el proxy esté funcionando, créame dos alias permanentes en mi terminal: el primero, ds, que arranque Claude Code con la variable ANTHROPIC_BASE_URL apuntando a http://localhost:8082 y GATEWAY_MODEL_DISCOVERY=1, llamándolo freecc. El segundo, dsdanger, igual que el anterior pero añadiendo el flag --dangerously-skip-permissions para sesiones donde quiera saltarme las confirmaciones. Guárdalos en mi .zshrc o .bashrc según corresponda y deja la sesión recargada.
A partir de ese momento, cuando quieras Claude Code con DeepSeek por debajo, simplemente escribes ds en tu terminal y listo. Y si en una sesión concreta prefieres saltarte las confirmaciones, escribes dsdanger.
El uso queda así de simple:
# Sesión normal con DeepSeek
ds
# Sesión sin confirmaciones (úsalo con cabeza)
dsdanger
# Sesión con Claude Opus original
claude6 errores comunes en la instalación y cómo resolverlos
Si has llegado hasta aquí sin ningún tropiezo, enhorabuena. Pero la realidad es que la mayoría de instalaciones tienen al menos un pequeño problema. Estos son los que más me he encontrado y la solución exacta de cada uno.
⚠️ Error 1: «Node no está instalado» o versión obsoleta
El proxy free-claude-code necesita Node.js versión 18 o superior. Si tu sistema tiene una versión más antigua, la instalación de dependencias va a fallar con errores raros.
node --version. Si te devuelve v16.x o un mensaje de «command not found», es esto.brew install node. En Linux, usa nvm para no liarte con permisos del sistema.⚠️ Error 2: Puerto 8082 ocupado
El proxy intenta arrancar en el puerto 8082. Si tienes otro servicio escuchando ahí (no es raro en máquinas de desarrollo), va a fallar al iniciar.
EADDRINUSE: address already in use :::8082.lsof -i :8082 te dice qué hay corriendo, y luego kill [PID] para cerrarlo. La segunda, cambiar el puerto del proxy. Edita el archivo .env que generó Claude Code, cambia el puerto a 8083 o el que prefieras, y acuérdate de actualizar también la variable ANTHROPIC_BASE_URL en tus alias.⚠️ Error 3: El alias «ds» no se carga
Has creado los alias, pero cuando escribes ds en tu terminal te dice «command not found». Esto pasa típicamente porque el shell aún no ha leído el archivo de configuración modificado.
source ~/.zshrc si usas zsh, o source ~/.bashrc si usas bash. Si después sigue sin funcionar, es probable que Claude Code haya escrito el alias en el archivo equivocado. Comprueba con cat ~/.zshrc | grep alias que el alias esté ahí, y si no, edita manualmente el archivo correcto.⚠️ Error 4: La variable de entorno no se exporta correctamente
Esto es un error sutil. El alias se ejecuta, Claude Code arranca, pero sigue conectándose a los servidores de Anthropic en lugar de a tu proxy local. La factura no baja, y te quedas con la sensación de que no funciona.
ds activo, en otra terminal ejecuta echo $ANTHROPIC_BASE_URL. Si te devuelve vacío o la URL oficial de Anthropic, el alias no está exportando bien la variable.export antes de la variable, y de que la URL apunta exactamente a http://localhost:8082. Un error típico es escribir https en lugar de http, o poner el puerto incorrecto.⚠️ Error 5: API key de DeepSeek inválida o sin saldo
El proxy arranca, los alias funcionan, pero al pedirle algo a Claude Code te devuelve un error de autenticación o de fondos insuficientes.
.env del proxy, vuelve a copiarla y reinicia el proxy.⚠️ Error 6: Claude Code abierto en otra ventana no detecta el cambio
Has hecho todo correctamente, pero tienes Claude Code corriendo en otra terminal de antes y los cambios no se aplican.
Cuándo usar DeepSeek y cuándo Claude Opus original
Después de probarlo, mi conclusión es clara: este sistema no sustituye a Claude Code original, lo complementa. Y la diferencia entre usarlo bien o usarlo mal está en saber para qué tareas te conviene cada motor.
✅ Usa ds (DeepSeek) para
- Refactorizar código existente
- Formateo y limpieza de archivos
- Generar tests unitarios repetitivos
- Convertir formatos de datos
- Documentar funciones ya escritas
- Tareas con contexto pequeño y respuesta predecible
🎯 Usa claude (Opus original) para
- Diseño de arquitectura de software
- Decisiones técnicas con muchas variables
- Debugging complejo
- Cualquier código con datos sensibles
- Sesiones largas con agentes encadenados
- Razonamiento de varios pasos
Aviso importante sobre privacidad y RGPD
🚨 Esto no es opcional, es importante
DeepSeek es una empresa china y sus servidores no están en Europa. Esto tiene una implicación práctica que no puedes ignorar: todo lo que envíes a través del proxy puede ser procesado en jurisdicciones distintas a las del RGPD europeo.
Para proyectos personales, código de prueba, o desarrollo de software no confidencial, no es un problema. Para código de tu empresa, datos sensibles de clientes, información médica, financiera o cualquier cosa que esté bajo acuerdo de confidencialidad, no lo uses. Punto.
El ahorro económico es real. Los problemas legales de filtrar datos protegidos también lo son. Combina con cabeza.
Latencia y diferencias reales de calidad
Dos cosas más que te aviso de cara a la práctica:
⏱️ La latencia es ligeramente superior
DeepSeek responde algo más despacio que Claude Opus, especialmente en tareas largas o cuando el contexto es muy grande. No es bloqueante para uso normal, pero si trabajas con agentes que encadenan muchos pasos, lo vas a notar.
🎯 La calidad ronda el 90% para código rutinario
Para refactor y formateo, no notas diferencia. Para arquitectura compleja, sí la notas. La salida no es exactamente igual a la de Claude Opus, aunque sea muy parecida. Esto es relevante si trabajas en código crítico donde una decisión de implementación puede tener consecuencias importantes.
Mi recomendación final
Si tu uso de Claude Code es sobre todo de tareas repetitivas, este sistema te va a ahorrar mucho dinero al mes con un coste de calidad mínimo. Si tu uso es más de arquitectura y decisiones complejas, mantén Claude Opus original y olvídate de esto. Si tu uso es mixto, instala los dos atajos y usa cada uno cuando toque.
Lo importante es que ahora puedes elegir. Antes pagabas Claude Opus para todo. Ahora pagas Claude Opus solo cuando merece la pena, y DeepSeek para el resto.
Un sistema más
Has aprendido a montar el sistema. Ahora toca probarlo.
Empieza por una tarea pequeña. Refactor de un script. Formateo de un archivo. Algo donde si la calidad es del 90%, no pasa nada.
Y si te sirve, cuéntamelo en los comentarios del vídeo.
Un sistema más. Un día más.
- ✅ Tips de IA práctica cada semana
- ✅ Sistemas de constancia de 500+ días
- ✅ Herramientas probadas (no teoría)