Recursos para Desenvolvedores

CC Switch

Instale o CC Switch, adicione um Provedor Claude Code do RunAPI, escolha um modelo e verifique a conexão.

Visão geral

CC Switch é uma aplicação desktop para gerenciar Provedores de ferramentas de codificação. Este guia conecta seu Claude Code Provider ao RunAPI sem editar seu perfil de shell ou arquivos de projeto manualmente.

Antes de começar

Instale o Claude Code e entre na sua conta RunAPI.
Crie uma Chave de API padrão no Guia de Autenticação. Mantenha-a no CC Switch; não a adicione ao controle de versão.
Utilize um identificador de modelo RunAPI disponível por meio desta conexão. Você pode selecionar um no CC Switch ou copiá-lo do Catálogo de Modelos.

Instalar

Baixe o CC Switch nas suas versões oficiais para Windows, macOS ou Linux. No macOS com Homebrew, instale com:

SHELL

brew install --cask cc-switch

Abra o CC Switch após a instalação e selecione Claude Code no alternador de aplicativos.

Configurar o RunAPI

Selecione Add Provider e escolha o preset Custom.
Nomeie o provedor RunAPI e insira sua Chave de API e Base URL no editor de configuração:

JSON

{
  "env": {
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_BASE_URL": "https://runapi.ai"
  }
}

A Chave de API acima é um placeholder. Crie e faça a rotação da sua chave real pelo Guia de Autenticação.

Escolher um modelo

Use Fetch Models apenas para descobrir candidatos. Se o modelo não estiver listado, copie seu identificador do Catálogo de Modelos. A busca não atribui modelos às funções de requisição do Claude Code.
Defina o identificador escolhido como Default fallback model e selecione Quick Set. Isso aplica o identificador a cada linha de Actual Request Model: Sonnet, Opus, Fable, Haiku e Subagent.
Antes de salvar, confirme que cada linha exibe o identificador RunAPI pretendido. O CC Switch persiste esse mapeamento como ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_FABLE_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL e CLAUDE_CODE_SUBAGENT_MODEL.
Salve o provedor, selecione-o na lista de provedores e ative-o.

Verificar

Abra um novo terminal em um diretório de projeto e inicie o Claude Code:

SHELL

claude

Execute /status para inspecionar o modelo ativo, depois envie um prompt curto como Describe this repository in one sentence. Uma resposta normal confirma que o CC Switch está usando o Provedor RunAPI ativo.

Solucionar problemas

A autenticação falha: verifique a Chave de API no Provider ativo do CC Switch, depois crie uma nova chave pelo Guia de Autenticação se necessário.
O modelo esperado está indisponível: atualize o seletor de modelos ou copie um identificador de modelo suportado do Catálogo de Modelos, defina-o como Modelo de fallback padrão e selecione Quick Set novamente.
Claude Code ainda usa outro Provider: ative o Provider RunAPI no CC Switch e abra uma nova sessão de terminal. Verifique a documentação de providers do CC Switch para conflitos de ambiente.

Próximas etapas

Para seleção de protocolo e comportamento das requisições, use o Início rápido da API LLM . Para campos de requisição e resposta, use a Referência da API Anthropic Messages . Para adicionar ferramentas RunAPI ao Claude Code, continue com a Visão geral do MCP.