Claude Code en VS Code y Cursor
Instale la extensión de Claude Code en VS Code o Cursor y conecte su configuración compartida a RunAPI.
Descripción general
La extensión oficial de Claude Code funciona tanto en VS Code como en Cursor. Ambos editores utilizan la misma configuración de usuario de Claude Code, por lo que esta guía instala la extensión correspondiente y configura RunAPI una sola vez en ~/.claude/settings.json.
Antes de comenzar
- Instale una versión compatible de VS Code o Cursor. La versión mínima actual de VS Code se indica en la guía oficial de extensiones.
- Cree una Clave de API estándar en la Guía de Autenticación. No la incluya en la configuración del espacio de trabajo ni en el control de código fuente.
- Copie un identificador de modelo que sea compatible con Anthropic Messages desde el Catálogo de modelos.
Instalar
Instale la extensión oficial anthropic.claude-code:
- VS Code: abre la página de VS Code Marketplace o busca
Claude Codeen Extensions. - Cursor: abre
cursor:extension/anthropic.claude-codeo buscaClaude Codeen Extensions.
La extensión incluye el entorno de ejecución necesario para su panel de chat. Instala la CLI independiente solo si también quieres ejecutar claude en la terminal integrada.
Configurar RunAPI
Abra ~/.claude/settings.json y agregue la configuración de entorno compartida a nivel de usuario:
{
"env": {
"ANTHROPIC_BASE_URL": "https://runapi.ai",
"ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
"ANTHROPIC_MODEL": "YOUR_RUNAPI_MODEL_ID"
}
}
En la configuración de VS Code o Cursor, busque Claude Code login y habilite
Disable Login Prompt para este punto de conexión personalizado. La configuración de usuario se
comparte con la CLI; la configuración de la extensión de VS Code solo controla el comportamiento de la extensión.
Mantenga la clave real fuera de .claude/settings.json y de la configuración del
espacio de trabajo del editor, ya que esos archivos podrían confirmarse.
Elegir un modelo
Reemplace YOUR_RUNAPI_MODEL_ID con un identificador exacto del Catálogo
de modelos. En el panel de Claude Code, /model cambia la
selección actual y /status muestra el modelo activo.
Verificar
- Recarga la ventana del editor después de cambiar la extensión o la configuración.
- Abre el panel Claude Code Spark.
- Ejecuta
/statusy confirma la configuración de usuario y el modelo. - Envía
Describe this repository in one sentence.y confirma que la respuesta es normal.
Solución de problemas
- La extensión no se instalará: confirma que la versión del editor cumple con los requisitos oficiales.
- El icono de Spark no aparece: recarga la ventana del editor y luego reinicia el editor.
- Todavía aparece una solicitud de inicio de sesión: habilita Disable Login Prompt en la configuración de la extensión Claude Code.
- El panel no hereda las variables del shell: usa
~/.claude/settings.jsono inicia el editor desde el terminal configurado. Las aplicaciones GUI suelen iniciarse sin el entorno de terminal. - La CLI funciona pero el panel no: recarga la ventana y usa la CLI independiente para reproducir la solicitud con diagnósticos más detallados.
- La autenticación o la selección de modelos falla: verifica la clave en la Guía de autenticación y copia el identificador exacto del Catálogo de modelos.
Próximos pasos
Usa el Inicio rápido de la API LLM para el comportamiento del protocolo y la Referencia de la API de Mensajes de Anthropic para los campos de solicitud. Para agregar herramientas de RunAPI dentro del editor, continúa con la Descripción general de MCP.