API Hop

Documentação

Documentação do API Hop

Integração com Claude Code

Use o endpoint compatível com Claude Messages da RequestBeam no Claude Code.

O Claude Code chama modelos pelo protocolo Anthropic Messages. Defina ANTHROPIC_BASE_URL como a URL base compatível com Anthropic mostrada nesta página.

O Claude Sonnet 4.6 (claude-sonnet-4-6) é suportado pelo fornecedor, mas não está publicado atualmente na RequestBeam. Não é o padrão de uma integração ativa. Antes de chamar qualquer modelo, confirme o acesso com sua própria resposta de GET https://api.apihop.ai/v1/models.

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

Pré-requisitos

Prepare primeiro uma chave de API RequestBeam válida. Ela será gravada no ambiente do shell local. Não a inclua em repositórios, registros ou capturas de tela.

Instalar Claude Code

No macOS / Linux, use o instalador nativo do Claude Code:

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

Se o instalador informar ~/.local/bin/claude, mas claude não for encontrado, abra um novo terminal ou adicione ~/.local/bin a PATH.

Para fluxos de trabalho antigos, o pacote npm continua disponível:

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

Não use sudo npm install -g @anthropic-ai/claude-code; isso pode causar problemas de permissão em atualizações futuras.

Verifique a CLI após a instalação:

bash
claude --version
claude doctor

No Windows, recomenda-se Git Bash ou WSL para o Claude Code. O PowerShell também pode definir variáveis de ambiente, mas a persistência varia por terminal.

Configurar variáveis de ambiente

Configurações temporárias afetam somente a sessão atual do 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"

O macOS usa zsh por padrão. Para configuração persistente, grave as variáveis em ~/.zshrc e execute source ~/.zshrc para que o terminal atual as leia imediatamente:

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

No Linux com bash, grave as mesmas variáveis em ~/.bashrc e execute source ~/.bashrc.

Configurações temporárias do 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"

Persistência no nível de usuário do 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")

Abra uma nova sessão do PowerShell antes de executar claude.

Arquivo de configurações

Como alternativa à configuração do shell, crie ou edite ~/.claude/settings.json. Se o arquivo já existir, mescle env e model ao JSON existente em vez de substituir outras configurações:

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 disponíveis:

  • 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

Use GET https://api.apihop.ai/v1/models para consultar os modelos atualmente disponíveis para sua chave de API.

Iniciar e testar

Reinicie o Claude Code após definir as variáveis de ambiente e envie um prompt normal:

bash
claude "Reply exactly OK."

Você também pode iniciar o modo interativo:

bash
claude

Na primeira execução, o Claude Code pode pedir um tema, confirmação de segurança, configuração do terminal ou se o diretório atual é confiável. Siga as instruções do terminal.

Selecionar um modelo

Defina um modelo padrão com a variável de ambiente ou escolha um para um único comando com --model:

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

Comportamento do endpoint

O Claude Code autentica com a chave de API RequestBeam configurada. O serviço aceita qualquer uma das formas de autenticação:

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

As respostas mantêm o formato nativo JSON ou de eventos SSE do Anthropic Messages. Não são convertidas para o formato OpenAI.

Solução de problemas

  • ANTHROPIC_BASE_URL deve ser a URL base da API pública mostrada nesta página mais /anthropic.
  • Não inclua caminhos de endpoints em ANTHROPIC_BASE_URL; basta a URL base compatível com Anthropic.
  • Após editar ~/.zshrc no macOS, execute source ~/.zshrc ou abra um novo terminal antes de iniciar o Claude Code.
  • Se claude retornar comando não encontrado, confirme que o local de instalação está em PATH; um local comum é ~/.local/bin/claude.
  • Se claude doctor informar variáveis de ambiente ausentes, execute echo $ANTHROPIC_BASE_URL e echo $ANTHROPIC_MODEL no mesmo terminal para confirmar que foram carregadas.
  • Se receber 401, confirme que a chave de API é válida.
  • Se o modelo estiver indisponível, confirme que seu nome consta na lista de modelos disponíveis acima.
  • Reinicie o processo Claude Code após alterar variáveis de ambiente.
  • POST https://api.apihop.ai/anthropic/v1/messages: endpoint compatível com Anthropic Messages.