> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4096bytes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CC Switch

> Importe o Provider 4096bytes para o CC Switch e gerencie clientes CLI

CC Switch é um gerenciador multiplataforma de configurações para CLIs de IA. Você pode usá-lo para gerenciar Providers de Claude Code, Codex, Gemini CLI, OpenCode e ferramentas semelhantes.

Depois de importar o 4096bytes para o CC Switch, Base URL, API Key e nomes de modelos ficam salvos em uma configuração local. Você pode alternar entre ferramentas CLI ou Providers sem editar variáveis de ambiente e arquivos de configuração repetidamente.

<Warning>
  A importação com um clique grava a API Key atual na configuração local do CC Switch. Use apenas no seu próprio computador. Não importe chaves em computadores compartilhados, máquinas remotas temporárias ou ambientes não confiáveis.
</Warning>

## Instalar

CC Switch é open source no GitHub: [`farion1231/cc-switch`](https://github.com/farion1231/cc-switch).

<Steps>
  <Step title="Abrir Releases">
    Abra a página [`farion1231/cc-switch` Releases](https://github.com/farion1231/cc-switch/releases) e veja a versão mais recente.
  </Step>

  <Step title="Baixar o pacote correto">
    Escolha o pacote do seu sistema:

    * macOS: `.dmg`
    * Windows: `.msi`
    * Linux: `.AppImage` ou `.deb`.
  </Step>

  <Step title="Instalar e abrir uma vez">
    Conclua a instalação. Abra o CC Switch pelo menos uma vez para que o navegador consiga acioná-lo durante a importação.
  </Step>
</Steps>

## Importação com um clique

Prefira a importação com um clique quando disponível. Ela grava o Provider no CC Switch local sem copiar cada campo manualmente.

<Steps>
  <Step title="Confirmar que o CC Switch está instalado">
    Verifique se o CC Switch está instalado e já foi aberto pelo menos uma vez.
  </Step>

  <Step title="Abrir API Keys">
    Abra o painel e encontre, na página **API Keys**, a chave que deseja importar.
  </Step>

  <Step title="Clicar em Import to CCS">
    Clique em **Import to CCS** na linha da chave. Se o sistema perguntar se pode abrir o CC Switch, permita.

    <img src="https://mintcdn.com/4096bytes/92zL9C5RTBxmIwvG/images/screenshots/clients/cc-switch/ccs-import-button.png?fit=max&auto=format&n=92zL9C5RTBxmIwvG&q=85&s=6553319b327746384fdfa1bcb39eeac6" alt="Botão Import to CCS" width="720" style={{ maxWidth: "100%", height: "auto" }} data-path="images/screenshots/clients/cc-switch/ccs-import-button.png" />
  </Step>

  <Step title="Confirmar a importação">
    Revise as informações do Provider no CC Switch e confirme a importação.

    <img src="https://mintcdn.com/4096bytes/92zL9C5RTBxmIwvG/images/screenshots/clients/cc-switch/import-to-ccs.png?fit=max&auto=format&n=92zL9C5RTBxmIwvG&q=85&s=d3c3e15c9b90ddaa75e43c7f70d6a7b7" alt="Confirmação de importação no CC Switch" width="720" style={{ maxWidth: "100%", height: "auto" }} data-path="images/screenshots/clients/cc-switch/import-to-ccs.png" />
  </Step>
</Steps>

Depois da importação, o CC Switch salva a configuração do Provider para a API Key selecionada. Se você excluir ou trocar a chave, importe novamente ou atualize a configuração manualmente.

## Adicionar Provider manualmente

Se a importação com um clique não estiver disponível, adicione o Provider 4096bytes manualmente no CC Switch.

| Campo no CC Switch   | Valor                                                 |
| -------------------- | ----------------------------------------------------- |
| Provider predefinido | Escolha configuração personalizada.                   |
| ID do Provider       | Use `4096bytes`.                                      |
| Nome do Provider     | Use `4096bytes`.                                      |
| Link oficial         | `https://www.4096bytes.com`                           |
| Endpoint da API      | `https://api.4096bytes.com` (não habilite "Full URL") |
| API Key              | A API Key criada no painel.                           |

<Tip>
  Copie o Base URL e o nome do modelo no painel. Não use capturas antigas, conversas ou configurações de outros usuários.
</Tip>

## Verificar

Depois da importação ou configuração manual, alterne para o Provider 4096bytes no CC Switch e faça um teste de baixo risco.

<img src="https://mintcdn.com/4096bytes/92zL9C5RTBxmIwvG/images/screenshots/clients/cc-switch/ccs-test.png?fit=max&auto=format&n=92zL9C5RTBxmIwvG&q=85&s=683226b076ef51b67b598018f5a582c8" alt="Teste de modelo no CC Switch" width="720" style={{ maxWidth: "100%", height: "auto" }} data-path="images/screenshots/clients/cc-switch/ccs-test.png" />

## Diagnóstico

* Se o navegador não abrir o CC Switch, confirme que ele está instalado e já foi iniciado uma vez.
* Se a autenticação falhar depois da importação, crie uma nova API Key e importe novamente.
* Se um cliente CLI não usar o novo Provider, confirme que ele é gerenciado pelo CC Switch e reinicie o terminal após a troca.