La extensión Claude Code para VS Code se instala directamente desde el marketplace y se ejecuta de forma nativa dentro de tu editor, de modo que no tienes que saltar entre una pestaña del navegador y tu espacio de trabajo. Incorpora el mismo motor de Claude Code que impulsa la CLI, por lo que todo, desde los comandos de barra hasta la edición de archivos y las llamadas a herramientas MCP, funciona igual, solo que dentro de la barra lateral de tu editor. PyCharm y el resto de la familia JetBrains reciben el mismo tratamiento a través de un plugin dedicado de JetBrains. Y como ambas superficies leen ANTHROPIC_BASE_URL del entorno, cambiar el backend de LLM a la API de Novita AI — y a su selección más amplia de modelos — requiere un solo cambio de variable de entorno.
Qué hace realmente la extensión de VS Code
La extensión Claude Code para VS Code no es una pestaña de chatbot acoplada a tu editor. Presenta el agente Claude Code completo dentro de un panel lateral: la misma interfaz estilo REPL, el mismo conjunto de herramientas, la misma continuidad de sesión. Cuando le pides que refactorice una función o que escriba pruebas para un archivo que tienes abierto, lee y edita esos archivos directamente en tu espacio de trabajo, sin portapapeles de por medio.
Cosas concretas que maneja la extensión:
- Ediciones de múltiples archivos con diff en línea. Claude Code propone cambios y muestra un diff que puedes aceptar o rechazar sin salir del editor.
- Comandos de barra.
/compact,/init,/memory,/cleary el resto funcionan igual que en la CLI. - Fijación de contexto. El prefijo
#te permite adjuntar archivos, carpetas o símbolos específicos como contexto para una solicitud. - Conciencia de CLAUDE.md. Las instrucciones del proyecto y los estándares de codificación que hayas escrito en
CLAUDE.mdse cargan automáticamente al inicio de la sesión. - Llamadas a herramientas MCP. Cualquier servidor MCP registrado en tu configuración de Claude Code está disponible dentro de la extensión.
Lo que no hace: no añade autocompletado de IA en el búfer de tu editor. Para eso, herramientas como Copilot o Cline cumplen un rol diferente. Claude Code en VS Code es un agente: le das una tarea y ejecuta múltiples pasos, no una única finalización en línea.
Instalar Claude Code en VS Code
Abre el panel de Extensiones en VS Code (Ctrl+Shift+X en Windows/Linux, Cmd+Shift+X en macOS). Busca Claude Code y busca la extensión publicada por Anthropic. Haz clic en Instalar.
Alternativamente, ejecuta esto desde tu terminal:
code --install-extension Anthropic.claude-code
Después de la instalación, el icono de Claude aparece en la Activity Bar de VS Code, a la izquierda. Haz clic en él para abrir el panel de Claude Code.
Autenticación en el primer inicio. La extensión te pide que inicies sesión. Tienes dos opciones:
- Cuenta de Anthropic (suscripción o facturación por consola): completa el flujo OAuth del navegador.
- Enrutamiento de API key a Novita AI: omite por completo la autenticación de Anthropic. Establece
ANTHROPIC_BASE_URLyANTHROPIC_AUTH_TOKENen tu entorno antes de lanzar VS Code, y la extensión los usará en su lugar. Instrucciones completas en la siguiente sección.
Actualizaciones automáticas. VS Code actualiza la extensión en segundo plano cuando reinicias el editor. No necesitas gestionar versiones manualmente.
Uso diario de Claude Code en VS Code
Una vez que el panel está abierto, el flujo de trabajo es sencillo. Escribe una solicitud; Claude Code lee tu espacio de trabajo y responde con acciones propuestas. Antes de editar un archivo, te muestra un diff y espera tu aprobación de forma predeterminada.
Algunos patrones que hacen eficiente el uso diario:
Haz referencia al archivo que estás viendo. Escribe # seguido de un nombre de archivo para adjuntarlo explícitamente como contexto. Para un archivo ya abierto en el editor activo, Claude Code normalmente lo detecta automáticamente, pero # es útil cuando quieres fijar un archivo específico en una tarea de varios archivos.
Ejecuta /init una vez en un proyecto nuevo. Esto crea un CLAUDE.md en la raíz del repositorio donde puedes almacenar instrucciones específicas del proyecto: librerías preferidas, notas de arquitectura, convenciones de pruebas. Claude Code lo lee en cada inicio de sesión, así no necesitas repetirte.
Usa /compact cuando la sesión se vuelva larga. Igual que en la CLI, la extensión comprime el historial de conversación bajo demanda para liberar contexto para la tarea actual.
Revisa la lista de herramientas en ejecución. En la parte inferior del panel, VS Code muestra qué herramienta está llamando Claude Code en ese momento (lecturas de archivos, comandos bash, búsquedas web). Esto es útil para entender qué está sucediendo en tareas automatizadas más largas.
Deshacer es tu amigo. Todas las ediciones de archivos pasan por el sistema de archivos estándar de VS Code, así que Ctrl+Z las revierte como cualquier edición manual. No hay una pila de deshacer separada para los cambios de Claude Code.
Enrutar la extensión a Novita AI
La extensión de VS Code lee ANTHROPIC_BASE_URL del entorno al inicio: la misma variable que usa la CLI. Configurarla con el endpoint compatible con Anthropic de Novita AI redirige cada llamada a la API lejos de los servidores de Anthropic. Obtienes acceso a los modelos actuales de codificación y uso de herramientas alojados por Novita, como Kimi K2.7 Code, GLM 5.2, DeepSeek V4 Pro y MiniMax M3, facturados a través de tu cuenta de Novita AI a las tarifas de token de Novita.
Obtén una API key de Novita AI
Crea una cuenta de Novita AI para recibir créditos de prueba gratuitos. Ve a Key Management, crea una nueva key y cópiala. Esta key reemplaza tu API key de Anthropic cuando enrutas a través de Novita.
Establece las variables de entorno antes de lanzar VS Code
macOS y Linux — añade estas líneas a tu perfil de shell (.zshrc, .bashrc o equivalente) y recárgalo:
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<Tu API key de Novita>"
export ANTHROPIC_MODEL="moonshotai/kimi-k2.7-code"
export ANTHROPIC_SMALL_FAST_MODEL="minimax/minimax-m3"
source ~/.zshrc # o ~/.bashrc
Windows (persistente: sobrevive a reinicios) — usa PowerShell para establecer variables de entorno a nivel de usuario:
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.novita.ai/anthropic","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","<Tu API key de Novita>","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL","moonshotai/kimi-k2.7-code","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL","minimax/minimax-m3","User")
Reinicia VS Code después de configurar estas variables para que la extensión lea el entorno actualizado.
Windows (solo sesión):
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Tu API key de Novita>
set ANTHROPIC_MODEL=moonshotai/kimi-k2.7-code
set ANTHROPIC_SMALL_FAST_MODEL=minimax/minimax-m3
Después de establecer estas variables, lanza VS Code desde el mismo shell. La extensión toma las variables al inicio. No necesitas iniciar sesión en Anthropic: Novita gestiona la autenticación mediante la API key.
Elegir un modelo
ANTHROPIC_MODEL le indica a Claude Code qué modelo usar para las tareas principales; ANTHROPIC_SMALL_FAST_MODEL controla operaciones en segundo plano como los resúmenes de archivos. Cualquier modelo disponible en Novita AI’s LLM API puede configurarse aquí. Modelos usados con frecuencia con Claude Code en Novita:
- Kimi K2.7 Code — la recomendación actual de Novita para trabajo agéntico en IDE con enfoque en codificación, con sólido razonamiento a nivel de repositorio, edición de código y ejecución larga de múltiples pasos.
- GLM 5.2 — una buena opción cuando quieres un razonamiento general más fuerte y una gran ventana de contexto para análisis de código, documentación y flujos mixtos de codificación y redacción.
- DeepSeek V4 Pro — una opción equilibrada para tareas de implementación complejas donde quieres profundidad sin saltar al nivel más caro.
- MiniMax M3 — un compañero rentable para
ANTHROPIC_SMALL_FAST_MODEL, especialmente para resúmenes rápidos, bucles intensivos en búsqueda y flujos de llamada a herramientas.
Para la mayoría de los usos interactivos en VS Code, configurar ANTHROPIC_MODEL con Kimi K2.7 Code y ANTHROPIC_SMALL_FAST_MODEL con MiniMax M3 ofrece un equilibrio práctico entre calidad de codificación, fiabilidad del uso de herramientas y control de costos.
Para volver al enrutamiento predeterminado de Anthropic, elimina las variables de entorno:
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL ANTHROPIC_SMALL_FAST_MODEL
O abre VS Code desde un shell donde esas variables nunca se hayan definido.
Integración con PyCharm y JetBrains
Claude Code incluye un plugin oficial para la plataforma JetBrains, que cubre PyCharm, IntelliJ IDEA, WebStorm, GoLand, Rider y el resto de la familia JetBrains.
Instalar el plugin
Abre Settings → Plugins en tu IDE de JetBrains, cambia a la pestaña Marketplace y busca Claude Code. Haz clic en Instalar y reinicia el IDE cuando se te indique.
Alternativamente, descarga el archivo del plugin desde el sitio de JetBrains Marketplace e instálalo mediante Settings → Plugins → Install Plugin from Disk.
Primer inicio
Después de la instalación, el panel de Claude Code aparece en la barra lateral del IDE o en el área de ventanas de herramientas, según tu distribución. El primer inicio solicita autenticación, igual que en VS Code.
Enrutar PyCharm a Novita AI
El plugin de JetBrains lee las mismas variables de entorno que la extensión de VS Code y la CLI. Establece ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_MODEL y ANTHROPIC_SMALL_FAST_MODEL en tu perfil de shell antes de lanzar el IDE, y el plugin enrutará a través de Novita.
Si lanzas PyCharm desde un lanzador de escritorio en lugar de desde una terminal (algo común en macOS y Linux), el IDE puede no heredar el entorno de tu shell. La solución fiable es un archivo .env por proyecto o establecer las variables en el entorno a nivel de sistema en lugar de en tu perfil de shell. En macOS específicamente, las variables definidas con launchctl setenv son visibles para las aplicaciones GUI.
Extensión de IDE vs. CLI: cuándo usar cada una
La extensión y la CLI comparten el mismo motor. La diferencia práctica está en el contexto y la integración.
| Extensión de VS Code / JetBrains | CLI | |
|---|---|---|
| Navegación de archivos | Clic para abrir, # para referenciar |
Lee desde el directorio actual; especifica rutas explícitamente |
| Revisión de diff | En línea en el editor | Salida de terminal |
| Múltiples proyectos | Un panel por ventana | Sesiones separadas por directorio |
| CI/CD y automatización | No apropiado | Flag -p para ejecuciones por lotes no interactivas |
| Pipes y scripting | No soportado | Soporte completo de pipes Unix |
| Enrutamiento a Novita AI | Variable de entorno ANTHROPIC_BASE_URL |
Igual |
La extensión es la mejor opción cuando tu flujo de trabajo principal es editar código de forma interactiva. La CLI es la opción correcta cuando automatizas tareas, ejecutas Claude Code en scripts, lo integras con CI o construyes sobre el Claude Code SDK. Si tu lista de candidatos se centra específicamente en agentes de codificación orientados a terminal, consulta OpenAI Codex vs Claude Code para una comparación CLI contra CLI más profunda.
Agent Sandbox de Novita AI
Cuando pasas del desarrollo interactivo a pipelines automatizados, la extensión de VS Code ya no es la superficie adecuada. Ejecutar Claude Code sin cabeza — revisiones de PR por lotes, generación automatizada de pruebas, refactorizaciones multi-repositorio, agentes de codificación integrados en CI — necesita un entorno de ejecución aislado en lugar de una sesión local de IDE.
El Agent Sandbox de Novita AI proporciona microVM basadas en Firecracker para ejecutar agentes programáticamente. Cada sandbox se inicia limpio, se ejecuta en completo aislamiento de tu máquina de desarrollo y se factura por segundo de uso. Casos de uso prácticos:
- Revisión de PR por lotes. Crea un sandbox por PR, ejecuta Claude Code con un prompt de revisión, recoge la salida y luego elimina el sandbox. No se acumula estado local entre ejecuciones.
- Generación automatizada de pruebas. Dispara un sandbox desde CI en ramas nuevas, haz que Claude Code lea el diff y genere pruebas, y luego envía los resultados de vuelta mediante la API del repositorio.
- Bancos de evaluación. Ejecuta la misma tarea de codificación en múltiples configuraciones de modelo en sandboxes paralelos. Cada sandbox usa el mismo enrutamiento
ANTHROPIC_BASE_URLque configuras localmente: cambiaANTHROPIC_MODELpor sandbox para comparar Kimi K2.7 Code, GLM 5.2, DeepSeek V4 Pro y MiniMax M3 entre sí en tareas reales. - Flujos multi-agente. Los sandboxes son componibles. Cada subagente obtiene su propio entorno aislado; los resultados se agregan aguas arriba sin que ningún agente toque el sistema de archivos de otro agente.
La interfaz entre el uso de VS Code y el de Sandbox es la misma capa de variables de entorno. Un flujo de trabajo que enruta a través del endpoint compatible con Anthropic de Novita AI en la extensión funciona sin cabeza en un sandbox sin ningún cambio de código.
FAQ
¿Necesito una suscripción paga de Anthropic para usar la extensión de VS Code?
No. Si enrutas la extensión a Novita AI mediante ANTHROPIC_BASE_URL, toda la facturación pasa por tu cuenta de Novita AI. No se requiere una cuenta de Anthropic y no se factura.
¿Cómo instalo la extensión Claude Code para VS Code?
Abre el panel de Extensiones en VS Code (Ctrl+Shift+X), busca Claude Code (publicador: Anthropic) y haz clic en Instalar. O ejecuta code --install-extension Anthropic.claude-code desde una terminal.
¿La extensión Claude Code funciona en Cursor?
Cursor es un fork de VS Code y soporta la mayoría de las extensiones de VS Code. La extensión Claude Code puede instalarse, pero Cursor ya incluye su propia integración de Claude integrada. Ejecutar ambas simultáneamente puede producir sugerencias duplicadas y flujos de autenticación en competencia. La mayoría de los desarrolladores usa una u otra, no ambas.
¿Hay una extensión de navegador de Claude?
No hay una extensión de navegador oficial de Claude de Anthropic. Claude Code se ejecuta como extensión de VS Code, plugin de JetBrains, CLI, aplicación de escritorio y a través de la interfaz web en claude.ai/code — pero no como una extensión de navegador que se enganche a páginas web arbitrarias.
¿Cómo cambio de modelo sin reiniciar VS Code?
Cambia ANTHROPIC_MODEL en tu perfil de shell y luego vuelve a abrir VS Code desde una nueva sesión de terminal. Dentro de una sesión de VS Code en ejecución, no hay un selector de modelos en el panel: la variable de entorno se lee al inicio.
¿Puedo usar diferentes modelos para diferentes proyectos?
Sí. Establece ANTHROPIC_MODEL en un archivo .env a nivel de proyecto o en una instrucción de CLAUDE.md, o usa direnv para delimitar las variables de entorno a directorios específicos. Claude Code respeta los valores de entorno a nivel de sesión, por lo que el enrutamiento por proyecto es posible con herramientas estándar de dotfiles.
¿En qué se diferencia la integración de Claude con VS Code de usar Cline?
Cline es una extensión que convierte VS Code en un entorno de codificación agéntico usando cualquier backend compatible con OpenAI. Claude Code es el propio agente de Anthropic, disponible como extensión de VS Code, con su propio conjunto de herramientas y bucle de razonamiento. La principal diferencia práctica: Cline te da más control sobre qué proveedor y modelo ejecuta el bucle, mientras que Claude Code está estrechamente integrado con la familia de modelos Claude por defecto — aunque ANTHROPIC_BASE_URL te permite redirigirlo al endpoint compatible de Novita AI.
Artículos recomendados
