Inicio › Claude Code › VS Code
Descripción generalInstalaciónreferencia de la CLIPrecios y límitesAgent SDKHabilidades y pluginsGitHubWeb, escritorio e IDEModelosErrores¿Código abierto?TutorialPara estudiantesAutomatización de QAComparación con CursorComparación con Codex y OpenCodeSubagentesHooksMCPEcosistemaVS CodeOpenRouterLímites de solicitudesGuía en chino
Última actualización: 11 de octubre de 2026

Claude Code en VS Code: la extensión, el uso desde la terminal y los errores

Hay dos formas de usar Claude Code dentro de VS Code, y la mayoría de los problemas que la gente busca se deben a confundirlas: la extensión oficial, que añade un panel y vistas de diferencias en línea, y la CLI directamente en el terminal integrado de VS Code, que es el mismo agente sin ninguna extensión. Esta página explica ambas opciones, además de cómo comprobar la cuenta y los mensajes de error.

TLDR

  • Extensión: instala anthropic.claude-code desde el Marketplace (o abre vscode:extension/anthropic.claude-code); instala la CLI automáticamente al iniciarse por primera vez.
  • Terminal: abre el terminal de VS Code y ejecuta claude — funciona en cualquier versión de VS Code, incluido Cursor, sin extensión.
  • Qué cuenta: /status dentro de una sesión muestra el endpoint, la clave y el inicio de sesión en uso; la extensión y el terminal leen el mismo entorno.
  • command 'claude-vscode.editor.openlast' not found = la extensión está instalada pero no activada, o falta la CLI que utiliza: recarga la ventana y luego comprueba claude --version.

Instala la extensión de Claude Code para VS Code

Busca Claude Code de Anthropic en la vista Extensiones, o pega vscode:extension/anthropic.claude-code en tu navegador para abrirla directamente. La extensión es una interfaz para la CLI: al iniciarse por primera vez, comprueba si está presente el binario claude y lo instala si falta (la instalación mediante npm requiere Node.js 18 o superior; el instalador nativo no necesita nada). Después, el icono de Claude en la barra de actividad abre un panel donde puedes conversar, y cada cambio que hace el agente se muestra como una diferencia en línea que aceptas o rechazas: el mismo ciclo que en el terminal, con el editor como interfaz de revisión.

# check the CLI the extension will use
claude --version
# if it is missing, install it yourself and reload VS Code
npm install -g @anthropic-ai/claude-code     # or: curl -fsSL https://claude.ai/install.sh | bash

O prescinde de la extensión: Claude Code en el terminal integrado

Abre el terminal de VS Code y ejecuta claude. Es el agente completo —modo de planificación, subagentes, hooks, MCP, /compact — y funciona en cualquier variante de VS Code, incluidos Cursor y VSCodium, sin la extensión. Los cambios se reflejan de inmediato en los archivos abiertos y la vista de diferencias de VS Code los muestra. Para tareas autónomas largas, la mayoría prefiere esta opción; para pequeñas ediciones interactivas, el panel de la extensión resulta más cómodo. Ambos pueden ejecutarse al mismo tiempo.

Comprueba qué cuenta está usando Claude Code en VS Code

Tanto la extensión como el terminal leen la misma configuración, así que la respuesta es la misma en ambos: ejecuta /status dentro de una sesión. Muestra el endpoint (ANTHROPIC_BASE_URL), si está activa una clave de API o una suscripción de /login , el modelo y la versión. Si hay una clave de API definida en el entorno, tiene prioridad sobre el inicio de sesión, que es la causa habitual de «Inicié sesión con Max, pero se me cobra del saldo de API». Para cambiar, elimina ANTHROPIC_API_KEY del entorno para usar la suscripción, o defínela (junto con ANTHROPIC_BASE_URL si usas una pasarela) para el uso con facturación por consumo.

# use this gateway from VS Code: put these in your shell profile, restart VS Code
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key

VS Code hereda las variables de entorno del shell desde el que se inició. Si /status sigue mostrando el endpoint anterior después de cambiar tu perfil, cierra VS Code por completo e inícialo desde un terminal nuevo: no basta con recargar la ventana.

Error: comando 'claude-vscode.editor.openlast' no encontrado

Aparece cuando un atajo de teclado o la paleta de comandos invoca la extensión antes de que se active, o cuando la extensión se ha activado pero no encuentra la CLI que utiliza.

En este orden: 1) Recargar ventana (Developer: Reload Window) — esto resuelve la mayoría de los casos. 2) Ejecuta claude --version en el terminal; si no se encuentra, instala la CLI (arriba) y vuelve a recargar. 3) Comprueba que la extensión esté habilitada para este espacio de trabajo, no solo instalada. 4) Si usas una variante de VS Code, confirma que la versión de la extensión sea compatible con ella; en caso contrario, la opción del terminal funciona de todos modos. 5) Como último recurso, desinstala la extensión, elimina las cachés de ~/.claude/ solo si aceptas perder el historial local de sesiones, y vuelve a instalarla.

Otros problemas de la extensión

  • El panel se abre, pero sigue vacío → la CLI se está iniciando; consulta el panel Salida (Claude Code) para ver el error real, que suele deberse a una versión antigua de Node.js.
  • Nunca aparecen las diferencias en línea → el espacio de trabajo no es de confianza; VS Code bloquea las extensiones en el modo restringido.
  • Funciona en el terminal, pero no en el panel → un proxy o ANTHROPIC_BASE_URL definido solo en tu perfil de shell, no en el entorno desde el que se inició VS Code.
  • 401 / clave no válida → la clave no corresponde al endpoint; una URL de pasarela necesita una clave de pasarela, y la URL de Anthropic necesita una clave de la consola.

Coste dentro de VS Code

La extensión factura exactamente igual que la CLI: por token, a través del servicio que utilice. En esta pasarela, se usan créditos con un valor de 7.69231 veces su valor nominal ($13 permiten comprar $100 de uso, con un 87% de descuento) o un plan ilimitado de tarifa plana desde $1; la guía de precios ofrece los detalles, y la guía de modelos enumera lo que /model puede seleccionar.

PlanDuraciónPrecio
Uso ilimitado durante 1 hora1 hora$1
Uso ilimitado durante 24 horas24 horas$10
Uso ilimitado durante 1 semana1 semana$49
Uso ilimitado durante 15 días15 días$89

Todos los planes ilimitados →

Pruébalo gratis primero

Las cuentas nuevas reciben $5 de crédito gratuito para la API con el código CLAUDECODE — suficiente para una tarde de Claude Code con Sonnet — y después créditos por 7.69231× su valor nominal.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Crea una cuenta con el código CLAUDECODE

Preguntas frecuentes

¿Existe una extensión de Claude Code para VS Code?

Sí: la extensión oficial `anthropic.claude-code` de Anthropic en el Marketplace. Ofrece una interfaz para la CLI con un panel y vistas de diferencias en línea; la CLI también se ejecuta por separado en el terminal de VS Code.

¿Cómo compruebo qué cuenta usa Claude Code en VS Code?

Ejecuta /status dentro de una sesión. Muestra el endpoint, si está activa una clave de API o una sesión iniciada con una suscripción, y el modelo. Una clave de API en el entorno tiene prioridad sobre /login.

¿Cómo soluciono «'claude-vscode.editor.openlast' no encontrado»?

Recarga la ventana de VS Code; si el problema persiste, comprueba que `claude --version` funcione en el terminal (instala la CLI si no es así) y que la extensión esté habilitada para el espacio de trabajo.

¿Claude Code funciona en Cursor o VSCodium?

En el terminal integrado, siempre. La extensión funciona cuando está disponible en el marketplace de la variante.

Ejecuta Claude Code con la pasarela

Los mismos modelos, dos variables de entorno y créditos por 7.69231× su valor nominal, o un plan ilimitado de tarifa plana. Cuentas nuevas: $5 de crédito gratuito para la API con el código CLAUDECODE.

Obtener una clave de API Ver planes ilimitados

AI Prime Tech es una pasarela API independiente y no está afiliada a Anthropic, ni cuenta con su respaldo o patrocinio. «Claude» y «Claude Code» son marcas comerciales de Anthropic. Las funciones de Claude Code descritas aquí se basan en la documentación pública de Anthropic en el momento de la redacción y cambian con frecuencia; los precios y las listas de modelos de esta página se obtienen de la configuración actual de esta pasarela.

Más guías de Claude Code

Claude Code: la guía completaCómo instalar Claude CodeDocumentación de la CLI de Claude Code: comandos y opcionesPrecios y límites de Claude Code, explicadosEl SDK de Claude Code, ahora Claude Agent SDKHabilidades y plugins de Claude CodeClaude Code en GitHub: la App, la Action y @claude¿Claude Code tiene una interfaz web? Explicación de las versiones web, de escritorio y para IDEQué modelo utiliza Claude Code y cómo cambiarloErrores de Claude Code y cómo solucionarlos¿Claude Code es de código abierto?Tutorial de Claude Code: tu primera sesión realClaude para estudiantes: Claude Code, la API y qué ofrece realmente el ámbito educativoCómo usar Claude Code para automatizar QAClaude Code frente a Cursor: cuál usar, cuándo y cómo ejecutar ambosClaude Code vs Codex vs OpenCode: comparativa de los agentes de terminalSubagentes de Claude Code: cómo funcionan, cómo definirlos y equipos de agentesHooks de Claude Code: control determinista sobre lo que hace el agenteMCP en Claude Code: conexión de servidores, ámbitos, MCP remoto y ejemplos realesEl ecosistema de Claude Code: enrutadores, frameworks, plugins y las listas que los recopilanCómo usar OpenRouter en Claude Code (y cuándo no hacerlo)Error de límite de solicitudes de Claude: qué significa «Error de API: se ha alcanzado el límite de solicitudes» y cómo solucionarloCómo usar Claude Code: desde la instalación hasta el uso diario