Configuración de la Extensión Claude Code para VS Code: Backend, Modelos y Sandbox

Claude Code llega a VS Code como un agente de codificación completo en la barra lateral — no es una herramienta de autocompletado, sino un solucionador de problemas de varios pasos que lee tu proyecto, edita archivos y ejecuta comandos. La extensión de VS Code comparte su motor con la CLI, por lo que los comandos de barra diagonal, el conocimiento de CLAUDE.md y las llamadas a herramientas MCP funcionan exactamente igual que en la terminal. Lo que hace que la configuración valga la pena entender es la capa de backend: cada llamada de inferencia pasa por un endpoint que tú controlas, y enrutar ese endpoint a Novita AI abre el acceso a los modelos Claude, además de un catálogo más amplio de alternativas de código abierto para codificación, a precios que hacen que las tareas de agente de alto volumen sean prácticas.

Qué Hace Claude Code en VS Code

La extensión Claude Code para VS Code es un panel lateral, no un motor de autocompletado en línea. Ábrelo, describe una tarea y Claude Code ejecuta trabajo de varios pasos: leer archivos, escribir cambios, ejecutar comandos del shell y esperar tu aprobación en los diffs antes de aplicarlos. La distinción importa porque los desarrolladores a menudo buscan “claude code vs code” esperando una experiencia al estilo Copilot — sugerencias de una sola línea que se completan mientras escribes. Eso no es lo que esto es. Para completados, otras herramientas cumplen ese rol. Claude Code en VS Code es para tareas: escribe pruebas para este módulo, refactoriza el manejador de autenticación, explica por qué esta consulta es lenta, crea un pull request con los cambios de hoy.

Capacidades concretas dentro de la extensión:

• Ediciones de múltiples archivos con diffs en línea. Claude Code propone cambios en varios archivos y muestra diffs que puedes aceptar o rechazar sin salir del editor.
• Comandos de barra diagonal. /compact, /clear, /init, /memory y comandos personalizados que hayas definido funcionan de forma idéntica a la CLI.
• Anclaje de contexto. El prefijo # adjunta archivos, símbolos o carpetas específicas a una solicitud. Escribir #src/auth/handler.ts corrige la condición de carrera le da a Claude Code el contexto adecuado de inmediato.
• Conocimiento de CLAUDE.md. Estándares de codificación del proyecto, notas de arquitectura, librerías preferidas — cualquier cosa en CLAUDE.md se carga al inicio de la sesión. Lo escribes una vez; el agente lo respeta en cada sesión.
• Llamadas a herramientas MCP. Los servidores MCP registrados en tu configuración de Claude Code están disponibles dentro del panel de la extensión.

Lo que la extensión no hace: reemplazar tus atajos de teclado existentes, modificar tu resaltado de sintaxis o añadir completados por pulsación de tecla. Es una interfaz de agente superpuesta a tu flujo de trabajo normal de VS Code.

Cómo Añadir Claude Code a VS Code

Abre el panel de Extensiones (Ctrl+Shift+X en Windows/Linux, Cmd+Shift+X en macOS). Busca Claude Code y busca el editor Anthropic. Haz clic en Instalar.

Si prefieres la línea de comandos:

code --install-extension Anthropic.claude-code

Después de la instalación, el icono de Claude aparece en la Barra de Actividades en el lado izquierdo de VS Code. Haz clic en él para abrir el panel del agente.

Autenticación en el primer inicio. La extensión te pide iniciar sesión al abrirla por primera vez. Dos opciones:

• Cuenta de Anthropic: Flujo OAuth en el navegador — funciona si tienes una clave API de Anthropic Console o una suscripción activa de Claude.
• Clave API de Novita AI: Configura ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN en tu entorno de shell antes de iniciar VS Code desde ese terminal. La extensión los lee al inicio y omite la autenticación de Anthropic por completo. Detalles en la siguiente sección.

VS Code actualiza la extensión automáticamente en segundo plano. No necesitas rastrear las versiones manualmente.

Cómo Funciona el Backend de la API LLM

Entender la arquitectura de tres capas aclara cada decisión de configuración:

1. Capa de UI: La extensión de VS Code (o la CLI, o la aplicación de escritorio — son superficies intercambiables).
2. Capa de lógica del agente: El motor de Claude Code — definiciones de herramientas, gestión de sesiones, lectura de archivos, ejecución de comandos.
3. Capa de API LLM: El endpoint de inferencia que maneja cada llamada al modelo de lenguaje.

Por defecto, la capa de API LLM apunta a api.anthropic.com. Claude Code envía las solicitudes usando el formato de la API Mensajes de Anthropic. El detalle crítico: ANTHROPIC_BASE_URL redirige todas esas solicitudes a cualquier endpoint compatible con Anthropic. Novita AI expone el mismo formato de API Mensajes en https://api.novita.ai/anthropic, por lo que el cambio es transparente para la capa de lógica del agente — Claude Code no sabe ni le importa si la respuesta provino de los servidores de Anthropic o de Novita.

Tres variables de entorno más completan la configuración:

• ANTHROPIC_AUTH_TOKEN — tu clave API para el proveedor elegido.
• ANTHROPIC_MODEL — el ID del modelo a usar para tareas principales.
• ANTHROPIC_SMALL_FAST_MODEL — el ID del modelo para tareas rápidas en segundo plano como resúmenes y compresión de contexto.

Configúralas antes de iniciar VS Code, y la extensión las hereda del entorno del shell.

Conectando Claude Code a Novita AI

Paso 1: Obtén una clave API de Novita AI

Regístrate en novita.ai y navega a la página de Gestión de Claves. Genera una nueva clave y cópiala inmediatamente — no se mostrará de nuevo.

Paso 2: Configura las variables de entorno

En macOS o Linux, exporta las variables en tu terminal antes de iniciar VS Code:

export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<tu-clave-api-novita>"
export ANTHROPIC_MODEL="zai-org/glm-4.6"
export ANTHROPIC_SMALL_FAST_MODEL="zai-org/glm-4.6"

En Windows (Símbolo del sistema):

set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<tu-clave-api-novita>
set ANTHROPIC_MODEL=zai-org/glm-4.6
set ANTHROPIC_SMALL_FAST_MODEL=zai-org/glm-4.6

Luego inicia VS Code desde esa misma sesión de terminal:

code .

Paso 3: Verifica la conexión

Abre el panel de Claude Code y envía un breve mensaje de prueba. Si la extensión devuelve una respuesta, el enrutamiento está funcionando. Ahora se te facturará a través de Novita AI — tu cuenta de Anthropic no se cargará.

Para hacer la configuración permanente, añade las exportaciones a tu perfil de shell (~/.zshrc, ~/.bashrc o equivalente) o usa un archivo .env a nivel de proyecto gestionado por direnv para cambiar de modelo por proyecto.

Modelos de Código Abierto que Igualan el Rendimiento de los de Código Cerrado

Una vez que enrutas a través de Novita AI, no estás limitado a los modelos Claude. El catálogo de LLM de Novita incluye modelos de codificación de código abierto que compiten directamente con las alternativas de código cerrado en los benchmarks que importan para tareas de codificación agéntica.

GLM-4.6 de Zhiyu AI es un ejemplo práctico. Tiene una ventana de contexto de 200K tokens y alcanza una tasa de victorias del 48.6% contra Claude Sonnet 4 en evaluaciones de codificación del mundo real. Para flujos de trabajo agénticos donde importa el contexto largo (depuración en bases de código grandes, lectura de suites de pruebas completas), esa ventana de contexto es una ventaja práctica, no solo un número en una ficha técnica. El ID del modelo en Novita es zai-org/glm-4.6.

Otros modelos en la plataforma de Novita que vale la pena evaluar para cargas de trabajo de codificación incluyen DeepSeek R1 y Qwen 3 Coder, ambos han demostrado un rendimiento competitivo en generación de código y benchmarks de seguimiento de instrucciones. La misma variable de entorno ANTHROPIC_MODEL cambia entre ellos — sin reinstalación, sin nueva integración.

El argumento de costo para el código abierto: los equipos que ejecutan Claude Code a escala — grandes cantidades de ejecuciones de agente en pipelines de CI, configuraciones de múltiples desarrolladores con claves API de Novita compartidas, o largas sesiones agénticas que consumen tokens significativos — encuentran que los modelos de código abierto con los precios de Novita crean un margen significativo en el presupuesto de infraestructura. Un modelo que rinde al 90% del nivel de Claude Sonnet 4 al 40% del costo cambia la economía de ejecutar agentes de forma continua.

Novita Agent Sandbox como Entorno de Ejecución

Claude Code en VS Code puede ejecutar comandos del shell localmente — construirá tu proyecto, ejecutará pruebas, instalará paquetes y creará archivos en tu máquina. Para la mayoría de las tareas diarias, eso está bien. Pero algunas tareas agénticas se manejan mejor en cómputo aislado: suites de pruebas pesadas que bloquean tu máquina, pasos de construcción que instalan paquetes del sistema, comandos que modifican la configuración del sistema, o ejecuciones de agente en paralelo donde necesitas reproducibilidad.

Novita Agent Sandbox proporciona entornos de ejecución en la nube diseñados específicamente para este caso de uso. Un sandbox es una microVM que se inicia en milisegundos, ejecuta código de forma aislada de tu sistema anfitrión y termina limpiamente cuando la tarea está completa. Sin estado residual, sin impacto en tu entorno local, sin esperar a que la CPU de tu máquina se recupere.

Para los usuarios de Claude Code, el flujo de trabajo práctico es: enrutar la inferencia al endpoint LLM de Novita AI para las llamadas al modelo de lenguaje, y para tareas de ejecución pesadas — construcciones, ejecuciones de pruebas, evaluación de código — iniciar una instancia de Agent Sandbox a través de la API de Novita Agent Sandbox. Los dos servicios comparten autenticación (la misma clave API de Novita), por lo que no hay gestión de credenciales separada.

Los equipos que construyen pipelines de revisión de código automatizada o agentes Claude Code integrados con CI encuentran esta combinación particularmente útil: el costo del LLM se mantiene predecible con el precio por token de Novita, y el costo de cómputo se mantiene predecible con la facturación por segundo de Agent Sandbox.

Consejos para el Flujo de Trabajo Diario en VS Code

Algunos patrones que hacen que la extensión sea práctica en lugar de una curiosidad:

Inicia nuevos proyectos con /init. Ejecutar /init en un repositorio nuevo genera un archivo CLAUDE.md de inicio. Es la forma más eficiente de contarle a Claude Code sobre las convenciones de tu proyecto antes de que empiece a editar.

Ancla el contexto con #. En lugar de describir qué archivo mirar, escribe #nombre-de-archivo para adjuntarlo directamente. Para trabajos de refactorización, #src/components/Button.tsx actualiza el manejador onClick para usar el nuevo tipo de evento es más rápido que “mira el componente Button y…”.

Usa /compact de forma proactiva. En una sesión larga, Claude Code acumula contexto. /compact resume la conversación y reduce la sobrecarga de tokens. Ejecútalo después de una tarea importante, antes de comenzar la siguiente.

Acepta o rechaza los diffs en línea. Antes de que Claude Code edite un archivo, muestra el diff en el panel. No tienes que aceptar todos los cambios — rechaza diffs parciales y pide un enfoque revisado. Tratar cada respuesta como un punto de partida en lugar de una respuesta final produce mejores resultados.

Separa las instrucciones del proyecto de las instrucciones de la sesión. CLAUDE.md es para el contexto estable del proyecto (comandos de construcción, arquitectura, estilo de código). Las instrucciones temporales para la tarea actual pertenecen al prompt de la sesión. No satures CLAUDE.md con guías de una sola tarea.

Preguntas Frecuentes

¿Dónde está la documentación de la extensión Claude Code para VS Code?

La documentación oficial de la extensión es mantenida por Anthropic en claude.ai/code. Las notas de la versión y el registro de cambios se ven en el panel de Extensiones de VS Code bajo la lista de Claude Code.

¿La extensión Claude Code para VS Code es gratuita?

La extensión en sí es gratuita de instalar. Los costos de uso dependen de tu configuración de backend. Con una cuenta de Anthropic, pagas por token o usas créditos de suscripción. Con el enrutamiento de Novita AI, pagas la tarifa por token de Novita y no se aplican cargos de Anthropic. Las nuevas cuentas de Novita reciben créditos de prueba gratuitos al registrarse.

¿Puedo usar la extensión de VS Code y la CLI de Claude Code al mismo tiempo?

Sí, pero se ejecutan como sesiones separadas. La extensión de VS Code no comparte una sesión en vivo con una instancia de CLI abierta. Si necesitas continuidad de sesión entre ambos, usa claude -c en la CLI para reanudar la sesión más reciente desde ese directorio.

¿Cuál es la diferencia entre Claude Code y Cline en VS Code?

Cline es una extensión de VS Code que enruta el trabajo del agente a través de cualquier backend compatible con OpenAI — te da la máxima flexibilidad de proveedores pero requiere más configuración. Claude Code es el agente propio de Anthropic con un conjunto de herramientas estrechamente integrado. La redirección ANTHROPIC_BASE_URL le da a Claude Code una flexibilidad de backend similar en la práctica. Si ya tienes Novita AI configurado para Claude Code, no necesitas una instalación separada de Cline para acceder al catálogo de modelos de Novita.

¿Puedo usar diferentes modelos para diferentes proyectos?

Sí. Usa direnv con archivos .env a nivel de proyecto para limitar ANTHROPIC_MODEL a un directorio específico. Cuando abres ese proyecto en VS Code desde un terminal con direnv activo, la extensión hereda la configuración de modelo específica del proyecto.

Novita AI es una plataforma cloud de IA que ofrece a los desarrolladores una forma sencilla de desplegar modelos de IA usando nuestra API simple, al mismo tiempo que proporciona GPU en la nube asequible y confiable para construir y escalar.

Artículos Recomendados

• Claude Code en VS Code: Instala la Extensión, Configura el IDE y Cambia a Novita AI
• Documentación de la CLI de Claude Code: Configuración, Comandos de Barra Diagonal e Integración con API LLM
• Cómo Integrar la API LLM de Novita AI con Cline en VScode