Extensión de Claude Code para VS Code con una API de terceros: configuración de environmentVariables

Wokey Team · 2026-09-24

Respuesta corta: para que la extensión de Claude Code para VS Code use una API de terceros, pon ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN en claudeCode.environmentVariables en la configuración de usuario de VS Code, y activa claudeCode.disableLoginPrompt. Exportar variables en una terminal casi nunca llega a la extensión. ~/.claude/settings.json tampoco basta: la comprobación de inicio de sesión previa al arranque de la extensión no puede leerlo, así que sigues viendo la pantalla de inicio de sesión.

Configuración

1. Instala la extensión. Necesita VS Code 1.94.0 o posterior. Busca "Claude Code" (editor: Anthropic) en la vista Extensions (Cmd/Ctrl+Shift+X). Cursor puede instalar la misma extensión, y editores como VSCodium pueden obtenerla desde Open VSX.
2. Abre tu configuración de usuario. Presiona Cmd/Ctrl+Shift+P y ejecuta Preferences: Open User Settings (JSON).
3. Agrega la configuración. Dentro de las {} más externas, agrega:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" }
  ],
  "claudeCode.disableLoginPrompt": true
}

4. Recarga. Ejecuta Developer: Reload Window desde la paleta de comandos y luego abre el panel de Claude Code.

Tres cosas a tener en cuenta:

• ANTHROPIC_BASE_URL es solo el dominio, sin /v1; la extensión agrega /v1/messages por su cuenta.
• Esto va en tu configuración de usuario, no en el .vscode/settings.json del workspace, que a menudo se sube al repositorio.
• disableLoginPrompt omite la solicitud de inicio de sesión. La descripción oficial dice que es "for third-party provider setups".

Por qué los export y settings.json no alcanzan

Antes de iniciar el proceso de Claude, la extensión comprueba que haya una credencial disponible. Esa comprobación solo lee claudeCode.environmentVariables:

• VS Code abierto desde el Dock, el menú Inicio o un ícono del escritorio no recibe las variables que exportas en ~/.zshrc.
• El bloque env de ~/.claude/settings.json llega al proceso de Claude que inicia la extensión, pero no a la comprobación de inicio de sesión de la propia extensión.

Así que con solo settings.json y disableLoginPrompt desactivado, el síntoma típico es una extensión que te sigue pidiendo iniciar sesión. Para usar variables de la shell de forma puntual, ejecuta code . desde una terminal donde estén definidas. Para el uso diario, la configuración de usuario de arriba es más confiable.

Confirma que las solicitudes pasan por Wokey

Ejecuta /status en el cuadro de prompt de la extensión (requiere Claude Code v2.1.280 o posterior). El Anthropic base URL de la pestaña Status debe decir https://api.wokey.ai.

Elegir modelos

Elige Switch model… en el menú de comandos, o haz clic en el nombre del modelo debajo del cuadro de prompt. Para fijar qué modelo usa cada nivel Opus, Sonnet y Haiku, agrega las variables a la misma lista:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" }
  ]
}

Qué no está disponible con una API de terceros

Con una API de terceros, la extensión no ofrece las funciones que requieren una cuenta de claude.ai:

• Las barras de uso del plan, el dictado por voz y la pestaña Web para sesiones en la nube.
• No hay opción Sign out en el menú.
• Enviar /bug muestra un error y no envía nada.

Una cuenta de claude.ai con la que hayas iniciado sesión antes mediante /login sigue guardada pero sin usarse.

En comparación con la CLI en una terminal, la extensión además solo admite una parte de los comandos, y no tiene el atajo de Bash ! ni autocompletado con tab.

Solución de problemas

La pantalla de inicio de sesión sigue apareciendo. Falta claudeCode.environmentVariables o está en el lugar equivocado (como la configuración del workspace), o no recargaste la ventana después del cambio. Comprueba también que disableLoginPrompt sea true.

invalid x-api-key. La solicitud fue a la dirección propia de Anthropic porque ANTHROPIC_BASE_URL no se aplicó. Wokey nunca devuelve ese mensaje; consulta la guía de invalid x-api-key.

Un 404 que menciona /v1/v1/messages. La base URL tiene un /v1 de más. Cámbiala a https://api.wokey.ai.

Sin respuesta y sin error. El consejo oficial es ejecutar claude en una terminal para ver errores más detallados. La extensión incluye su propia CLI pero no agrega claude a tu PATH, así que instala la CLI por separado y configura sus variables como en la guía de base URL de Claude Code.

Usuarios de JetBrains

El plugin de JetBrains no incluye una CLI. Ejecuta el comando claude que tienes instalado en la terminal del IDE; puedes cambiar la ruta en Settings → Tools → Claude Code [Beta] → Claude command. Por eso JetBrains se configura igual que la CLI: pon ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN en el bloque env de ~/.claude/settings.json. Consulta la guía de base URL de Claude Code.