Usar Claude Code en VS Code

• Revisar y editar los planes de Claude antes de aceptarlos
• Aceptar automáticamente las ediciones a medida que se realizan
• Mencionar con @ archivos con rangos de líneas específicos de tu selección
• Acceder al historial de conversaciones
• Abrir múltiples conversaciones en pestañas o ventanas separadas

​

Requisitos previos

• 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

• Instalar para VS Code
• Instalar para Cursor

• Otros forks de VS Code: la extensión también se instala en forks como Devin Desktop o Kiro. Busca “Claude Code” en la vista de Extensiones del editor, o instálala desde el registro de Open VSX.
• Editores que no pueden instalar la extensión: instala la CLI y ejecuta claude en la terminal integrada del editor. La CLI funciona en cualquier terminal.
• Dev containers: para ejecutar Claude Code dentro de un dev container, consulta Contenedores de desarrollo.

​

Primeros pasos

1

Abre el panel de Claude Code

En todo VS Code, el ícono Spark indica Claude Code: La forma más rápida de abrir Claude es hacer clic en el ícono Spark en la Editor Toolbar (esquina superior derecha del editor). El ícono solo aparece cuando tienes un archivo abierto.Otras formas de abrir Claude Code:

• Activity Bar: haz clic en el ícono Spark en la barra lateral izquierda para abrir la lista de sesiones. Haz clic en cualquier sesión para abrirla en tu ubicación preferida, o inicia una nueva. Este ícono siempre está visible en la Activity Bar.
• Command Palette: Cmd+Shift+P (Mac) o Ctrl+Shift+P (Windows/Linux), escribe “Claude Code” y selecciona una opción como “Open in New Tab”
• Status Bar: haz clic en ✻ Claude Code en la esquina inferior derecha de la ventana. Esto funciona incluso cuando no hay ningún archivo abierto.

Puedes arrastrar el panel de Claude para reubicarlo en cualquier lugar de VS Code. Consulta Personaliza tu flujo de trabajo para más detalles.

2

Inicia sesión

La primera vez que abres el panel, aparece una pantalla de inicio de sesión. Haz clic en Sign in y completa la autorización en tu navegador.Si más adelante ves Not logged in · Please run /login, la extensión vuelve a abrir la pantalla de inicio de sesión automáticamente. Si no aparece, recarga la ventana desde la Command Palette con Developer: Reload Window.Si tienes ANTHROPIC_API_KEY configurada en tu shell pero aún ves la solicitud de inicio de sesión, es posible que VS Code no haya heredado el entorno de tu shell. Inicia VS Code desde una terminal con code . para que herede tus variables de entorno, o inicia sesión con tu cuenta de Claude en su lugar.Después de iniciar sesión, aparece una lista de verificación Learn Claude Code. Completa cada elemento haciendo clic en Show me, o ciérrala con la X. Para volver a abrirla más tarde, desmarca Hide Onboarding en la configuración de VS Code en Extensions > Claude Code.

3

Envía un prompt

Pídele a Claude que te ayude con tu código o tus archivos, ya sea explicando cómo funciona algo, depurando un problema o haciendo cambios.

Claude ve automáticamente el texto que seleccionas. Presiona Option+K (Mac) / Alt+K (Windows/Linux) para además insertar una referencia de @-mención (como @file.ts#5-10) en tu prompt.

Este es un ejemplo de cómo preguntar sobre una línea específica de un archivo:

4

Revisa los cambios

Revisa el modo de permisos que se muestra en la parte inferior del cuadro del prompt:

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

Para revisar una edición propuesta cambio por cambio, usa los botones Accept this change y Reject this change debajo de cada cambio en el diff. Rechazar un cambio lo revierte en el contenido propuesto; aceptarlo lo marca como revisado. La revisión por cambio requiere Claude Code v2.1.275 o posterior.Aceptar o rechazar el archivo completo sigue finalizando la revisión. Un diff con más de 100 cambios se abre sin los botones por cambio, así que revísalo como un archivo completo.Las mismas acciones están disponibles en la posición del cursor desde el menú contextual del editor y desde la Command Palette como Claude Code: Accept Change at Cursor y Claude Code: Reject Change at Cursor.

​

Usar el cuadro de prompt

• Modos de permisos: haz clic en el indicador de modo en la parte inferior del cuadro de prompt para cambiar de modo de permisos. Con Claude Code v2.1.283 o posterior, Auto es el modo de permisos inicial integrado; en versiones anteriores, solo lo es en los planes Pro, Max y Team. Consulta cómo elige la extensión el modo de permisos inicial para saber qué lo cambia y conocer todos los modos de permisos que ofrece el indicador.
  • Auto: un clasificador revisa la mayoría de las acciones en lugar de preguntarte. Consulta modo automático para saber qué revisa y qué bloquea.
  • Manual: Claude pide permiso antes de editar archivos y de ejecutar la mayoría de los comandos de shell.
  • Plan: Claude describe lo que hará y espera tu aprobación antes de hacer cambios. VS Code abre automáticamente el plan como un documento Markdown completo donde puedes agregar comentarios en línea para dar retroalimentación antes de que Claude comience. También puedes escribir /plan en el cuadro de prompt. Requiere Claude Code v2.1.280 o posterior.
    • /plan: cambia a modo plan. Si ya estás en modo plan, muestra el plan actual.
    • /plan con una tarea, como /plan fix the auth bug: cambia a modo plan y comienza a planificar esa tarea.
    • /plan open: cuando ya estás en modo plan, abre el archivo del plan en el editor.
  • Edit automatically: Claude hace ediciones sin preguntar.
• Modelo: selecciona Switch model… en el menú de comandos para cambiar el modelo a mitad de la sesión. También puedes hacer clic en el nombre del modelo en la parte inferior del cuadro de prompt para abrir el mismo selector. Con Claude Code v2.1.284 o posterior, escribir /model solo en el cuadro de prompt también abre el selector. Cuando el modelo actual admite niveles de esfuerzo, el selector también muestra una fila Effort y el botón con el nombre del modelo muestra el nivel seleccionado. Cuando eliges un nivel distinto de max, Claude Code lo guarda como tu valor predeterminado para el modelo actual, en modelSettings dentro de tu configuración de usuario; max se aplica solo a la sesión actual. El botón con el nombre del modelo y la fila Effort requieren Claude Code v2.1.257 o posterior. Cuando los flujos de trabajo dinámicos están habilitados y el modelo actual los admite, aparece un interruptor Ultracode debajo de la fila Effort. Actívalo para que Claude planifique un flujo de trabajo para cada tarea sustancial de esta sesión, con el nivel de esfuerzo seleccionado. Mientras está activado, el botón con el nombre del modelo muestra · Ultracode después del nivel. El interruptor requiere Claude Code v2.1.284 o posterior.
• Menú de comandos: haz clic en / o escribe / para abrir el menú de comandos. Las opciones incluyen adjuntar archivos, cambiar de modelo y activar o desactivar el pensamiento extendido. La sección Customize incluye entradas como servidores MCP, comandos, estilos de salida, hooks, memoria, instrucciones, permisos y plugins. Los elementos con un icono de terminal se abren en la terminal integrada.
  • Para explorar comandos como /usage o /remote-control, selecciona Slash commands en la sección Customize. Un cuadro de diálogo los enumera con un cuadro de filtro. Elige uno para ejecutarlo. Escribir / en el cuadro de prompt sigue sugiriendo comandos en línea. Requiere Claude Code v2.1.257 o posterior. Escribir /skills también abre este cuadro de diálogo. Cada fila de skill muestra su visibilidad, como On o Name only. Haz clic en la visibilidad para cambiarla, excepto en las filas marcadas como locked, como los skills de plugins. El atajo /skills y los controles de visibilidad requieren Claude Code v2.1.280 o posterior.
  • Selecciona Output styles en la sección Customize para elegir un estilo de salida, incluidos tus estilos personalizados. Requiere Claude Code v2.1.257 o posterior. Para crear un estilo personalizado, selecciona Build a custom style en el menú Output styles. Claude Code escribe el archivo de estilo por ti a nivel de proyecto o de usuario. Requiere Claude Code v2.1.261 o posterior.
  • Selecciona Hooks en la sección Customize para ver los hooks cargados en la sesión, agrupados por evento. Puedes agregar, editar o eliminar hooks guardados en tus archivos de configuración de usuario, de proyecto y local. Los hooks de otras fuentes, como la configuración administrada o los plugins, son de solo lectura. Requiere Claude Code v2.1.269 o posterior.
  • Selecciona Permissions en la sección Customize para ver las reglas de permisos de la sesión, agrupadas en Allow, Ask y Deny. Puedes agregar reglas a tu configuración de usuario, de proyecto o local, y eliminar las reglas guardadas allí. Las reglas de otras fuentes, como la configuración administrada o las aprobaciones hechas solo para esta sesión, son de solo lectura. Requiere Claude Code v2.1.269 o posterior.
  • Selecciona Memory en la sección Customize para activar o desactivar la memoria automática. Mientras está activada, también puedes explorar las memorias que Claude ha guardado y mostrar en tu administrador de archivos las carpetas que las almacenan. Requiere Claude Code v2.1.274 o posterior. Haz clic en una memoria guardada para leerla en el cuadro de diálogo, donde puedes editar el texto, eliminar la memoria o abrir su archivo en el editor. Ver, editar y eliminar una memoria en el cuadro de diálogo requiere Claude Code v2.1.275 o posterior.
  • Selecciona Instructions en la sección Customize para editar los archivos CLAUDE.md que Claude lee. Elige un archivo para abrirlo en el editor. Si el archivo aún no existe, Claude Code lo crea primero. Requiere Claude Code v2.1.274 o posterior.
  • Selecciona Status en la sección Customize, o escribe /status, para consultar la versión de Claude Code, la cuenta, el modelo y los detalles de los servidores MCP de la sesión. Requiere Claude Code v2.1.280 o posterior.
  • Selecciona Sandbox en la sección Customize, o escribe /sandbox, para ver si los comandos Bash de Claude se ejecutan en el sandbox. Allí puedes cambiar el modo del sandbox y agregar comandos excluidos. Requiere Claude Code v2.1.280 o posterior.
  • Selecciona Claude in Chrome en la sección Customize, o escribe /chrome, para comprobar y administrar la conexión de Claude in Chrome. Ambas opciones requieren iniciar sesión con una cuenta de claude.ai. Requiere Claude Code v2.1.280 o posterior.
  • Selecciona Export conversation en la sección Context, o escribe /export, para copiar la conversación como texto sin formato o guardarla en un archivo. Agrega un nombre de archivo, como /export notes.txt, para omitir el cuadro de diálogo y elegir dónde guardar el archivo. Requiere Claude Code v2.1.280 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 automáticamente a Remote Control. Requiere Claude Code v2.1.203 o posterior. Cuando activas o desactivas el interruptor en una ventana de VS Code, el cambio no se limita a las sesiones que inicies después. También se aplica a las sesiones que ya están abiertas en esa ventana de VS Code. Si lo desactivas, las sesiones abiertas se desconectan. Con Claude Code v2.1.261 o posterior, el cambio también llega a las sesiones abiertas en tus otras ventanas de VS Code.
  • La sección Settings también incluye Focus view, que oculta las llamadas a herramientas, los resultados de herramientas y el pensamiento detrás de filas expandibles, dejando visibles tus prompts y las respuestas de Claude. Actívala o desactívala 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 se mantiene entre sesiones. Requiere Claude Code v2.1.221 o posterior. La lista de tareas más reciente de Claude sigue visible, al igual que el texto sobre el que pregunta una pregunta pendiente de Claude; esto requiere Claude Code v2.1.225 o posterior. Mientras Claude ejecuta subagentes, aparecen filas de progreso en vivo con su actividad más reciente debajo del grupo de llamadas a herramientas que los inició. Esto requiere Claude Code v2.1.269 o posterior.
  • Para cerrar sesión en tu cuenta de Anthropic, selecciona Sign out en la sección Settings, o escribe /logout. Con un proveedor externo, el menú no ofrece ninguna de las dos opciones. Requiere Claude Code v2.1.277 o posterior.
  • Para reportar un error, haz clic en Report a problem en la parte inferior del menú, o escribe /bug o /feedback con una descripción opcional que completa previamente el reporte. Cuando envías el reporte y has iniciado sesión en Anthropic con una conexión de primera parte, Claude Code lo envía a Anthropic. Requiere Claude Code v2.1.229 o posterior. Con un proveedor externo, o sin credenciales de Anthropic, no se envía nada. El cuadro de diálogo lo indica antes de que escribas. Al enviarlo, el reporte se guarda como un archivo local en ~/.claude/feedback-bundles/ con los patrones conocidos de claves de API y tokens ocultos. Guardar el reporte en tu computadora requiere Claude Code v2.1.284 o posterior. Una vez guardado el reporte, la confirmación indica el nombre del archivo e incluye un botón Show folder. Envía ese archivo a tu representante de cuenta de Anthropic o adjúntalo a una solicitud de soporte. Si la política de tu organización desactiva los comentarios sobre el producto, Report a problem no aparece en el menú, y /bug y /feedback muestran el aviso Feedback is turned off by your organization's policy or this environment's settings. en lugar de abrir el reporte. Con Claude Code v2.1.284 o posterior, si estableces la variable de entorno DISABLE_FEEDBACK_COMMAND o CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, los comentarios también se desactivan y al abrir el reporte se muestra ese aviso.
• Preguntas paralelas: escribe /btw seguido de una pregunta para preguntar sobre tu sesión sin agregarla a la conversación. La respuesta se abre en un panel junto al chat, donde puedes hacer preguntas de seguimiento. Requiere Claude Code v2.1.227 o posterior. El hilo se mantiene al recargar la ventana. Claude Code conserva los 20 intercambios más recientes y hace expirar los hilos almacenados según el calendario de cleanupPeriodDays, siempre que Claude Code pueda determinar de forma segura el período de retención. Para borrar un hilo, haz clic en el icono de papelera del panel.
• Copiar una respuesta: pasa el cursor sobre una respuesta y haz clic en Copy response para copiarla al portapapeles, o escribe /copy para copiar la respuesta más reciente. /copy 2 copia la penúltima. Requiere Claude Code v2.1.277 o posterior.
• Marcadores: pasa el cursor sobre una respuesta y haz clic en Bookmark response para guardarla, o haz clic en Remove bookmark en una respuesta guardada para quitarla. Para revisar las respuestas guardadas, abre el panel Bookmarks. Puedes hacer clic en el icono de marcador en la parte superior del panel de Claude Code, seleccionar Bookmarks en la sección Context del menú de comandos, o escribir /bookmarks. Requiere Claude Code v2.1.286 o posterior.
• Archivos que Claude te envía: cuando la sesión está conectada a Remote Control y Claude te envía archivos con la herramienta SendUserFile, la conversación muestra una fila como Sent report.md, chart.png. Haz clic en el nombre de un archivo para abrirlo en el editor.
• Indicador de contexto: el cuadro de prompt muestra cuánto de la ventana de contexto de Claude estás usando. Claude compacta automáticamente cuando es necesario, o puedes ejecutar /compact manualmente.
• Reloj de la caché de prompts: un icono de reloj junto al indicador de contexto estima cuánto tiempo le queda a la caché de prompts de la conversación antes de expirar. Hace una cuenta regresiva desde la duración de cinco minutos o una hora de la caché, y cada respuesta que usa la caché reinicia la cuenta regresiva. Aparte de la compactación, las acciones que invalidan la caché no reinician el reloj, por lo que aún puede mostrar minutos restantes después de cambiar de modelo.
  • Hasta que termina la cuenta regresiva, el icono muestra los minutos restantes, como 12m.
  • Cuando termina la cuenta regresiva, los minutos desaparecen y el icono se vuelve rojo, o del color de error de tu tema, hasta la siguiente respuesta. Es probable que la caché haya expirado, así que espera una respuesta más lenta y costosa a tu siguiente mensaje mientras la caché se reconstruye. Si la duración de cinco minutos se agota constantemente entre tus mensajes, consulta Elegir el TTL tú mismo.
  • Justo después de que la conversación se compacta, el icono también se vuelve rojo sin minutos hasta la siguiente respuesta, porque la caché aún no cubre la conversación compactada.
• Mapa de agentes: cuando la conversación incluye subagentes, aparece un recuento de agentes como 2 agents en la parte inferior del cuadro de prompt. Su punto indica si algún subagente está trabajando o esperando tu permiso. Haz clic en el recuento de agentes para abrir el mapa de agentes, que dibuja los subagentes de la conversación como un árbol debajo del agente principal, cada uno con su estado, tiempo transcurrido y recuento de tokens. Haz clic en un subagente para ver su prompt y sus llamadas a herramientas, abrir su transcripción de solo lectura o detenerlo mientras se ejecuta. Requiere Claude Code v2.1.269 o posterior. El mapa también enumera las demás tareas en segundo plano de la sesión, como los comandos de shell en segundo plano y los monitores, debajo de los agentes. Haz clic en una fila para abrir la tarjeta de la tarea y detenerla allí. Para abrir el mapa cuando no se muestra ningún recuento de agentes, por ejemplo cuando Claude ha iniciado un shell en segundo plano pero ningún subagente, escribe /tasks en el cuadro de prompt. Las tareas en segundo plano en el mapa y el comando /tasks escrito requieren Claude Code v2.1.277 o posterior. Con Claude Code v2.1.286 o posterior, cuando haces clic en Stop o presionas Esc, el turno actual termina. Los agentes en segundo plano siguen ejecutándose hasta que terminan o los detienes desde el mapa.
• Pensamiento extendido: permite que Claude dedique más tiempo a razonar sobre problemas complejos. Actívalo desde el menú de comandos (/). El razonamiento de Claude aparece en la conversación como bloques contraídos: haz clic en un bloque para leerlo, o presiona Ctrl+O para expandir o contraer todos los bloques de pensamiento de la sesión. Consulta Pensamiento extendido para más detalles.
• Entrada de varias líneas: presiona Shift+Enter para agregar una nueva línea sin enviar. Esto también funciona en la entrada de texto libre “Other” de los cuadros de diálogo de preguntas.

​

Hacer referencia a archivos y carpetas

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

• Cuando el archivo está dentro de tu espacio de trabajo y coincide con tus ajustes files.exclude o search.exclude, Claude recibe como máximo la ruta del archivo y no el texto que seleccionaste.
• Lo mismo se aplica a un archivo que git ignora, siempre que el ajuste search.useIgnoreFiles de VS Code y el ajuste respectGitIgnore de la extensión estén ambos activados, que es el valor predeterminado.

• Para adjuntar una imagen, pégala desde el portapapeles en el cuadro de prompt.
• Para adjuntar archivos, mantén presionada Shift mientras los arrastras al cuadro de prompt.
• Para quitar un adjunto del contexto, haz clic en su X.

​

Incluir la salida de la terminal en los prompts

​

Pegar texto

• Si al pegar aparece un aviso como Removed 3 invisible characters from the pasted text, el texto se insertó sin esos caracteres.
• Si al enviar aparece un aviso sobre caracteres eliminados, no se envió nada. El texto limpio vuelve al cuadro de prompt. Envía de nuevo para enviar el texto tal como se muestra.

​

Matemáticas en LaTeX en las respuestas

• Matemáticas en bloque: un bloque $$ … $$ o \[ … \] en una o varias líneas propias, y un bloque de código delimitado con math como lenguaje
• Matemáticas en línea: $…$ o \(…\) que se abre y se cierra en la misma línea, como $E = mc^2$ o \(a^2 + b^2 = c^2\)

​

Reanudar conversaciones anteriores

• Títulos de sesión: las sesiones nuevas reciben títulos generados por IA a partir de tu primer mensaje.
• Renombrar y archivar: pasa el cursor sobre una sesión para mostrar estas acciones. Renómbrala para darle un título descriptivo, o archívala para moverla al grupo Archived sessions al final de la lista.

This conversation is still open somewhere else. Using it in two places at once can mix up its messages.

• Una sesión: expande Archived sessions y haz clic en Unarchive session.
• Todas las sesiones archivadas a la vez: pasa el cursor sobre el encabezado Archived sessions en la lista de sesiones de la barra de actividad y haz clic en su icono de desarchivar. Requiere Claude Code v2.1.277 o posterior.

• La extensión elige el modo de permisos inicial a partir de claudeCode.initialPermissionMode o de una selección que se mantiene de una conversación anterior
• Tienes configurado claudeCode.claudeProcessWrapper
• Una regla de denegación elimina la herramienta ExitPlanMode

​

Reanudar sesiones en la nube desde claude.ai

​

Consultar la cuenta y el uso

• Plan de claude.ai: barras de uso para los límites de tu plan, como la sesión actual y la semana. Cada barra muestra cuánto falta para que se restablezca su límite. El cuadro de diálogo también desglosa qué contribuye a los límites de tu plan. Señala los comportamientos que representan el 10 % o más del uso reciente, como los fallos de caché, el contexto largo y las sesiones con muchos subagentes o muy paralelas. Cada comportamiento señalado incluye un consejo para reducirlo. Las tablas de atribución muestran cuánto uso provino de cada skill, subagente, plugin y servidor MCP. Usa el selector Day y Week para alternar entre las últimas 24 horas y los últimos 7 días. Las cifras son aproximadas y se calculan a partir de las sesiones locales en esta máquina, por lo que no se incluye el uso desde otros dispositivos ni desde claude.ai.
• Otros inicios de sesión: cuando los límites del plan no se aplican a tu inicio de sesión, como con un proveedor externo o con una clave de API, la sección Usage muestra en su lugar el costo y el uso de tokens de la propia sesión. El /usage de la CLI muestra los mismos totales en su bloque Session. La lista de sesiones de la barra de actividad también muestra los totales de la sesión activa bajo su encabezado Account & usage. Requiere Claude Code v2.1.277 o posterior.

​

Retroceder con checkpoints

• Fork conversation from here: inicia una nueva rama de la conversación a partir de este mensaje y conserva intactos todos los cambios de código
• Rewind code to here: revierte los cambios de archivos hasta este punto de la conversación y conserva el historial completo de la conversación
• Fork conversation and rewind code: inicia una nueva rama de la conversación y revierte los cambios de archivos hasta este punto

​

Personaliza tu flujo de trabajo

​

Elige dónde vive Claude

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

​

Continúa conversaciones después de recargar

• 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 el historial de sesiones.

​

Pasos interrumpidos después de recargar

​

Desactiva la continuación después de recargar

​

Una conversación no se volvió a abrir

“Fix the login bug” was not reopened. It did not finish opening the last 2 times, and opening it again may stop Claude Code from responding here.

• Para abrirla de todos modos: haz clic en Open it anyway o elige la conversación desde el historial de sesiones. Si se abre y el panel sigue funcionando, vuelve después de recargas posteriores como de costumbre. Si el panel deja de responder otra vez, recarga la ventana para volver a un chat nuevo con el aviso.
• Para dejarla cerrada: sigue trabajando en el chat nuevo. El aviso desaparece cuando envías un prompt.

​

Ejecuta varias conversaciones

​

Organiza sesiones en grupos

• 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 quitarla de su grupo. Cada sesión pertenece a un solo grupo a la vez, así que moverla a otro grupo la quita del primero.
• Mover varias sesiones a la vez: haz Cmd-clic (Mac) / Ctrl-clic (Windows/Linux) en cada sesión, o Shift-clic para seleccionar un rango, y 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 y luego elige o crea un grupo. Requiere Claude Code v2.1.257 o posterior.
• Renombrar o eliminar un grupo: haz clic derecho en el encabezado de un grupo. Eliminar un grupo solo quita el grupo, y sus sesiones vuelven a la lista sin agrupar.

​

Filtra la lista de sesiones

• Active: activa este interruptor para mostrar solo las sesiones que necesitan tu intervención, están trabajando o no se han leído, además de la sesión de la pestaña de Claude que enfocaste por última vez.
• Filtrar por estado: haz clic en el ícono de embudo y luego marca Needs input, Working o Completed para mostrar las sesiones en cualquiera de esos estados. Marca Open o Closed para acotar según si una sesión está abierta. Una sesión cuenta como abierta cuando tiene una pestaña en esta ventana o se está ejecutando en otro proceso de Claude Code en esta máquina, como en una terminal.

​

Cambia al modo terminal

​

Administrar plugins

​

Instalar plugins

• Los plugins instalados aparecen en la parte superior con interruptores para activarlos o desactivarlos.
  • Si desactivas un plugin que el .claude/settings.json compartido de tu proyecto activa, la extensión te pregunta primero: Disable for me lo desactiva solo para ti, mientras que Disable for everyone cambia el archivo compartido.
  • Un plugin que no se pudo cargar muestra un motivo breve en su fila. Haz clic en el motivo para ver qué puedes hacer al respecto, incluido copiar el mensaje de error completo para buscarlo en Solución de problemas de plugins.
• Los plugins disponibles de tus marketplaces configurados aparecen debajo
• Busca para filtrar plugins por nombre o descripción
• Haz clic en Install en cualquier plugin disponible

• Install for you: disponible en todos tus proyectos (alcance de usuario)
• Install for this project: compartido con los colaboradores del proyecto (alcance de proyecto)
• Install locally: solo para ti, solo en este repositorio (alcance local)

​

Desinstalar plugins

• Un plugin que el .claude/settings.json compartido de tu proyecto activa: elige Disable for me, que mantiene el plugin instalado para tus colaboradores, o Uninstall for everyone, que elimina la instalación del proyecto con --keep-data, de modo que el directorio de datos guardados del plugin se conserva. Si ya desactivaste el plugin para ti, el icono de papelera elimina tu propia instalación sin hacer la pregunta.
• En otro caso, la última instalación de un plugin con datos guardados: elige si conservar o eliminar los datos; Keep es la opción predeterminada

​

Compartir un enlace de instalación de un plugin

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

• Nombre del plugin: como máximo 100 caracteres, que comience con una letra o un dígito ASCII y que, por lo demás, use solo letras ASCII, dígitos, ., _ y -.
• Fuente del marketplace: solo las formas que lista el parámetro marketplace, así que no una ruta local, una dirección http:// ni el nombre del marketplace, como claude-plugins-official. Una URL https:// no puede contener un nombre de usuario, una contraseña ni una cadena de consulta.
• Ref de Git: para fijar el marketplace a una rama o etiqueta, agrega la ref a la fuente después de %23, la forma codificada de #, como en marketplace=owner/repo%23v1.0. Un enlace con un # sin codificar falla. Los marketplaces de la organización anthropics de GitHub no se pueden fijar en un enlace.

• El marketplace no lista ningún plugin con ese nombre: el diálogo informa que no se encontró el plugin. Compara el valor de plugin con la lista del marketplace.
• El plugin ya está instalado: el diálogo lo indica y no cambia nada.
• Ya se agregó un marketplace diferente con el mismo nombre: el diálogo indica que no se agregó el marketplace del enlace, y no se instala nada.

​

Administrar marketplaces

• Ingresa un repositorio de GitHub, una URL o una ruta local para agregar un nuevo marketplace
• Haz clic en el icono de actualizar para actualizar la lista de plugins de un marketplace
• Haz clic en el icono de papelera para eliminar un marketplace. Eliminarlo desinstala todos los plugins que instalaste desde él, por lo que primero aparece una confirmación que nombra esos plugins

​

Plugins que dibujan en el panel

• Un panel junto a la conversación o encima del cuadro del prompt
• Una notificación emergente o una línea de estado encima del cuadro del prompt
• Un mensaje o una llamada a herramienta dibujados a la manera propia del plugin

• From the token-chart plugin: el plugin dibujó o imprimió esto, o esta tarjeta es el plugin preguntándote algo
• Edited by the token-chart plugin: el plugin cambió algo que dibuja Claude Code, como una llamada a herramienta
• Prompt from the token-chart plugin: el plugin envió este mensaje en tu nombre

​

Automatiza tareas del navegador con Chrome

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

• Habilitar Chrome de forma predeterminada: haz que cada sesión se conecte a tu navegador al iniciarse, sin escribir @browser
• Solicitudes de permiso en sesiones de VS Code: cuándo Claude Code te pregunta antes de una acción del navegador
• Usar Claude Code con Chrome: instrucciones de configuración, la lista completa de capacidades y solución de problemas

​

Trabajar con git

​

Crear confirmaciones y solicitudes de extracción

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

​

Ejecutar trabajo en segundo plano

​

Mover un comando o subagente en ejecución al segundo plano

• Momento: la acción aparece una vez que un comando lleva unos dos segundos en ejecución, o tan pronto como se inicia un subagente.
• Después de hacer clic: Claude deja de esperar y continúa el turno. El comando o subagente sigue ejecutándose como una tarea en segundo plano que notifica a Claude cuando termina.

​

Supervisar procesos en segundo plano

​

Comandos y atajos de VS Code

​

Abrir una pestaña de VS Code desde otras herramientas

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

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

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

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

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

​

Configurar los ajustes

• Ajustes de la extensión en VS Code: controlan el comportamiento de la extensión dentro de VS Code. Ábrelos con Cmd+, (Mac) o Ctrl+, (Windows/Linux) y luego ve a Extensions > Claude Code. También puedes escribir / y seleccionar General config… para abrir la configuración.
• Configuración de Claude Code en ~/.claude/settings.json: compartida entre la extensión y la CLI. Úsala para comandos permitidos, variables de entorno, hooks y servidores MCP. Con Claude Code v2.1.283 o posterior, también es uno de los factores que determinan el modo de permisos con el que empiezan las conversaciones; en versiones anteriores, solo en los planes Pro, Max y Team. Cambiar modos de permisos indica el orden. Consulta Configuración para más detalles.

​

Ajustes de la extensión

​

Usar proveedores externos

​

Usar un lector de pantalla

• Las respuestas de Claude: la extensión anuncia cada respuesta una sola vez, cuando está completa, y permanece en silencio mientras el texto se transmite. Tu lector de pantalla lee los bloques de código como un resumen con el número de líneas, lee los enlaces por su etiqueta y lee las tablas celda por celda; la respuesta completa sigue disponible para leer en la transcripción.
• Solicitudes de permiso y preguntas: la extensión anuncia una solicitud cuando aparece su solicitud de permiso, indicando la herramienta que Claude quiere usar. Anuncia de la misma manera cuando Claude te hace una pregunta y cuando Claude termina un plan y espera tu revisión.
• Cambios de estado: la extensión anuncia cuando Claude empieza a trabajar, cuando Claude está listo para tu entrada y cuando Claude Code empieza a compactar la conversación.
• Mensajes en cola: cuando envías un mensaje mientras Claude está trabajando, la extensión anuncia “Message queued.” para ese mensaje.
• Errores y solicitudes del modelo: la extensión anuncia los errores en la conversación y anuncia cuando aparece la solicitud de consentimiento de créditos de uso o la solicitud de una solicitud marcada.

​

Usar el panel de chat desde el teclado

• Tus mensajes: “You”
• Los mensajes de Claude: “Claude”
• Pasos de herramientas: “Claude” más el nombre de la herramienta, como “Claude, Bash”
• Bloques de pensamiento: “Claude, thinking”

• Con esa opción enfocada, presiona la tecla de flecha Left o Right. La extensión anuncia cada destino a medida que te desplazas a él. Las teclas de flecha requieren Claude Code v2.1.268 o posterior.
• Haz clic en el destino en la etiqueta.

​

Extensión de VS Code vs. CLI de Claude Code

​

Ejecutar la CLI en VS Code

​

Cambiar entre la extensión y la CLI

​

Conectar con herramientas externas mediante MCP

• Agregar servidores
• Eliminar servidores guardados en el alcance local, de usuario o de proyecto
• Habilitar o deshabilitar servidores
• Volver a conectarte a un servidor
• Administrar la autenticación OAuth

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

​

El servidor MCP integrado del IDE

• Abre diffs en el visor de diffs nativo de VS Code
• Lee tu selección actual para las @-menciones
• Le pide a VS Code que ejecute celdas cuando trabajas en un notebook de Jupyter

• Mensajes en cola: si pones un mensaje en cola mientras Claude trabaja, conserva la selección que tenías cuando presionaste Enter, independientemente de lo que selecciones después.
• Archivos sensibles: para excluir un archivo sensible como .env, agrega una regla de denegación Read para su ruta. Una regla de denegación que coincida impide que tanto el texto seleccionado como el aviso de archivo abierto de ese archivo lleguen a Claude.
• Attach Open File desactivado: si desactivas el ajuste Attach Open File, la CLI recibe la ruta del archivo activo solo mientras tienes texto seleccionado en él.

• Transporte: ws:// sin cifrar. Como el socket es solo de loopback, cualquier proceso que pudiera capturar el tráfico también puede leer el token del archivo de bloqueo, por lo que TLS no añadiría protección.
• Token de autenticación: cada activación de la extensión genera un nuevo token de autenticación aleatorio y lo escribe en un archivo de bloqueo en ~/.claude/ide/<port>.lock. La CLI debe presentar el token como el encabezado X-Claude-Code-Ide-Authorization para conectarse.
• Permisos del archivo de bloqueo: el archivo de bloqueo tiene permisos 0600 en un directorio 0700, por lo que solo el usuario que ejecuta VS Code puede leerlo. Si CLAUDE_CONFIG_DIR está definido, el archivo de bloqueo se escribe en $CLAUDE_CONFIG_DIR/ide/ en su lugar.

{
  "permissions": {
    "deny": [
      "mcp__ide__getDiagnostics",
      "mcp__claude-vscode__getDiagnostics"
    ]
  }
}

1. El código se inserta como una nueva celda al final del notebook activo.
2. VS Code desplaza la vista hasta la celda.
3. Un Quick Pick nativo te pide que elijas Execute o Cancel.

​

Soluciona problemas comunes

​

La extensión no se instala

• Asegúrate de tener una versión compatible de VS Code (1.94.0 o posterior)
• Verifica que VS Code tenga permiso para instalar extensiones
• Intenta instalarla directamente desde el VS Code Marketplace

​

El ícono Spark no es visible

1. Abre un archivo: el ícono requiere que haya un archivo abierto. Tener solo una carpeta abierta no es suficiente.
2. Verifica la versión de VS Code: se requiere 1.94.0 o posterior. Revísala en Help > About
3. Reinicia VS Code: ejecuta “Developer: Reload Window” desde la Command Palette
4. Desactiva las extensiones en conflicto: desactiva temporalmente otras extensiones de IA (Cline, Continue, etc.)
5. Verifica la confianza del espacio de trabajo: la extensión no funciona en el modo restringido (Restricted Mode)

​

Cmd+Esc no hace nada en macOS

1. Abre System Settings
2. Ve a Keyboard, luego a Keyboard Shortcuts y luego a Game Controllers
3. Desmarca la casilla Game Overlay

​

Una conversación reanudada aparece en blanco al principio

​

El panel deja de responder cada vez que una recarga vuelve a abrir una conversación

​

Una fórmula se muestra como LaTeX sin procesar

• Se interpreta como algo distinto de matemáticas: el texto $…$ que se lee como una palabra se mantiene tal como está escrito, por ejemplo $O(n log n)$. El texto $…$ que empieza con un dígito, como $30$ o $1/N$, también se mantiene tal como está escrito, a menos que un carácter como =, + o ^ lo marque como matemáticas. Pídele a Claude un bloque $$ en sus propias líneas, que el panel formatea sin esta comprobación.
• Tiene espacios de relleno, es largo o está dividido en varias líneas: $ x^2 $ con espacios dentro de los signos de dólar, el contenido $…$ de más de 60 caracteres y $…$ o \(…\) divididos en dos líneas no reciben formato tipográfico. Pídele a Claude un bloque $$ en sus propias líneas, que no tiene ninguno de estos límites.
• El TeX no se puede formatear: una fórmula con un error de sintaxis, una definición de macro como \newcommand o \def, o un % sin escapar se muestra tal como está escrita. Pídele a Claude que la reescriba con el error corregido, sin la macro o con \% para el signo de porcentaje.
• Es demasiado grande: una fórmula de más de 8,192 caracteres, o una que se dibujaría mucho más grande que su código fuente, se muestra tal como está escrita. Pídele a Claude que la divida en fórmulas más pequeñas o que la escriba de forma más compacta.
• Viene después de una gran cantidad de matemáticas: dentro de un mismo bloque de texto de una respuesta, el panel formatea las fórmulas en orden hasta un límite. Una fórmula posterior que superaría el límite se muestra tal como está escrita. Pídele a Claude que vuelva a enviar la fórmula que necesitas por sí sola.

​

Claude Code nunca responde

1. Verifica tu conexión a internet: asegúrate de tener una conexión a internet estable
2. Inicia una nueva conversación: intenta iniciar una conversación nueva para ver si el problema persiste
3. Prueba la CLI: ejecuta claude desde la terminal para ver si obtienes mensajes de error más detallados

​

Desinstalar la extensión

1. Presiona Cmd+Shift+X en Mac o Ctrl+Shift+X en Windows/Linux para abrir la vista de Extensiones
2. Busca “Claude Code”
3. Haz clic en Uninstall

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

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

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

​

Próximos pasos

• Explora flujos de trabajo comunes para aprovechar al máximo Claude Code
• Configura servidores MCP para ampliar las capacidades de Claude con herramientas externas. Agrégalos y adminístralos con /mcp en el panel de chat.
• Configura los ajustes de Claude Code para personalizar los comandos permitidos, los hooks y más. Esta configuración se comparte entre la extensión y la CLI.
• Revisa las medidas de seguridad y el uso de datos de Claude Code