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:
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:
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) oCtrl+Shift+P(Windows/Linux), escriba "Claude Code" y seleccione una opción como "Open in New Tab" - Barra de estado: si ha establecido
preferredLocationensidebar, 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.
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.
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:
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 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. Cuando el modelo actual admite niveles de esfuerzo, el selector también muestra una fila Effort y el botón de nombre del modelo muestra el nivel seleccionado. El botón de 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, 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
/usageo/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.
-
La sección Settings incluye Enable Remote Control for all sessions, que establece
remoteControlAtStartuppara 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. 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
/bugo/feedbackcon 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/bugde la CLI, la extensión no escribe un archivo local. Requiere Claude Code v2.1.229 o posterior.
-
- Side questions: escriba
/btwseguido 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 cronogramacleanupPeriodDays, 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
/compactmanualmente. - 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 presioneCtrl+Opara expandir o contraer cada bloque de pensamiento en la sesión. Consulte Extended thinking para obtener más detalles. - Multi-line input: presione
Shift+Enterpara 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.
Para adjuntar una imagen, péguelo 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 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. 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.initialPermissionModeo una selección que se transfiere de una conversación anterior - Tiene
claudeCode.claudeProcessWrapperconfigurado
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.
Open session history
Haga clic en el botón Session history en la parte superior del panel de Claude Code.
Select the Web tab
El diálogo muestra dos pestañas: Local y Web. Haga clic en Web para ver sesiones de claude.ai.
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 los límites de su plan, como 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.
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, oShift-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)
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:
| Parámetro | Descripción |
|---|---|
plugin |
El nombre del plugin tal como lo enumera su marketplace. Requerido. |
marketplace |
De dónde proviene el plugin, en cualquier forma que la pestaña Marketplaces acepte, como un owner/repo de GitHub o una URL de git. Codifíquelo en URL si contiene caracteres como &. Por defecto es anthropics/claude-plugins-official cuando se omite. |
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
plugincontra 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.
| 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 a la 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"
xdg-open "vscode://anthropic.claude-code/open"
El comando xdg-open viene del paquete xdg-utils. Si el shell informa que no se encuentra, consulte xdg-open is not found on Linux.
En PowerShell:
Start-Process "vscode://anthropic.claude-code/open"
En cmd.exe, start trata su primer argumento entrecomillado como un título de ventana, así que pase un título vacío antes de la URL:
start "" "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
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) oCtrl+,(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. |
archiveInactiveSessions |
14 |
Archivar una sesión automáticamente después de estos muchos días sin actividad: 1, 2, 7 o 14. Establezca 0 para desactivarlo. Requiere Claude Code v2.1.265 o posterior |
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í | Sí (agregue y administre servidores 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 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:
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.
Configurar su proveedor
Siga la guía de configuración de su proveedor:
- Claude Code en Amazon Bedrock
- Claude Code en Google Cloud's Agent Platform
- Claude Code en Microsoft Foundry
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
- 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:
- Abra un archivo: El icono requiere que un archivo esté abierto. Solo tener una carpeta abierta no es suficiente.
- Verifique la versión de VS Code: Requiere 1.94.0 o superior (Ayuda → Acerca de)
- Reinicie VS Code: Ejecute "Developer: Reload Window" desde la Paleta de comandos
- Desactive extensiones conflictivas: Desactive temporalmente otras extensiones de IA (Cline, Continue, etc.)
- 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:
- Abra Configuración del sistema
- Vaya a Teclado, luego Atajos de teclado, luego Controladores de juegos
- 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:
- Verifique su conexión a Internet: Asegúrese de tener una conexión a Internet estable
- Inicie una nueva conversación: Intente iniciar una conversación nueva para ver si el problema persiste
- Pruebe la CLI: Ejecute
claudedesde 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:
- Abra la vista Extensiones (
Cmd+Shift+Xen Mac oCtrl+Shift+Xen Windows/Linux) - Busque "Claude Code"
- 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
/mcpen 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.