Usar Claude Code en VS Code - Claude Code Docs

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 tu IDE. Esta es la forma recomendada de usar Claude Code en VS Code. Con la extensión, puedes 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 tu 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.98.0 o superior
Una cuenta de Anthropic (iniciarás sesión cuando abras la extensión por primera vez). Si estás utilizando un proveedor de terceros como Amazon Bedrock o Google Vertex AI, consulta Usar proveedores de terceros en su lugar.

La extensión incluye la CLI (interfaz de línea de comandos), a la que puedes acceder desde la terminal integrada de VS Code para funciones avanzadas. Consulta Extensión de VS Code frente a CLI de Claude Code para obtener más detalles.

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.

Si la extensión no aparece después de la instalación, reinicia VS Code o ejecuta “Developer: Reload Window” desde la Paleta de comandos.

Comenzar

Una vez instalada, puedes 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:

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 tienes un archivo abierto.

Otras formas de abrir Claude Code:

Barra de actividades: haz clic en el icono Spark en la barra lateral izquierda para abrir la lista de sesiones. Haz clic en cualquier sesión para abrirla como una pestaña de editor completa, o inicia 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), escribe “Claude Code” y selecciona una opción como “Abrir en Nueva Pestaña”
Barra de estado: 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 reposicionarlo en cualquier lugar de VS Code. Consulta Personalizar tu flujo de trabajo para obtener más detalles.

Iniciar sesión

La primera vez que abres el panel, aparece una pantalla de inicio de sesión. Haz clic en Iniciar sesión y completa la autorización en tu navegador.Si ves No iniciado sesión · Por favor ejecuta /login más tarde, la extensión reabre la pantalla de inicio de sesión automáticamente. Si no aparece, recarga la ventana desde la Paleta de comandos con Developer: Reload Window.Si tienes ANTHROPIC_API_KEY configurada en tu shell pero aún ves el mensaje de inicio de sesión, VS Code puede no haber heredado tu entorno de shell. Lanza 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 Aprender Claude Code. Trabaja en cada elemento haciendo clic en Mostrarme, o descártalo con la X. Para reabrirlo más tarde, desmarque Ocultar incorporación en la configuración de VS Code en Extensiones → Claude Code.

Enviar un mensaje

Pide a Claude que te ayude con tu código o archivos, ya sea explicando cómo funciona algo, depurando un problema o realizando cambios.

Claude ve automáticamente tu texto seleccionado. Presiona Option+K (Mac) / Alt+K (Windows/Linux) para también insertar una referencia de mención @ (como @file.ts#5-10) en tu mensaje.

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

Editor de VS Code 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 de mención @

Revisar cambios

Cuando Claude quiere editar un archivo, muestra una comparación lado a lado del original y los cambios propuestos, luego solicita 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, Claude es informado de que lo modificaste para que no asuma que el archivo coincide con su propuesta original.

VS Code mostrando un diff de los cambios propuestos por Claude con un mensaje de permiso preguntando si realizar la edición

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

Ejecuta “Claude Code: Open Walkthrough” desde la Paleta de comandos para un tour guiado de los conceptos básicos.

Usar el cuadro de mensaje

El cuadro de mensaje admite varias características:

Modos de permiso: haz clic en el indicador de modo en la parte inferior del cuadro de mensaje para cambiar de modo. En modo normal, Claude solicita permiso antes de cada acción. En Plan Mode, 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 puedes agregar comentarios en línea para dar retroalimentación antes de que Claude comience. En modo de aceptación automática, Claude realiza ediciones sin preguntar. Establece el valor predeterminado en la configuración de VS Code en claudeCode.initialPermissionMode.
Menú de comandos: haz clic en / o escribe / para abrir el menú de comandos. Las opciones incluyen adjuntar archivos, cambiar modelos, alternar pensamiento extendido, ver uso del plan (/usage) e iniciar una sesión de Control remoto (/remote-control). La sección Personalizar proporciona acceso a MCP servers, hooks, memoria, permisos y plugins. Los elementos con un icono de terminal se abren en la terminal integrada.
Indicador de contexto: el cuadro de mensaje muestra cuánto de la ventana de contexto de Claude estás utilizando. Claude se compacta automáticamente cuando es necesario, o puedes ejecutar /compact manualmente.
Pensamiento extendido: permite que Claude dedique más tiempo a razonar sobre problemas complejos. Actívalo a través del 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 cada bloque de pensamiento en la sesión. Consulta Pensamiento extendido para obtener más detalles.
Entrada multilínea: presiona Shift+Enter para agregar una nueva línea sin enviar. Esto también funciona en la entrada de texto libre “Otro” de los diálogos de preguntas.

Referenciar archivos y carpetas

Usa menciones @ para dar a Claude contexto sobre archivos o carpetas específicas. Cuando escribes @ 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 puedes escribir nombres parciales para encontrar lo que necesitas:

> 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, puedes 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 seleccionas texto en el editor, Claude puede ver tu código resaltado automáticamente. El pie de página del cuadro de mensaje muestra cuántas líneas están seleccionadas. Presiona Option+K (Mac) / Alt+K (Windows/Linux) para insertar una mención @ con la ruta del archivo y los números de línea (por ejemplo, @app.ts#5-10). Haz clic en el indicador de selección para alternar si Claude puede ver tu texto resaltado: el icono de barra diagonal significa que la selección está oculta para Claude. También puedes mantener presionado Shift mientras arrastras archivos al cuadro de mensaje para agregarlos como adjuntos. Haz clic en la X en cualquier adjunto para eliminarlo del contexto.

Reanudar conversaciones pasadas

Haz clic en el botón Historial de sesiones en la parte superior del panel de Claude Code para acceder a tu historial de conversaciones. Puedes buscar por palabra clave o examinar por tiempo (Hoy, Ayer, Últimos 7 días, etc.). Haz clic en cualquier conversación para reanudarla con el historial de mensajes completo. Las nuevas sesiones reciben títulos generados por IA basados en tu primer mensaje. Pasa el cursor sobre una sesión para revelar acciones de cambio de nombre y eliminación: cambia el nombre para darle un título descriptivo, o elimina para borrarlo de la lista. Para más información sobre cómo reanudar sesiones, consulta Flujos de trabajo comunes.

Reanudar sesiones remotas desde Claude.ai

Si utilizas Claude Code en la web, puedes reanudar esas sesiones remotas directamente en VS Code. Esto requiere iniciar sesión con Claude.ai Subscription, no Anthropic Console.

Abrir historial de sesiones

Haz clic en el botón Historial de sesiones en la parte superior del panel de Claude Code.

Seleccionar la pestaña Remoto

El diálogo muestra dos pestañas: Local y Remoto. Haz clic en Remoto para ver sesiones desde claude.ai.

Seleccionar una sesión para reanudar

Examina o busca tus sesiones remotas. Haz clic en cualquier sesión para descargarla y continuar la conversación localmente.

Solo las sesiones web iniciadas con un repositorio de GitHub aparecen en la pestaña Remoto. Reanudar carga el historial de conversaciones localmente; los cambios no se sincronizan de vuelta a claude.ai.

Personalizar tu flujo de trabajo

Una vez que estés en funcionamiento, puedes reposicionar el panel de Claude, ejecutar múltiples sesiones o cambiar al modo terminal.

Elegir dónde vive Claude

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

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

Usa la barra lateral para tu sesión principal de Claude y abre pestañas adicionales para tareas secundarias. Claude recuerda tu ubicación preferida. El icono de lista de sesiones de la Barra de actividades es separado del panel de Claude: la lista de sesiones siempre es visible en la Barra de actividades, mientras que el icono del panel de Claude solo aparece allí cuando el panel está acoplado a la barra lateral izquierda.

Ejecutar múltiples conversaciones

Usa Abrir en Nueva Pestaña u Abrir en Nueva Ventana desde la Paleta de comandos para iniciar conversaciones adicionales. Cada conversación mantiene su propio historial y contexto, permitiéndote trabajar en diferentes tareas en paralelo. Cuando usas pestañas, un pequeño punto de color en el icono spark indica el estado: azul significa que hay una solicitud de permiso pendiente, naranja significa que Claude terminó mientras la pestaña estaba oculta.

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 Usar terminal y marca la casilla. También puedes abrir la configuración de VS Code (Cmd+, en Mac o Ctrl+, en Windows/Linux), ir a Extensiones → Claude Code y marcar Usar terminal.

Administrar plugins

La extensión de VS Code incluye una interfaz gráfica para instalar y administrar plugins. Escribe /plugins en el cuadro de mensaje para abrir la interfaz Administrar 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 tus marketplaces configurados aparecen a continuación
Busca para filtrar plugins por nombre o descripción
Haz clic en Instalar en cualquier plugin disponible

Cuando instalas un plugin, elige el alcance de instalación:

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

Administrar marketplaces

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

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

Después de realizar cambios, un banner te solicita que reinicies Claude Code para aplicar las actualizaciones.

La administración de plugins en VS Code utiliza los mismos comandos CLI bajo el capó. Los plugins y marketplaces que configuras en la extensión también están disponibles en la CLI, y viceversa.

Para más información sobre el sistema de plugins, consulta Plugins y Marketplaces de plugins.

Automatizar tareas del navegador con Chrome

Conecta Claude a tu 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. Escribe @browser en el cuadro de mensaje seguido de lo que deseas que Claude haga:

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

También puedes abrir el menú de adjuntos para seleccionar herramientas específicas del navegador como abrir una nueva pestaña o leer contenido de la página. Claude abre nuevas pestañas para tareas del navegador y comparte el estado de inicio de sesión de tu navegador, por lo que puedes acceder a cualquier sitio en el que ya hayas iniciado sesión. Para instrucciones de configuración, la lista completa de capacidades y solución de problemas, consulta Usar Claude Code con Chrome.

Comandos y atajos de teclado de VS Code

Abre la Paleta de comandos (Cmd+Shift+P en Mac o Ctrl+Shift+P en Windows/Linux) y escribe “Claude Code” para ver todos los comandos de VS Code disponibles para la extensión Claude Code. Algunos atajos de teclado dependen de qué panel esté “enfocado” (recibiendo entrada de teclado). Cuando tu cursor está en un archivo de código, el editor está enfocado. Cuando tu cursor está en el cuadro de mensaje de Claude, Claude está enfocado. Usa Cmd+Esc / Ctrl+Esc para alternar entre ellos.

Estos son comandos de VS Code para controlar la extensión. No todos los comandos integrados de Claude Code están disponibles en la extensión. Consulta Extensión de VS Code frente a CLI de Claude Code para obtener más detalles.

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 izquierda
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`
Insert @-Mention Reference	`Option+K` (Mac) / `Alt+K` (Windows/Linux)	Insertar una referencia al archivo actual y selección (requiere que el editor esté enfocado)
Show Logs	-	Ver registros de depuración de la extensión
Logout	-	Cerrar sesión de tu cuenta de Anthropic

Lanzar una pestaña de VS Code desde otras herramientas

La extensión registra un controlador URI en vscode://anthropic.claude-code/open. Úsalo para abrir una nueva pestaña de Claude Code desde tu propia herramienta: un alias de shell, un marcador de navegador, o cualquier script que pueda abrir una URL. Si VS Code no está ejecutándose, abrir la URL lo lanza primero. Si VS Code ya está ejecutándose, la URL se abre en la ventana que está actualmente enfocada. Invoca el controlador con el abridor de URL de tu sistema operativo. En macOS:

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

Usa xdg-open en Linux o start en Windows. El controlador acepta dos parámetros de consulta opcionales:

Parámetro	Descripción
`prompt`	Texto para rellenar previamente en el cuadro de mensaje. Debe estar codificado en URL. El mensaje 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, consulta Continuar conversaciones.

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

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

Configurar ajustes

La extensión tiene dos tipos de configuración:

Configuración de extensión en VS Code: controla el comportamiento de la extensión dentro de VS Code. Abre con Cmd+, (Mac) o Ctrl+, (Windows/Linux), luego ve a Extensiones → 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. Usa para comandos permitidos, variables de entorno, hooks y MCP servers. Consulta Configuración para obtener más detalles.

Agrega "$schema": "https://json.schemastore.org/claude-code-settings.json" a tu settings.json para obtener autocompletado y validación en línea para todos los ajustes disponibles directamente en VS Code.

Configuración de extensión

Configuración	Predeterminado	Descripción
`useTerminal`	`false`	Lanzar Claude en modo terminal en lugar de panel gráfico
`initialPermissionMode`	`default`	Controla mensajes de aprobación para nuevas conversaciones: `default`, `plan`, `acceptEdits`, o `bypassPermissions`. Consulta modos de permiso.
`preferredLocation`	`panel`	Dónde se abre Claude: `sidebar` (derecha) o `panel` (nueva pestaña)
`autosave`	`true`	Guardar archivos automáticamente 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
`hideOnboarding`	`false`	Ocultar la lista de verificación de incorporación (icono de gorro de graduación)
`respectGitIgnore`	`true`	Excluir patrones de .gitignore de búsquedas de archivos
`usePythonEnvironment`	`true`	Activar el entorno de Python del espacio de trabajo cuando se ejecuta Claude. Requiere la extensión de Python.
`environmentVariables`	`[]`	Establecer variables de entorno para el proceso de Claude. Usa la configuración 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 Modo Auto y Bypass permissions a la selector de modo. Auto mode tiene requisitos de plan, admin, modelo y proveedor, por lo que puede permanecer no disponible incluso con este toggle activado. Usa Bypass permissions solo en sandboxes sin acceso a Internet.
`claudeProcessWrapper`	-	Ruta ejecutable utilizada para lanzar el proceso de Claude

Extensión de VS Code frente a CLI de Claude Code

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 necesitas una característica solo de CLI, ejecuta claude en la terminal integrada de VS Code.

Característica	CLI	Extensión de VS Code
Comandos y skills	Todos	Subconjunto (escribe `/` para ver disponibles)
Configuración de MCP server	Sí	Parcial (agrega servidores a través de CLI; administra servidores existentes con `/mcp` en el panel de chat)
Checkpoints	Sí	Sí
Atajo bash `!`	Sí	No
Autocompletado de pestañas	Sí	No

Retroceder con checkpoints

La extensión de VS Code admite checkpoints, que rastrean las ediciones de archivos de Claude y te permiten retroceder a un estado anterior. Pasa el cursor sobre cualquier mensaje para revelar el botón de retroceso, luego elige entre tres opciones:

Bifurcar conversación desde aquí: iniciar una nueva rama de conversación desde este mensaje mientras mantienes todos los cambios de código intactos
Retroceder código a aquí: revertir cambios de archivo a este punto en la conversación mientras mantienes el historial de conversación completo
Bifurcar conversación y retroceder código: iniciar una nueva rama de conversación y revertir cambios de archivo a este punto

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

Ejecutar CLI en VS Code

Para usar la CLI mientras permaneces en VS Code, abre la terminal integrada (Ctrl+` en Windows/Linux o Cmd+` en Mac) y ejecuta claude. La CLI se integra automáticamente con tu IDE para características como visualización de diffs y uso compartido de diagnósticos. Si usas una terminal externa, ejecuta /ide dentro de Claude Code para conectarlo a VS Code.

Cambiar entre extensión y CLI

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

Incluir salida de terminal en mensajes

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

Monitorear procesos en segundo plano

Cuando Claude ejecuta comandos de larga duración, la extensión muestra el progreso en la barra de estado. Sin embargo, la visibilidad de tareas en segundo plano es limitada en comparación con la CLI. Para mejor visibilidad, haz que Claude genere el comando para que puedas ejecutarlo en la terminal integrada de VS Code.

Conectar a herramientas externas con MCP

Los servidores MCP (Model Context Protocol) dan a Claude acceso a herramientas externas, bases de datos y APIs. Para agregar un servidor MCP, abre la terminal integrada (Ctrl+` o Cmd+`) y ejecuta:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

Una vez configurado, pide a Claude que use las herramientas (por ejemplo, “Review PR #456”). Para administrar servidores MCP sin salir de VS Code, escribe /mcp en el panel de chat. El diálogo de administración de MCP te permite habilitar o deshabilitar servidores, reconectarse a un servidor y administrar la autenticación OAuth. Consulta la documentación de MCP para servidores disponibles.

Trabajar con git

Claude Code se integra con git para ayudarte con flujos de trabajo de control de versiones directamente en VS Code. Pide a Claude que confirme cambios, cree solicitudes de extracción o trabaje en diferentes ramas.

Crear confirmaciones y solicitudes de extracción

Claude puede preparar cambios, escribir mensajes de confirmación y crear solicitudes de extracción basadas en tu 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 pruebas o decisiones de implementación.

Usar git worktrees para tareas paralelas

Usa la bandera --worktree (-w) para iniciar Claude en un worktree aislado con sus propios archivos y rama:

claude --worktree feature-auth

Cada worktree mantiene un estado de archivo independiente mientras comparte el historial de git. Esto evita que las instancias de Claude interfieran entre sí cuando trabajan en diferentes tareas. Para más detalles, consulta Ejecutar sesiones paralelas de Claude Code con Git worktrees.

Usar proveedores de terceros

De forma predeterminada, Claude Code se conecta directamente a la API de Anthropic. Si tu organización utiliza Amazon Bedrock, Google Vertex AI o Microsoft Foundry para acceder a Claude, configura la extensión para usar tu proveedor en su lugar:

Deshabilitar mensaje de inicio de sesión

Abre la configuración Deshabilitar mensaje de inicio de sesión y marca la casilla.También puedes abrir la configuración de VS Code (Cmd+, en Mac o Ctrl+, en Windows/Linux), buscar “Claude Code login” y marcar Deshabilitar mensaje de inicio de sesión.

Configurar tu proveedor

Sigue la guía de configuración para tu proveedor:

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

Seguridad y privacidad

Tu código permanece privado. Claude Code procesa tu 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, consulta Datos y privacidad. Con permisos de edición automática 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:

Habilita Modo restringido de VS Code para espacios de trabajo no confiables
Usa el modo de aprobación manual en lugar de aceptación automática para ediciones
Revisa cuidadosamente los cambios 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 tu selección actual para menciones @ y, cuando estás trabajando en un notebook de Jupyter, le pide a VS Code que ejecute celdas. El servidor se llama ide y está oculto de /mcp porque no hay nada que configurar. Sin embargo, si tu organización utiliza un hook PreToolUse para permitir herramientas MCP, necesitarás saber que existe. Transporte y autenticación. El servidor se vincula a 127.0.0.1 en un puerto alto aleatorio y no es accesible desde otras máquinas. Cada activación de extensión genera un token de autenticación aleatorio nuevo que la CLI debe presentar para conectarse. El token se escribe en un archivo de bloqueo bajo ~/.claude/ide/ con permisos 0600 en un directorio 0700, por lo que solo el usuario que ejecuta VS Code puede leerlo. 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 usa 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 herramienta (como se ve en hooks)	Qué hace	¿Escribe?
`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.	No
`mcp__ide__executeCode`	Ejecuta código Python en el kernel del notebook de Jupyter activo. Consulta el flujo de confirmación a continuación.	Sí

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 notebook activo, VS Code lo desplaza a la vista y una Quick Pick nativa te pregunta si Ejecutar o Cancelar. Cancelar (o descartar la selección con Esc) devuelve un error a Claude y nada se ejecuta. La herramienta también se niega rotundamente cuando no hay un notebook activo, cuando la extensión de Jupyter (ms-toolsai.jupyter) no está instalada, o cuando el kernel no es Python.

La confirmación de Quick Pick es separada de los hooks PreToolUse. Una entrada de lista de permitidos para mcp__ide__executeCode permite que Claude proponga ejecutar una celda; la Quick Pick dentro de VS Code es lo que permite que realmente se ejecute.

Solucionar problemas comunes

La extensión no se instala

Asegúrate de tener una versión compatible de VS Code (1.98.0 o posterior)
Verifica que VS Code tenga permiso para instalar extensiones
Intenta 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 tienes un archivo abierto. Si no lo ves:

Abre un archivo: El icono requiere que un archivo esté abierto. Solo tener una carpeta abierta no es suficiente.
Verifica la versión de VS Code: Requiere 1.98.0 o superior (Ayuda → Acerca de)
Reinicia VS Code: Ejecuta “Developer: Reload Window” desde la Paleta de comandos
Deshabilita extensiones conflictivas: Deshabilita temporalmente otras extensiones de IA (Cline, Continue, etc.)
Verifica la confianza del espacio de trabajo: La extensión no funciona en Modo restringido

Alternativamente, haz clic en ”✱ Claude Code” en la Barra de estado (esquina inferior derecha). Esto funciona incluso sin un archivo abierto. También puedes usar la Paleta de comandos (Cmd+Shift+P / Ctrl+Shift+P) y escribir “Claude Code”.

Claude Code nunca responde

Si Claude Code no responde a tus mensajes:

Verifica tu conexión a Internet: Asegúrate de tener una conexión a Internet estable
Inicia una nueva conversación: Intenta iniciar una conversación nueva para ver si el problema persiste
Intenta la CLI: Ejecuta claude desde la terminal para ver si obtienes mensajes de error más detallados

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

Desinstalar la extensión

Para desinstalar la extensión Claude Code:

Abre la vista Extensiones (Cmd+Shift+X en Mac o Ctrl+Shift+X en Windows/Linux)
Busca “Claude Code”
Haz clic en Desinstalar

Para también eliminar datos de extensión y restablecer toda la configuración:

rm -rf ~/.vscode/globalStorage/anthropic.claude-code

Para obtener ayuda adicional, consulta 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 servidores usando la CLI, luego adminístralos con /mcp en el panel de chat.
Configura la configuración de Claude Code para personalizar comandos permitidos, hooks y más. Esta configuración se comparte entre la extensión y la CLI.

Primeros pasos

Conceptos fundamentales

Usar Claude Code

Plataformas e integraciones

​Requisitos previos

​Instalar la extensión

​Comenzar

​Usar el cuadro de mensaje

​Referenciar archivos y carpetas

​Reanudar conversaciones pasadas

​Reanudar sesiones remotas desde Claude.ai

​Personalizar tu flujo de trabajo

​Elegir dónde vive Claude

​Ejecutar múltiples conversaciones

​Cambiar al modo terminal

​Administrar plugins

​Instalar plugins

​Administrar marketplaces

​Automatizar tareas del navegador con Chrome

​Comandos y atajos de teclado de VS Code

​Lanzar una pestaña de VS Code desde otras herramientas

​Configurar ajustes

​Configuración de extensión

​Extensión de VS Code frente a CLI de Claude Code

​Retroceder con checkpoints

​Ejecutar CLI en VS Code

​Cambiar entre extensión y CLI

​Incluir salida de terminal en mensajes

​Monitorear procesos en segundo plano

​Conectar a herramientas externas con MCP

​Trabajar con git

​Crear confirmaciones y solicitudes de extracción

​Usar git worktrees para tareas paralelas

​Usar proveedores de terceros

​Seguridad y privacidad

​El servidor MCP IDE integrado

​Solucionar problemas comunes

​La extensión no se instala

​El icono Spark no es visible

​Claude Code nunca responde

​Desinstalar la extensión

​Próximos pasos

Requisitos previos

Instalar la extensión

Comenzar

Usar el cuadro de mensaje

Referenciar archivos y carpetas

Reanudar conversaciones pasadas

Reanudar sesiones remotas desde Claude.ai

Personalizar tu flujo de trabajo

Elegir dónde vive Claude

Ejecutar múltiples conversaciones

Cambiar al modo terminal

Administrar plugins

Instalar plugins

Administrar marketplaces

Automatizar tareas del navegador con Chrome

Comandos y atajos de teclado de VS Code

Lanzar una pestaña de VS Code desde otras herramientas

Configurar ajustes

Configuración de extensión

Extensión de VS Code frente a CLI de Claude Code

Retroceder con checkpoints

Ejecutar CLI en VS Code

Cambiar entre extensión y CLI

Incluir salida de terminal en mensajes

Monitorear procesos en segundo plano

Conectar a herramientas externas con MCP

Trabajar con git

Crear confirmaciones y solicitudes de extracción

Usar git worktrees para tareas paralelas

Usar proveedores de terceros

Seguridad y privacidad

El servidor MCP IDE integrado

Solucionar problemas comunes

La extensión no se instala

El icono Spark no es visible

Claude Code nunca responde

Desinstalar la extensión

Próximos pasos