Claude Code

Conecte Claude Code a HopBase con la configuración con un clic o mediante variables de entorno.

Claude Code es la CLI oficial de Anthropic. Use la configuración con un clic de la consola para la primera instalación, CC Switch cuando gestione varios proveedores, y la configuración manual cuando ya gestione usted mismo las variables de entorno.

Método	Ideal para	Qué hace
Configuración con un clic (recomendado)	Primera configuración	Instala Claude Code, hace una copia de seguridad y escribe `~/.claude/settings.json`, y verifica la clave
CC Switch	Configuración gráfica o varios proveedores	Importa y cambia las configuraciones de proveedor de Claude Code
Configuración manual	Flujos de trabajo existentes de gestión de entornos	Establece directamente las variables de entorno Base URL y de la clave

Recomendado: configuración con un clic desde la consola

No se requieren conocimientos de variables de entorno. Se admiten Windows, macOS y Linux.

Ubique el botón de un clic

Inicie sesión en la consola, abra Claves API y seleccione Configuración con un clic junto a la clave.

Copie el comando para su sistema

Seleccione Claude Code, elija macOS / Linux o Windows PowerShell, haga clic en Generar comando de configuración y luego copie el comando.

Péguelo en una terminal y presione Enter

En macOS, abra Terminal. En Linux, abra cualquier terminal (necesita curl instalado). En Windows, abra PowerShell. El script instala Claude Code si es necesario, hace una copia de seguridad de la configuración existente, escribe la configuración de HopBase y verifica la conexión.

Inicie Claude Code

Una vez que la configuración se complete correctamente, abra una nueva ventana de terminal y ejecute claude.

El comando contiene un token de integración de un solo uso que expira a los 15 minutos, no la clave API en sí.

La configuración con un clic escribe un archivo de configuración.

El script combina ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN en el bloque env de ~/.claude/settings.json, después de respaldar el archivo existente como settings.json.bak.<timestamp>. Claude Code usa los valores de este archivo, por lo que una variable con el mismo nombre definida en su shell no tendrá efecto. Para cambiar la clave o la dirección, edite este archivo o vuelva a ejecutar la configuración con un clic; no la combine con la configuración manual.

Configuración de escritorio con CC Switch

La guía de CC Switch cubre la instalación en macOS, Windows y Linux, la importación de Claude Code o Codex CLI desde la consola de HopBase, el cambio de proveedores y el enrutamiento local de GLM-5.3.

Configuración manual

La configuración temporal solo se aplica a la ventana de terminal actual:

export ANTHROPIC_BASE_URL=https://api.hop-base.com
export ANTHROPIC_AUTH_TOKEN=sk-your-key

claude

La configuración persistente debe colocarse en el archivo de inicio de su shell:

# zsh (la opción predeterminada en macOS)
echo 'export ANTHROPIC_BASE_URL=https://api.hop-base.com' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-your-key' >> ~/.zshrc
source ~/.zshrc

# bash (habitual en Linux; use este bloque en lugar del de zsh)
echo 'export ANTHROPIC_BASE_URL=https://api.hop-base.com' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-your-key' >> ~/.bashrc
source ~/.bashrc

Cambiar de modelo

En una sesión de Claude Code, escriba /model para elegir o escribir un ID de modelo. También puede iniciar Claude Code con --model, o definir la variable de entorno ANTHROPIC_MODEL (con la configuración con un clic, añádala al bloque env de ~/.claude/settings.json). Use solo los ID devueltos por GET /v1/models para la clave actual.

# Cambiar dentro de una sesión (escriba /model solo para listar los modelos)
/model claude-opus-5

# O elegir un modelo al iniciar
claude --model claude-sonnet-5

Elija un grupo

El menú de grupos que se muestra al crear una clave es la referencia autorizada. Los grupos Claude públicos ofrecen los mismos modelos y se diferencian en los clientes para los que están pensados:

Grupo	Uso con
Claude Max (oficial, cuota completa)	Claude Code, SDKs, editores y clientes de terceros
Claude Max (oficial, cuota completa) - Oferta limitada	Igual que la fila anterior, ofrecido por tiempo limitado
Claude Max (ccmax)	Solo el cliente Claude Code; las llamadas con esta clave desde SDKs, curl, editores o clientes de terceros fallan

Use una clave de grupo Claude.

Use una clave de un grupo Claude (la familia Claude Max). Errores comunes: añadir /v1 al Base URL, con lo que las solicitudes van a /v1/v1/messages, o llamar a un endpoint del protocolo OpenAI (/v1/chat/completions, /v1/responses) con una clave Claude. Ambos devuelven 404 "La plataforma actual no admite esta ruta de API". Las solicitudes count_tokens de Claude Code también cuentan para la concurrencia; los límites están en Concurrencia, tiempos de espera y facturación. Consulte Solución de problemas si la configuración falla.

Próximos pasos

CC Switch: cambie entre varios proveedores o claves
Editores e IDE: use modelos Claude en Cursor, Cline o Continue
Solución de problemas: busque un mensaje de error

En esta página