Claude Code CLI

​

Descripción general

​

Requisitos previos

​

Obtener la clave API de EvoLink

• Inicia sesión en el Panel de EvoLink
• Busca API Keys en el panel, haz clic en el botón “Crear nueva clave” y luego copia la clave generada
• La clave API generalmente comienza con sk-

​

Paso 1: Instalar Claude Code CLI

​

1. Instalación con un solo comando

• macOS / Linux
• Windows

Copiar

curl -fsSL https://claude.ai/install.sh | bash

Resultado esperado: Verás información de descarga e instalación, finalizando con un mensaje de éxito.Si ocurre un error: permission denied significa que necesitas agregar sudo antes del comando.

​

1.1 Instalar Node.js y npm (Omitir si ya están instalados)

Primera instalación:

1. Visita el sitio web oficial de Node.js para descargar e instalar (se recomienda la versión LTS)
2. Si no estás familiarizado con el proceso de instalación, consulta la Guía de instalación de Node.js
3. Se recomienda Node.js v20 o superior

Verificar la instalación:

Copiar

node -v
npm -v

​

1.2 Instalar Claude Code CLI

Ejecuta en PowerShell o CMD:

Copiar

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

Resultado esperado: Verás información de descarga e instalación, finalizando con un mensaje de éxito.Si ocurre un error:

• permission denied: Ejecuta PowerShell o CMD como administrador
• npm command not found: Node.js no está instalado correctamente o no se ha agregado a las variables de entorno

​

2. Verificar la instalación

claude --version

​

Paso 2: Configurar la API de EvoLink

• Método 1: Configurar settings.json (Recomendado)
• Método 2: Configuración temporal (Solo terminal actual)
• Método 3: Configuración permanente (Global)

Nota: Si es la primera vez que usas Claude Code CLI, te recomendamos comenzar con el “Método 2: Configuración temporal” para probar tu configuración antes de usar este método para una configuración permanente.

​

1. Abrir el directorio de configuración

• Windows
• macOS
• Linux

Presiona Win + R, pega lo siguiente y luego presiona Enter:

Copiar

%userprofile%\.claude

Si la carpeta no existe: Crea manualmente la carpeta .claude (presiona Win + R, escribe %userprofile%, presiona Enter para abrir el directorio del usuario y luego crea una nueva carpeta llamada .claude).

En Finder, presiona Command + Shift + G, pega la siguiente ruta y luego presiona Enter:

Copiar

~/.claude

Si la carpeta no existe: Abre la Terminal y ejecuta mkdir ~/.claude para crear la carpeta.

Abre el administrador de archivos y navega a:

Copiar

~/.claude

Si la carpeta no existe: Abre la Terminal y ejecuta mkdir ~/.claude para crear la carpeta.

​

2. Editar settings.json

En la carpeta abierta, si settings.json no existe, haz clic derecho en un espacio vacío → Nuevo → Documento de texto → Renombrar a settings.json (elimina la extensión .txt). Luego haz doble clic para abrir con un editor y agrega el siguiente contenido:

Copiar

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-evolink-api-key",
    "ANTHROPIC_BASE_URL": "https://code.evolink.ai",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

⚠️ Importante:

• Copia completamente sin omitir ningún símbolo
• Reemplaza "your-evolink-api-key" con la clave API real (mantén las comillas)
• No uses un método de entrada en chino para la puntuación

Opciones de configuración:

• ANTHROPIC_AUTH_TOKEN: Tu clave API de EvoLink
• ANTHROPIC_BASE_URL: https://code.evolink.ai (punto de acceso de la API de EvoLink)
• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: Reducir solicitudes de red no esenciales

• Windows
• macOS / Linux

En PowerShell:

Copiar

$env:ANTHROPIC_BASE_URL="https://code.evolink.ai"
$env:ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"

En CMD:

Copiar

set ANTHROPIC_BASE_URL=https://code.evolink.ai
set ANTHROPIC_AUTH_TOKEN=your-evolink-api-key

Nota: La configuración caduca al cerrar la terminal.

En la Terminal:

Copiar

export ANTHROPIC_BASE_URL="https://code.evolink.ai"
export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"

Nota: La configuración caduca al cerrar la terminal.

⚠️ Nota: Reemplaza your-evolink-api-key con tu clave API real.

• Windows
• macOS
• Linux

Configuración mediante interfaz gráfica:

1. Haz clic derecho en “Este equipo” → “Propiedades” → “Configuración avanzada del sistema” → “Variables de entorno”
2. En “Variables de usuario” o “Variables del sistema”, crea una nueva:
   • Nombre de variable: ANTHROPIC_BASE_URL
   • Valor de variable: https://code.evolink.ai
3. Agrega ANTHROPIC_AUTH_TOKEN con tu clave API como valor
4. Haz clic en “Aceptar” para guardar

Comando de PowerShell:

Copiar

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://code.evolink.ai', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'your-evolink-api-key', 'User')

Nota: Reinicia la terminal para que surta efecto.

Edita el archivo de configuración del shell (elige según tu shell):Si usas zsh (predeterminado en macOS):

Copiar

echo 'export ANTHROPIC_BASE_URL="https://code.evolink.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"' >> ~/.zshrc

Si usas bash:

Copiar

echo 'export ANTHROPIC_BASE_URL="https://code.evolink.ai"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"' >> ~/.bash_profile

Aplicar inmediatamente:

Copiar

source ~/.zshrc  # o source ~/.bash_profile

Edita el archivo de configuración del shell (elige según tu shell):Si usas bash (común en Linux):

Copiar

echo 'export ANTHROPIC_BASE_URL="https://code.evolink.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"' >> ~/.bashrc

Si usas zsh:

Copiar

echo 'export ANTHROPIC_BASE_URL="https://code.evolink.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"' >> ~/.zshrc

Aplicar inmediatamente:

Copiar

source ~/.bashrc  # o source ~/.zshrc

⚠️ Nota: Reemplaza your-evolink-api-key con tu clave API real.

​

Paso 3: Comenzar a usar Claude Code CLI

​

1. Ingresa a un directorio de trabajo seguro

cd your-working-directory

​

2. Modo interactivo

claude

​

3. Verificar la configuración

claude "Who are you"

• Ves texto de respuesta de la IA (varias líneas)
• Sin errores como 401, 403, API Key invalid

• 401 Unauthorized: La clave API no está configurada o es inválida → Verifica settings.json
• 403 Forbidden: Permisos insuficientes de la clave API → Verifica la clave API
• Network error: Problema de red → Verifica la conexión

​

Preguntas frecuentes

​

1. ¿Qué es Claude Code CLI y para qué se usa?

​

2. ¿Cómo verifico la instalación y configuración en el primer uso?

• claude --version: Confirma que Claude Code CLI está instalado
• claude "Who are you": Confirma que la configuración de la API es correcta

​

3. ¿Cuál es la diferencia entre el modo interactivo y el modo de comando único?

• Modo interactivo: Ejecuta claude para entrar en una conversación continua para interacciones de múltiples turnos, ideal para tareas complejas
• Modo de comando único: Ejecuta claude "pregunta" para obtener una sola respuesta y salir, ideal para consultas rápidas

​

4. ¿Claude Code CLI leerá o subirá automáticamente mis archivos y código locales?

​

5. ¿Cómo uso Claude Code CLI para analizar o procesar contenido de archivos locales?

• Escribir la ruta del archivo para que Claude lo lea
• Arrastrar archivos a la ventana de la terminal
• Copiar y pegar el contenido del archivo

​

6. ¿Claude Code CLI admite entrada y salida en chino?

​

7. ¿Sin salida después de la ejecución, cuál podría ser la causa?

• Problemas de conexión de red que impiden el acceso al servidor API
• Clave API inválida o saldo insuficiente
• Configuración incorrecta de ANTHROPIC_BASE_URL
• Firewall o proxy bloqueando las solicitudes

​

8. ¿Por qué los cambios en mi archivo de configuración o variables de entorno no surten efecto?

• Reinicia tu terminal o ventana de línea de comandos
• Verifica que settings.json tenga una sintaxis JSON válida
• Verifica la ruta del archivo de configuración:
  • Windows: C:\Users\{username}\.claude\settings.json
  • macOS / Linux: ~/.claude/settings.json

​

9. ¿Qué causa los errores 401/403?

• Error 401: ANTHROPIC_AUTH_TOKEN no configurado o clave API inválida
• Error 403: Permisos insuficientes de la clave API o clave expirada
• Verifica que ANTHROPIC_BASE_URL esté configurado como https://code.evolink.ai

​

10. ¿Para qué escenarios es adecuado Claude Code CLI? ¿Para qué no es adecuado?

• Escritura, depuración y refactorización de código
• Preguntas y respuestas rápidas en entornos de línea de comandos
• Análisis y procesamiento de contenido de archivos
• Integración de scripts de automatización

• Interacciones complejas que requieren una interfaz gráfica
• Edición colaborativa en tiempo real
• Procesamiento masivo de archivos a gran escala

​

11. ¿Cómo cambio de modelo?

​

12. ¿Qué modelos Claude admite EvoLink?

​

13. ¿Cómo subo imágenes?

• Opción 1: Hacer referencia a la ruta de la imagen
• Opción 2: Arrastrar y soltar una imagen en la terminal
• Opción 3: Pegar una imagen directamente

​

14. ¿Cómo abrir la terminal de línea de comandos?

​

Notas