Configuração do Codex CLI

Saiba como configurar o Codex CLI para usar a API da Aiberm. Este guia aborda a instalação e a configuração no Windows, macOS e Linux.

O que é o Codex CLI?

O Codex CLI é a interface de linha de comando da OpenAI projetada para tarefas de terminal relacionadas a código. Ele enfatiza uma saída pronta para engenharia, com alterações de código mais claras e acionáveis em comparação com ferramentas de chat gerais. Ao configurá-lo para usar a Aiberm, você pode acessar vários modelos de IA por um endpoint econômico.

Pré-requisitos

Antes de começar, certifique-se de ter:

• Uma conta Aiberm (Cadastre-se aqui)
• Uma chave de API da Aiberm (Obtenha sua chave)
• Node.js v20 ou superior com npm

Instalação

Instale o Codex CLI globalmente usando o npm:

npm install -g @openai/codex

Verificar a instalação:

codex --version

Isso deve exibir o número da versão.

Configuração

O Codex CLI usa um arquivo config.toml para configuração. O local do diretório de configuração varia conforme o sistema operacional:

• Windows: %userprofile%\.codex
• macOS/Linux: ~/.codex

Método 1: Configuração manual

Navegue até o diretório de configuração e crie ou edite config.toml:

macOS/Linux:

mkdir -p ~/.codex
nano ~/.codex/config.toml

Windows:

mkdir $env:USERPROFILE\.codex -Force
notepad $env:USERPROFILE\.codex\config.toml

Adicione a seguinte configuração:

model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false

Importante: Substitua sk-your-aiberm-api-key pela sua chave de API real da Aiberm. A chave fica armazenada em texto simples no config.toml. Não faça commit desse arquivo no Git nem o compartilhe com outras pessoas.

Método 2: Configuração com um único comando

macOS/Linux:

mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false
EOF

Windows PowerShell:

$configPath = "$env:USERPROFILE\.codex"
New-Item -ItemType Directory -Force -Path $configPath | Out-Null
@"
model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false
"@ | Out-File -FilePath "$configPath\config.toml" -Encoding utf8

Importante: Substitua sk-your-aiberm-api-key na configuração pela sua chave de API real da Aiberm. A chave fica armazenada em texto simples no config.toml. Não faça commit desse arquivo no Git nem o compartilhe com outras pessoas.

Verificar a configuração

Verificar a instalação do Node.js:

node -v
npm -v

Verificar a instalação do Codex CLI:

codex --version

Testar a conexão com a API:

codex "Hi"

Se estiver configurado corretamente, o Codex CLI deve responder usando a API da Aiberm.

Solução de problemas

Erro 401 Unauthorized

• Verifique se sua chave de API está correta: Console → API Keys
• Certifique-se de que experimental_bearer_token contém sua chave de API real da Aiberm e que o marcador de posição não foi salvo sem alteração

Erro 403 Forbidden

• Verifique a validade da sua chave de API
• Confira o saldo da sua conta em https://aiberm.com/console
• Certifique-se de que sua chave de API tem acesso ao modelo solicitado

Erros de rede

• Verifique sua conexão com a internet
• Confirme se você consegue acessar https://aiberm.com no navegador
• Certifique-se de que o firewall permite conexões HTTPS de saída
• Confirme se o base_url em config.toml está correto: https://aiberm.com/v1

A configuração não está sendo aplicada

• Reinicie o terminal após editar config.toml
• Valide a formatação da sintaxe TOML (sem espaços extras, aspas corretas)
• Verifique se o local do arquivo de configuração está correto para o seu sistema operacional
• Certifique-se de que o arquivo foi salvo como config.toml (não config.toml.txt)

Comando Codex não encontrado

macOS/Linux:

# Check if npm global bin is in PATH
npm config get prefix

# If needed, add to PATH in ~/.zshrc or ~/.bashrc:
export PATH="$(npm config get prefix)/bin:$PATH"

Windows:

• Verifique se o caminho global do npm está no PATH do sistema
• Reinicie o terminal após a instalação do npm