Usar Claude Code en VS Code

Instala y configura la extensión Claude Code para VS Code. Obtén asistencia de codificación con IA con diffs en línea, menciones @, revisión de planes y atajos de teclado.

La extensión de VS Code proporciona una interfaz gráfica nativa para Claude Code, integrada directamente en su IDE. Esta es la forma recomendada de usar Claude Code en VS Code.

Con la extensión, puede revisar y editar los planes de Claude antes de aceptarlos, aceptar automáticamente ediciones a medida que se realizan, mencionar archivos con rangos de líneas específicas de su selección, acceder al historial de conversaciones y abrir múltiples conversaciones en pestañas o ventanas separadas.

Requisitos previos

Antes de instalar, asegúrate de tener:

• VS Code 1.94.0 o superior
• Una cuenta de Anthropic: cualquier suscripción pagada de Claude (Pro, Max, Team o Enterprise) o una cuenta de Claude Console funciona, y no se requiere clave API. Iniciarás sesión con esta cuenta cuando abras la extensión por primera vez. Si accedes a Claude a través de un proveedor de terceros como Amazon Bedrock o Google Cloud's Agent Platform, consulta Usar proveedores de terceros para obtener instrucciones de configuración.

Instalar la extensión

Haz clic en el enlace de tu IDE para instalar directamente:

• Instalar para VS Code
• Instalar para Cursor

O en VS Code, presiona Cmd+Shift+X (Mac) o Ctrl+Shift+X (Windows/Linux) para abrir la vista Extensiones, busca "Claude Code" y haz clic en Instalar.

La extensión también se instala en otros forks de VS Code como Devin Desktop o Kiro. Busca "Claude Code" en la vista Extensiones del editor, o instala desde el registro Open VSX. Si tu editor no puede instalar la extensión, instala la CLI y ejecuta claude en su terminal integrada en su lugar. La CLI funciona en cualquier terminal.

Comenzar

Una vez instalado, puede comenzar a usar Claude Code a través de la interfaz de VS Code:

1

Abrir el panel de Claude Code

En todo VS Code, el icono Spark indica Claude Code: <img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Icono Spark" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />

La forma más rápida de abrir Claude es hacer clic en el icono Spark en la Barra de herramientas del editor (esquina superior derecha del editor). El icono solo aparece cuando tiene un archivo abierto.

Otras formas de abrir Claude Code:

• Barra de actividades: haga clic en el icono Spark en la barra lateral izquierda para abrir la lista de sesiones. Haga clic en cualquier sesión para abrirla en su ubicación preferida, o inicie una nueva. Este icono siempre es visible en la Barra de actividades.
• Paleta de comandos: Cmd+Shift+P (Mac) o Ctrl+Shift+P (Windows/Linux), escriba "Claude Code" y seleccione una opción como "Open in New Tab"
• Barra de estado: si ha establecido preferredLocation en sidebar, o abrió Claude con Claude Code: Open in Side Bar, haga clic en ✻ Claude Code en la esquina inferior derecha de la ventana. Esto funciona incluso cuando no hay ningún archivo abierto.

Puede arrastrar el panel de Claude para reposicionarlo en cualquier lugar de VS Code. Consulte Personalizar su flujo de trabajo para obtener más detalles.

2

Iniciar sesión

La primera vez que abre el panel, aparece una pantalla de inicio de sesión. Haga clic en Sign in y complete la autorización en su navegador.

Si ve Not logged in · Please run /login más tarde, la extensión reabre la pantalla de inicio de sesión automáticamente. Si no aparece, recargue la ventana desde la Paleta de comandos con Developer: Reload Window.

Si tiene ANTHROPIC_API_KEY establecido en su shell pero aún ve el mensaje de inicio de sesión, es posible que VS Code no haya heredado su entorno de shell. Inicie VS Code desde una terminal con code . para que herede sus variables de entorno, o inicie sesión con su cuenta de Claude en su lugar.

Después de iniciar sesión, aparece una lista de verificación Learn Claude Code. Trabaje en cada elemento haciendo clic en Show me, o descártelo con la X. Para reabrirlo más tarde, desmarque Hide Onboarding en la configuración de VS Code en Extensions → Claude Code.

3

Enviar un mensaje

Pida a Claude que le ayude con su código o archivos, ya sea explicando cómo funciona algo, depurando un problema o realizando cambios.

Aquí hay un ejemplo de cómo hacer una pregunta sobre una línea particular en un archivo:

4

Revisar cambios

Lo que ve depende del modo de permiso que se muestra en la parte inferior del cuadro de mensaje:

• En modo Auto o Edit automatically, Claude edita la mayoría de los archivos en su espacio de trabajo sin preguntar.
• En modo Manual, cuando Claude quiere editar un archivo, muestra una comparación lado a lado del original y los cambios propuestos, luego solicita permiso. Puede aceptar, rechazar o decirle a Claude qué hacer en su lugar. Si edita el contenido propuesto directamente en la vista de diferencias antes de aceptar, Claude es informado de que lo modificó para que no asuma que el archivo coincide con su propuesta original.

Para más ideas sobre lo que puede hacer con Claude Code, consulte Flujos de trabajo comunes.

Usar el cuadro de solicitud

El cuadro de solicitud admite varias características:

• Modos de permiso: haga clic en el indicador de modo en la parte inferior del cuadro de solicitud para cambiar los modos de permiso. En los planes Pro, Max y Team, Auto es el modo de permiso inicial integrado. Consulte cómo la extensión elige el modo de permiso inicial para saber qué cambia eso y todos los modos de permiso que ofrece el indicador.

  • Auto: un clasificador revisa la mayoría de las acciones en lugar de pedirle permiso. Consulte modo auto para saber qué revisa y bloquea.
  • Manual: Claude solicita permiso antes de ediciones de archivos y la mayoría de comandos de shell.
  • Plan: Claude describe lo que hará y espera aprobación antes de hacer cambios. VS Code abre automáticamente el plan como un documento Markdown completo donde puede agregar comentarios en línea para dar retroalimentación antes de que Claude comience.
  • Edit automatically: Claude realiza ediciones sin preguntar.

• Model: seleccione Switch model… desde el menú de comandos para cambiar el modelo durante la sesión. También puede hacer clic en el nombre del modelo en la parte inferior del cuadro de solicitud para abrir el mismo selector. Cuando el modelo actual admite niveles de esfuerzo, el selector también muestra una fila Effort y el botón del nombre del modelo muestra el nivel seleccionado. El botón del nombre del modelo y la fila Effort requieren Claude Code v2.1.257 o posterior.

• Command menu: haga clic en / o escriba / para abrir el menú de comandos. Las opciones incluyen adjuntar archivos, cambiar modelos y alternar el pensamiento extendido. La sección Customize proporciona acceso a servidores MCP, comandos, estilos de salida, hooks, memoria, permisos y plugins. Los elementos con un icono de terminal se abren en la terminal integrada.

  • Para examinar comandos como /usage o /remote-control, seleccione Slash commands en la sección Customize. Un diálogo los enumera con un cuadro de filtro. Elija uno para ejecutarlo. Escribir / en el cuadro de solicitud aún sugiere comandos en línea. Requiere Claude Code v2.1.257 o posterior.

  • Seleccione Output styles en la sección Customize para elegir un estilo de salida, incluidos sus estilos personalizados. Requiere Claude Code v2.1.257 o posterior.

    Para crear un estilo personalizado en su lugar, seleccione Build a custom style desde el menú Output styles. Claude Code escribe el archivo de estilo para usted a nivel de proyecto o usuario. Requiere Claude Code v2.1.261 o posterior.

  • Seleccione Hooks en la sección Customize para ver los hooks cargados en la sesión, agrupados por evento. Puede agregar, editar o eliminar hooks guardados en sus archivos de configuración de usuario, proyecto y local. Los hooks de otras fuentes, como configuración administrada o plugins, son de solo lectura. Requiere Claude Code v2.1.269 o posterior.

  • Seleccione Permissions en la sección Customize para ver las reglas de permiso de la sesión, agrupadas en Allow, Ask y Deny. Puede agregar reglas a su configuración de usuario, proyecto o local y eliminar reglas guardadas allí. Las reglas de otras fuentes, como configuración administrada o aprobaciones realizadas solo para esta sesión, son de solo lectura. Requiere Claude Code v2.1.269 o posterior.

  • La sección Settings incluye Enable Remote Control for all sessions, que establece remoteControlAtStartup para controlar si las nuevas sesiones interactivas se conectan a Remote Control automáticamente. Requiere Claude Code v2.1.203 o posterior.

    Cuando activa o desactiva el conmutador en una ventana de VS Code, el cambio se aplica a las sesiones ya abiertas en esa ventana de VS Code, no solo a las sesiones que inicia después. Si lo desactiva, las sesiones abiertas se desconectan. Con Claude Code v2.1.261 o posterior, el cambio también llega a las sesiones abiertas en sus otras ventanas de VS Code.

  • La sección Settings también incluye Focus view, que oculta llamadas de herramientas, resultados de herramientas y pensamiento detrás de filas expandibles, dejando sus solicitudes y las respuestas de Claude. Actívelo allí, con Ctrl+Option+F (Mac) / Ctrl+Alt+F (Windows/Linux), o desde la Paleta de comandos con Claude Code: Toggle Focus view. El cambio se aplica a todas las sesiones abiertas y persiste entre sesiones. Requiere Claude Code v2.1.221 o posterior.

    La lista de tareas más reciente de Claude permanece visible, al igual que el texto de una pregunta pendiente de Claude; esto requiere Claude Code v2.1.225 o posterior. Mientras Claude ejecuta subagentes, filas de progreso en vivo con su actividad más reciente aparecen bajo el grupo de llamadas de herramientas que las inició. Esto requiere Claude Code v2.1.269 o posterior.

  • Para reportar un error, haga clic en Report a problem en la parte inferior del menú, o escriba /bug o /feedback con una descripción opcional que rellene previamente el informe. Cuando envía el informe y está conectado a Anthropic en una conexión de primera parte, Claude Code lo envía a Anthropic. En un proveedor de terceros, o sin credenciales de Anthropic, el diálogo aún se abre, pero enviar muestra un error y no envía nada: a diferencia de /bug de la CLI, la extensión no escribe un archivo local. Requiere Claude Code v2.1.229 o posterior.

    Si la política de su organización desactiva la retroalimentación del producto, Report a problem no aparece en el menú, y /bug y /feedback muestran un aviso Feedback is turned off by your organization's policy or this environment's settings. en lugar de abrir el informe.

• Side questions: escriba /btw seguido de una pregunta para preguntar sobre su sesión sin agregar a la conversación. La respuesta se abre en un panel junto al chat, donde puede hacer preguntas de seguimiento. El hilo sobrevive a las recargas de ventana. Claude Code mantiene los 20 intercambios más nuevos y expira los hilos almacenados en el cronograma cleanupPeriodDays, siempre que Claude Code pueda determinar de forma segura el período de retención. Para borrar un hilo, haga clic en el icono de papelera en el panel. Requiere Claude Code v2.1.227 o posterior.

• Context indicator: el cuadro de solicitud muestra cuánta ventana de contexto de Claude está utilizando. Claude se compacta automáticamente cuando es necesario, o puede ejecutar /compact manualmente.

• Prompt cache clock: un icono de reloj junto al indicador de contexto estima cuánto tiempo le queda a la caché de solicitud de la conversación antes de que expire. Cuenta regresiva desde la vida útil de cinco minutos o una hora de la caché, y cada respuesta que usa la caché reinicia la cuenta regresiva. Aparte de la compactación, las acciones que invalidan la caché no restablecen el reloj, por lo que aún puede mostrar minutos restantes después de cambiar modelos.

  • Hasta que se agote la cuenta regresiva, el icono muestra los minutos restantes, como 12m.
  • Cuando se agota la cuenta regresiva, los minutos desaparecen y el icono se vuelve rojo, o el color de error de su tema, hasta la siguiente respuesta. Es probable que la caché haya expirado, así que espere una respuesta más lenta y costosa a su próximo mensaje mientras se reconstruye la caché. Si la vida útil de cinco minutos sigue agotándose entre sus mensajes, consulte Elija el TTL usted mismo.
  • Justo después de que la conversación se compacte, el icono también se vuelve rojo sin minutos hasta la siguiente respuesta, porque la caché aún no cubre la conversación compactada.

• Agent map: cuando la conversación incluye subagentes, un recuento de agentes como 2 agents aparece en la parte inferior del cuadro de solicitud. Su punto muestra si algún subagente está trabajando o esperando su permiso.

  Haga clic en el recuento de agentes para abrir el mapa de agentes, que dibuja los subagentes de la conversación como un árbol bajo el agente principal, cada uno con su estado, tiempo transcurrido y recuento de tokens. Haga clic en un subagente para ver su solicitud y llamadas de herramientas, abrir su transcripción de solo lectura, o detenerlo mientras se ejecuta. Requiere Claude Code v2.1.269 o posterior.

• Extended thinking: permite que Claude dedique más tiempo a razonar problemas complejos. Actívelo a través del menú de comandos (/). El razonamiento de Claude aparece en la conversación como bloques contraídos: haga clic en un bloque para leerlo, o presione Ctrl+O para expandir o contraer cada bloque de pensamiento en la sesión. Consulte Extended thinking para obtener detalles.

• Multi-line input: presione Shift+Enter para agregar una nueva línea sin enviar. Esto también funciona en la entrada de texto libre "Other" de los diálogos de preguntas.

Archivos y carpetas de referencia

Use menciones con @ para dar a Claude contexto sobre archivos o carpetas específicos. Cuando escribe @ seguido de un nombre de archivo o carpeta, Claude lee ese contenido y puede responder preguntas sobre él o hacer cambios en él. Claude Code admite coincidencia difusa, por lo que puede escribir nombres parciales para encontrar lo que necesita:

Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)
What's in @src/components/ (include a trailing slash for folders)

Para archivos PDF grandes, puede pedirle a Claude que lea páginas específicas en lugar del archivo completo: una sola página, un rango como páginas 1-10, o un rango abierto como página 3 en adelante.

Cuando selecciona texto en el editor, Claude puede ver su código resaltado automáticamente. El pie de página del cuadro de solicitud muestra cuántas líneas están seleccionadas. Presione Option+K (Mac) / Alt+K (Windows/Linux) para insertar una mención con @ con la ruta del archivo y números de línea (por ejemplo, @app.ts#5-10). Haga clic en la X en el indicador de selección para eliminarlo para que Claude no reciba la selección. El indicador reaparece cuando selecciona otro texto.

Claude también ve qué archivo tiene abierto en el editor, incluso cuando nada está seleccionado, y el cuadro de solicitud muestra su nombre. Para agregar solo su texto seleccionado, desactive la configuración Attach Open File. La configuración requiere Claude Code v2.1.271 o posterior.

Para adjuntar una imagen, péguela desde su portapapeles en el cuadro de solicitud. También puede mantener presionado Shift mientras arrastra archivos al cuadro de solicitud para agregarlos como adjuntos. Haga clic en la X en cualquier adjunto para eliminarlo del contexto.

Reanudar conversaciones pasadas

Haga clic en el botón Session history en la parte superior del panel de Claude Code para acceder a su historial de conversaciones. Puede buscar por palabra clave o examinar por tiempo.

Haga clic en cualquier conversación para reanudarla con el historial de mensajes completo. Si la conversación ya está abierta en otra pestaña de la ventana actual, hacer clic en ella cambia a esa pestaña. Para obtener más información sobre cómo reanudar sesiones, consulte Manage sessions.

• Session titles: las nuevas sesiones reciben títulos generados por IA basados en su primer mensaje.
• Rename and archive: pase el cursor sobre una sesión para revelar estas acciones. Cambie el nombre para darle un título descriptivo, o archive para moverla al grupo Archived sessions en la parte inferior de la lista.

De forma predeterminada, una sesión sin actividad durante 14 días se mueve a Archived sessions automáticamente, a menos que esté abierta, no leída o en un grupo. El archivado automático requiere Claude Code v2.1.265 o posterior. Para cambiar el período o desactivarlo, abra la configuración Archive Inactive Sessions y seleccione un número de días o Never.

Para restaurar una sesión archivada, expanda Archived sessions y haga clic en Unarchive session. Antes de v2.1.257, la acción era Delete session, que ocultaba una sesión sin forma de restaurarla. Las sesiones que eliminó aparecen bajo Archived sessions después de actualizar.

Cuando la conversación que reanuda terminó en modo plan, Claude Code restaura el modo plan. Requiere Claude Code v2.1.246 o posterior. Claude Code no lo restaura en dos casos:

• La extensión elige el modo de permiso inicial de claudeCode.initialPermissionMode o una selección que se transfiere de una conversación anterior
• Tiene claudeCode.claudeProcessWrapper configurado

Reanudar sesiones en la nube desde Claude.ai

Si ejecuta sesiones en la nube, puede reanudarlas directamente en VS Code. Esto requiere iniciar sesión con Claude.ai Subscription, no Anthropic Console.

Verificar cuenta y uso

Ejecute /usage para abrir el diálogo Account & usage. El diálogo requiere un inicio de sesión en claude.ai, por lo que no se ofrece en un proveedor de terceros. Muestra su cuenta conectada, su plan y barras de uso para los límites de su plan, como la sesión actual y la semana. Cada barra muestra cuánto tiempo falta para que se restablezca su límite.

El diálogo también desglosa qué está contribuyendo a los límites de su plan. Marca comportamientos que representan el 10% o más del uso reciente, como fallos de caché, contexto largo, sesiones pesadas en subagentes o altamente paralelas, cada una con un consejo para reducirlo. Las tablas de atribución muestran cuánto uso provino de cada skill, subagente, plugin y servidor MCP.

Use el conmutador Day y Week para cambiar entre las últimas 24 horas y los últimos 7 días. Las cifras son aproximadas y se calculan a partir de sesiones locales en esta máquina, por lo que el uso de otros dispositivos o claude.ai no se incluye. Para obtener más información sobre cómo rastrear y reducir el uso, consulte Track your costs.

Personaliza tu flujo de trabajo

Puedes reposicionar el panel de Claude, ejecutar múltiples conversaciones, organizar la lista de sesiones en grupos o cambiar al modo terminal.

Elige dónde vive Claude

Puedes arrastrar el panel de Claude para reposicionarlo en cualquier lugar de VS Code. Agarra la pestaña o la barra de título del panel y arrástralo a:

• Barra lateral secundaria: el lado derecho de la ventana. Mantiene Claude visible mientras codificas.
• Barra lateral principal: la barra lateral izquierda con iconos para Explorer, Search, etc.
• Área del editor: abre Claude como una pestaña junto a tus archivos. Útil para tareas secundarias.

Después de ejecutar Developer: Reload Window o reiniciar VS Code, si una conversación vuelve con su historial depende de dónde estuviera abierta:

• Pestaña del editor: la conversación vuelve con su pestaña.
• Barra lateral: la conversación vuelve si enviaste un mensaje o Claude respondió en ella en los últimos 10 minutos. Si no vuelve, reanuda la conversación desde Historial de sesiones.

Ejecuta múltiples conversaciones

Usa Open in New Tab u Open in New Window desde la Command Palette para iniciar conversaciones adicionales. Cada conversación mantiene su propio historial y contexto, permitiéndote trabajar en diferentes tareas en paralelo.

Cuando uses pestañas, un pequeño punto de color en el icono de spark indica el estado: azul significa que hay una solicitud de permiso pendiente, naranja significa que Claude terminó mientras la pestaña estaba oculta.

Organiza sesiones en grupos

En la lista de sesiones de la Activity Bar, puedes recopilar sesiones relacionadas en grupos nombrados y contraíbles. Requiere Claude Code v2.1.229 o posterior.

• Agrupar o desagrupar una sesión: haz clic derecho en una sesión para crear un grupo a partir de ella, moverla a un grupo existente o eliminarla de su grupo. Cada sesión pertenece a un grupo a la vez, por lo que moverla a otro grupo la elimina del primero.
• Mover varias sesiones a la vez: Cmd-clic (Mac) / Ctrl-clic (Windows/Linux) en cada sesión, o Shift-clic para seleccionar un rango, luego haz clic derecho en la selección.
• Agrupar una sesión desde su pestaña: ejecuta Claude Code: Add Session Tab to Group desde la Command Palette, luego elige o crea un grupo. Requiere Claude Code v2.1.257 o posterior.
• Renombrar o eliminar un grupo: haz clic derecho en un encabezado de grupo. Eliminar un grupo solo elimina el grupo, y sus sesiones vuelven a la lista sin agrupar.

La extensión guarda grupos por carpeta de espacio de trabajo, por lo que sobreviven a recargas de ventana y aparecen en cada ventana donde abres la misma carpeta. Cuando buscas en la lista, la extensión muestra coincidencias en una lista plana única en todos los grupos.

Cambiar al modo terminal

De forma predeterminada, la extensión abre un panel de chat gráfico. Si prefieres la interfaz de estilo CLI, abre la configuración Use Terminal y marca la casilla.

También puedes abrir la configuración de VS Code (Cmd+, en Mac o Ctrl+, en Windows/Linux), ve a Extensions → Claude Code y marca Use Terminal.

Gestionar plugins

La extensión de VS Code incluye una interfaz gráfica para instalar y gestionar plugins. Escriba /plugins en el cuadro de solicitud para abrir la interfaz Gestionar plugins.

Instalar plugins

El diálogo de plugins muestra dos pestañas: Plugins y Marketplaces.

En la pestaña Plugins:

• Los plugins instalados aparecen en la parte superior con interruptores de alternancia para habilitarlos o deshabilitarlos
• Los plugins disponibles de sus marketplaces configurados aparecen a continuación
• Busque para filtrar plugins por nombre o descripción
• Haga clic en Instalar en cualquier plugin disponible

Cuando instale un plugin, elija el alcance de la instalación:

• Instalar para usted: disponible en todos sus proyectos (alcance de usuario)
• Instalar para este proyecto: compartido con colaboradores del proyecto (alcance de proyecto)
• Instalar localmente: solo para usted, solo en este repositorio (alcance local)

Compartir un enlace de instalación de plugin

Para enviar a alguien directamente a la instalación de un plugin específico, proporciónele la URL install-plugin de la extensión. Al abrirla, se inicia o enfoca VS Code, abre el panel Claude Code y abre el diálogo Gestionar plugins en la opción de alcance de ese plugin. Nada se instala hasta que la persona elige un alcance. Si el marketplace del plugin aún no está configurado en su Claude Code, el diálogo primero le pide que lo agregue.

vscode://anthropic.claude-code/install-plugin?plugin=code-review&marketplace=anthropics/claude-plugins-official

La URL toma dos parámetros de consulta:

Dos casos terminan en un mensaje en el diálogo en lugar de la opción de alcance:

• El marketplace no enumera un plugin con ese nombre: el diálogo informa que el plugin no fue encontrado. Verifique el valor de plugin contra el listado del marketplace.
• El plugin ya está instalado: el diálogo lo indica, y nada cambia.

Los README de GitHub, problemas y algunos otros hosts de Markdown eliminan enlaces cuyo esquema no es http o https, por lo que un enlace vscode:// allí se representa como texto sin formato. Coloque la URL en un bloque de código en esos hosts, como El enlace se representa como texto sin formato en lugar de ser clickeable describe para enlaces claude-cli://.

Gestionar marketplaces

Cambie a la pestaña Marketplaces para agregar o eliminar fuentes de plugins:

• Ingrese un repositorio de GitHub, URL o ruta local para agregar un nuevo marketplace
• Haga clic en el icono de actualización para actualizar la lista de plugins de un marketplace
• Haga clic en el icono de papelera para eliminar un marketplace

Los cambios de plugins que realiza en el diálogo se aplican inmediatamente a las sesiones de Claude Code abiertas en esa ventana de VS Code. Si la sesión desde la que abrió el diálogo no puede recargar sus plugins, el diálogo le ofrece intentar de nuevo o reiniciar Claude en esa sesión.

Para obtener más información sobre el sistema de plugins, consulte Plugins y Plugin marketplaces.

Automatizar tareas del navegador con Chrome

Conecte Claude a su navegador Chrome para probar aplicaciones web, depurar con registros de consola y automatizar flujos de trabajo del navegador sin salir de VS Code. Esto requiere la extensión Claude in Chrome versión 1.0.36 o superior.

Escriba @browser en el cuadro de solicitud seguido de lo que desea que Claude haga:

@browser go to localhost:3000 and check the console for errors

También puede abrir el menú de archivos adjuntos para seleccionar herramientas específicas del navegador, como abrir una nueva pestaña o leer el contenido de la página.

Claude abre nuevas pestañas para tareas del navegador y comparte el estado de inicio de sesión de su navegador, por lo que puede acceder a cualquier sitio en el que ya haya iniciado sesión.

Para obtener instrucciones de configuración, la lista completa de capacidades y solución de problemas, consulte Usar Claude Code con Chrome.

Comandos y atajos de teclado de VS Code

Abra la Paleta de Comandos (Cmd+Shift+P en Mac o Ctrl+Shift+P en Windows/Linux) y escriba "Claude Code" para ver todos los comandos disponibles de VS Code para la extensión Claude Code.

Algunos atajos de teclado dependen de qué panel esté "enfocado" (recibiendo entrada de teclado). Cuando su cursor está en un archivo de código, el editor está enfocado. Cuando su cursor está en el cuadro de solicitud de Claude, Claude está enfocado. Use Cmd+Esc / Ctrl+Esc para alternar entre ellos.

Iniciar una pestaña de VS Code desde otras herramientas

La extensión registra un controlador de URI en vscode://anthropic.claude-code/open. Úselo para abrir una nueva pestaña de Claude Code desde sus propias herramientas: un alias de shell, un marcador de navegador o cualquier script que pueda abrir una URL. Si VS Code no se está ejecutando, abrir la URL lo inicia primero. Si VS Code ya se está ejecutando, la URL se abre en la ventana que actualmente tiene el enfoque.

Invoque el controlador con el abridor de URL de su sistema operativo.

open "vscode://anthropic.claude-code/open"

xdg-open "vscode://anthropic.claude-code/open"

Start-Process "vscode://anthropic.claude-code/open"

start "" "vscode://anthropic.claude-code/open"

El controlador acepta dos parámetros de consulta opcionales:

Por ejemplo, para abrir una pestaña rellenada previamente con "review my changes":

vscode://anthropic.claude-code/open?prompt=review%20my%20changes

La extensión también maneja vscode://anthropic.claude-code/install-plugin, que abre el diálogo de plugins en un plugin. Para iniciar una sesión de terminal en lugar de una pestaña de VS Code, use el controlador claude-cli:// de la CLI. Consulte Launch sessions from links.

Configurar ajustes

La extensión tiene dos tipos de ajustes:

• Ajustes de extensión en VS Code: controlan el comportamiento de la extensión dentro de VS Code. Abra con Cmd+, (Mac) o Ctrl+, (Windows/Linux), luego vaya a Extensiones → Claude Code. También puede escribir / y seleccionar General config… para abrir los ajustes.
• Ajustes de Claude Code en ~/.claude/settings.json: compartidos entre la extensión y CLI. Úselo para comandos permitidos, variables de entorno, hooks y servidores MCP. En los planes Pro, Max y Team, también es una entrada al modo de permisos en el que comienzan las conversaciones. Switch permission modes enumera el orden. Consulte Settings para obtener detalles.

Ajustes de extensión

VS Code lee initialPermissionMode de sus ajustes de usuario e ignora los valores del espacio de trabajo. Antes de v2.1.225, VS Code establecía por defecto el ajuste en default y aplicaba los valores del espacio de trabajo.

Usar un lector de pantalla

El panel de chat de la extensión funciona con lectores de pantalla. No necesita activar nada: la extensión anuncia la actividad de la conversación para cada usuario, sin cambios visuales. Esto es independiente del modo de lector de pantalla de la CLI, que adapta la interfaz del terminal.

La compatibilidad con lectores de pantalla en el panel de chat requiere Claude Code v2.1.236 o posterior.

Durante una conversación, la extensión anuncia:

• Respuestas de Claude: la extensión anuncia cada respuesta una sola vez, cuando está completa, y permanece en silencio mientras el texto se transmite. Su lector de pantalla lee los bloques de código como un resumen de recuento de líneas, lee los enlaces por su etiqueta y lee las tablas celda por celda; la respuesta completa permanece legible en la transcripción.
• Solicitudes de permiso y preguntas: la extensión anuncia una solicitud cuando aparece su solicitud de permiso, nombrando la herramienta que Claude desea utilizar. Anuncia de la misma manera cuando Claude le hace una pregunta y cuando Claude termina un plan y espera su revisión.
• Cambios de estado: la extensión anuncia cuando Claude comienza a trabajar, cuando Claude está listo para su entrada y cuando Claude Code comienza a compactar la conversación.
• Errores y solicitudes de modelo: la extensión anuncia errores en la conversación y anuncia cuando aparece la solicitud de consentimiento de créditos de uso o la solicitud de solicitud marcada.

Cada turno en la transcripción comienza con un encabezado visualmente oculto etiquetado con la solicitud que inició el turno, para que pueda saltar entre turnos con la navegación de encabezados de su lector de pantalla. También puede mover el foco a la transcripción misma con Tab, ya que la extensión la expone como una región etiquetada, y leerla a su propio ritmo. Mientras Claude trabaja, su lector de pantalla lee una etiqueta de texto en lugar de la animación del indicador de progreso.

Cuando reabre una sesión o cambia a otra, la extensión no anuncia nada: el historial restaurado, las solicitudes de permiso pendientes y el estado en progreso permanecen en silencio hasta que suceda algo nuevo.

Extensión de VS Code vs. Claude Code CLI

Claude Code está disponible tanto como una extensión de VS Code (panel gráfico) como una CLI (interfaz de línea de comandos en la terminal). Algunas características solo están disponibles en la CLI. Si necesita una característica solo de CLI, ejecute claude en la terminal integrada de VS Code. Esto requiere la instalación independiente de CLI: la extensión no agrega claude a su PATH. Consulte Ejecutar CLI en VS Code.

Rewind con checkpoints

La extensión de VS Code admite checkpoints, que rastrean las ediciones de archivos de Claude y le permiten revertir a un estado anterior. Pase el cursor sobre cualquier mensaje para revelar el botón de rewind, luego elija entre tres opciones:

• Fork conversation from here: inicie una nueva rama de conversación desde este mensaje mientras mantiene todos los cambios de código intactos
• Rewind code to here: revierta los cambios de archivo a este punto en la conversación mientras mantiene el historial de conversación completo
• Fork conversation and rewind code: inicie una nueva rama de conversación y revierta los cambios de archivo a este punto

Para obtener detalles completos sobre cómo funcionan los checkpoints y sus limitaciones, consulte Checkpointing.

Ejecutar CLI en VS Code

Para usar la CLI mientras permanece en VS Code, abra la terminal integrada (Ctrl+` en Windows/Linux o Cmd+` en Mac) y ejecute claude. La CLI se integra automáticamente con su IDE para características como visualización de diferencias y uso compartido de diagnósticos.

Instalar la extensión no coloca claude en su PATH de shell. La extensión incluye una copia privada de la CLI para su panel de chat, pero escribir claude en una terminal requiere la instalación independiente de CLI. Ejecute la instalación una vez y los comandos en esta página, incluidos claude mcp add y claude --resume, funcionan en cualquier terminal. Si claude aún no se encuentra después de instalar, verifique su PATH.

Si utiliza una terminal externa, ejecute /ide dentro de Claude Code para conectarla a VS Code.

Cambiar entre extensión y CLI

La extensión y la CLI comparten el mismo historial de conversación. Para continuar una conversación de extensión en la CLI, ejecute claude --resume en la terminal. Esto abre un selector interactivo donde puede buscar y seleccionar su conversación.

Incluir salida de terminal en indicaciones

Haga referencia a la salida de terminal en sus indicaciones usando @terminal:name donde name es el título de la terminal. Esto permite que Claude vea la salida de comandos, mensajes de error o registros sin copiar y pegar.

Monitorear procesos en segundo plano

La visibilidad de las tareas en segundo plano en la extensión es limitada en comparación con la CLI. Para una mejor visibilidad, haga que Claude genere el comando para que pueda ejecutarlo en la terminal integrada de VS Code.

Conectar a herramientas externas con MCP

MCP (Model Context Protocol) los servidores dan a Claude acceso a herramientas externas, bases de datos y API.

Para administrar servidores MCP sin salir de VS Code, escriba /mcp en el panel de chat. En el diálogo que se abre, puede agregar servidores, eliminar servidores guardados en el ámbito local, de usuario o de proyecto, habilitar o deshabilitar servidores, reconectarse a un servidor y administrar la autenticación OAuth. Agregar y eliminar servidores en el diálogo requiere Claude Code v2.1.261 o posterior.

También puede ejecutar claude mcp add en la terminal integrada de VS Code (Ctrl+` o Cmd+`). El diálogo y el comando de terminal guardan en la misma configuración de MCP, y los cambios de cualquiera de los dos tienen efecto en las conversaciones que inicia después. El ejemplo a continuación agrega el servidor MCP remoto de GitHub, que se autentica con un token de acceso personal pasado como encabezado:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

Reemplace YOUR_GITHUB_PAT con su token de acceso personal. El comando claude mcp add guarda la configuración sin validar credenciales, por lo que se acepta un valor de marcador de posición aquí pero el servidor no se conecta más tarde. Para verificar la conexión, inicie una nueva conversación, escriba /mcp y compruebe que el servidor muestre Connected. Un servidor con credenciales incorrectas muestra Failed.

Una vez configurado, pida a Claude que use las herramientas (por ejemplo, "Review PR #456").

Para encontrar servidores para conectar, consulte Encontrar y construir servidores MCP.

Trabajar con git

Claude Code se integra con git para ayudar con flujos de trabajo de control de versiones directamente en VS Code. Pida a Claude que confirme cambios, cree solicitudes de extracción o trabaje en diferentes ramas. Para iniciar Claude en un árbol de trabajo aislado con sus propios archivos y rama, consulte Ejecutar sesiones paralelas con worktrees.

Crear confirmaciones y solicitudes de extracción

Claude puede preparar cambios, escribir mensajes de confirmación y crear solicitudes de extracción basadas en su trabajo:

commit my changes with a descriptive message
create a pr for this feature
summarize the changes I've made to the auth module

Al crear solicitudes de extracción, Claude genera descripciones basadas en los cambios de código reales y puede agregar contexto sobre decisiones de prueba o implementación.

Usar proveedores de terceros

De forma predeterminada, Claude Code se conecta directamente a la API de Anthropic. Si su organización utiliza Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry para acceder a Claude, configure la extensión para usar su proveedor en su lugar:

En un proveedor de terceros, la extensión no ofrece características que requieren una cuenta de claude.ai, como el seguimiento de uso, dictado de voz y la pestaña Web para sesiones en la nube. Un inicio de sesión de claude.ai que queda de un /login anterior permanece sin usar: la extensión no lo envía con ninguna solicitud.

Seguridad y privacidad

Su código permanece privado. Claude Code procesa su código para proporcionar asistencia, pero no lo utiliza para entrenar modelos. Para obtener detalles sobre el manejo de datos y cómo optar por no participar en el registro, consulte Datos y privacidad.

Con los permisos de auto-edición habilitados, Claude Code puede modificar archivos de configuración de VS Code (como settings.json o tasks.json) que VS Code puede ejecutar automáticamente. Para reducir el riesgo al trabajar con código no confiable:

• Habilite Modo restringido de VS Code para espacios de trabajo no confiables
• Utilice el modo Manual en lugar de Editar automáticamente o Auto para ediciones
• Revise los cambios cuidadosamente antes de aceptarlos

El servidor MCP IDE integrado

Cuando la extensión está activa, ejecuta un servidor MCP local al que la CLI se conecta automáticamente. Así es como la CLI abre diffs en el visor de diffs nativo de VS Code, lee su selección actual para menciones @ y, cuando está trabajando en un cuaderno Jupyter, le pide a VS Code que ejecute celdas.

El servidor se llama ide y está oculto en /mcp porque no hay nada que configurar. Sin embargo, si su organización utiliza un hook PreToolUse para crear una lista de herramientas MCP permitidas, deberá saber que existe.

Contexto de selección y archivo abierto. Mientras está conectado, la CLI incluye su selección actual del editor y la ruta del archivo activo como contexto en cada solicitud que envía. La transcripción muestra una línea ⧉ Selected N lines from <file> cuando esto sucede.

Para excluir un archivo sensible como .env, agregue una regla de denegación Read para su ruta. Una regla de denegación coincidente evita que tanto el texto seleccionado como el aviso de archivo abierto para ese archivo lleguen a Claude.

Si desactiva la configuración Attach Open File, la CLI recibe la ruta del archivo activo solo mientras tenga texto seleccionado en él.

Transporte y autenticación. El servidor se vincula a 127.0.0.1 en un puerto aleatorio en el rango 10000–65535, y el puerto no es configurable. El transporte es ws:// sin cifrar; como el socket es solo de bucle invertido, cualquier proceso que pueda capturar el tráfico también puede leer el token del archivo de bloqueo, por lo que TLS no agregaría protección. Cada activación de extensión genera un token de autenticación aleatorio nuevo, lo escribe en un archivo de bloqueo en ~/.claude/ide/<port>.lock, y la CLI debe presentarlo como el encabezado X-Claude-Code-Ide-Authorization para conectarse. El archivo de bloqueo tiene permisos 0600 en un directorio 0700, por lo que solo el usuario que ejecuta VS Code puede leerlo. Si se establece CLAUDE_CONFIG_DIR, el archivo de bloqueo se escribe en $CLAUDE_CONFIG_DIR/ide/ en su lugar.

Herramientas expuestas al modelo. El servidor aloja una docena de herramientas, pero solo dos son visibles para el modelo. El resto son RPC internas que la CLI utiliza para su propia interfaz de usuario — abrir diffs, leer selecciones, guardar archivos — y se filtran antes de que la lista de herramientas llegue a Claude.

La ejecución de Jupyter siempre pregunta primero. mcp__ide__executeCode no puede ejecutar nada silenciosamente. En cada llamada, el código se inserta como una nueva celda al final del cuaderno activo, VS Code la desplaza a la vista, y una Quick Pick nativa le pide que Ejecute o Cancele. Cancelar — o descartar el selector con Esc — devuelve un error a Claude y nada se ejecuta. La herramienta también se niega rotundamente cuando no hay un cuaderno activo, cuando la extensión Jupyter (ms-toolsai.jupyter) no está instalada, o cuando el kernel no es Python.

• Asegúrese de tener una versión compatible de VS Code (1.94.0 o posterior)
• Verifique que VS Code tenga permiso para instalar extensiones
• Intente instalar directamente desde VS Code Marketplace

El icono Spark no es visible

El icono Spark aparece en la Barra de herramientas del editor (esquina superior derecha del editor) cuando tiene un archivo abierto. Si no lo ve:

1. Abra un archivo: El icono requiere que un archivo esté abierto. Solo tener una carpeta abierta no es suficiente.
2. Verifique la versión de VS Code: Requiere 1.94.0 o superior (Ayuda → Acerca de)
3. Reinicie VS Code: Ejecute "Developer: Reload Window" desde la Paleta de comandos
4. Desactive extensiones conflictivas: Desactive temporalmente otras extensiones de IA (Cline, Continue, etc.)
5. Verifique la confianza del espacio de trabajo: La extensión no funciona en Modo restringido

Alternativamente, si ha establecido preferredLocation en sidebar, o ha abierto Claude con Claude Code: Open in Side Bar, haga clic en "✻ Claude Code" en la Barra de estado (esquina inferior derecha). Esto funciona incluso sin un archivo abierto. También puede usar la Paleta de comandos (Cmd+Shift+P / Ctrl+Shift+P) y escribir "Claude Code".

Cmd+Esc no hace nada en macOS

En macOS Tahoe y posterior, el atajo del sistema Game Overlay está vinculado a Cmd+Esc de forma predeterminada e intercepta la pulsación de tecla antes de que llegue a VS Code. Para liberar el atajo:

1. Abra Configuración del sistema
2. Vaya a Teclado, luego Atajos de teclado, luego Controladores de juegos
3. Desmarque la casilla Game Overlay

Alternativamente, revinculle la extensión a una tecla diferente: abra el editor de Atajos de teclado de VS Code (Cmd+K Cmd+S), busque Claude Code: Focus input, y asigne un nuevo atajo.

Claude Code nunca responde

Si Claude Code no responde a sus indicaciones:

1. Verifique su conexión a Internet: Asegúrese de tener una conexión a Internet estable
2. Inicie una nueva conversación: Intente iniciar una conversación nueva para ver si el problema persiste
3. Pruebe la CLI: Ejecute claude desde la terminal para ver si obtiene mensajes de error más detallados

Si los problemas persisten, presente un problema en GitHub con detalles sobre el error.

Desinstalar la extensión

Para desinstalar la extensión Claude Code:

1. Abra la vista Extensiones (Cmd+Shift+X en Mac o Ctrl+Shift+X en Windows/Linux)
2. Busque "Claude Code"
3. Haga clic en Desinstalar

Si ejecuta claude en una terminal integrada de VS Code, Claude Code reinstala la extensión automáticamente. Para mantenerla desinstalada, desactive Auto-install IDE extension en /config, o establezca autoInstallIdeExtension en false. También puede establecer la variable de entorno CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL en 1.

Para eliminar también los datos de la extensión y restablecer toda la configuración, elimine el directorio de almacenamiento de la extensión para su plataforma.

En macOS:

rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code

En Linux:

rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-code

En Windows, en PowerShell:

Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

Para obtener ayuda adicional, consulte la guía de solución de problemas.

Próximos pasos

Ahora que tienes Claude Code configurado en VS Code:

• Explora flujos de trabajo comunes para aprovechar al máximo Claude Code
• Configura MCP servers para extender las capacidades de Claude con herramientas externas. Agrega y administra servidores con /mcp en el panel de chat.
• Configura la configuración de Claude Code para personalizar comandos permitidos, hooks y más. Esta configuración se comparte entre la extensión y la CLI.