SpyBara
Go Premium

vs-code.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 256 additions and 202 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Mon 14 22:58 Fri 18 23:58 Tue 22 23:59 Wed 23 23:57 Fri 25 23:58

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.

Editor de VS Code con el panel de extensión Claude Code abierto en el lado derecho, mostrando una conversación con Claude

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:

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.

VS Code editor mostrando el icono Spark en la Barra de herramientas del editor

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 como una pestaña de editor completa, 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:

VS Code editor con las líneas 2-3 seleccionadas en un archivo Python, y el panel de Claude Code mostrando una pregunta sobre esas líneas con una referencia @-mention
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.
VS Code mostrando una diferencia de los cambios propuestos por Claude con un mensaje de permiso preguntando si realizar la edición

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 realizar cambios. VS Code abre automáticamente el plan como un documento Markdown completo donde puede agregar comentarios en línea para proporcionar 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. El selector incluye una página More models con los modelos que no están en la lista principal. Cuando el modelo actual admite niveles de esfuerzo, el selector también muestra una fila Effort. El botón de nombre del modelo, la página More models 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, slash commands, estilos de salida, hooks, memoria, permisos y plugins. Los elementos con un icono de terminal se abren en el terminal integrado.

    • 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.

    • 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 el conmutador, el cambio se aplica a las sesiones ya abiertas en VS Code, no solo a las sesiones que inicia después. Si lo desactiva, las sesiones abiertas se desconectan. Antes de v2.1.257, el conmutador se aplicaba solo a las sesiones iniciadas después del cambio.

    • 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. 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. 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.

    • 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 del /bug de la CLI, la extensión no escribe un archivo local. Requiere Claude Code v2.1.229 o posterior.

  • 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 recientes 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.
  • 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 más 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íficas. Cuando escribe @ seguido de un nombre de archivo o carpeta, Claude lee ese contenido y puede responder preguntas sobre él o realizar 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 el indicador de selección para alternar si Claude puede ver su texto resaltado: el icono de barra diagonal significa que la selección está oculta de Claude.

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 anteriores

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. Para obtener más información sobre cómo reanudar sesiones, consulte Manage sessions.

Las nuevas sesiones reciben títulos generados por IA basados en su primer mensaje. Pase el cursor sobre una sesión para revelar acciones de cambio de nombre y archivo: cambie el nombre para darle un título descriptivo, o archive para moverla al grupo Archived sessions en la parte inferior de la lista.

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 utiliza Claude Code en la web, puede reanudar esas sesiones en la nube directamente en VS Code. Esto requiere iniciar sesión con Claude.ai Subscription, no Anthropic Console.

1

Open session history

Haga clic en el botón Session history en la parte superior del panel de Claude Code.

2

Select the Web tab

El diálogo muestra dos pestañas: Local y Web. Haga clic en Web para ver sesiones de claude.ai.

3

Select a session to resume

Examine o busque sus sesiones en la nube. Haga clic en cualquier sesión para descargarla y continuar la conversación localmente.

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 la sesión actual y la semana. Cada barra muestra cuánto tiempo falta para que se reinicie 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 con muchos 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. Requiere Claude Code v2.1.174 o posterior.

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.

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, o haz clic derecho en la pestaña del editor de la sesión, 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)

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

Después de realizar cambios, un banner le solicita que reinicie Claude Code para aplicarlos.

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.

Comando Atajo de teclado Descripción
Focus Input Cmd+Esc (Mac) / Ctrl+Esc (Windows/Linux) Alternar el enfoque entre el editor y Claude
Open in Side Bar - Abrir Claude en la barra lateral
Open in Terminal - Abrir Claude en modo terminal
Open in New Tab Cmd+Shift+Esc (Mac) / Ctrl+Shift+Esc (Windows/Linux) Abrir una nueva conversación como una pestaña del editor
Open in New Window - Abrir una nueva conversación en una ventana separada
New Conversation Cmd+N (Mac) / Ctrl+N (Windows/Linux) Iniciar una nueva conversación. Requiere que Claude esté enfocado y enableNewConversationShortcut establecido en true
Reopen Closed Session Cmd+Shift+T (Mac) / Ctrl+Shift+T (Windows/Linux) Reabrir la pestaña de sesión de Claude cerrada más recientemente. Se remite al reapertura normal de editor cerrado de VS Code cuando la última pestaña cerrada no era una sesión de Claude. Deshabilitar con enableReopenClosedSessionShortcut
Insert @-Mention Reference Option+K (Mac) / Alt+K (Windows/Linux) Insertar una referencia al archivo actual y la selección (requiere que el editor esté enfocado)
Toggle Focus view Ctrl+Option+F (Mac) / Ctrl+Alt+F (Windows/Linux) Ocultar o mostrar la actividad de herramientas en la conversación. Funciona mientras un panel de Claude o la barra lateral sea visible. Requiere Claude Code v2.1.221 o posterior
Rename Session Tab - Cambiar el nombre de la sesión en la pestaña activa de Claude. El comando también aparece en el menú de clic derecho de la pestaña. Requiere Claude Code v2.1.257 o posterior
Add Session Tab to Group - Agregar la sesión en la pestaña activa de Claude a un grupo de sesiones que elija o cree. El comando también aparece en el menú de clic derecho de la pestaña. Requiere Claude Code v2.1.257 o posterior
Mark Session as Unread - Marcar la sesión en la pestaña activa de Claude como no leída en la lista de sesiones. El comando también aparece en el menú de clic derecho de la pestaña. Requiere Claude Code v2.1.257 o posterior
Show Logs - Ver registros de depuración de la extensión
Logout - Cerrar sesión en su cuenta de Anthropic

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"

El controlador acepta dos parámetros de consulta opcionales:

Parámetro Descripción
prompt Texto para rellenar previamente en el cuadro de solicitud. Debe estar codificado en URL. La solicitud se rellena previamente pero no se envía automáticamente.
session Un ID de sesión para reanudar en lugar de iniciar una nueva conversación. La sesión debe pertenecer al espacio de trabajo actualmente abierto en VS Code. Si la sesión no se encuentra, se inicia una conversación nueva. Si la sesión ya está abierta en una pestaña, esa pestaña se enfoca. Para capturar un ID de sesión mediante programación, consulte Continue conversations.

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

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

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.

Ajuste Predeterminado Descripción
useTerminal false Inicie Claude en modo terminal en lugar de panel gráfico
initialPermissionMode - Controla los mensajes de aprobación para nuevas conversaciones: default, plan, acceptEdits o bypassPermissions. manual es un alias para default y selecciona el modo etiquetado como Manual en el indicador de modo. Cuando lo deja sin establecer, la extensión elige el modo de permisos inicial como se describe en Switch permission modes.
preferredLocation panel Dónde se abre Claude: sidebar (derecha) o panel (nueva pestaña)
autosave true Guardar automáticamente archivos antes de que Claude los lea o escriba
useCtrlEnterToSend false Usar Ctrl/Cmd+Enter en lugar de Enter para enviar mensajes
enableNewConversationShortcut false Habilitar Cmd/Ctrl+N para iniciar una nueva conversación
enableReopenClosedSessionShortcut true Usar Cmd/Ctrl+Shift+T para reabrir la pestaña de sesión de Claude cerrada más recientemente. Cuando la última pestaña cerrada no era una sesión de Claude, el atajo ejecuta el comando normal de reapertura de editor cerrado de VS Code en su lugar.
hideOnboarding false Ocultar la lista de verificación de incorporación (icono de gorro de graduación)
focusView false Ocultar llamadas de herramientas, resultados de herramientas y pensamiento detrás de filas expandibles, dejando sus mensajes y las respuestas de Claude. La lista de tareas más reciente de Claude permanece visible; esto requiere Claude Code v2.1.225 o posterior. También puede alternar la vista de enfoque desde el menú de comandos. Requiere Claude Code v2.1.221 o posterior
respectGitIgnore true Excluir patrones de .gitignore de búsquedas de archivos
usePythonEnvironment true Activar el entorno de Python del espacio de trabajo al ejecutar Claude. Requiere la extensión de Python.
environmentVariables [] Establecer variables de entorno para el proceso de Claude. Use los ajustes de Claude Code en su lugar para configuración compartida.
disableLoginPrompt false Omitir mensajes de autenticación (para configuraciones de proveedores de terceros)
allowDangerouslySkipPermissions false Agrega Bypass permissions al selector de modo. Úselo solo en espacios aislados sin acceso a Internet.
claudeProcessWrapper - Ejecutable utilizado para iniciar el proceso de Claude. La ruta del binario incluido se pasa como argumento cuando está presente. Establezca esto en un binario claude instalado por separado si la compilación de la extensión no incluye uno para su plataforma. En una configuración envuelta, las conversaciones comienzan en modo Manual a menos que establezca initialPermissionMode o haya seleccionado Manual, Editar automáticamente o Auto en una conversación anterior, porque la extensión omite los ajustes y los pasos predeterminados integrados allí; consulte Switch permission modes. Un error "Unsupported platform" en la activación significa que no hay binario incluido para su plataforma; consulte which platforms have prebuilt binaries.

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.

Característica CLI Extensión de VS Code
Comandos y skills Todos Subconjunto (escriba / para ver los disponibles)
Configuración del servidor MCP Sí Parcial (agregue servidores a través de CLI; administre servidores existentes con /mcp en el panel de chat)
Checkpoints Sí Sí
Atajo bash ! Sí No
Finalización de pestañas Sí No

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 agregar un servidor MCP, abra la terminal integrada (Ctrl+` o Cmd+`) y ejecute claude mcp add. 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, escriba /mcp en el panel de chat 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 administrar servidores MCP sin salir de VS Code, escriba /mcp en el panel de chat. El diálogo de administración de MCP le permite habilitar o deshabilitar servidores, reconectarse a un servidor y administrar la autenticación OAuth. Consulte la documentación de MCP para servidores disponibles.

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:

1

Desactivar el aviso de inicio de sesión

Abra la configuración Desactivar aviso de inicio de sesión y marque la casilla.

También puede abrir la configuración de VS Code (Cmd+, en Mac o Ctrl+, en Windows/Linux), buscar "Claude Code login" y marcar Desactivar aviso de inicio de sesión.

2

Configurar su proveedor

Siga la guía de configuración de su proveedor:

Estas guías cubren la configuración de su proveedor en ~/.claude/settings.json, lo que garantiza que su configuración se comparta entre la extensión de VS Code y la CLI.

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.

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.

Nombre de la herramienta (como se ve en los hooks) Qué hace Solo lectura
mcp__ide__getDiagnostics Devuelve diagnósticos del servidor de lenguaje — los errores y advertencias en el panel Problemas de VS Code. Opcionalmente limitado a un archivo. Sí
mcp__ide__executeCode Ejecuta código Python en el kernel del cuaderno Jupyter activo. Consulte el flujo de confirmación a continuación. No

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.

Solucionar problemas comunes

La extensión no se instala

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: