Codex/ChatGPT
Recomendamos usar o CC Switch para gerenciar a configuração de Provider do Codex/ChatGPT. Salve getapi.one e getapi.pro como Providers separados para alternar serviços ou modelos sem editar a Key manualmente.
TIP
Caminho recomendado: instale primeiro o CC Switch, prepare o cliente Codex/ChatGPT que deseja usar e adicione o GetAPI como Provider compatível com OpenAI.
Neste guia, Codex/ChatGPT cobre a experiência atual dos clientes relacionados ao Codex e os fluxos do app de desktop ChatGPT.
Download e instalação
Baixar CC Switch
Use primeiro o pacote CDN. Se seu sistema precisar de outra versão, use a página CC Switch Releases como alternativa.
| Cliente | Sistema / cenário | Download CDN | Alternativa |
|---|---|---|---|
| CC Switch | macOS | Baixar | GitHub Releases |
| CC Switch | Windows | Baixar | GitHub Releases |
| CC Switch | Mais versões | — | GitHub Releases |
Baixar Codex/ChatGPT
Para a experiência de desktop atual, use o app de desktop ChatGPT. Se precisar do cliente Codex separado, baixe o pacote correspondente abaixo; usuários de Mac Intel também podem usar OpenAI Codex Releases.
| Cliente | Sistema / cenário | Download recomendado | Oficial / alternativa |
|---|---|---|---|
| App de desktop ChatGPT | macOS / Windows / Linux | Download oficial | Documentação |
| Cliente Codex | macOS Apple Silicon | Baixar | GitHub Releases |
| Cliente Codex | macOS Intel | Baixar | GitHub Releases |
| Cliente Codex | Windows | Baixar | GitHub Releases |
| Extensão Codex IDE | VS Code / Cursor / Windsurf / JetBrains | Documentação | Documentação |
Para uso no terminal, leia o guia de configuração do Codex CLI.
Antes de começar
- O CC Switch está instalado.
- O app de desktop ChatGPT, cliente Codex ou extensão IDE que você usará está instalado.
- Cadastro e login no GetAPI foram concluídos. Caso contrário, comece pela visão geral de cadastro e login.
- Uma API Key do GetAPI foi criada. Caso contrário, leia a visão geral de API Key.
- Confirme se usará getapi.one ou getapi.pro.
- Confirme o nome do modelo que deseja usar.
Escolha um serviço GetAPI
API Key e Base URL devem vir do mesmo serviço. No Codex e no CC Switch, a Base URL precisa incluir /v1. Não misture Key do getapi.one com o endereço relay do getapi.pro, nem o contrário.
| Serviço | Codex Base URL | Origem da API Key | Guia de solicitação |
|---|---|---|---|
| getapi.one | https://www.getapi.one/v1 | getapi.one API Keys | Guia de solicitação |
| getapi.pro | https://relay-api.getapi.pro/v1 | getapi.pro API Keys | Guia de solicitação |
Configurar com CC Switch
1. Abrir o CC Switch
Inicie o CC Switch e prepare-se para entrar na área de configuração do Provider do Codex.
2. Abrir a aba de Provider do Codex
No CC Switch, selecione a aba de Provider do Codex e clique no botão de mais para adicionar um novo Provider.
3. Escolher configuração personalizada
Na página de adicionar Provider, selecione configuração personalizada. Se não aparecer, role para baixo.
4. Preencher o Provider GetAPI
Informe um nome, cole a API Key correspondente e preencha o endereço API com /v1, por exemplo https://relay-api.getapi.pro/v1.
| Item de configuração | getapi.pro | getapi.one | Observações |
|---|---|---|---|
| Nome do Provider | GetAPI Pro | GetAPI One | Nome personalizado para facilitar a identificação. |
| Site oficial | https://www.getapi.pro | https://www.getapi.one | Site do Provider. Pode ficar vazio se o CC Switch não exigir. |
| API Key | API Key de getapi.pro | API Key de getapi.one | Copie a Key do serviço correspondente. Não misture Keys e endereços de serviços diferentes. |
| Endereço de requisição API | https://relay-api.getapi.pro/v1 | https://www.getapi.one/v1 | Deve incluir /v1. |
| Modelo padrão | Por exemplo gpt-5.6-sol | Por exemplo gpt-5.6-sol | Use um modelo habilitado no console GetAPI correspondente. |
5. Ativar o Provider
Depois de salvar, volte à lista de Providers e ative o Provider GetAPI que acabou de adicionar.
Verificar a conexão
1. Verificar no Codex/ChatGPT
Abra o Codex/ChatGPT e envie uma mensagem curta. Se o modelo responder normalmente, o Provider está disponível.
Problemas comuns
| Problema | Causa possível |
|---|---|
| 401 / Unauthorized | A API Key está incorreta, desativada ou não corresponde ao endereço do serviço escolhido. |
| 404 / Not Found | A Base URL está incorreta, falta /v1 ou o cliente adicionou um caminho incompatível. |
| Model not found | O nome do modelo está incorreto ou o grupo escolhido não habilita esse modelo. |
| Sem resposta ou timeout | Problema de saldo, cota, limite de taxa, rede ou disponibilidade do serviço. |
Dicas de segurança
Nunca coloque API Keys em capturas públicas, repositórios públicos, código frontend ou documentos compartilhados. Oculte Keys, conta e saldo antes de compartilhar capturas para suporte.
Referências
A documentação oficial da OpenAI traz referências para ChatGPT App, Codex CLI e extensão Codex IDE. Os links CDN acima são mirrors fornecidos pelo projeto.