Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Inicio rápido

Esta guía te ayudará a empezar con Claude Code proporcionado por AIHubMix en solo unos minutos.

​
1. Instalar Claude Code

​
Instalación local

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

​
Instalar mediante npm

Necesitas Node.js versión 18 o superior. 
npm install -g @anthropic-ai/claude-code

​
2. Configurar la API de AIHubMix

Para acceder a los servicios de modelos de AIHubMix a través de la API compatible con Anthropic, debes configurar las siguientes variables de entorno.
  1. Establece ANTHROPIC_BASE_URL como https://aihubmix.com
  2. Establece ANTHROPIC_AUTH_TOKEN como la clave API obtenida en la plataforma AIHubMix
  3. Establece ANTHROPIC_MODEL como un modelo admitido de la lista de modelos.
  1. Ejecuta el siguiente comando en la terminal para comprobar el tipo de Shell predeterminado.
echo $SHELL
  1. Configura las variables de entorno según el tipo de Shell con los siguientes comandos:
# Replace AIHUBMIX_API_KEY with the Key obtained from the AIHUBMIX platform
echo 'export ANTHROPIC_BASE_URL="https://aihubmix.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="AIHUBMIX_API_KEY"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-5"' >> ~/.zshrc
  1. Ejecuta el siguiente comando en la terminal para que las variables de entorno surtan efecto.
source ~/.zshrc
  1. Abre una nueva terminal y ejecuta los siguientes comandos para comprobar si las variables de entorno son efectivas.
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_MODEL

​
3. Empezar

Una vez completada la configuración, navega a tu directorio de trabajo y ejecuta el comando claude en la terminal para empezar a usar Claude Code. 
$ cd /path/your-project
> claude
Al usar Claude Code por primera vez, es posible que se te solicite iniciar sesión en tu cuenta de Anthropic. Sigue estos pasos para omitir ese proceso: Cc 7
  1. Localiza el archivo .claude.json en tu directorio personal, con las siguientes rutas:
    • macOS / Linux: ~/.claude.json
    • Windows: C:\Users\%USERNAME%\.claude.json
  2. Establece el valor del campo hasCompletedOnboarding como true.
{
  "hasCompletedOnboarding": true
}
  1. Guarda el archivo y vuelve a ejecutar claude en la terminal.

​
(Opcional) Métodos adicionales de configuración del modelo

Claude Code admite los siguientes métodos de configuración del modelo, ordenados por prioridad de mayor a menor, donde las configuraciones de mayor prioridad anulan a las de menor prioridad.
  1. Durante una conversación: Ejecuta el comando /model <model_name> para cambiar de modelo. Es adecuado para cambios temporales.
/model claude-sonnet-4-5
  1. Al iniciar Claude Code: Ejecuta claude --model <model_name> para especificar el modelo. Es adecuado para uso en una sola sesión.
claude --model claude-sonnet-4-5
  1. Configurar variables de entorno: Puedes configurar distintos niveles de modelos según la complejidad de la tarea. Claude Code seleccionará automáticamente el modelo apropiado según el tipo de tarea. Es adecuado para un efecto global.
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
Donde:
  • ANTHROPIC_DEFAULT_OPUS_MODEL: Para razonamiento complejo, diseño de arquitectura y otras tareas de alta dificultad.
  • ANTHROPIC_DEFAULT_SONNET_MODEL: Para programación, implementación de funciones y otras tareas rutinarias.
  • ANTHROPIC_DEFAULT_HAIKU_MODEL: Para revisiones gramaticales, búsqueda de archivos y otras tareas sencillas.
  1. Configurar permanentemente en el archivo settings.json: Crea un archivo settings.json en la raíz del proyecto o en el directorio personal del usuario, y escribe la información de configuración del modelo para una configuración permanente a nivel de proyecto o de usuario.
{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

​
Configuración mediante cc-switch

  1. Ejecuta CC-Switch y haz clic en “Add Vendor”.
Cc 1
  1. Selecciona “AiHubMix” de la lista predefinida.
Cc 2
  1. Rellena tu clave en el campo “API Key”.
Cc 3
  1. Una vez completada la configuración, haz clic en “Add” para guardar los ajustes.
Cc 4
  1. Vuelve a la página de inicio, selecciona “AiHubMix” de la lista de proveedores y haz clic en “Start” para empezar a usarlo.
Cc 5

​
Configuración mediante el plugin de VS Code

  1. Ejecuta VS Code e instala el plugin.
I Shot 2026 03 25 11 44 03
  1. Pulsa Ctrl + Shift + P (o Cmd + Shift + P), escribe Settings para abrir los ajustes.
I Shot 2026 03 25 11 47 48
  1. Busca Claude Code, encuentra Claude Code: Environment Variable → Edit in settings.json.
I Shot 2026 03 25 11 49 37
  1. Rellena la información relacionada con AIHubMix en claudeCode.environmentVariables.
I Shot 2026 03 25 11 53 07

​
Wechat-Agent-SDK

Con sencillas llamadas a la API, integra fácilmente con un clic entidades de IA principales como Claude Code, Codex y Kimi en WeChat. Es compatible con el protocolo ACP, se ejecuta completamente en local sin necesidad de servidor ni base de datos, e incluye funciones de nivel empresarial como reanudación con puntos de control y reconexión automática, lo que permite a tu asistente de IA mantener conversaciones inteligentes de forma fluida dentro de WeChat.
Enlace de instalación: https://github.com/AIhubmix/wechat-agent-sdk

​
Preguntas frecuentes

​
P: Al usar Claude Code, recibo el mensaje “401, No token provided…”

Abre la terminal de Claude e introduce /config, busca la opción Use custom API key y comprueba si el token está configurado correctamente. install

​
P: Después de instalar con éxito en macOS, sigo obteniendo un error: zsh: command not found: claude

Esto se debe a que la CLI de Claude está instalada, pero su directorio ejecutable no se ha añadido al PATH del sistema.
  1. Confirma la ruta de instalación de Claude. El script oficial de Claude Code suele instalarse en uno de los siguientes directorios:
  • ~/.claude/bin
  • ~/.local/bin
Ejecuta el siguiente comando en la terminal: 
ls -l ~/.claude/bin
or
ls -l ~/.local/bin | grep claude
Si ves el archivo claude, significa que la instalación tuvo éxito, pero el PATH no está configurado.
  1. Añade el directorio de instalación al PATH. Ejecuta el comando correspondiente según la ubicación real de la instalación:
Caso A: Instalado en ~/.claude/bin
echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Caso B: Instalado en ~/.local/bin
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
  1. Verifica si surte efecto. Ejecuta:
which claude
claude -v
Si puedes ver la ruta y el número de versión de claude, la instalación tuvo éxito.

​
P: Claude Code no puede conectarse a los servicios de Anthropic

Tras actualizar a la última versión de Claude Code, si experimentas problemas al conectarte a los servicios de Anthropic o fallos de autenticación, suele deberse a un cambio en el nombre de la cabecera de autenticación. La nueva versión requiere actualizar la cabecera de la solicitud de ANTHROPIC_API_KEY a ANTHROPIC_AUTH_TOKEN. El valor de la clave API no necesita cambiar; solo necesitas actualizar el nombre de la cabecera de la solicitud y recargar la configuración. Para instrucciones específicas, consulta este documento para reconfigurarla.

​
Más recursos

​
¡Feliz programación!

Última actualización: 2026-06-01