Cómo configurar Claude Code en VS Code y usarlo para algo más que autocompletar

Instalado no es lo mismo que integrado

Poner Claude Code en marcha junto a VS Code lleva unos diez minutos. Conseguir que cambie tu forma de trabajar lleva más. Lo habitual es conectarlo y tratarlo como Copilot: autocompletado con Tab, sugerencias rápidas y alguna refactorización suelta. Está bien y es útil, pero no transforma nada, y se parece un poco a conducir un deportivo en primera. Tener a Claude en el editor y tenerlo integrado en tu flujo de trabajo son cosas distintas. La configuración es rápida; lo que rinde es saber qué pedirle una vez funcionando.

Cuatro maneras de usar Claude con VS Code

"Claude en VS Code" puede significar varias cosas:

• Claude Code en la terminal: la CLI propia de Anthropic. Tiene acceso a todo tu código, lee y escribe archivos, ejecuta comandos y trabaja con muchos archivos a la vez. Es la más potente de las cuatro.
• GitHub Copilot con un modelo Claude: quien esté suscrito a Copilot puede cambiar el modelo por Claude Sonnet y seguir en la interfaz que ya conoce.
• Claude.ai en una pestaña del navegador junto al editor: poco tecnológico e infravalorado. Pegas código, recibes sugerencias y lo vuelves a pegar. Es más lento, funciona en cualquier sitio y no cuesta nada extra.
• Extensiones de terceros que añaden un chat de Claude en la barra lateral: la calidad varía y algunas llevan meses sin actualizarse.

El resto del artículo se centra en Claude Code, porque es el que cambia lo que la IA puede hacer. El chat del navegador y Copilot son prácticos pero limitados. Claude Code ve el proyecto entero, entiende cómo se relacionan los archivos, ejecuta tests e itera, y eso es otra clase de herramienta.

Configuración en tres pasos

Cuenta con unos 10 minutos si ya lo has hecho antes y quizá 20 la primera vez.

Instalación

Claude Code es una herramienta de línea de comandos que se instala con npm:

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

Necesita Node.js 18 o posterior, así que actualiza primero si tienes una versión más antigua. Tras instalarlo, arráncalo:

claude

Te pedirá iniciar sesión con tu cuenta de Anthropic. Para empezar basta una cuenta gratuita, pero en un proyecto real llegarás pronto a los límites. Una vez autenticado, ya está.

Úsalo desde la terminal de VS Code

El método que se describe aquí no usa ninguna extensión de VS Code. Claude Code se ejecuta en la terminal integrada, así que la rutina es:

1. Abre el proyecto en VS Code.
2. Abre la terminal integrada con Ctrl+ (Cmd+ en Mac).
3. Haz cd hasta la raíz del proyecto.
4. Escribe claude.

A partir de ahí tiene contexto sobre el proyecto. Puede leer archivos, entender la estructura, ejecutar tus tests y cambiar varios archivos de una sola pasada. Además convive bien con el editor: deja que Claude edite en el panel de la terminal y mira cómo los cambios aparecen en el editor en tiempo real. La pantalla dividida cuesta un poco al principio y luego resulta muy fluida.

Escribe un CLAUDE.md

La mayoría de los tutoriales se saltan este paso, y es el que más rinde. CLAUDE.md es un archivo en la raíz del proyecto que le explica a Claude tus convenciones, preferencias y reglas. Sin él, Claude hace suposiciones razonables a partir de lo que ve. Con él, actúa como si llevara meses en el equipo. Una versión mínima:

# Project conventions

## Tech stack
- Node.js 20, TypeScript, Express
- PostgreSQL via Prisma
- Jest for testing

## Code style
- Use async/await, never callbacks
- Prefer explicit error handling over try/catch everywhere
- All new functions need JSDoc comments

## Testing
- Every new endpoint needs at least 3 tests: happy path,
  validation error, and auth failure
- Use factories, not fixtures

## What NOT to do
- Don't use any (TypeScript). Use unknown and narrow it.
- Don't add console.log for debugging. Use the logger.
- Don't install new dependencies without asking first.

Quince minutos con este archivo ahorran horas corrigiendo el comportamiento por defecto de Claude. Actualízalo cada vez que veas que Claude repite el mismo error.

Hábitos que hacen que merezca la pena

Con la configuración lista, lo difícil es usarlo de forma que supere a una simple ventana de chat.

Encárgale trabajos más grandes

Un hábito frecuente al principio es usar Claude Code como un autocompletado de lujo, pidiendo una función, un arreglo de sintaxis o un parámetro más cada vez. Funciona, pero no es lo que hace especial a la herramienta. Rinde mejor con tareas grandes. Algo así: añade paginación a todos los endpoints de listado de esta API; así lo hace ahora el endpoint de users; aplica el mismo patrón en todas partes. A mano es una hora de trabajo, y Claude puede hacerlo en unos cinco minutos.

La ventana de contexto es lo bastante grande para abarcar una parte considerable de un código real, así que aprovéchala. Dale varios archivos, describe el panorama completo y deja que trabaje sobre todo ello.

Pídele que investigue

Cuando en producción aparece algo raro, como una consulta lenta, una respuesta ligeramente incorrecta o un error que solo sale de vez en cuando, descríbelo, señala a Claude los archivos relevantes y pregúntale dónde podría estar fallando. Recorre el código y te devuelve una lista de sospechosos ordenada por probabilidad. No siempre acierta, pero encuentra cosas que se te habrían pasado y sigue los caminos de ejecución mucho más rápido que a mano.

En una prueba cara a cara con Cursor y Copilot sobre un bug real, Claude Code fue el único que se detuvo a hacer una pregunta aclaratoria antes de empezar, y esa pregunta resultó ser el bug entero.

Escribe primero el test

Suena al revés, y para cualquier cosa con requisitos claros funciona muy bien. Escribe un test que describa el comportamiento que quieres, pásaselo y dile: haz que pase sin romper nada más. De ahí salen tres cosas. La implementación se ajusta a tus requisitos reales, porque los definiste en código. Las ambigüedades salen pronto, porque escribir el test te obliga a pensar en los casos límite. Y terminas con un test en la mano, algo que no tendrías necesariamente si pidieras primero la funcionalidad y los tests después. Merece especialmente la pena en flujos de pago, autenticación y APIs externas, donde los errores son tan caros que conviene definir el comportamiento correcto antes de que exista el código.

Úsalo para refactorizar

Las refactorizaciones son fáciles de describir y pesadas de hacer con cuidado. Quizá una función ha crecido demasiado, un módulo ha asumido demasiadas cosas o el mismo fragmento se ha copiado cinco veces en lugar de abstraerse. Dile a Claude de qué debería encargarse el módulo, pídele que extraiga el resto a uno nuevo y que actualice todos los imports. Puede hacerlo en todo el código, corregir cada referencia y ejecutar la batería de tests para comprobar que no se ha roto nada. Lo que llevaría una mañana de trabajo minucioso puede quedar listo en veinte minutos.

Dónde se queda corto

• Se equivoca con seguridad. Claude Code a veces implementa algo mal sin mostrar ninguna duda, así que lee el resultado y no te limites a ejecutarlo, sobre todo si toca datos o dinero.
• No te hará la arquitectura. Llevar a cabo un diseño es su punto fuerte; decidir qué construir, cómo estructurar el sistema y qué compromisos asumir, no. Esas decisiones siguen siendo tuyas.
• Los límites de contexto son reales. En un código muy grande no lo ve todo, así que indícale los archivos relevantes en vez de dar por hecho que sabe dónde mirar.
• No puede ejecutar lo que tu entorno no puede ejecutar. Si los tests necesitan una conexión concreta a la base de datos, un servidor en marcha o variables de entorno, todo eso tiene que estar configurado. Trabaja en tu entorno real; no hace magia.

Conviene saber exactamente dónde falló en una funcionalidad realista antes de confiarle algo crítico para producción.

Tres prompts que vale la pena guardar

Salieron de mucho ensayo y error.

Primero el contexto. Explica de forma explícita el comportamiento actual y el deseado, para que Claude no malinterprete lo que ya existe:

I'm working in [filename]. Here's the current behavior:
[describe it]

Here's what I want it to do instead:
[describe it]

Constraints: [any important limits]

Make the change and update any affected tests.

Saca a la luz las suposiciones. Úsalo siempre que los requisitos sean mínimamente ambiguos. Cuesta medio minuto y te libra de una implementación sutilmente equivocada:

Before you start coding, list the assumptions you're making
about how this should work. I'll confirm or correct them.

Revisión con lista de comprobación. Una revisión de código es más útil cuando dices qué buscar. Si no, el modelo tiende a señalar cuestiones de estilo y pasar por alto lo importante. Ejecútalo antes de fusionar cualquier cambio relevante:

Review this code for: performance issues, security concerns,
missing error handling, and anything that would cause problems
at scale. Be specific. If something is fine, say it's fine
and move on.

¿Claude Code o Copilot?

Cada uno destaca en un trabajo distinto, por eso quien prueba los dos suele quedarse con ambos. Copilot gana en el autocompletado en línea: las sugerencias aparecen mientras escribes sin cambiar de contexto mental, su autocompletado con Tab sigue siendo más fluido y está algo mejor integrado en la interfaz de VS Code. Claude Code es más fuerte en tareas de varios archivos, investigación, refactorización y todo lo que puedas describir en lenguaje natural y dejar que la IA resuelva a lo largo del código. En capacidad agéntica va claramente por delante.

Si tienes que elegir uno, elige Claude Code, porque el trabajo que solo él hace bien vale más que un autocompletado más rápido. Muchos desarrolladores que lo usan a diario siguen teniendo Copilot en segundo plano y alternan según la tarea.

Qué marcó la diferencia

Tras meses de uso diario, la mayor mejora no vino de la configuración. Vino de cambiar lo que pides. Quienes más partido sacan a Claude Code no lo usan para escribir funciones más deprisa. Le dan problemas más grandes, más desordenados y más realistas: la refactorización siempre aplazada, la funcionalidad que abarca seis archivos, la investigación que se comería una tarde leyendo logs.

La configuración cuesta diez minutos. Aprender a pensar en esas tareas más grandes es la verdadera inversión, y merece la pena.