Tutorial de configuração com um clique do CC-Switch (recomendado para iniciantes)

Primeira escolha recomendada para iniciantes!

O CC-Switch é uma ferramenta de configuração com um clique projetada especialmente para usuários sem experiência — não é preciso editar arquivos de configuração manualmente, a operação é feita em interface gráfica e a alteração de canal fica pronta em poucos segundos.

Etapas de configuração

1. Baixe e instale o CC-Switch

• Windows: acesse CC-Switch GitHub Releases e baixe o instalador .msi
• macOS (Homebrew):

brew tap farion1231/ccswitch
brew install --cask cc-switch

• Linux: baixe o pacote .deb na página Releases e instale-o

Após o download, conclua a instalação localmente.

2. Abra o programa e selecione a CLI a ser configurada

Inicie o CC-Switch, selecione na tela principal a ferramenta que você quer configurar (como Claude Code, Codex etc.) e clique em "Adicionar provedor" para fazer a configuração.

3. Preencha as informações do provedor

• Nome do provedor: preencha NextHub
• Endereço da requisição: para Claude Code, use https://api.nexthub.cc; para Codex, use https://api.nexthub.cc/v1
• Formato da API: configure de acordo com o tipo de CLI que você escolheu
• API Key: preencha a chave que você gerou no console

O endereço de requisição precisa incluir /v1?

O Claude Code usa o protocolo Anthropic e anexa /v1/messages automaticamente ao endereço, portanto basta informar o domínio puro; a Codex usa o protocolo OpenAI Responses (/v1/responses), portanto o endereço de requisição precisa incluir /v1.

Depois de preencher, clique no botão "Adicionar" no canto inferior direito para salvar a configuração.

4. Confirme que o canal está ativo

Volte à tela principal, verifique o canal em uso no momento e garanta que já foi alternado para o canal NextHub que você acabou de configurar.

5. Pular a confirmação da primeira instalação do Claude Code (opcional)

Na tela principal, clique no botão "Configurações", entre na página de configurações gerais, encontre "Pular a confirmação da primeira instalação do Claude Code" e garanta que essa opção esteja ativada.

6. Validação executando no terminal

Abra o terminal, execute claude ou codex para uma conversa simples e veja se a configuração está normal. Se receber uma resposta, a configuração foi um sucesso 🎉

claude

Também é possível configurar o Claude Desktop

O CC-Switch já vem com um painel do Claude Desktop e suporta a importação com um clique dos provedores existentes no Claude Code; depois de alternar, lembre-se de reiniciar completamente o Claude Desktop. Veja os passos detalhados em tutorial de configuração do Claude Desktop.

Destaques do CC-Switch

Alteração de configuração de API com um clique, gerenciamento visual de configurações, gerenciamento de servidores MCP, operações rápidas pela bandeja do sistema, suporte a proxy local com alteração a quente, failover totalmente automático de canais.