📋 Etapas Preparatórias
Antes de começar, certifique-se de que você:
- Tenho registrado uma conta Koze e feito login
- Tenho criado uma chave de API na página de Gerenciamento de API
- Tenho instalado a CLI do Codex (
npm install -g @openai/codex)
🚀 Etapa 1: Configurar o Arquivo de Configuração do Codex
Adicione a seguinte configuração ao início do arquivo ~/.codex/config.toml:
model_provider = "koze"
model = "gpt-4.1"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.koze]
name = "koze"
base_url = "https://api.kozeai.com/v1"
wire_api = "responses"
requires_openai_auth = true
💡 Dica: Substitua `
https://api.kozeai.com/v1` pelo endereço real do seu proxy Koze. O campo `model` permite selecionar diferentes modelos de acordo com o seu plano.
🔑 Passo Dois: Configurar a Chave da API
Configure sua chave da API no arquivo ~/.codex/auth.json:
{
'OPENAI_API_KEY': 'Sua Chave da API Koze'
}
🎯 Passo Três: Iniciar o Codex
Após a configuração, inicie-o diretamente no terminal:
codexO Codex CLI usará automaticamente o proxy Koze para as requisições da API.
📌 Modelos Disponíveis
Você pode usar os seguintes modelos no campo `model` do arquivo de configuração. (Dependendo do seu plano Koze):
| Nome do Modelo | Descrição |
|---|---|
gpt-5.3-codex |
gpt-5.3-codex, adequado para tarefas de programação do dia a dia |
gpt-5.4-mini |
GPT-4.1 Mini, melhor custo-benefício |
gpt-5.4 |
GPT-5.4 Multimodal Modelo |
⚠️ Perguntas Frequentes
| Problema | Solução |
|---|---|
| Dica: "Falha na autenticação" | Verifique se a chave da API em auth.json está correta |
config.toml não está funcionando |
Certifique-se de que a configuração esteja escrita no início do arquivo e que o nome do model_provider corresponda a [model_providers.xxx] |
| Usando O anti-protótipo do Nginx falha. | Adicione `underscores_in_headers on;` ao bloco ` |