Integraciones

@hypershub/cli

Usa el comando hy para configurar Codex, Claude Code y OpenCode con un solo clic; consulta automática de modelos; gestión de configuración global y cambio de modelo; verificaciones locales y pruebas de conectividad.

Instalación

Requiere Node.js 18 o superior. Instala la última versión para funciones de configuración global como hy config.

npm install -g @hypershub/cli@latest
hy --help

Inicio rápido

Elegir herramientas a configurar

Inicializa una sola herramienta o usa all para configurar todo a la vez.

Terminal

hy init codex
hy init claude-code
hy init opencode
hy init all

Introducir URL de plataforma y clave API

El CLI solicita paso a paso la URL base, la clave API y el modelo predeterminado. Introduce la URL raíz de la plataforma; las URLs con /v1 se normalizan automáticamente. Tras la inicialización, los valores confirmados se guardan en la configuración global para reutilización.

Ejemplo interactivo

hy init claude-code
HypersHub Base URL (https://apiclaw.cc):
API Key: hy-...
Default model (claude-sonnet-4-6): claude-deepseek-v4-pro
✓ Global config updated for future hy commands
Run connectivity test now (y/N): Y

Normalización automática de URL

Distintas herramientas requieren distintos formatos de URL: Codex/OpenCode necesitan direcciones compatibles con OpenAI /v1, mientras que ANTHROPIC_BASE_URL de Claude Code normalmente omite /v1. hy lo gestiona automáticamente—solo introduce la URL recomendada.

Reglas de URL

Entrada recomendada: https://apiclaw.cc
 Entrada alternativa: https://apiclaw.cc/v1
 
 Escritura automática:
 Codex / OpenCode: https://apiclaw.cc/v1
 Claude Code: https://apiclaw.cc

Verificar configuración y probar

Después de init, ejecuta hy check all --live para verificar la configuración local, la clave API y la disponibilidad del modelo.

Terminal

hy check all --live
hy use gpt-5.5
hy use claude-deepseek-v4-pro claude-code --live
hy test codex
hy test claude-code
hy test opencode

Configuración global: hy config

Para evitar reintroducir tu clave API cada vez que ejecutes hy models, usa hy config para guardar parámetros comunes. hy init también escribe esta configuración global automáticamente.

Terminal

hy config set baseUrl https://apiclaw.cc
hy config set apiKey hy-xxx
hy config set defaultModel gpt-5.5
hy config list
hy config get apiKey
hy config path
hy models

Elemento de configuración	Descripción
baseUrl	URL raíz de la plataforma, ej. https://apiclaw.cc. También puedes introducir https://apiclaw.cc/v1; el CLI la normaliza automáticamente.
apiBaseUrl	URL de API compatible con OpenAI. Al establecerla también se actualiza baseUrl.
apiKey	Clave API de HypersHub. La salida se enmascara por defecto para evitar exposición accidental.
defaultModel	Modelo predeterminado cuando no se especifica --model.

Prioridad：Flags del CLI > variables de entorno > hy config > entrada interactiva / valores por defecto. Consulta la ruta del archivo de configuración con hy config path; por defecto es ~/.hypershub/config.json (macOS/Linux) o %APPDATA%\HypersHub\config.json (Windows).

Flujo de trabajo diario

hy init normalmente solo se ejecuta una vez. Una vez configurado, hy use es el comando más común: reutiliza la URL y clave existentes y solo cambia el modelo predeterminado.

Flujo recomendado

hy init all
hy config list
hy models
hy check all --live
hy use gpt-5.5
hy use gpt-5.5 codex
hy use claude-deepseek-v4-pro claude-code --live

¿Por qué usar hy use por separado? Cambiar de modelo no debería requerir volver a introducir la clave API ni reescribir toda la configuración. hy use solo actualiza el modelo predeterminado y puede validar la disponibilidad primero con --live.

Comandos comunes

Comando	Descripción
hy init <codex\|claude-code\|opencode\|all>	Escribe la configuración local de la herramienta destino y ejecuta opcionalmente una prueba de conectividad; sincroniza con la configuración global de hy.
hy config list\|get\|set\|unset\|path	Gestiona URL base global, clave API, modelo predeterminado y ruta de archivo de configuración.
hy models	Consulta los modelos disponibles para la clave API actual mediante /v1/models; lee automáticamente de hy config.
hy check [target\|all]	Lee la configuración local y verifica URL, clave API, modelo predeterminado y catálogo de modelos.
hy check [target\|all] --live	Además verifica la clave API en línea y confirma que el modelo predeterminado está en la lista de modelos disponibles.
hy use <model> [target\|all]	Cambia el modelo predeterminado en la configuración existente sin reintroducir URL/clave API; añade --live para validar disponibilidad primero.
hy test <target>	Envía una solicitud mínima a /v1/responses o /v1/messages para verificar la cadena de llamada real.
hy doctor	Inspecciona rápidamente archivos de configuración comunes y variables de entorno actuales.

Cambiar modelo predeterminado

Después de hy init, cambiar de modelo a diario ya no requiere reintroducir URL/clave API—solo usa hy use.

Terminal

hy use gpt-5.5
hy use gpt-5.5 codex
hy use claude-deepseek-v4-pro claude-code
hy use deepseek-v4-pro opencode
hy use gpt-5.5 all --live
hy use gpt-5.5 codex --live --json

Destino	Qué se actualiza
Codex	~/.codex/config.toml y asegura que el modelo existe en all-models.json
Claude Code	Configuración de shell y ~/.claude/settings.json, sincronizando variables de modelo compatibles con cc-switch
OpenCode	~/.config/opencode/opencode.json model y provider.models

Consejo：Con --live, el CLI llama primero a /v1/models para confirmar que el modelo es compatible con la clave API actual antes de escribir. Reinicia la herramienta después; para Claude Code, ejecuta source ~/.zshrc si es necesario.

Uso no interactivo

En scripts, CI o configuración por lotes, pasa URL, clave API y modelo directamente mediante flags. Usa la URL raíz de la plataforma—el CLI añade o quita /v1 automáticamente según la herramienta.

Terminal

hy init codex --url https://apiclaw.cc --key hy-xxx --model gpt-5.4 --yes
hy init claude-code --url https://apiclaw.cc --key hy-xxx --model claude-sonnet-4-6 --yes
hy init opencode --url https://apiclaw.cc --key hy-xxx --model gpt-5.4 --yes

Nota de seguridad：La configuración existente se respalda por defecto; usa --dry-run para previsualizar escrituras. La salida de la clave API se enmascara automáticamente.

Consultar, verificar y probar

Terminal

hy config set baseUrl https://apiclaw.cc
hy config set apiKey hy-xxx
hy models
hy models --json
hy check codex
hy check all --live
hy check all --live --json
hy use gpt-5.5
hy use gpt-5.5 codex --live
hy use claude-deepseek-v4-pro claude-code --live
hy test claude-code --model claude-deepseek-v4-pro

Si la visualización del modelo no coincide con lo esperado tras iniciar una herramienta, usa hy use <model> claude-code para sincronizar el modelo, luego ejecuta hy check claude-code --live. El CLI verifica tanto la configuración de shell como ~/.claude/settings.json.

¿Qué archivos se escriben?

Integración	Archivo
Codex	~/.codex/config.toml、~/.codex/model-catalogs/all-models.json
Claude Code	~/.zshrc / ~/.bashrc / fish / PowerShell profile、~/.claude/settings.json
OpenCode	~/.config/opencode/opencode.json
Configuración global de hy	macOS/Linux: ~/.hypershub/config.json；Linux XDG: $XDG_CONFIG_HOME/hypershub/config.json；Windows: %APPDATA%\HypersHub\config.json