Claude Code en VS Code: Instala la Extensión, Configura el IDE y Cambia a Novita AI

Claude Code en VS Code: Instala la Extensión, Configura el IDE y Cambia a Novita AI

Claude Code funciona como una extensión nativa de VS Code instalada directamente desde el marketplace — sin pestañas de navegador, sin copiar y pegar entre ventanas. La extensión 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 de la misma manera, justo 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 para JetBrains. Y debido a que ambas superficies leen ANTHROPIC_BASE_URL del entorno, cambiar el backend de LLM a la API de Novita AI — y 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 de Claude Code para VS Code no es una pestaña de chat añadida a tu editor. Presenta el agente completo de Claude Code dentro de un panel lateral: la misma interfaz tipo 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 necesidad del portapapeles.

Cosas concretas que maneja la extensión:

  • Ediciones multiarchivo con diferencias 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, /clear y el resto funcionan de manera idéntica a la CLI.
  • Fijación de contexto. El prefijo # te permite adjuntar archivos, carpetas o símbolos específicos como contexto para una solicitud.
  • Reconocimiento de CLAUDE.md. Las instrucciones del proyecto y los estándares de codificación que hayas escrito en CLAUDE.md se 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 Barra de Actividades 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 solicita que inicies sesión. Tienes dos opciones:

  • Cuenta de Anthropic (suscripción o facturación de consola): Sigue el flujo OAuth en el navegador.
  • Enrutamiento de clave API a Novita AI: Omite la autenticación de Anthropic por completo. Configura ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN en 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 las versiones manualmente.

Usando Claude Code en VS Code a Diario

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 las acciones propuestas. Antes de editar un archivo, te muestra un diff y espera tu aprobación por defecto.

Algunos patrones que hacen eficiente el uso diario:

Haz referencia al archivo que estás viendo. Escribe # seguido del nombre de un 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 multiarchivo.

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 — bibliotecas preferidas, notas de arquitectura, convenciones de prueba. Claude Code lo lee en cada inicio de sesión, por lo que no te repites.

Usa /compact cuando la sesión se alargue. Al igual que la CLI, la extensión comprime el historial de la 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 actualmente Claude Code (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, por lo que Ctrl+Z las revierte como cualquier edición manual. No hay una pila de deshacer separada para los cambios de Claude Code.

Redirigir 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 API lejos de los servidores de Anthropic. Obtienes acceso a DeepSeek, Kimi K2, Qwen, GLM y otros modelos en la infraestructura de Novita AI, facturados a través de tu cuenta de Novita AI a las tarifas de token de Novita.

Obtén una clave API de Novita AI

Regístrate para obtener una cuenta de Novita AI para recibir créditos de prueba gratuitos. Ve a Key Management, crea una nueva clave y cópiala. Esta clave reemplaza tu clave API de Anthropic cuando enrutas a través de Novita.

Configura las variables de entorno antes de lanzar VS Code

macOS y Linux — añade estas a tu perfil de shell (.zshrc, .bashrc o equivalente) y luego recárgalo:

export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<Tu Clave API de Novita>"
export ANTHROPIC_MODEL="deepseek/deepseek-v4-flash"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek/deepseek-v4-flash"
source ~/.zshrc   # o ~/.bashrc

Windows (persistente — sobrevive a reinicios) — usa PowerShell para configurar 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 Clave API de Novita>","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL","deepseek/deepseek-v4-flash","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL","deepseek/deepseek-v4-flash","User")

Reinicia VS Code después de configurar estas 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 Clave API de Novita>
set ANTHROPIC_MODEL=deepseek/deepseek-v4-flash
set ANTHROPIC_SMALL_FAST_MODEL=deepseek/deepseek-v4-flash

Después de configurar estas, lanza VS Code desde el mismo shell. La extensión detecta las variables al iniciar. No necesitas iniciar sesión en Anthropic — Novita maneja la autenticación a través de la clave API.

Elegir un modelo

ANTHROPIC_MODEL le dice a Claude Code qué modelo usar para las tareas principales; ANTHROPIC_SMALL_FAST_MODEL controla las operaciones en segundo plano como los resúmenes de archivos. Cualquier modelo disponible en la API LLM de Novita AI se puede configurar aquí. Los modelos utilizados con frecuencia con Claude Code en Novita incluyen DeepSeek V4 Flash, Kimi K2 y GLM-4.6, cada uno con diferentes tamaños de ventana de contexto, precios y características de rendimiento según tu carga de trabajo.

Para revertir 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 configuraron.

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 JetBrains, cambia a la pestaña Marketplace y busca Claude Code. Haz clic en Install y luego reinicia el IDE cuando se te solicite.

Alternativamente, descarga el archivo del plugin desde el sitio web de JetBrains Marketplace e instálalo a través de 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 diseño. El primer inicio solicita autenticación, de manera idéntica a VS Code.

Redirigir PyCharm a Novita AI

El plugin de JetBrains lee las mismas variables de entorno que la extensión de VS Code y la CLI. Configura 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 un terminal (común en macOS y Linux), el IDE puede no heredar el entorno de tu shell. La solución confiable es un archivo .env por proyecto o configurar las variables en el entorno a nivel del sistema en lugar de en tu perfil de shell. En macOS específicamente, las variables configuradas mediante launchctl setenv son visibles para las aplicaciones GUI.

Extensión del IDE vs. CLI: Cuándo Usar Cada Una

La extensión y la CLI comparten el mismo motor. La diferencia práctica es el contexto y la integración.

Extensión VS Code / JetBrains CLI
Navegación de archivos Haz clic para abrir, # para referenciar Lee desde el directorio de trabajo actual; especifica rutas explícitamente
Revisión de diferencias En línea en el editor Salida en terminal
Múltiples proyectos Un panel por ventana Sesiones separadas por directorio
CI/CD y automatización No es apropiado Indicador -p para ejecuciones por lotes no interactivas
Tuberías y scripting No soportado Soporte completo para tuberías 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 la edición interactiva de código. La CLI es la opción correcta cuando estás automatizando tareas, ejecutando Claude Code en scripts, integrándolo con CI o creando sobre el Claude Code SDK.

Sandbox de Agentes de Novita AI

Si pasas del desarrollo interactivo a tuberías automatizadas — ejecutando agentes de Claude Code sin supervisión, lanzando múltiples agentes contra diferentes repositorios o creando arneses de evaluación — el Agent Sandbox de Novita AI proporciona entornos de ejecución aislados para ejecutar agentes de forma programática. Cada sandbox es una VM respaldada por firecracker, por lo que los agentes se ejecutan de forma aislada sin afectar tu máquina de desarrollo.

FAQ

¿Necesito una suscripción paga de Anthropic para usar la extensión de VS Code?

No — si rediriges 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 de 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 un terminal.

¿La extensión de Claude Code funciona en Cursor?

Cursor es un fork de VS Code y es compatible con la mayoría de las extensiones de VS Code. La extensión de Claude Code puede instalarse, pero Cursor ya incluye su propia integración integrada de Claude. Ejecutar ambos simultáneamente puede producir sugerencias duplicadas y flujos de autenticación en competencia. La mayoría de los desarrolladores usan uno u otro, no ambos.

¿Existe una extensión de navegador de Claude?

No hay una extensión de navegador oficial de Claude de Anthropic. Claude Code funciona como una extensión de VS Code, un plugin de JetBrains, una CLI, una 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í. Configura ANTHROPIC_MODEL en un archivo .env a nivel de proyecto o en una instrucción 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 de dotfile estándar.

¿En qué se diferencia la integración de Claude con VSCode 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 agente propio de Anthropic, disponible como una 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