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
| Parte | Fala | Função |
|---|---|---|
| CLI Claude Code | Formato Anthropic Messages | Planeja edições, chama ferramentas, mostra diffs |
| Proxy de tradução (local) | Ambos os formatos | Converte requisições e streams, mapeia nomes de modelos |
| Esta API | Chat Completions OpenAI | Executa 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_choiceetool_callsem streaming, com resultados retornados como mensagens comrole: "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.
