---
title: "Integrar com CC Switch"
description: "Adicione 1折AI no CC Switch usando uma configuração personalizada para alternar provedores no Claude Code com um clique, sem editar settings.json manualmente."
headingIds: {"Instalação":"section-1","Adicionar 1折AI ao Claude Code":"section-2","Obter a lista de modelos":"section-3","Codex":"section-4","Perguntas frequentes":"section-5"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentação mantida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fontes e correções](https://1zheai.com/en/editorial/).

Encontrou um erro? [Contate o suporte](mailto:support@1zheai.com) com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

</aside>
[CC Switch](https://github.com/farion1231/cc-switch) é uma ferramenta de área de trabalho que ajuda a gerenciar as configurações de provedores de ferramentas de linha de comando como Claude Code e Codex. Depois de adicionar uma vez, alternar entre a conta oficial, 1折AI e outros provedores leva apenas um clique.

## Instalação

- macOS: `brew install --cask cc-switch`
- Windows / Linux: baixe o instalador em [GitHub Releases](https://github.com/farion1231/cc-switch/releases)

## Adicionar 1折AI ao Claude Code

<Steps>
<Step title="Abrir página de adição">

Selecione **Claude Code** na barra lateral e clique em **Adicionar provedor** (símbolo +) no lado direito do cabeçalho da página.

</Step>
<Step title="Selecionar &quot;Configuração personalizada&quot;">

O 1折AI ainda não está na lista predefinida do CC Switch; selecione **Configuração personalizada** no topo da lista.

</Step>
<Step title="Preencher configuração">

Preencha o nome com `1折AI` e escreva no campo de edição da configuração `env`:

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}
```

Se quiser fixar o modelo ao mesmo tempo, adicione variáveis como `ANTHROPIC_MODEL`; a forma de escrita está na seção de mapeamento de modelos da [integração com Claude Code](/pt/docs/quickstart-claude-code/).

</Step>
<Step title="Salvar e ativar">

Clique em **Adicionar** no rodapé e, em seguida, habilite o 1折AI na lista de provedores. O CC Switch gravará a configuração no `~/.claude/settings.json` do Claude Code, e o Claude Code usará o novo provedor sem precisar reiniciar.

</Step>
<Step title="Confirmar">

Execute `/status` no Claude Code; a base URL deve ser `https://1zheai.com`. Envie outra mensagem e confirme o registro nos [logs de chamada](/pt/docs/usage-logs/) do console.

</Step>
</Steps>

<Note>

O exemplo oficial do CC Switch usa `ANTHROPIC_API_KEY`; ambas as variáveis funcionam. Recomendamos `ANTHROPIC_AUTH_TOKEN`; o motivo está na [integração com Claude Code](/pt/docs/quickstart-claude-code/).

</Note>

## Obter a lista de modelos

Ao editar um provedor, o botão **Obter lista de modelos** ao lado do campo de modelos usará sua chave de API (API key) para chamar `/v1/models`, listar os modelos disponíveis e permitir que você selecione um para preencher.

## Codex

O CC Switch também pode gerenciar os provedores do Codex. Para configurar a Base URL deste site, a chave de API e o modelo GPT, consulte a [integração com Codex CLI](/pt/docs/quickstart-codex/).

## Perguntas frequentes

<AccordionGroup>
<Accordion title="Após alternar, o Claude Code ainda usa o provedor antigo?">

Primeiro, confirme no CC Switch que o 1折AI está habilitado; depois, verifique se o terminal exportou `ANTHROPIC_BASE_URL` ou `ANTHROPIC_AUTH_TOKEN`. O Claude Code usa o settings.json como referência, mas variáveis antigas exportadas manualmente podem causar interpretações erradas; recomendamos limpá-las todas e deixar o gerenciamento unificado por meio do CC Switch.

</Accordion>
<Accordion title="Obter lista de modelos retorna 401?">

A chave de API foi preenchida incorretamente ou foi excluída. Copie a chave de API novamente, tomando cuidado para não incluir espaços.

</Accordion>
</AccordionGroup>