Instalar Claude Code y completar la primera ejecución segura
Guía actual de instalación, autenticación, gateway, primera modificación segura y validación con Git.
Claude Code es el agente de programación de Anthropic para terminal y entornos de desarrollo. Instala el cliente actual, abre un proyecto Git pequeño, usa default o plan y revisa cada primer cambio con git diff.
Para un flujo API pay-as-you-go independiente con Claude Code, crea tu propia clave siguiendo la guía BetterToken para Claude Code. BetterToken es un acceso API Anthropic-compatible para Claude Code: no habilita Claude Chat ni Cowork y no sustituye una suscripción Claude.
Requisitos antes de instalar
Necesitas una terminal, un proyecto Git pequeño que pueda modificarse y, preferiblemente, git status limpio. El login oficial requiere una cuenta Claude o Console compatible; un gateway es una ruta de provider separada. Nunca pongas claves en código, capturas o historial del shell.
Native Install en macOS, Linux y WSL
Anthropic recomienda Native Install:
Solo instala el cliente; no realiza login ni configura un provider. Consulta los Docs actuales antes de usar métodos antiguos de npm.
Diferencias de instalación en Windows
PowerShell:
CMD:
En Windows nativo se recomienda Git for Windows para que Claude Code pueda usar Bash. En WSL no se necesita; instala el cliente Linux y trabaja, cuando sea posible, dentro del filesystem WSL.
Verificar instalación y autenticación
Abre otra terminal y ejecuta:
Después ejecuta claude y completa el login oficial en el navegador. Usa /login para cambiar de cuenta. Una API Key no pertenece a un prompt ordinario ni al repositorio.
Configurar un gateway de terceros
Un gateway necesita API Key, Model ID admitido y Base URL correcta. Con BetterToken sigue el documento actual y usa https://bettertoken.ai como Base URL Anthropic-compatible. No es una URL HTTP Messages cruda: el cliente añade la ruta de protocolo. Prueba una petición pequeña tras cambiar una sola variable.
Primer proyecto en modo solo lectura
Pide: «Explica estructura, punto de entrada y comando de inicio. No modifiques archivos ni ejecutes comandos de red.» Plan mode lee y explora, pero no edita fuentes.
Primera modificación reversible
Aprueba solo la acción prevista y después ejecuta:
Revisa límite de archivo, contenido, secretos y cambios inesperados de configuración o dependencias.
Permisos y seguridad
default permite lecturas y pide aprobación antes de ediciones o comandos. plan investiga sin editar. acceptEdits acepta ediciones y operaciones comunes; auto es una research preview con comprobaciones de fondo. bypassPermissions solo debe usarse en containers o VM aislados. El primer día usa default o plan.
Señal de éxito y verificación API
El primer run es correcto si está abierto el directorio adecuado, login o petición provider funciona, solo cambia el archivo permitido y el diff es comprensible. Con BetterToken, comprueba modelo, estado y tokens input/output/cache en Dashboard e historial de uso. Eso prueba la ruta API, no los derechos de Chat o Cowork.
Diagnóstico por capas
Si no se encuentra claude, abre una terminal nueva y consulta la ayuda oficial, no una instrucción npm antigua. Separa login Claude, Console/API y gateway. Ante un error provider, comprueba primero Key, luego Base URL y después Model ID. Si Claude intenta editar demasiado, rechaza la acción, vuelve a Plan mode y limita a un archivo, sin red ni commit.
Siguientes pasos y fuentes
Tras un README correcto, avanza a un test o una corrección pequeña. Aumenta alcance y autonomía de uno en uno: despliegues, APIs y sistemas remotos no se revierten como un archivo local.