Guia de configuração do Codex

Instale o Codex, adicione sua chave de API e comece a conversar pelo Starsg.

ImportanteAntes de começar, prepare uma chave de API criada noconsole. Se você ainda não tem um, siga o link para criá-lo.

1. Verificação ambiental

Se usar os comandos npm abaixo, execute primeiro node --version no terminal. Se o comando não for encontrado, acesse a página de download do Node.js e instale o Node.js. Abra um novo terminal e execute as duas verificações abaixo.

bash

node --version
npm --version

Guias oficiais de instalação: Codex CLI

Instale apenas a ferramenta que deseja usar; pule as que já tiver. Comandos npm:

bash

npm i -g @openai/codex@latest

Importante: execute o comando --version apenas para a ferramenta instalada.

bash

codex --version

Se aparecer um número de versão, a instalação deu certo. Se o comando não for encontrado, reabra o terminal e tente novamente.

2. Configure o Codex

Editar~/.codex/config.toml— este arquivo contém o endpoint do gateway, padrões do modelo e esforço de raciocínio:

toml

disable_response_storage = true
model = "gpt-5.5"
model_provider = "novamaas"
model_reasoning_effort = "high"
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.novamaas]
base_url = "https://api.starsg.ai/v1"
name = "novamaas"
requires_openai_auth = true
wire_api = "responses"

Em seguida, escreva sua chave API em~/.codex/auth.json:

json

{
  "OPENAI_API_KEY": "sk-abc...xyz"
}

Nota: Se algum arquivo de configuração ou sua pasta não existir, crie-o antes de colar o exemplo acima. No Windows, a pasta do usuário é %USERPROFILE%.

3. Verifique

Execute codex no terminal. Uma resposta no chat confirma a conexão.

Veja também:Console › Chaves de API·Documentos API › Início rápido