Claude Code en VS Code: cómo usar la extensión

Como comenté en la sección de capacidades, el modo plan funciona muy bien para cambios grandes. Un detalle que me salté allí: Claude también ejecuta comandos de exploración primero y guarda el plan completo en un archivo. Añade tus comentarios antes de que se escriba nada. El plan por escrito me resulta útil incluso cuando acabo cambiando la mayor parte.

Para dar contexto dirigido, usa las menciones @ con rangos de líneas: @app.ts#5-10 centra a Claude en una región concreta. Mantener Shift mientras arrastras archivos a la caja de prompts los añade como adjuntos. Option+K en Mac (o Alt+K en Windows y Linux) inserta una @-mención del archivo y selección actuales directamente.

Atajos de teclado de VS Code que merece la pena conocer

Estos atajos vienen de la documentación de la extensión de VS Code de Anthropic y recogen los que más utilizo en el panel.

El cambio de modo de permisos sigue en la CLI: pulsa Shift+Tab en la terminal integrada para moverte entre default, plan y accept-edits. Para ver todos los slash commands, consulta nuestra guía de slash commands de Claude Code.

Los checkpoints registran las ediciones de archivos de Claude durante la sesión. Pasa el ratón por cualquier mensaje de la conversación para mostrar el botón de rebobinar. Las opciones son: bifurcar la conversación manteniendo los cambios de código, rebobinar el código manteniendo el historial de la conversación o ambas. Los checkpoints se conservan 30 días. No registran comandos de bash: rm, mv y cp quedan fuera del sistema de checkpoints. Para algo destructivo, Git sigue siendo la red de seguridad adecuada.

Claude Code en VS Code para depuración y refactorización

Ambos flujos siguen los mismos pasos: dale contexto a Claude, revisa el cambio propuesto, verifica el resultado. La parte delicada en cada uno es reunir el contexto adecuado.

Depuración

Comparte el error pegándolo directamente, haciendo referencia a la salida de la terminal con @terminal:name o dejando que Claude lea el panel Problemas vía mcp__ide__getDiagnostics. Claude rastrea la causa raíz, propone una solución como diff y tú ejecutas tus tests para verificar.

Claude Code no se integra con el depurador nativo de VS Code: no hay breakpoints, ni paso a paso, ni variables en vivo. Compartir errores y diagnósticos cubre la mayoría de casos. Si necesitas el depurador específicamente, hay un servidor MCP comunitario (claude-debugs-for-you en GitHub) que hace de puente, pero requiere su propia configuración.

Para depuración web en vivo, @browser conecta Claude con Chrome mediante la extensión Claude para Chrome (versión 1.0.36 o superior). Un prompt como @browser go to localhost:3000 and check the console for errors permite a Claude inspeccionar el estado del navegador en vivo sin cambiar de ventana.

Refactorización

Claude gestiona bien cambios coordinados entre archivos: renombrar una función en una base de código grande, migrar de una librería a otra. El paso de revisión del diff es lo que evita que sea temerario.

El archivo CLAUDE.md es clave aquí más que en ningún otro punto del artículo. Sin cargar las convenciones específicas del proyecto, Claude recurre a los patrones que infiere del código, que pueden no coincidir con lo que realmente quieres. Como mencioné en la configuración, /init te da un archivo de partida; dedicarle diez minutos a pulirlo antes de una sesión grande de refactor compensa.

La compactación del contexto es el límite práctico de las sesiones largas. Cuando se llena la ventana de contexto, Claude compacta automáticamente resumiendo conversaciones antiguas. A partir de ahí, puede perder decisiones previas. Ejecutar /compact manualmente antes de empezar una nueva fase da resultados más predecibles que esperar a que la autocombactación salte a mitad de tarea.

Claude Code en VS Code vs. el flujo en terminal

La documentación de Anthropic llama a la extensión de VS Code "la forma recomendada de usar Claude Code en VS Code". La extensión aporta cosas que la terminal no puede: visor de diffs en paralelo, revisión de planes en un documento markdown que puedes editar, varias conversaciones en pestañas separadas y @browser para depuración web en vivo.

La terminal gana en capacidad. El atajo ! de bash, el autocompletado por tabulador, el conjunto completo de slash commands y flujos basados en pipes como tail -200 app.log | claude -p "..." son exclusivos de la CLI. La configuración de servidores MCP también es solo por terminal. Desde la extensión puedes gestionar servidores existentes con /mcp pero no añadir nuevos.

No son excluyentes. Ejecutar claude en la terminal integrada de VS Code sigue dándote integración con el IDE: visualización de diffs, compartir contexto de selección y diagnósticos funcionan igual. Las sesiones iniciadas en la extensión pueden continuar en la terminal con claude --resume. Ejecuta claude --ide desde la terminal integrada cuando quieras forzar que la CLI se conecte al visor de diffs de VS Code y al puente de diagnósticos.

La mayoría de desarrolladores usan ambas: VS Code para trabajo multiarchivo y revisión cuidadosa, la terminal para tareas rápidas y automatización. Algunos se quedan en terminal para todo, y sinceramente también funciona bien. Si prefieres Cursor en lugar de VS Code, nuestra guía de Claude Code en Cursor cubre el mismo flujo de la extensión allí. Nuestra guía completa de la CLI merece la pena en cualquier caso.

Claude Code en VS Code vs. GitHub Copilot

Como dije al principio, "Claude en VS Code" puede significar la extensión nativa, Claude accedido a través del selector de modelos de GitHub Copilot o la CLI en la terminal integrada. La extensión nativa y Copilot comparten modelo pero no producto, y funcionan de forma muy distinta.

A través de Copilot, el modelo de Claude se ejecuta dentro del paradigma de chat y autocompletado de GitHub: sin sandbox local del SO, sin integraciones MCP personalizadas, sin comandos nativos de terminal. Con la extensión Claude Code, el mismo modelo funciona con hasta 1M de tokens de ventana de contexto, ejecuta tareas entre archivos y tiene acceso a checkpoints, modo plan y servidores MCP.

Las herramientas están hechas para trabajos distintos. Copilot ofrece autocompletado en línea como función principal. Claude Code no hace autocompletado. El modo agente de Copilot ha crecido mucho, pero en benchmarks de la comunidad suele ir por detrás en tareas que abarcan muchos archivos. Ninguna es intrínsecamente mejor.

Extensión nativa y Copilot: mismo modelo, experiencia diferente. Imagen del autor.

Sobre precios: Copilot Pro cuesta 10 $/mes con 300 solicitudes premium. Claude Code Pro cuesta 20 $/mes. Un patrón habitual entre desarrolladores que usan ambos es 10 $ para Copilot (autocompletado al teclear) y 20 $ para Claude Code (tareas deliberadas y de mayor alcance). Los dos productos cubren partes distintas del flujo con poca superposición. Anthropic también se ha asociado con GitHub para incluir modelos de Claude dentro de Copilot, que cubre la parte de autocompletado.

Consideraciones de seguridad y privacidad

Anthropic no usa tu código para entrenar los modelos de Claude. Los usuarios de Free, Pro y Max pueden desactivar por completo el registro de datos en los ajustes de cuenta; los planes Team, Enterprise y API están excluidos por defecto. Para detalles de modos de permisos, servidores MCP y sandbox más allá de la superficie de VS Code, consulta nuestra guía de seguridad de Claude Code.

Siempre hay un conjunto de rutas protegidas independientemente del modo: .git, .vscode, .idea, .husky, y .claude (con excepciones para sus propios subdirectorios de trabajo), además de .gitconfig, .gitmodules y varios archivos de configuración de shell y herramientas. Esto importa especialmente en el modo de aceptación automática, que escribe sin pausar y puede tocar settings.json y tasks.json. Revisa los diffs de git antes de hacer commit.

El sandbox aísla los comandos bash a tu directorio de trabajo y bloquea el acceso de red no autorizado. Está desactivado por defecto; actívalo con /sandbox.

El modo auto sustituye la aprobación por acción por un clasificador que revisa las acciones antes de ejecutarlas, bloqueando cosas como borrados masivos de archivos, envío de datos a endpoints no autorizados y force push a main. Anthropic lo describe como una alternativa más segura a --dangerously-skip-permissions.

Las transcripciones locales se guardan en texto plano en ~/.claude/projects/ durante 30 días (cleanupPeriodDays ajusta esto). Las configuraciones Enterprise en Amazon Bedrock, Google Vertex AI o Microsoft Foundry siguen las condiciones de datos de esos proveedores. El modo auto no está disponible en esos proveedores; requiere la API de Anthropic directamente.

Solución de problemas comunes de la extensión de VS Code

La mayoría de problemas de configuración entran en una lista corta. Me he topado con todos al menos una vez.

• Falta el icono Spark: Abre un archivo real, no solo una carpeta. Recarga la ventana desde la paleta de comandos (Developer: Reload Window) o haz clic en la entrada de Spark en la barra de estado (abajo a la derecha), que funciona incluso sin archivo abierto.

• Conflictos de extensiones: Desactiva temporalmente otras extensiones de IA (Cline, Continue, etc.) si Claude Code no se activa.

• Modo restringido: Claude Code no se ejecuta en el Modo restringido de VS Code. Marca el espacio de trabajo como de confianza.

• Bloqueo de archivos en Windows: Colapsa el panel Explorer y pausa los depuradores activos antes de sesiones grandes multiarchivo si las escrituras fallan a mitad.

• Conflicto de macOS Tahoe con Cmd+Esc: La superposición de juegos del sistema puede interceptar Cmd+Esc. Reasigna Claude Code: Focus input en los atajos de teclado de VS Code (Cmd+K Cmd+S) si deja de funcionar el cambio de foco.

• Bedrock o Vertex en lugar de inicio de sesión de Anthropic: Puedes apuntar Claude Code a endpoints de proveedores cloud. Nuestra guía de modelos locales y alternativos explica rutas sin suscripción.

Anthropic mantiene una guía específica de resolución de problemas si nada de lo anterior lo soluciona.

Limitaciones y compromisos

La extensión es un subconjunto de la CLI. Como vimos en la comparación con la terminal, el autocompletado por tabulador, el atajo ! de bash y los flujos por pipes son exclusivos de la CLI, al igual que el modo dontAsk para pipelines de CI.

La visibilidad de tareas en segundo plano es limitada; para lo que necesites vigilar de cerca, la terminal integrada es más transparente.

La aprobación es por archivo, no por fragmento: si Claude acertó con una función y falló con otra en el mismo archivo, aceptas todo y reviertes manualmente lo que no quieras.

Los límites de uso son lo que más frustra a los usuarios Pro. Los límites se aplican en ventanas móviles, no por mensaje, y se agotan antes en horas punta. Para uso esporádico, Pro basta; para un día completo de trabajo, Max 5x o Max 20x es más realista. No me fiaría de estimaciones de la comunidad; Anthropic no publica cifras exactas y cambian.

En Windows, el bloqueo de archivos entre el explorador de proyectos de VS Code y las escrituras de Claude provoca más fallos que en macOS o Linux. Colapsar el panel del explorador y pausar depuradores activos antes de sesiones grandes suele prevenirlo.

Reflexiones finales

Claude Code en VS Code es un agente de código orientado a tareas con una interfaz que prioriza la revisión. El visor de diffs, el modo plan y los checkpoints existen porque importa más detectar lo que el agente ha cambiado realmente que obtener un primer borrador rápido.

El flujo por terminal no va a desaparecer, y para trabajo scriptado, automatizado o intensivo en CLI sigue siendo la mejor superficie. Pero si haces un trabajo en el que quieres leer cada cambio propuesto antes de que llegue a main, el editor es mejor encaje.

Claude Code se actualiza cada semana, así que partes de este artículo quedarán desfasadas rápido. Nuestras buenas prácticas de Claude Code y la guía de Claude Code 2.1 son buenos recursos para estar al día. El changelog oficial recoge los lanzamientos. Si algo de aquí no coincide con lo que ves, mira ahí primero.

Si quieres práctica estructurada con modelos de Claude y flujos con agentes, te recomiendo nuestro curso Introduction to Claude Models.