Para comprobar la cuenta de Claude Code en VS Code, no empieces por cambiar la suscripción ni por borrar claves. Abre Claude Code en la misma ventana de VS Code, inicia claude desde el terminal integrado si hace falta y ejecuta /status. Ese resultado es la prueba de la sesión real: cuenta, modelo o versión y conectividad.
Señal en /status o en la misma sesión | Qué significa | Primera comprobación | Siguiente acción |
|---|---|---|---|
| Cuenta esperada y conexión normal | VS Code usa la sesión prevista | Revisa cuenta, modelo/versión y conectividad | Continúa; usa /usage, /cost o /stats solo como contexto |
| No has iniciado sesión, cuenta equivocada o sesión caducada | La sesión local no es la cuenta esperada | Ejecuta /logout, luego /login, y repite /status | No interpretes facturación todavía |
| API key, auth token, provider o base URL personalizada | La sesión puede estar usando una ruta de credenciales | Comprueba ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, helper o variables de provider | Conserva o elimina la ruta de forma intencional, recarga VS Code y repite /status |
| La ruta local parece correcta pero fallan muchas peticiones | Puede haber incidente, bloqueo de organización o permiso de cuenta | Consulta Claude Status con fecha y prepara evidencia redactada | Deja de cambiar credenciales hasta aclarar el estado |
No compartas secretos en capturas. Comparte ruta de /status, versión, forma de abrir VS Code, nombres de variables relevantes, error y hora; nunca valores reales de API keys, bearer tokens, provider secrets ni archivos .env completos.
Comprueba la misma superficie de VS Code
La comprobación solo vale si ocurre en la misma ventana de VS Code que va a ejecutar el trabajo. La integración oficial expone icono Spark, Activity Bar, Command Palette, Status Bar y terminal integrado. Una terminal externa puede tener otra ruta de entorno, por eso no basta con recordar qué cuenta usaste en el navegador.
Ejecuta:
bashclaude
Dentro de Claude Code ejecuta:
text/status
Si la extensión pide iniciar sesión, usa /login, completa la autorización del navegador y vuelve a esa ventana. Si el flujo no se abre otra vez, recarga la ventana antes de reinstalar. Si claude --version no funciona dentro del terminal integrado, el dueño es instalación o PATH; usa instalación de Claude Code o Claude Code no funciona en VS Code.
Interpreta la ruta de cuenta y credenciales
Claude Code puede autenticarse con cuenta Claude.ai, Team o Enterprise, Console, API key, auth token, apiKeyHelper, Bedrock, Vertex, Foundry o un gateway compatible. La pregunta útil no es solo si hay sesión, sino qué contrato gobierna esa sesión.
| Señal de ruta | Dueño probable | Verifica | No supongas |
|---|---|---|---|
| Inicio con cuenta Claude.ai | Cuenta personal o plan | Etiqueta de cuenta correcta | Que el API también queda cubierto |
| Team o Enterprise | Organización gestionada | Org, workspace y permisos | Que tu cuenta personal tiene el mismo acceso |
| Console o API key | Proyecto API o dueño de la key | Presencia de key, Console Usage y proyecto | Que Pro o Max paga esa sesión |
ANTHROPIC_AUTH_TOKEN y base URL | Gateway compatible o proxy | Host, token, modelo y frontera de confianza | Que equivale a Anthropic directo |
| Bedrock, Vertex o Foundry | Cuenta cloud y región | Credenciales, región y modelo | Que /login es el interruptor principal |
Si la ruta es login de suscripción y la duda ya es de facturación, usa API key frente a suscripción. Si aparece API key, gateway o provider, usa configuración de Claude Code API. La ruta se prueba antes de discutir el medidor.
Revisa la herencia del entorno sin revelar claves
VS Code puede heredar un entorno distinto al de tu terminal externa. Dock, terminal, WSL, Git Bash, devcontainer o CI pueden cambiar variables. Comprueba presencia sin imprimir valores:
bashtest -n "$ANTHROPIC_API_KEY" && echo "ANTHROPIC_API_KEY is set" test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set" test -n "$ANTHROPIC_BASE_URL" && echo "ANTHROPIC_BASE_URL is set"
Para una auditoría breve:
bashenv | grep -E '^ANTHROPIC_(API_KEY|AUTH_TOKEN|BASE_URL)=' | sed 's/=.*/=set/'
Ejecuta esas pruebas dentro del terminal integrado. Si necesitas que VS Code herede el shell correcto, abre el proyecto desde ahí:
bashcode .
Luego repite claude y /status. Si la ruta cambia, el problema era el contexto de lanzamiento, no una cuenta rota.
Corrige cuenta equivocada, sesión antigua o override de API key
Cambia una cosa por vez. Para cuenta equivocada:
text/logout /login /status
Para una API key accidental en el shell actual:
bashunset ANTHROPIC_API_KEY claude
Si la key vuelve en una terminal nueva, busca en perfiles de shell, .env, devcontainer, scripts de lanzamiento, secrets de CI o gestor de configuración. En rutas provider o gateway, no esperes que /logout lo arregle todo: revisa variables, base URL, región, modelo y dueño de credenciales. En errores de clave inválida u organización deshabilitada, prueba si una key vieja está ganando por precedencia.
Elige el comando de uso correcto
/status responde identidad y ruta. /usage, /stats y /cost solo tienen sentido después. Para gasto de API, Console Usage es la referencia. Para patrones de suscripción, los comandos locales ayudan, pero no sustituyen límites del plan.
| Pregunta | Superficie inicial | Motivo |
|---|---|---|
| ¿Qué cuenta usa VS Code ahora? | /status | Pertenece a la sesión activa |
| ¿Una variable cambia la ruta? | Comprobación enmascarada | Prueba presencia sin secreto |
| ¿Por qué apareció gasto API? | /status, variables y Console Usage | La facturación sigue la ruta |
| ¿Qué envío a soporte? | Estado, versión, error y hora redactados | Reduce ida y vuelta sin filtrar secretos |
Detén cambios locales durante incidentes
Claude Status sirve como regla de parada fechada, no como prueba de que tu VS Code local está sano. Consúltalo después de /status cuando hay fallos amplios, bucles de login o errores de servicio. Si hay un incidente relevante, deja de reinstalar, rotar claves o cambiar cuentas. Si el estado está claro y la misma ruta falla, vuelve a evidencia local: entorno, /status, logs y error exacto.
Escala con un paquete redactado
Incluye versión de Claude Code, versión de VS Code, ruta de lanzamiento, resultado redactado de /status, presencia de variables sin valores, login probado, provider si aplica, error exacto, request id o hora, y timestamp de Claude Status. No incluyas API keys, bearer tokens, provider secrets, .env completos ni capturas con datos privados.
Revisión adicional en equipos y varios workspaces
En un equipo, la cuenta humana y la ruta real del workspace no siempre coinciden. Puedes haber iniciado sesión en Claude.ai con una cuenta personal mientras el workspace de VS Code hereda una API key de organización, un provider token o variables de un devcontainer. También puede ocurrir lo contrario: la terminal externa está limpia, pero el contenedor, el profile o el script de lanzamiento inyecta secretos.
Cuando alguien diga que ya inició sesión, pide una prueba reproducible: /status en la ventana de VS Code donde falla, comprobación enmascarada de ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN y ANTHROPIC_BASE_URL en el terminal integrado, y confirmación de repository, branch, remote/container y profile. Sin esos datos, un cambio de cuenta se confunde con permisos, quota, gasto API o caída de provider.
| Entorno | Lectura equivocada común | Evidencia adicional | Acción |
|---|---|---|---|
| Varios VS Code Profiles | Un profile está autenticado y otro conserva una sesión antigua | nombre del profile, título de ventana, /status | repetir login o limpiar ruta en el profile correcto |
| devcontainer / remote SSH | La shell local no tiene key, pero el contenedor sí | nombre del contenedor, host remoto, masked env check | corregir la fuente del secret |
| Team / Enterprise | El login personal funciona, pero la política org bloquea el repo | org, workspace, permisos, admin policy | escalar por administración de organización |
| Gateway compatible | Base URL cambia la frontera de confianza | host, modelo, dueño del provider | diagnosticar gateway contract, no la suscripción |
El orden estable es: /status en la ventana objetivo, masked env check en el mismo terminal integrado, contexto de lanzamiento y workspace, y solo después Console Usage, Claude Status o panel de organización. Repite /status después de cada cambio; si no, no podrás explicar qué acción corrigió la ruta.
Nota mínima después de corregir
Cierra el diagnóstico con una nota breve: ventana de VS Code, forma de lanzamiento, /status antes y después, presencia de variables ANTHROPIC_*, cambio único realizado, recarga de ventana y decisión final. Es mejor que una colección de capturas porque separa cuenta, entorno, provider y estado del servicio.
Fuentes y verificación
Los hechos de comportamiento provienen de la documentación oficial de Claude Code revisada el 7 de mayo de 2026: integración con VS Code, autenticación, quickstart, comandos, errores y troubleshooting. La evidencia local en español se capturó con Computer Use en Google es-ES el mismo día; los resultados locales se usan como señal de intención, no como autoridad de política.
Preguntas frecuentes
¿Cómo compruebo qué cuenta usa Claude Code en VS Code?
Abre Claude Code en la misma ventana de VS Code y ejecuta /status. Si hace falta, inicia claude desde el terminal integrado.
¿Qué hago si VS Code dice que no he iniciado sesión?
Ejecuta /login, autoriza en el navegador y repite /status. Si el flujo no reaparece, recarga la ventana.
¿Una API key puede ganar sobre mi suscripción?
Sí. Una variable como ANTHROPIC_API_KEY puede mover la sesión a ruta API. Comprueba presencia en el terminal integrado.
¿Por qué mi terminal externa ve una key y VS Code no?
VS Code fue lanzado desde otro entorno. Abre el proyecto con code . desde el shell previsto.
¿/cost muestra mi cuenta?
No. Primero /status; después interpreta coste o uso.
¿Debo borrar la API key?
Normalmente no. Primero elimina la variable del entorno que lanza VS Code y verifica.
¿Claude Status prueba mi estado local?
No. Solo ayuda a decidir si hay incidente.
¿Qué información envío?
Versiones, lanzamiento, /status redactado, variables presentes, error, request id o hora y estado; nunca secretos.