PT ▾

InícioGuia

Proxy Claude Code: use uma API LLM compatível com OpenAI

Um proxy Claude Code é um pequeno servidor que fica entre a CLI e a API do modelo e traduz as requisições. Você precisa de um porque o Claude Code usa o formato Anthropic e esta API usa o formato OpenAI.

Uma caixa de tradução entre um terminal e um servidor, mostrando um proxy convertendo requisições entre dois formatos de API

Pontos principais

  1. O Claude Code envia requisições no estilo Anthropic; esta API aceita requisições no estilo OpenAI
  2. Um proxy de tradução como o LiteLLM fica no meio e mapeia os nomes dos modelos
  3. O modelo por trás dele é um modelo de pesos abertos, não o Claude, então teste-o nas suas próprias tarefas
  4. Uma sessão de codificação com 30 requisições de 20.000 tokens de entrada e 800 de saída custa cerca de $0,10

O que o proxy faz

Um proxy claude code é qualquer servidor que você executa entre a CLI de codificação da Anthropic e o modelo que responde. O Claude Code lê uma variável de ambiente para o endereço da API e envia suas requisições para lá. Se esse endereço for um proxy, o proxy decide o que realmente acontece: ele pode registrar o tráfego, adicionar regras ou encaminhar a chamada para um modelo diferente.

O detalhe-chave é o formato de rede. O Claude Code usa o formato Messages da Anthropic. A API em https://api.claudecodeproxyapi.com/v1 usa o formato Chat Completions da OpenAI, com o ID do modelo uncensored. Os dois são semelhantes em espírito, mas não são intercambiáveis, então você não pode colar nossa URL diretamente no Claude Code. Uma camada de tradução precisa reescrever cada requisição e cada resposta, incluindo chunks de streaming e chamadas de ferramentas.

O que fica onde

ParteFalaFunção
CLI Claude CodeFormato Anthropic MessagesPlaneja edições, chama ferramentas, mostra diffs
Proxy de tradução (local)Ambos os formatosConverte requisições e streams, mapeia nomes de modelos
Esta APIChat Completions OpenAIExecuta o modelo de pesos abertos, cobra por token

Projetos da comunidade lidam com a parte do meio. O proxy do LiteLLM e o claude-code-router são dois que têm documentação pública para esse fim. Ambos são software de terceiros, então verifique sua documentação atual para versões e flags suportadas antes de construir sobre eles. Se algo falhar no caminho, o guia de solução de problemas do proxy é o lugar para começar, e este site também tem um artigo separado de configuração passo a passo.

Antes de configurar: seja honesto sobre o modelo

O Claude Code foi construído em torno dos próprios modelos da Anthropic. Trocar por um modelo diferente altera o comportamento, e nenhum proxy pode esconder isso. O modelo aqui é um modelo de pesos abertos executado por um provedor independente e ajustado para responder sem recusas de conteúdo para uso adulto legal. Não é o Claude, e não é uma API oficial da Anthropic ou de qualquer outro fornecedor.

O que ele oferece para trabalho estilo agente:

  • Chamada de ferramentas com tools, tool_choice e tool_calls em streaming, com resultados retornados como mensagens com role: "tool".
  • Uma janela de contexto de 100.000 tokens, incluindo prompt e conclusão.
  • Modo JSON com response_format, e streaming via SSE.

O que você deve verificar por conta própria: o quão bem ele segue um loop de agente longo, com que frequência ele faz chamadas de ferramentas malformadas e como ele lida com seu idioma e framework. Execute três ou quatro tarefas reais do seu repositório antes de migrar um fluxo de trabalho inteiro. O crédito de teste de $0,50, reivindicado com um clique após entrar, é suficiente para isso.

Teste o upstream primeiro

Antes de mexer no Claude Code, confirme que o lado da API funciona com uma requisição simples, incluindo uma chamada de ferramenta, já que agentes dependem disso:

curl https://api.claudecodeproxyapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the files in the src folder."}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "list_files",
        "description": "List files in a directory",
        "parameters": {
          "type": "object",
          "properties": {"path": {"type": "string"}},
          "required": ["path"]
        }
      }
    }],
    "tool_choice": "auto"
  }'

Uma boa resposta contém uma entrada tool_calls com list_files e uma string de argumento JSON. Se você ver isso, o upstream está pronto e qualquer problema posterior pertence à configuração do proxy ou da CLI.

Duas rotas, e quando escolher cada uma

Rota 1: um proxy de tradução para o Claude Code

Escolha isso se você gosta da interface do Claude Code, de seus prompts de permissão e de seu fluxo de trabalho, e quer um modelo diferente por trás. Você executa o proxy localmente, aponta a CLI para ele e mapeia os nomes de modelo que a CLI envia para uncensored. As variáveis exatas estão cobertas na documentação e no artigo de configuração.

Rota 2: um cliente que já fala OpenAI

Vários assistentes de codificação e extensões de editor de código aberto, incluindo Aider, Continue e Cline, podem usar qualquer endpoint compatível com OpenAI diretamente. Você insere a base URL, a chave e o nome do modelo e não há camada de tradução para manter. Se você não precisa especificamente da interface do Claude Code, este é o caminho mais curto e tem menos partes que podem falhar.

Uma regra prática: escolha a rota 2 para uma avaliação rápida do modelo no código, e a rota 1 quando sua equipe já depende do fluxo de trabalho do Claude Code.

Custo de uma sessão de codificação

Agentes reenviam muito contexto, então tokens de entrada dominam a conta. Considere uma sessão de 30 requisições, cada uma com 20.000 tokens de entrada (arquivos, histórico, saída de ferramentas) e 800 tokens de saída:

  • Entrada: 30 x 20.000 = 600.000 tokens, que é 0,6 x $0,15 = $0,09
  • Saída: 30 x 800 = 24.000 tokens, que é 0,024 x $0,50 = $0,012
  • Total: $0,102

Os preços são $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída. O faturamento é feito a partir de crédito pré-pago sem assinatura, requisições falhas ou recusadas não são cobradas, e o crédito nunca expira. Recargas variam de $20 a $500 com bônus de +5% a partir de $50, +10% a partir de $100 e +15% a partir de $200. Este site aceita recargas por cripto (USDT na TRC20, USDC na Base). A página de preços tem a tabela completa, e a página de chaves é onde você se cadastra com Google ou e-mail.

Limites que afetam loops de agente

Uma chave completa permite 8 requisições simultâneas e 300 requisições por minuto. A chave de teste permite 2 simultâneas e 60 por minuto. Agentes que ramificam subtarefas podem atingir o limite de concorrência primeiro. A API então responde HTTP 429 com o código concurrency, enquanto o limite de taxa de requisições retorna rate_limited. Uma sobrecarga temporária também retorna 429, com Retry-After: 5. Um bom proxy tenta novamente em 429 após o atraso, e uma requisição em streaming mantém seu slot até o fim do stream, então streams travados contam contra você.

O corpo da requisição pode ter até 8 MB. Tenha isso em mente se sua ferramenta colar arquivos grandes em prompts, e mantenha o prompt inteiro dentro da janela de 100.000 tokens.

Notas de segurança para um proxy local

Um proxy armazena sua chave upstream, então trate-a como qualquer outra credencial. Vincule-a ao localhost, e não a todas as interfaces de rede, a menos que você realmente precise que outras máquinas acessem o proxy. Armazene a chave em uma variável de ambiente ou em um gerenciador de segredos, em vez de em um arquivo que será incluído no controle de versão. Se você compartilhar um proxy entre uma equipe, atribua uma chave mestra própria a ele para que você possa rotacioná-la sem alterar a chave upstream.

Lembre-se também do que um agente envia. Uma CLI de codificação encaminha o conteúdo dos arquivos, a saída de comandos e seus prompts para o modelo. Os prompts não são usados para treinamento aqui, mas você ainda deve manter segredos, como chaves privadas e arquivos .env, fora do diretório de trabalho que o agente pode ler.

Uma maneira justa de avaliar o modelo no seu código

Escolha três tarefas de dificuldade crescente em um repositório real: uma correção em um único arquivo, uma alteração que toque três arquivos e uma pequena refatoração com testes. Execute cada tarefa duas vezes com o mesmo prompt: uma vez com seu modelo atual e outra com uncensored, e anote quatro aspectos: as edições foram aplicadas corretamente, as chamadas de ferramentas foram analisadas com sucesso, quantas tentativas foram necessárias e qual foi o custo de cada execução. Uma hora disso vale mais do que qualquer ranking.

Se o modelo de pesos abertos não for suficiente para a tarefa mais difícil, você ainda pode encontrá-lo adequado para tarefas mais simples, como redigir testes, escrever mensagens de commit ou explicar código desconhecido. Como a cobrança é pagamento por uso a partir de crédito pré-pago e não há assinatura, não há penalidade por usá-lo apenas para essas tarefas.

Perguntas e respostas

O Claude Code pode usar esta API sem um proxy?

Não. O Claude Code envia solicitações no formato Anthropic e esta API aceita solicitações no formato OpenAI, portanto, é necessária uma camada de tradução entre eles.

O modelo se comportará como o Claude?

Não. É um modelo de pesos abertos de um provedor independente. Teste-o em suas próprias tarefas antes de confiar nele.

A API oferece suporte à chamada de ferramentas?

Sim. Ela oferece suporte a ferramentas, tool_choice e tool_calls em streaming, e você retorna os resultados como mensagens com role tool.

Existe uma opção mais fácil do que um proxy?

Sim. Assistentes de codificação que aceitam um endpoint compatível com OpenAI, como Aider, Continue ou Cline, podem se conectar diretamente à base URL.

Quanto custa para testar?

Novos usuários podem reivindicar $0,50 de crédito de teste com um clique após o cadastro. É válido por 7 dias e não precisa de cartão.

Sua chave está a um formulário de distância

Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.