Configurar Provedor de Modelo

Recomendamos usar o CC Switch para a configuração — uma ferramenta open source de gerenciamento de provedores com operação visual, sem necessidade de editar JSON ou variáveis de ambiente manualmente.

1. Instalar o CC Switch

macOS


brew install --cask cc-switch

Ou acesse Releases para baixar o .dmg e instalar manualmente.

Windows

Acesse Releases para baixar o instalador .msi.

Linux


# Debian / Ubuntu
sudo dpkg -i CC-Switch-*.deb
 
# Fedora / RHEL
sudo rpm -i CC-Switch-*.rpm
 
# AppImage
chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage

Compatível com macOS 12+, Windows 10+, Ubuntu 22.04+ / Debian 11+ / Fedora 34+

2. Adicionar Provedor OfoxAI

Passo 1: Adicionar novo provedor

Abra o CC Switch, acesse a página de gerenciamento de provedores e clique no botão + no canto superior direito.

Passo 2: Preencher a configuração

Preencha conforme indicado na imagem abaixo e clique em + Adicionar para concluir.

Campo	Valor	Descrição
❶ Nome do provedor	`ofoxai-claude`	Personalizável, para fácil identificação
❷ Site oficial	`https://ofox.ai`	Site do provedor
❸ API Key	Sua chave de API OfoxAI	Obtenha em app.ofox.ai
❹ URL de requisição	`https://api.ofox.ai/anthropic`	Não adicione barra no final
❺ Formato da API / Campo de autenticação	`Anthropic Messages (nativo)` / `ANTHROPIC_AUTH_TOKEN (padrão)`	Mantenha o padrão
❻ Configuração do modelo	Deixe em branco	Deixe em branco para usar o modelo Claude padrão
❼ Opções	Marque “Ocultar assinatura AI” e “Modo Teammates”	Marque conforme necessário
❽ Gravar na configuração global	✅ Marcar	Grava na configuração global, aplicável a todos os projetos

O CC Switch grava automaticamente em ~/.claude/settings.json, sem necessidade de editar qualquer arquivo manualmente.

Passo 3: Ativar o provedor

Após adicionar, volte à lista, selecione ofoxai-claude e clique no botão Usar. Quando aparecer a mensagem “Alternado com sucesso”, a configuração está concluída.

3. Verificar a Configuração

Acesse o diretório do projeto e inicie o Claude Code:


cd your-project
claude

Na primeira inicialização, pressione Esc para pular o login. Após iniciar, observe a barra de informações no topo e confirme que exibe API Usage Billing (❶), indicando que a cobrança está sendo feita pelo OfoxAI:

Se as informações acima estiverem corretas, a configuração foi bem-sucedida.

Solução de Problemas

Em caso de problemas, execute /status no terminal do Claude Code para verificar a configuração:


/status

Confirme os seguintes campos principais:

❶ Anthropic base URL deve ser https://api.ofox.ai/anthropic
❷ Model exibe o modelo atualmente em uso

P: Mensagem “Authentication error”

Confirme que o Anthropic base URL está correto e verifique se a API Key é válida.

P: Timeout de conexão

Confirme que a URL de requisição é https://api.ofox.ai/anthropic, sem barra no final.

P: Lentidão na resposta em streaming

O OfoxAI possui aceleração global integrada. Geralmente trata-se de um problema na rede local. Verifique sua conexão e tente novamente.