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 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 e como compará-los.

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 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 para entender os limites do produto.