Herramientasclaude code
Cómo usar Claude Code en VS Code: primeros pasos
Aprende a usar Claude Code en VS Code: instala la integración, abre un proyecto de prueba y revisa permisos y cambios antes de aceptar resultados.
- Autor: humAIns
- 9 min de lectura
índice · 7 apartados
Claude Code en VS Code se usa desde una extensión oficial que añade un panel de conversación al editor: puedes pedir que explique archivos, proponer cambios y revisar diferencias sin empezar por la terminal. Para probarlo, instala la extensión, abre una carpeta ficticia y comienza con una tarea de solo lectura, como entender un README de ejemplo. El servicio requiere una cuenta compatible y conviene mantener el modo de permisos en Manual mientras aprendes.
Esta guía cubre la integración del editor, no la instalación y actualización de la herramienta por terminal. Si ya trabajas con el CLI, consulta también cómo actualizar Claude Code, cómo instalar skills de Claude Code y cómo usar Claude en el trabajo.
Requisitos y diferencia entre extensión y terminal
Necesitas Visual Studio Code 1.94.0 o posterior y una cuenta de Anthropic compatible: una suscripción de pago Claude (Pro, Max, Ultra, Team o Enterprise) o una cuenta de Claude Console. La documentación también contempla proveedores externos, que requieren su configuración propia. El plan gratuito de claude.ai no incluye Claude Code. No hace falta una clave API si inicias sesión con una de las cuentas indicadas.
La extensión incorpora la CLI que necesita el panel de chat. Por eso puedes usar la interfaz de Claude Code en VS Code sin instalar por separado el ejecutable de terminal. Si quieres escribir claude en la terminal integrada de VS Code, sí necesitas instalar el CLI independiente siguiendo las instrucciones oficiales para tu sistema operativo.
| Opción | Qué necesitas | Cómo empiezas |
|---|---|---|
| Extensión de VS Code | VS Code 1.94.0 o posterior y cuenta compatible | Abre el panel Claude Code dentro del editor |
| CLI en terminal | Instalación independiente del CLI y cuenta compatible | Abre una terminal en el proyecto y ejecuta claude |
La extensión no es una versión «gratuita» distinta del servicio: el acceso y el consumo dependen de la cuenta o proveedor elegido. Comprueba sus condiciones actuales antes de usarla en un proyecto profesional.
Instalar la integración oficial y abrir una carpeta ficticia
En VS Code, abre la vista Extensiones con Ctrl+Shift+X en Windows o Linux, o Cmd+Shift+X en macOS. Busca Claude Code, verifica que el editor muestre la extensión publicada por Anthropic y pulsa Install. La documentación de Anthropic indica que la extensión se publica en Visual Studio Marketplace y Open VSX; los marketplaces son servicios de terceros y Anthropic señala que no los mantiene ni audita.
Para practicar sin tocar material de trabajo, crea una carpeta local de prueba con un archivo README.md. Por ejemplo, escribe algo como:
# Proyecto de ejemplo
Este proyecto ficticio organiza una pequeña biblioteca de recetas.
La carpeta docs contiene instrucciones para colaboradores.
Todavía no hay código ni datos de usuarios.
Abre esa carpeta en VS Code. Con un archivo abierto, puedes pulsar el icono Spark de la barra superior del editor; también aparece en la barra de actividad. Otra opción es abrir la paleta con Ctrl+Shift+P o Cmd+Shift+P, escribir “Claude Code” y elegir una acción como Open in New Tab. La barra de estado también permite abrir Claude Code.
La primera vez, el panel presenta Sign in. Púlsalo y completa la autorización en el navegador con la cuenta compatible. No copies claves, tokens ni información de acceso en una conversación ni en archivos del proyecto.
Primer encargo: explicar un README de ejemplo
Empieza con una petición que no autorice cambios. Por ejemplo:
Lee únicamente README.md. Explícame en cinco puntos qué describe este proyecto ficticio y qué información falta para que una persona colaboradora pueda empezar. No modifiques archivos, no ejecutes comandos y no completes los huecos por deducción.
El panel puede usar el contenido del espacio de trabajo para responder. Comprueba que sus afirmaciones aparecen en el README: si menciona una tecnología, un plazo o una función que no está escrita, pídele que señale la frase que lo respalda. Para centrar la pregunta en un fragmento, selecciona el texto relevante; Claude Code puede incluir la selección en el contexto. La documentación describe también referencias a archivos y líneas mediante menciones.
Cuando la explicación sea correcta, prueba una tarea de edición pequeña y explícita, siempre en la carpeta ficticia:
Propón una sección “Cómo colaborar” para README.md con tres pasos genéricos. No inventes comandos ni enlaces. Muéstrame el cambio antes de aplicarlo.
Así separas dos actividades: consultar el contenido y modificarlo. En un proyecto real, delimita primero el archivo permitido, el resultado esperado y las acciones que no autorizas.
Revisar diferencias, permisos y ejecución de comandos
El indicador inferior del cuadro de prompt muestra el modo de permisos. Para aprender y revisar cada acción, usa Manual. Según la documentación oficial, en este modo Claude pide autorización antes de la mayoría de cambios de archivos y comandos de shell. Cuando propone una edición, la extensión muestra una comparación lado a lado: lee el original y la propuesta, y decide si aceptas, rechazas o pides otra versión.
La interfaz también ofrece modos con más automatización, como aceptar ediciones automáticamente, además de Plan y Auto en versiones compatibles. No son equivalentes a una revisión manual. Antes de cambiar de modo, revisa qué puede hacer sin preguntarte y las reglas de permisos de tu organización. No actives la aceptación automática solo para ahorrar clics.
Antes de aceptar un cambio, verifica:
- Que solo afecte al archivo y a las líneas que pediste.
- Que no borre información útil ni añada afirmaciones sin fuente.
- Que las rutas, enlaces y nombres citados existan.
- Que el texto no revele datos personales, credenciales o detalles internos.
- Que entiendes cualquier comando que proponga ejecutar y su efecto en el proyecto.
En el diff puedes aceptar o rechazar el cambio; también puedes pedir una corrección concreta. Si necesitas una revisión por partes, la documentación describe botones por cambio en versiones recientes, aunque su disponibilidad depende de la versión de Claude Code. El historial y las conversaciones en pestañas facilitan retomar el trabajo, pero no reemplazan el control de cambios de Git ni una revisión de seguridad.
Diagnóstico: extensión, inicio de sesión y límites
La extensión no aparece tras instalarla. Reinicia VS Code o abre la paleta de comandos y ejecuta Developer: Reload Window. Asegúrate también de haber buscado “Claude Code” en la vista Extensiones del editor correcto.
No encuentras el icono Spark. El icono de la barra superior aparece cuando hay un archivo abierto. Prueba la barra de actividad, la barra de estado o la paleta de comandos para abrir el panel.
El panel indica que no has iniciado sesión. Pulsa el flujo de inicio de sesión. Si no reaparece, ejecuta Developer: Reload Window. La documentación advierte que, si has definido ANTHROPIC_API_KEY en una terminal pero VS Code no heredó esa variable, podrías ver igualmente la pantalla de inicio; iniciar VS Code desde la terminal es una opción documentada, pero no es necesario si accedes con la cuenta compatible.
No sabes si te queda uso o cuánto costará. No asumas que hay acceso gratuito ni una cuota fija válida para todas las cuentas. Suscripción, Console y proveedores externos pueden tener condiciones distintas. Consulta el panel de cuenta y la página oficial del proveedor correspondiente; los precios y límites cambian.
Para CLI, versiones y actualización, sigue la guía de actualización de Claude Code, sin mezclar sus instrucciones con la instalación de la extensión.
Una rutina segura para documentación y proyectos pequeños
Una rutina sencilla para un profesional que mantiene documentación puede ser:
- Abre una copia de prueba o una rama de trabajo, no el documento final compartido.
- Pide primero una explicación o una lista de inconsistencias sin cambios.
- Formula una edición acotada por archivo y resultado; indica explícitamente qué no debe inventar ni ejecutar.
- Revisa el diff y valida los hechos contra la documentación original.
- Guarda el cambio con el control de versiones habitual y solicita la revisión que exija tu equipo.
Claude Code acelera la exploración y la redacción, pero no determina si tienes permiso para compartir un repositorio ni garantiza que el contenido sea correcto. Para ampliar el uso de IA en otros flujos profesionales, consulta cómo usar Claude en el trabajo. Si además trabajas en producción creativa audiovisual y quieres desarrollar ese ámbito, puedes revisar el curso de IA audiovisual; está orientado a esa vertical, no a programación.
Preguntas frecuentes
¿Necesito una suscripción o facturación?
Sí necesitas acceso a través de una suscripción Claude de pago compatible o una cuenta de Claude Console, según la documentación consultada. El plan gratuito de claude.ai no incluye Claude Code. Los proveedores externos tienen requisitos y facturación propios; confirma las condiciones vigentes antes de usar el servicio.
¿La extensión modifica archivos?
Puede proponer y aplicar ediciones cuando se lo pides. En modo Manual solicita autorización para la mayoría de ediciones; en modos más automáticos puede realizar acciones sin una confirmación individual. Comprueba siempre el modo seleccionado y el diff.
¿Cómo reviso un cambio?
Lee la comparación lado a lado, valida cada afirmación y decide si aceptas o rechazas. Si algo no encaja, pide una corrección acotada. No autorices comandos que no entiendas.
¿Puedo usar repositorios privados?
No hay una garantía universal que sustituya las reglas de tu empresa o las condiciones del proveedor. Antes de abrir un repositorio privado, confirma que su uso está permitido, qué información puede procesarse y bajo qué cuenta; omite secretos y datos confidenciales no autorizados.
Fuentes oficiales: Claude Code en VS Code, requisitos y configuración de Claude Code, modos de permisos y documentación de extensiones de VS Code.
Sigue leyendo en humAIns