Guia de configuração do Codex

Instale o Codex, adicione a chave de API e inicie uma conversa através do Starsg.

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

1. Verificação ambiental

Se utilizar os comandos npm abaixo, execute primeiro node --version no terminal. Se o comando não for encontrado, aceda à página de descarga 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 pretende utilizar; ignore 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 foi concluída. Se o comando não for encontrado, reabra o terminal e tente novamente.

2. Configurar o Codex

Editar~/.codex/config.toml— este ficheiro 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 faltar algum ficheiro de configuração ou a respetiva pasta, crie-o antes de colar o exemplo acima. No Windows, a pasta do utilizador é %USERPROFILE%.

3. Verificar

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

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