Source: https://aiprimetech.io/pt/docs/guides/codex-cli/

[Documentação](/pt/docs/) / [API do Codex](/pt/codex-api/)

# Codex CLI: configuração de chave de API e provedor personalizado 

Use este guia para conectar o trabalho local na Codex CLI à AI Prime Tech. Você precisa de uma conta no gateway, uma chave ativa no grupo Codex desejado e um modelo disponível para essa chave. Comece pela [visão geral da API do Codex](/pt/codex-api/) se ainda estiver escolhendo um tipo de acesso. 

## 1. Verifique a chave e o grupo 

Crie uma chave no painel. O acesso pré-pago ao GPT usa o grupo Codex grupo. Se houver acesso ao Codex por tempo determinado, use o grupo e os termos indicados para esse plano; o acesso ao Claude é separado. Confirme a lista de modelos da chave que você usará. 

Defina a chave no terminal atual. Substitua o valor de exemplo localmente; não inclua a chave em um commit no repositório. 

PowerShell 

```
$env:AIPRIMETECH_API_KEY = "YOUR_GATEWAY_KEY"

```

bash ou zsh 

```
export AIPRIMETECH_API_KEY="YOUR_GATEWAY_KEY"

```

Reinicie um terminal ou editor iniciado antes de você definir seu ambiente caso ele não consiga acessar a variável. Estes exemplos a definem para o processo atual e seus processos filhos. 

## 2. Configure o provedor 

Mescle este conteúdo no seu arquivo de configuração de usuário ~/.codex/config.toml. No Windows, o caminho equivalente é %USERPROFILE%\.codex\config.toml. As credenciais do provedor devem ficar na configuração do usuário, não no arquivo do repositório .codex/config.toml. 

```
model_provider = "aiprimetech"
model = "gpt-6.1-sol"

[model_providers.aiprimetech]
name = "AI Prime Tech"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIMETECH_API_KEY"
wire_api = "responses"
supports_websockets = false

```

Use um ID de provedor como aiprimetech e mantenha model_provider correspondente à sua tabela. O Codex atual usa o protocolo Responses. A URL base é a raiz do gateway /v1 ; o Codex adiciona o caminho da requisição. Esta configuração usa transporte HTTP/SSE. 

## 3. Verifique a conexão 

Execute codex doctor para inspecionar a configuração da CLI. Inicie codexe depois use /status para confirmar o provedor e o modelo. Peça uma resposta curta antes de permitir uma tarefa maior no repositório. Verifique se a requisição aparece na sua página de uso da AI Prime Tech. 

Você pode inspecionar a lista de modelos da chave independentemente do Codex: 

```
Invoke-RestMethod -Uri "https://aiprimetech.io/v1/models" -Headers @{Authorization="Bearer $env:AIPRIMETECH_API_KEY"}

```

```
curl --fail-with-body https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $AIPRIMETECH_API_KEY"

```

Se o catálogo retornado incluir seu modelo, mas a requisição falhar, verifique o erro real e a disponibilidade atual do grupo. Um ID listado, por si só, não constitui um teste de inferência bem-sucedido. 

## Mantenha um perfil opcional da CLI 

Para selecionar este provedor apenas em sessões específicas da CLI, coloque a configuração acima em ~/.codex/aiprimetech.config.toml e inicie: 

```
codex --profile aiprimetech

```

No Codex 0.134.0 e em versões posteriores, os perfis da CLI usam arquivos separados. Exemplos antigos de [profiles.aiprimetech] não usam o formato atual de perfil. A extensão da IDE usa a configuração do usuário; verifique seu provedor ativo após reiniciá-la, em vez de presumir que a troca de perfil da CLI foi aplicada nela. 

## Escolha um modelo 

Use gpt-6.1-sol como ponto de partida para programação, gpt-6-astra para tarefas exigentes ou gpt-6-luna para trabalho focado. gpt-6-sol é um ID separado para fluxos de trabalho existentes do Sol. Consulte [detalhes do modelo](/pt/openai-api/) e [como compará-los](/pt/blog/gpt-6-models-for-codex/). 

## Solução de problemas 

  | Sintoma  | Verifique    

  | Variável de ambiente ausente  | Defina AIPRIMETECH_API_KEY no processo que inicia o Codex.  

  | Erro de autenticação 401  | Confirme que a chave está ativa, foi copiada integralmente e foi emitida por este gateway.  

  | 403 ou modelo indisponível  | Confirme o grupo da chave, o acesso pelo plano e o ID exato do modelo.  

  | 404 ou uma resposta HTML  | Use https://aiprimetech.io/v1; remova a duplicação de /v1 ou a adição de /responses.  

  | wire_api rejeitado  | Use responses; os antigos chat exemplos de provedores estão obsoletos.  

  | Erro de saldo, plano ou limite de requisições  | Leia o erro, verifique sua conta e reduza o trabalho simultâneo antes de tentar novamente.  

  | A conexão termina durante a resposta  | Tente uma requisição curta, verifique a conectividade da rede e do proxy e registre o ID da requisição para o suporte.    

## Claude e recursos hospedados do Codex 

Para usar o Claude por meio da tradução de Responses do gateway, siga [Claude com Codex](/pt/learn/use-claude-api-with-codex/) usando uma chave compatível do grupo Claude. O exemplo de GPT acima é para acesso pelo grupo Codex. 

O acesso pelo gateway não concede direitos de uso do espaço de trabalho do ChatGPT nem acesso ao Codex na nuvem. Consulte a [comparação de formas de login](/pt/blog/codex-api-key-vs-chatgpt-subscription/) para entender os limites do produto. 

## Referências  
- [OpenAI: use credenciais do provedor por meio de um gateway](https://learn.chatgpt.com/docs/enterprise/connect-to-a-gateway) 
- [OpenAI: referência de configuração](https://learn.chatgpt.com/docs/config-file/config-reference) 
- [OpenAI: configuração avançada e perfis](https://learn.chatgpt.com/docs/config-file/config-advanced)