Skip to main content
O Claude Code é a ferramenta CLI da Anthropic para codificação agêntica. Este guia mostra como executá-lo através da Venice para acesso anonimizado e por token (pay-per-token) aos modelos Claude.

Pagamento por token

Sem assinatura. Pague apenas pelo que usar

Modelos Claude

Acesse os modelos Opus, Sonnet e Fable atuais através da Venice

Prompt caching

O cache da Venice funciona em conjunto com o Claude Code

​
Por que você precisa de um router

Por padrão, o Claude Code conecta-se diretamente à API da Anthropic. Para usá-lo com a Venice, você precisa do claude-code-router, um proxy local de código aberto que:

Intercepta

Captura as requisições de saída do Claude Code antes que cheguem à Anthropic

Transforma

Converte requisições Anthropic Messages para o formato de chat compatível com OpenAI da Venice

Redireciona

Encaminha as requisições para api.venice.ai/api/v1/chat/completions

​
Pré-requisitos

Conta Venice

Com créditos Venice

Node.js

v22 ou superior

Claude Code

Instalado via npm

​
Configuração

1

Instale ou atualize o Claude Code

Instale a versão mais recente do CLI do Claude Code:
2

Instale o Claude Code Router

3

Obtenha sua chave de API

Gere uma chave em venice.ai/settings/api. Você a adicionará ao CCR na próxima etapa.
4

Adicione a Venice como provedor

Inicie a interface de gerenciamento do CCR:
Na página Providers, escolha Add provider e depois Other / custom API endpoint. Informe:
  • Name: Venice
  • API endpoint: https://api.venice.ai/api/v1
  • API key: sua chave de API da Venice
O CCR deve detectar OpenAI Chat automaticamente. Se não detectar, abra Advanced settings, desative a detecção automática de protocolo e selecione OpenAI Chat.Use Search models ou Custom models para adicionar os modelos Claude que você deseja, depois execute Check Connection e salve o provedor. A verificação de conexão envia uma requisição real com limite de saída de um token.
5

Crie um perfil do Claude Code

Em Agent Config, escolha Add profile e depois Claude Code:
  • Nomeie o perfil como Claude Code - Venice.
  • Mantenha Effect scope definido como Only opened from CCR durante os testes.
  • Escolha CLI only ou CLI & APP.
  • Defina Model para um modelo da Venice, como Venice/claude-opus-4-8.
  • Para manter todos os níveis do Claude Code na Venice, defina os campos opcionais de modelo Fable, Opus, Sonnet e Haiku também para modelos da Venice.
Salve o perfil.
6

Inicie e verifique

Inicie o perfil pelo nome:
No Claude Code:
  1. Execute /context e confirme que a janela de contexto corresponde ao modelo selecionado. Para claude-opus-4-8, deve exibir 1M.
  2. Execute /model se quiser trocar para outro modelo da Venice; as variantes 1M são marcadas com 1M context.
  3. Envie uma mensagem de teste e depois verifique Request logs no CCR para confirmar que ela usou a Venice.

​
Modelos suportados

O catálogo muda com o tempo. Use Search models no CCR ou GET /models?type=text para a lista e os limites atuais.
O Claude Code é otimizado para modelos Claude. Embora outros modelos disponíveis na Venice (GPT, DeepSeek, Grok, etc.) possam funcionar, não podemos garantir uma experiência equivalente, já que o Claude Code depende de recursos específicos do Claude, como extended thinking. Para outros modelos, considere usar a API padrão da Venice.

​
Atualizando uma instalação existente

Atualize o CCR antes de solucionar problemas em uma instalação existente:
As versões atuais do CCR armazenam a configuração ativa em ~/.claude-code-router/config.sqlite. Um config.json mais antigo é importado quando o banco de dados não existe. Após a migração, faça as alterações através do ccr ui em vez de continuar editando o config.json. Se um processo em segundo plano continuar em execução após uma atualização, reinicie-o:

​
Prompt caching

O prompt caching da Venice funciona com os marcadores de cache nativos do Claude Code. Nenhum transformer de cache adicional é necessário para a configuração normal.

​
Solução de problemas

  1. Atualize o CCR com npm install -g @musistudio/claude-code-router@latest.
  2. Inicie uma nova sessão do Claude Code a partir do perfil do CCR.
  3. Execute /model e selecione a entrada da Venice marcada com 1M context.
  4. Execute /context e confirme que a janela é 1M, não 200K.
Versões mais antigas do CCR podem não expor a janela de contexto ou o uso de tokens corretos ao Claude Code.
Confirme que tem Node.js 22 ou mais recente e atualize o CCR:
Use ccr serve para executar em primeiro plano e expor o erro original de inicialização. Um stack Cannot read properties of undefined (reading 'error') vindo de server.logger.error indica uma instalação desatualizada do CCR; atualize-a antes de investigar mais.
Inicie o gateway e verifique sua integridade:
Uma verificação de integridade com falha significa que o gateway local do CCR está indisponível; a requisição não chegou à Venice.
Abra o ccr ui e faça a alteração por lá. As versões atuais do CCR armazenam a configuração em config.sqlite; o config.json é apenas uma fonte de migração para instalações mais antigas.

​
Recursos

Documentação da API Venice

Referência completa da API

claude-code-router

Código-fonte e issues

Versões do CCR

Versões atuais e notas de lançamento