Este tutorial de uso de Claude se centra solo en Claude Code: desde la instalación hasta la primera ejecución, la vinculación de la API Key, el cambio de cuenta, y luego la suscripción y la solución de errores comunes. Siguiendo los pasos podrás ejecutar Claude Code en tu terminal local. Los comandos del artículo sirven para Windows/macOS/Linux; intento dejar los puntos conflictivos por delante para que evites rodeos.
1) Instalar Claude Code: preparación del entorno y primera ejecución
Claude Code depende de Node.js; se recomienda instalar primero Node.js 18 o superior y confirmar que en la terminal puedes usar npm. Luego ejecuta la instalación global:
npm install -g @anthropic-ai/claude-code
Tras instalar, usa
claude --version
para comprobar si se muestra el número de versión.
La primera vez que ejecutes Claude Code, normalmente te pedirá configurar la Anthropic API Key. También puedes configurar de antemano la variable de entorno ANTHROPIC_API_KEY en el sistema y luego iniciar Claude Code, para evitar tener que introducirla repetidamente.
2) Vinculación y cambio de cuenta: gestionar con API Key es lo más cómodo
El núcleo del “inicio de sesión” de Claude Code es la vinculación de la API Key: una clave corresponde a una fuente de facturación y permisos. Si quieres cambiar de cuenta, el método más seguro es cambiar ANTHROPIC_API_KEY (o sustituir la Key en el archivo de configuración generado en la primera ejecución de Claude Code; la ruta concreta se indicará durante la inicialización).
Si alternas entre una cuenta de empresa y una personal, se recomienda establecer variables de entorno por separado para distintas sesiones de terminal, evitando fijar la Key en la configuración global y reduciendo el riesgo de uso indebido y filtraciones.
3) Diferencias entre planes e ideas para ahorrar: elige según el escenario de uso
Las suscripciones relacionadas con Claude suelen incluir Pro y Max (los precios y beneficios pueden ajustarse oficialmente), más adecuadas para conversaciones frecuentes en la web; mientras que en Claude Code el coste más común proviene del volumen de llamadas a la API. Para desarrolladores, concentrar las tareas grandes en uno o dos días y el resto del tiempo hacer solo pequeños cambios suele ser más económico que “mantenerlo abierto con alta frecuencia” durante mucho tiempo.
Si los usuarios en China continental se encuentran con restricciones de pago o de red, prioriza canales de pago de API conformes o métodos de liquidación unificada para empresas/equipos; no se recomienda usar Keys de procedencia desconocida, ya que es fácil activar controles de riesgo y que Claude Code se interrumpa a mitad de uso.
4) Problemas y diagnóstico de errores comunes: fallo de suscripción, errores de solicitud, cuenta bloqueada
Los fallos de suscripción suelen ocurrir por desajustes en el método de pago, la región o la información de facturación; primero revisa la verificación 3DS de la tarjeta, la dirección de facturación y el soporte de moneda; si solo usas Claude Code, confirma si realmente necesitas una suscripción o si solo necesitas una API Key válida y cuota.
Los errores de solicitud (como tiempo de espera/interrupción) suelen deberse a una red inestable, concurrencia demasiado alta o un contexto demasiado largo. El orden recomendado para resolverlo: cambiar a una red más estable → reducir la cantidad de entrada y el alcance de cambios de una sola vez → hacer que Claude Code ejecute por pasos (primero analizar, luego modificar y después probar).
Cuando la cuenta se bloquea o la Key deja de ser válida, primero revisa en la consola si la Key fue revocada, si la cuota se agotó y si se activaron llamadas anómalas. Tras cambiar a una nueva API Key y reiniciar Claude Code normalmente se recupera; si el error persiste, revisa si hay interceptación por proxy/certificados locales y si la hora del sistema es correcta.
