> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# CC Switch
O CC Switch é um gerenciador multiplataforma de configurações para ferramentas de programação com IA. Ele centraliza em um só lugar as configurações dos provedores de modelos de diferentes ferramentas, permitindo alternar entre backends de API com um clique, sem editar arquivos manualmente. É compatível com ferramentas populares como Claude Code, Claude Desktop, Codex e Gemini CLI, sendo adequado para desenvolvedores e equipes que alternam frequentemente entre serviços de modelos.
Ao conectar-se à Interface AI, você pode usar serviços de API acessíveis diretamente com o Claude Code e outros agentes no CC Switch. Não é necessário alterar o código do projeto: crie um provedor personalizado, informe o endpoint e a chave de API e salve.
## Principais recursos do CC Switch
### Gerenciamento visual de configurações
Todas as configurações dos provedores ficam armazenadas em um banco de dados local e podem ser criadas, editadas, consultadas e excluídas pela interface. Não é necessário editar arquivos JSON nem configurar variáveis de ambiente repetidamente.
### Troca com um clique
Mais de 50 provedores predefinidos estão disponíveis. A troca exige apenas um clique e entra em vigor sem reiniciar o agente.
### Gerenciamento unificado de várias ferramentas
* Claude Code e Claude Desktop
* Codex e Gemini CLI
* OpenCode, OpenClaw, Hermes e outras
* Sincronização entre aplicativos de serviços MCP, prompts e Skills
### Suporte multiplataforma
O CC Switch é compatível com Windows, macOS e Linux, incluindo as principais distribuições.
### Segurança das configurações
O sistema usa gravações atômicas e cria backups automaticamente. Os arquivos de configuração e os backups ficam em `~/.cc-switch/`, evitando danos às configurações existentes durante a troca.
## Conectar a Interface AI ao CC Switch
Conclua a integração em três etapas.
### 1. Obter uma chave de API
1. Acesse [jiekou.vip](https://jiekou.vip), faça o cadastro e abra o console de gerenciamento. Clique em “Minha conta” no canto superior direito e selecione “Gerenciamento de chaves de API”.
2. Clique em “Adicionar” e informe um nome para a chave. Use um nome reconhecível, como `CCSwitch`, para diferenciar as chaves por finalidade.
3. Copie e registre a chave gerada. O console não poderá exibi-la novamente; guarde-a com segurança para a próxima etapa.
### 2. Adicionar um provedor no CC Switch
1. Abra o CC Switch, selecione **Claude Code** à esquerda e clique em “Adicionar provedor” no canto superior direito.
2. Selecione “Configuração personalizada” na lista de predefinições e informe um nome, como “Interface AI”.
3. Informe a Base URL:
* Modelos Anthropic: `https://api.highway.ai/anthropic`
* Modelos OpenAI: `https://api.highway.ai/openai`
4. Informe a chave copiada na etapa anterior, obtenha a lista de modelos e selecione o modelo desejado.
5. Salve o provedor, selecione-o e clique em “Ativar”. O provedor ativo aparecerá na bandeja do sistema.
**Configuração de modelos da Anthropic:**
**Configuração de modelos da OpenAI:**
### 3. Verificar a configuração
Abra um terminal e execute `claude`. Se a conversa iniciar normalmente, a integração está funcionando. Depois de trocar de provedor no Claude Code, basta iniciar uma nova sessão, sem reiniciar o aplicativo.
Se ocorrer um erro, verifique:
* **404**: confirme se o caminho no final do endpoint está ausente ou duplicado.
* **401 ou 403**: volte ao console da Interface AI e confirme se a chave de API está ativa.
