Claude Code en VS Code: conectar y verificar la integración

Las tres capas de la integración

Un «Claude Code no responde» puede proceder de tres capas diferentes.

CLI. La extensión oficial incluye la CLI de Claude Code en el terminal integrado. Solo hace falta instalarla por separado para usarla fuera del paquete de la extensión.

Extensión de VS Code. La extensión oficial de Anthropic ofrece chat, diffs lado a lado, referencias a archivos con @ e historial de sesiones. En la fecha de comprobación, la documentación oficial requería VS Code 1.98.0 o posterior.

Endpoint API. Claude Code usa por defecto la API de Anthropic. Para BetterToken define ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN; la extensión los pasa automáticamente a Claude Code.

Una entrada correcta en Dashboard solo confirma que BetterToken recibió la solicitud. Comprueba el contexto del archivo y el diff por separado para validar la integración con el IDE.

Usa tu propia cuenta BetterToken, crea una clave API en el panel y toma la Base URL de la documentación.

Crea tu propia clave API y configura Claude Code con la documentación de BetterToken: docs.bettertoken.ai/ai-tools/claude-code

Crear la clave API y conectar el endpoint

Paso 1. Crear la cuenta y la clave

Abre bettertoken.ai, regístrate, entra en la gestión de claves y crea una nueva clave API. Cópiala para el paso siguiente.

Paso 2. Usar la Base URL

Para Claude Code usa esta Base URL compatible con Anthropic:

https://www.bettertoken.ai

No añadas /v1: Claude Code añade la ruta del método automáticamente. La dirección con /v1 corresponde a herramientas compatibles con OpenAI, como Codex CLI.

Paso 3. Editar ~/.claude/settings.json

En macOS y Linux está en ~/.claude/settings.json; en Windows, en %USERPROFILE%\.claude\settings.json. Añade el bloque env:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "your_api_key_here"
  }
}

Sustituye your_api_key_here por la clave del paso 1. Si ya hay otros campos, añade únicamente "env". La CLI y la extensión comparten este archivo.

Paso 4. Desactivar el aviso de inicio de sesión

En ajustes de VS Code (Cmd+, en Mac o Ctrl+, en Windows/Linux), abre Extensions → Claude Code y activa Disable Login Prompt. Oculta la pantalla de Anthropic para un proveedor externo, pero no reemplaza la configuración env.

Iniciar Claude Code en VS Code

Paso 5. Instalar la extensión

Pulsa Cmd+Shift+X en Mac o Ctrl+Shift+X en Windows/Linux, busca «Claude Code» de Anthropic y pulsa Install. Si no aparece el icono, ejecuta Developer: Reload Window en la paleta de comandos. Comprueba en Help → About que VS Code sea 1.98.0 o posterior.

Paso 6. Abrir el panel

Abre un archivo. El icono Spark (✱) aparece en Editor Toolbar solo con un archivo abierto y abre el chat. También puedes usar:

• Activity Bar, icono Spark de la barra izquierda;
• Command Palette (Cmd+Shift+P / Ctrl+Shift+P) → «Claude Code: Open in New Tab»;
• Status Bar → ✱ Claude Code, incluso sin archivo abierto.

Paso 7. Comprobar el contexto

Selecciona varias líneas: Claude Code muestra el número de líneas seleccionadas bajo el campo de entrada. Option+K en Mac o Alt+K en Windows/Linux inserta una referencia como @file.ts#5-10.

Verificar contexto, diff y Dashboard

Paso 8. Enviar una prueba de bajo riesgo

Abre un script o configuración pequeño y pide un cambio sencillo y reversible:

Añade antes de la primera función un comentario de una línea que explique brevemente qué hace.

O bien:

Renombra la variable `tmp` a `result` en este archivo.

Paso 9. Revisar el diff lado a lado

La extensión muestra la comparación antes/después y pide permiso. Revísala y elige Accept o Reject. Un diff coherente confirma la respuesta del modelo y su asociación con el archivo actual; el recorrido por BetterToken se verifica en Dashboard.

Paso 10. Buscar la solicitud en Dashboard

Abre bettertoken.ai y ve a Dashboard o al historial. Busca la solicitud de la hora de prueba y compara modelo, estado, tokens de entrada, salida y caché, y el cargo.

Un diff correcto y una entrada exitosa a la misma hora confirman que la extensión pasó el contexto, BetterToken procesó la solicitud y la respuesta volvió al IDE. Sin resultado: ninguna respuesta ni entrada indica revisar extensión, env, Base URL y red; una entrada de error requiere revisar clave, modelo y mensaje; un diff sin entrada exige revisar endpoint, hora y filtros, pues la ruta BetterToken no está confirmada.

Si no se detecta la integración

No aparece Spark

El icono de Editor Toolbar requiere un archivo abierto. Si lo hay:

1. Verifica VS Code 1.98.0 o posterior en Help → About.
2. Ejecuta Developer: Reload Window.
3. Desactiva temporalmente Cline, Continue o GitHub Copilot: pueden competir por iconos de la barra.

✱ Claude Code en Status Bar funciona sin archivo abierto.

VS Code no hereda variables del terminal

Si ANTHROPIC_BASE_URL está en el shell pero la extensión pide iniciar sesión, VS Code abierto desde Spotlight o el menú de aplicaciones no heredó el entorno. Ábrelo desde el terminal:

code .

Así recibe el entorno actual. Como alternativa, añade las variables en Extensions → Claude Code → environmentVariables.

Vuelve a pedir inicio de sesión

Confirma Disable Login Prompt. Oculta la pantalla de Anthropic, pero las variables de conexión siguen siendo necesarias.

No lee la configuración cambiada

Comprueba la ruta y el JSON de settings.json: una coma adicional o una llave sin cerrar impide cargar env. Recarga la ventana y revisa que el shell o la extensión no tengan una Base URL o clave antiguas. Usa los nombres de campo de la documentación actual de BetterToken, no de un fragmento antiguo.

Error de autenticación: 401 o sin respuesta

1. Base URL: https://www.bettertoken.ai sin /v1; ese sufijo puede producir 404 en algunos métodos.
2. Clave API: sin espacios, saltos de línea ni comillas extra.
3. Conflicto de variables: un ANTHROPIC_AUTH_TOKEN o ANTHROPIC_BASE_URL distinto puede sobrescribir la configuración. Elimínalo o inicia con code ..

Sin registro en Dashboard, revisa envío, endpoint y red; un 401 apunta a la clave o a su formato.

Documentación completa de Claude Code para BetterToken: docs.bettertoken.ai/ai-tools/claude-code