Tutorial de instalação da Codex CLI

Se você pretende usar os modelos da série GPT / Codex, também pode instalar a Codex CLI com antecedência. Depois de instalada, você também pode integrá-la ao NextHub pelo CC-Switch.

Etapas de instalação

1. Confirme o ambiente Node.js

A Codex CLI também precisa do ambiente Node.js; recomenda-se verificar a versão primeiro:

node -v
npm -v

2. Instale a Codex CLI globalmente

Execute o seguinte comando no terminal para instalar a Codex:

npm install -g @openai/codex

3. Verifique se a Codex foi instalada com sucesso

Execute o comando abaixo; basta que o número da versão seja exibido normalmente ou que a Codex inicie:

codex --version
codex

Forma de integração 1: CC-Switch (recomendado)

Após a instalação, basta continuar com o tutorial do CC-Switch. No CC-Switch, selecione Codex, informe o endereço de requisição https://api.nexthub.cc/v1 (o protocolo OpenAI Responses exige /v1), insira sua ApiKey e pronto: você já pode usar o grupo GPT-Azure (0.47x).

Forma de integração 2: configuração manual

Se você não quiser usar uma ferramenta de configuração, basta editar manualmente os dois arquivos de configuração da Codex.

1. Abra a pasta de configuração da Codex

Windows (CMD)

start "" "%USERPROFILE%\.codex"

macOS (Terminal)

open "$HOME/.codex"

Se os arquivos correspondentes não estiverem na pasta, crie-os manualmente.

2. Configure o config.toml

Escreva o seguinte conteúdo em ~/.codex/config.toml:

model = "gpt-5.6"
model_provider = "nexthub"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.nexthub]
name = "nexthub"
base_url = "https://api.nexthub.cc/v1"
wire_api = "responses"
requires_openai_auth = true

O endereço de requisição precisa incluir /v1

A Codex usa o protocolo OpenAI Responses (/v1/responses), portanto o base_url precisa incluir /v1. Preencha o model com o ID do modelo oferecido pelo grupo GPT-Azure / GPT-Pro conforme necessário (como gpt-5.6 e gpt-6-astra), seguindo os dados em tempo real do Model Plaza.

3. Configure o auth.json

Escreva a ApiKey em ~/.codex/auth.json (a chave do grupo GPT-Azure ou GPT-Pro):

{
  "OPENAI_API_KEY": "sua ApiKey do NextHub"
}

4. Verificação

Execute codex no terminal e envie uma mensagem de teste; se o modelo selecionado aparecer no topo da interface e as respostas forem normais, a integração está concluída.

Prompt global

~/.codex/AGENTS.md é o arquivo de prompt global da Codex. Se não existir, ele será criado automaticamente; você pode escrever nele suas convenções de trabalho conforme necessário.