Pular para a documentação

Compatibilidade com Claude Code

Entenda os limites do gateway Messages antes de configurar Claude Code.

Atualizado em 3 de novembro de 2026

Instale o cliente

Claude Code 2.1.233 foi testado com duas solicitações, streaming e um ciclo de ferramenta/resultado do cliente usando uma resposta local sintética. Isso comprova cliente/protocolo, não fornecedor real nem cobrança de produção. Instale esta versão pelo pacote npm oficial e revise mudanças antes de atualizar.

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

Antes de começar

Abra um terminal novo, configure uma chave com escopos e consulte os modelos disponíveis para sua conta antes de usar o cliente. A configuração compartilhada inclui comandos Bash e PowerShell.

Status de compatibilidade

A Anthropic declara não oferecer suporte ao roteamento do Claude Code para modelos que não sejam Claude. A NotHoly oferece os modelos de seu catálogo por uma interface compatível com Messages; não fornece pesos nem assinatura Claude. Essa opção experimental não equivale a um serviço Claude suportado.

Use o protocolo documentado

Use a referência Messages e o SDK oficial Anthropic para o subconjunto de protocolo verificado. Claude Code pode enviar cabeçalhos beta, controles de raciocínio e definições de ferramentas adicionais. Recursos não suportados falham explicitamente; nunca remova controles de segurança ou execução para fazer uma chamada passar.

Configuração do cliente

Selecione um modelo publicado para gerar a configuração. Confirme o acesso da sua conta com GET /v1/models antes de enviar uma solicitação.

bash
export ANTHROPIC_API_KEY="$NOTHOLY_API_KEY"
unset ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_BASE_URL="https://api.notholy.com"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"
export CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING="1"
export MAX_THINKING_TOKENS="0"
export DISABLE_PROMPT_CACHING="1"
claude --bare --model "notholy-pulse" --tools Read --max-turns 2 --no-session-persistence

PowerShell

powershell
$env:ANTHROPIC_API_KEY = $env:NOTHOLY_API_KEY
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue
$env:ANTHROPIC_BASE_URL = "https://api.notholy.com"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"
$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS = "1"
$env:CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING = "1"
$env:MAX_THINKING_TOKENS = "0"
$env:DISABLE_PROMPT_CACHING = "1"
claude --bare --model "notholy-pulse" --tools Read --max-turns 2 --no-session-persistence

Inicialização de diagnóstico somente leitura, com compatibilidade experimental com Claude Code. Use um terminal novo e uma pasta descartável com apenas um arquivo inofensivo. --bare ignora hooks pessoais, plugins e descoberta automática de CLAUDE.md. Read pode ler arquivos locais, mas não habilita Bash nem edições. Exige raciocínio high e pelo menos 32.000 tokens de saída no catálogo. O cliente instalado foi testado com resposta local sintética, não com um modelo real.

Referência de configuração: um exemplo gerado não certifica o cliente completo. Confira os limites acima. Mantenha chaves de API no ambiente privado.