Tutorial de instalación y uso de Claude Code

Claude Code es un potente asistente de programación de IA que le permite programar en colaboración con la IA directamente en el terminal. Este tutorial lo guiará a través del proceso de instalación y configuración.

📋 Requisitos del sistema

Versión de Node.js ≥ 18.0

Sistemas operativos compatibles: macOS, Linux, Windows (WSL)

🚀 Inicio rápido

1. Instale Node.js

💡 Consejo: Si ya tienes instalado Node.js 18.0 o superior, puedes omitir este paso.

Usuarios de Ubuntu/Debian

# Instalar la versión LTS de Node.js
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

# Verificar la instalación
nodo --versión

usuarios de macOS

#Instalar herramientas de línea de comando de Xcode
sudo xcode-select --instalar

# Instalar Homebrew (si aún no está instalado)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Instalar Node.js a través de Homebrew
nodo de instalación de cerveza

# Verificar la instalación
nodo --versión

2. Instalar el código Claude

Instale Claude Code globalmente usando npm:

npm install -g @anthropic-ai/claude-code

# Verificar la instalación
claude --versión

3. Configura y comienza a usar

Obtener la información de configuración necesaria

Debe preparar dos elementos de configuración importantes:

Elementos de configuración	Descripción	Obtener método
ANTHROPIC_AUTH_TOKEN	Token de autenticación API	Después del registro, haga clic en `Agregar token` en la página `API Token` para obtenerlo (comenzando con `sk-`)
ANTHROPIC_BASE_URL	Dirección del servicio API	Utilice `https://yossapi.com` (igual que la dirección del sitio principal)

📝 Configuraciones recomendadas al crear un token:
Nombre: Nómbralo como quieras
Cuota: Establecer una cuota ilimitada
Grupo: elija el código Claude exclusivo o la transferencia oficial a Claude 3 y superior
Otras opciones: mantener la configuración predeterminada

Iniciar código Claude

En el directorio de su proyecto ejecute:

# Ingrese al directorio del proyecto
cd la carpeta-de-su-proyecto

#Linux/Unix establece variables de entorno
export ANTHROPIC_AUTH_TOKEN=sk-... # Reemplace con su token real
exportar ANTHROPIC_BASE_URL=https://yossapi.com
exportar API_TIMEOUT_MS=300000 # Establecer el tiempo de espera en 300 segundos

# Iniciar código Claude
claudio

# Ingrese al directorio del proyecto
cd la carpeta-de-su-proyecto

# windows PowerShell establece variables de entorno
$env:ANTHROPIC_BASE_URL = "https://yossapi.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-..."
$env:API_TIMEOUT_MS = "300000" # Establece el tiempo de espera en 300 segundos

# cmd de Windows establece variables de entorno
establecer ANTHROPIC_BASE_URL=https://yossapi.com
establecer ANTHROPIC_AUTH_TOKEN=sk-...
establecer API_TIMEOUT_MS=300000

# Iniciar código Claude
claudio

Configuración de primera ejecución

Una vez iniciado, verá los siguientes pasos de configuración:

Seleccione Tema → Seleccione su tema favorito + Presione Enter

Instrucciones de seguridad → Confirme las instrucciones de seguridad + presione Entrar

Configuración de terminal → Usar la configuración predeterminada + presionar Enter

Confianza en el directorio de trabajo → Confiar en el directorio actual + presione Entrar

✨ **¡Felicidades! ** ¡Ahora puedes empezar a codificar con tu socio de programación de IA!

❓ Preguntas frecuentes

R: Esto indica que Claude Code no detectó la variable de entorno. Por favor verifique:

¿Están configurados correctamente ANTHROPIC_AUTH_TOKEN y ANTHROPIC_BASE_URL?

Si el valor de la variable de entorno es correcto (el token comienza con sk-)

Si se utiliza una configuración permanente, si se reinicia el terminal

P: ¿Por qué se muestra el estado "fuera de línea"?

R: Claude Code determina el estado de la red al conectarse a Google. Mostrar "sin conexión" no afecta el uso normal, solo indica que no puedes conectarte a Google.

P: ¿Por qué falla Fetch al navegar por la web?

R: Claude Code necesita llamar al servicio de Claude para realizar un control de seguridad antes de acceder a la página web. Necesitas:

Mantener una conexión a Internet internacional estable

Utilice proxies globales cuando sea necesario

P: ¿La solicitud siempre muestra "error de recuperación"?

R: El problema puede deberse al entorno de red. Solución:

Intente utilizar una herramienta proxy

P: ¿Cómo manejar los errores de API?

R: Puede deberse a la inestabilidad del agente de transporte. Sugerencias:

Salir del código Claude (Ctrl+C)

Vuelva a ejecutar el comando claude

Si el problema persiste, inténtalo de nuevo más tarde.

P: ¿Error de inicio de sesión en la página web?

R: Intente borrar las cookies de este sitio e inicie sesión nuevamente.

📌 Notas

Este sitio está directamente conectado al servicio oficial de reenvío de Claude Code

Solo admite el tráfico API de Claude Code y no admite otras llamadas API

Conserve su token API correctamente para evitar fugas.

🔗 Enlaces relacionados

Documentación oficial del Código Claude

Sitio web oficial de Node.js

💡 Consejo: Si encuentra otros problemas, consulte la documentación oficial o comuníquese con el soporte técnico.

Tutorial de instalación y uso de Claude Code

Tutorial de instalación y uso de Claude Code#

📋 Requisitos del sistema#

🚀 Inicio rápido#

1. Instale Node.js#

Usuarios de Ubuntu/Debian#

usuarios de macOS#

2. Instalar el código Claude#

3. Configura y comienza a usar#

Obtener la información de configuración necesaria#

Iniciar código Claude#

Configuración de primera ejecución#

❓ Preguntas frecuentes#

P: ¿Encontró el error "Clave API no válida · Ejecute /login"?#

P: ¿Por qué se muestra el estado "fuera de línea"?#

P: ¿Por qué falla Fetch al navegar por la web?#

P: ¿La solicitud siempre muestra "error de recuperación"?#

P: ¿Cómo manejar los errores de API?#

P: ¿Error de inicio de sesión en la página web?#

📌 Notas#

🔗 Enlaces relacionados#

Tutorial de instalación y uso de Claude Code

📋 Requisitos del sistema

🚀 Inicio rápido

1. Instale Node.js

Usuarios de Ubuntu/Debian

usuarios de macOS

2. Instalar el código Claude

3. Configura y comienza a usar

Obtener la información de configuración necesaria

Iniciar código Claude

Configuración de primera ejecución

❓ Preguntas frecuentes

P: ¿Encontró el error "Clave API no válida · Ejecute /login"?

P: ¿Por qué se muestra el estado "fuera de línea"?

P: ¿Por qué falla Fetch al navegar por la web?

P: ¿La solicitud siempre muestra "error de recuperación"?

P: ¿Cómo manejar los errores de API?

P: ¿Error de inicio de sesión en la página web?

📌 Notas

🔗 Enlaces relacionados