API Hop

Documentación

Documentación de API Hop

Integración de Claude Code

Usa el endpoint de RequestBeam compatible con Claude Messages en Claude Code.

Claude Code llama a los modelos mediante el protocolo Anthropic Messages. Establece ANTHROPIC_BASE_URL en la URL base compatible con Anthropic indicada en esta página.

El proveedor admite Claude Sonnet 4.6 (claude-sonnet-4-6), pero actualmente no está publicado en RequestBeam. No es un valor predeterminado activo de integración. Antes de llamar a cualquier modelo, confirma el acceso con tu propia respuesta de GET https://api.apihop.ai/v1/models.

text
ANTHROPIC_BASE_URL=https://api.apihop.ai/anthropic

Requisitos previos

Prepara primero una clave de API válida de RequestBeam. La clave se guardará en el entorno local de tu shell. No la incluyas en repositorios, registros ni capturas de pantalla.

Instalar Claude Code

En macOS / Linux, usa el instalador nativo de Claude Code:

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

Si el instalador indica ~/.local/bin/claude pero no se encuentra claude, abre una terminal nueva o añade ~/.local/bin a PATH.

Para flujos antiguos, el paquete npm sigue disponible:

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

No uses sudo npm install -g @anthropic-ai/claude-code; puede causar problemas de permisos en futuras actualizaciones.

Verifica la CLI después de instalarla:

bash
claude --version
claude doctor

En Windows se recomienda Git Bash o WSL para Claude Code. PowerShell también puede establecer variables de entorno, pero la persistencia varía según la terminal.

Configurar variables de entorno

Los ajustes temporales solo afectan a la sesión actual de la terminal:

bash
export ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"
export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
export ANTHROPIC_MODEL="claude-sonnet-5-5"

macOS usa zsh por defecto. Para configurar de forma persistente, escribe las variables en ~/.zshrc y ejecuta source ~/.zshrc para que la terminal actual las lea inmediatamente:

bash
printf '%s\n' \
  'export ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"' \
  'export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"' \
  'export ANTHROPIC_MODEL="claude-sonnet-5-5"' \
  >> ~/.zshrc

source ~/.zshrc

En Linux con bash, escribe las mismas variables en ~/.bashrc y ejecuta source ~/.bashrc.

Ajustes temporales en Windows PowerShell:

powershell
$env:ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"
$env:ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
$env:ANTHROPIC_MODEL="claude-sonnet-5-5"

Persistencia a nivel de usuario en PowerShell:

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_REQUESTBEAM_API_KEY", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.apihop.ai/anthropic", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5-5", "User")

Abre una sesión nueva de PowerShell antes de ejecutar claude.

Archivo de configuración

Como alternativa a configurar el shell, crea o edita ~/.claude/settings.json. Si ya existe, combina env y model con el JSON existente sin sustituir los demás ajustes:

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_REQUESTBEAM_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.apihop.ai/anthropic",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  },
  "model": "claude-sonnet-5-5"
}

Modelos disponibles:

  • claude-fable-5
  • claude-fable-5-1
  • claude-opus-4-6
  • claude-opus-4-7
  • claude-opus-4-8
  • claude-opus-5
  • claude-opus-5-5
  • claude-sonnet-5
  • claude-sonnet-5-5

Usa GET https://api.apihop.ai/v1/models para consultar los modelos disponibles actualmente para tu clave de API.

Iniciar y probar

Reinicia Claude Code después de configurar las variables de entorno y envía una instrucción normal:

bash
claude "Reply exactly OK."

También puedes iniciar el modo interactivo:

bash
claude

En el primer inicio, Claude Code puede pedir un tema, confirmación de seguridad, configuración de la terminal o si confías en el directorio actual. Sigue las indicaciones de la terminal.

Elegir un modelo

Establece un modelo predeterminado con la variable de entorno o elige uno para un solo comando con --model:

bash
claude --model claude-sonnet-5-5 "Review this PR"

Comportamiento del endpoint

Claude Code se autentica con la clave de API de RequestBeam configurada. El servicio acepta cualquiera de las dos formas:

http
x-api-key: YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01
http
Authorization: Bearer YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01

Las respuestas conservan el formato nativo JSON o de eventos SSE de Anthropic Messages. No se convierten al formato OpenAI.

Resolución de problemas

  • ANTHROPIC_BASE_URL debe ser la URL base pública indicada en esta página más /anthropic.
  • No incluyas rutas de endpoints en ANTHROPIC_BASE_URL; solo se necesita la URL base compatible con Anthropic.
  • Tras editar ~/.zshrc en macOS, ejecuta source ~/.zshrc o abre una terminal nueva antes de iniciar Claude Code.
  • Si claude indica que no se encuentra el comando, confirma que su ubicación está en PATH; una ubicación habitual es ~/.local/bin/claude.
  • Si claude doctor informa de variables ausentes, ejecuta echo $ANTHROPIC_BASE_URL y echo $ANTHROPIC_MODEL en la misma terminal para confirmar que se cargaron.
  • Si recibes 401, confirma que la clave de API es válida.
  • Si el modelo no está disponible, confirma que el nombre procede de la lista anterior.
  • Reinicia el proceso de Claude Code tras cambiar variables de entorno.
  • POST https://api.apihop.ai/anthropic/v1/messages: endpoint compatible con Anthropic Messages.