CC-Switch Codex
Esta página aborda o gerenciamento de provedores (providers) do Codex por meio do CC Switch. Isso não é o mesmo que a configuração direta no cliente Codex ou na CLI do Codex: o foco aqui é primeiro gerenciar os provedores no CC Switch e, em seguida, aplicá-los ao Codex.
Informações oficiais Downloads e documentação estão sujeitos ao site oficial.
O que esta página explica
O Codex geralmente opera por meio de interfaces da OpenAI ou compatíveis com a OpenAI, portanto, concentre-se em verificar três itens: Base URL, Key e o nome do modelo. Se a Base URL precisa incluir /v1 depende do que é exibido no painel do provedor.
Verificações antes de começar
| O que verificar | Como verificar | Por quê |
|---|---|---|
| O Codex abre normalmente | Primeiro, confirme se a CLI do Codex ou o cliente correspondente consegue ser executado | O CC Switch não instala o Codex para você |
| O provedor oferece suporte a interfaces compatíveis com a OpenAI | O painel exibe endereço de API, Base URL, compatibilidade com OpenAI e outras instruções | O Codex precisa ser capaz de fazer requisições à interface compatível |
| O modelo pode ser usado em cenários do Codex | O nome do modelo disponível pode ser visto na lista de modelos do painel | Não insira nomes de modelos Claude/Gemini no Codex |
| O status da Key está normal | O token no painel não está expirado, nem desativado, e o saldo está normal | A maioria dos erros 401 deve ser investigada verificando a Key primeiro |
Como preencher os campos
| Configuração | Como preencher | Atenção iniciantes |
|---|---|---|
| Nome do Provedor | Escreva o nome do provedor ou sua finalidade | Por exemplo: 'Provedor compatível com OpenAI principal' |
| Ferramenta de Destino / Preset | Selecione o Codex ou presets relacionados a OpenAI/Codex | Não selecione Claude Code ou Gemini |
| Base URL | Copie o link da API fornecido no painel do provedor | Geralmente, é o endereço de API fornecido pelo provedor; para saber se deve incluir /v1, siga o exemplo do painel |
| API Key | Copie a chave completa | Não adicione espaços extras antes ou depois e não a copie como nome de observação |
| Nome do Modelo | Copie exatamente como consta na lista de modelos do painel | Se a obtenção da lista de modelos falhar, adicione manualmente, ainda copiando exatamente o nome do painel |
Aplicar ao Codex
- Abra o CC Switch e acesse a área de gerenciamento de provedores (Providers).
- Adicione um novo provedor ou escolha um provedor compatível com OpenAI já existente.
- Selecione o Codex ou presets relacionados a OpenAI/Codex como a ferramenta de destino.
- Preencha a Base URL, a API Key e o nome do modelo e salve.
- Execute Apply / Switch para aplicar este provedor ao Codex.
- Feche a janela atual do terminal, abra-a novamente e faça o teste.
Testar se está funcionando
Primeiro, teste a requisição com uma pergunta o mais curta possível para verificar se ela passa. Depois que o teste for bem-sucedido, prossiga para usá-lo em seu projeto real.
Teste Mínimo do Codex
codex "Please reply only: CC-Switch Codex is active"Se o retorno indicar que o modelo não existe, verifique primeiro o nome do modelo; se o retorno for de não autorizado (unauthorized), verifique primeiro a Key; se houver tempo limite de conexão (timeout), verifique primeiro a Base URL e a rede.