CC Switch

Três campos e dois menus suspensos. https://api.kunavo.com como endpoint, sua chave sk-kn-… e — o detalhe que a maioria dos guias omite — deixe API Format em Anthropic Messages (Native) e Auth Field em ANTHROPIC_AUTH_TOKEN. Kunavo oferece suporte nativo à API Messages, então não há roteamento local no lado do Claude Code.

Provider Name   Kunavo
API Key         sk-kn-...
API Endpoint    https://api.kunavo.com      <- service root, no /v1, no trailing slash

Advanced Options
  API Format    Anthropic Messages (Native) <- the default; do NOT switch
  Auth Field    ANTHROPIC_AUTH_TOKEN (Default)

Passo a passo (aba Claude Code)

1. Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
2. Abra o CC Switch na aba principal Claude Code e clique no botão de adição. Mantenha a opção padrão Custom Configuration em vez de escolher uma predefinição.
3. Preencha Provider Name, API Key e API Endpoint = https://api.kunavo.com.
4. Expanda Advanced Options e confirme se API Format está em Anthropic Messages (Native) e Auth Field em ANTHROPIC_AUTH_TOKEN (Default). Esses são os valores padrão; a ideia é conferir, não alterar.
5. Salve e depois Activate. O cartão não deve exibir um indicador Needs Routing — esse indicador só aparece nos provedores cujo protocolo precisa ser traduzido.

Por que não há o indicador “Requer roteamento”

O roteamento local do CC Switch existe para fazer a ponte entre protocolos. O Claude Code envia solicitações Anthropic Messages para /v1/messages; um gateway que oferece apenas OpenAI Chat Completions ou a API Responses não pode atendê-las, então a rota converte a solicitação na saída e converte a resposta no retorno. Essa conversão reformata os eventos de streaming, as chamadas de ferramentas e a configuração de raciocínio — funciona, mas acrescenta mais uma etapa entre o editor e o modelo.

Kunavo oferece POST /v1/messages diretamente, então não há nada para converter no lado do Claude Code: o provedor permanece em Anthropic Messages (Native) e a rota nem chega a ser usada. Kunavo também oferece POST /v1/chat/completions e POST /v1/responses com a mesma chave, o que possibilita a configuração para o Codex descrita abaixo.

Executar modelos Claude no Codex

Esta é a configuração que os guias dos outros provedores não abordam. O Codex usa a API OpenAI Responses, então apontá-lo diretamente para um endpoint /v1/messages retorna 404 — o CC Switch resolve isso mantendo o Codex na rota local e fazendo a tradução. Na aba Codex, não há predefinição Anthropic, então esta também é uma Custom Configuration:

Provider Name      Kunavo
API Key            sk-kn-...
API Request URL    https://api.kunavo.com
Default Model      claude-sonnet-5

Advanced Options
  Upstream Format  Anthropic Messages (routing required)

Mapeamento de modelos

O CC Switch mapeia as três categorias do Claude Code para IDs de modelos reais. Preencha as três e também Default fallback model — caso contrário, solicitações sem correspondência são encaminhadas com o nome original do Claude e geram erro no serviço de origem. As tarifas são em USD por 1 milhão de tokens, entrada / saída, consultadas em tempo real no catálogo.

Verifique antes de depurar o aplicativo

Um par de solicitações basta para determinar se a falha está na chave, no endpoint ou no CC Switch. Se ambas retornarem 200, qualquer problema restante está em um campo do formulário — quase sempre é Auth Field ou um /v1 que não deveria estar no endpoint.

# Settles whether a failure is the key, the endpoint, or CC Switch.
# 200 + a JSON list of model ids means the same key works in the app.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

# The Anthropic face, which is the one the Claude Code tab actually calls.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":16,
       "messages":[{"role":"user","content":"ping"}]}'

Referência

O CC Switch é de código aberto em github.com/farion1231/cc-switch. Os nomes dos campos e o comportamento acima vêm dos próprios guias — o guia de roteamento do Claude Code e o guia de roteamento do Codex —, ambos aplicáveis à versão 3.17.0 e posteriores. Em versões mais antigas, o formulário é diferente; consulte a seção Sobre do aplicativo se algum campo mencionado aqui não aparecer. A documentação do lado da Kunavo está em API Messages, chat completions e central de integrações.