Guia de configuração CLI

Aponte os dois assistentes baseados em terminal – Claude Code e OpenAI Codex – para Starsg para que eles compartilhem um gateway, um conjunto de chaves de API e uma visualização de uso.

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

Confirme que o Node.js está instalado executandonpm list -g --depth-0no seu terminal. Se o shell reportar "comando não encontrado", sigaeste guiapara instalar o ambiente Node.js Claude Code / Codex precisa, em seguida, execute novamente o comando.

bash

npm list -g --depth-0

Instale ambas as CLIs de uma só vez:

bash

npm i -g @anthropic-ai/claude-code@latest
npm i -g @openai/codex@latest

Importante:execute cada um dos comandos abaixo uma vez para verificar a instalação. A primeira inicialização também é o que gera o diretório de configuração de cada CLI em sua pasta pessoal - cada etapa posterior depende desses diretórios, portanto, não pule esta etapa.

bash

claude
codex

Se o terminal abrir um prompt de chat, imprimir um banner de boas-vindas ou mostrar um menu de seleção, essa CLI está instalada corretamente.

Importante: se o comando claude indicar que não consegue aceder ao serviço Anthropic, siga Claude Code não consegue se conectar à Anthropicpara executar os comandos extras de configuração primeiro, depois volte e continue com as seções de configuração por CLI abaixo.

2. Código Claude

Abrir~/.claude/settings.json(crie o ficheiro se ele não existir) e escreva:

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.starsg.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-abc...xyz",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1"
  }
}

Substituirsk-abc...xyzcom uma chave criada noconsole. Execute Claude em seu terminal – uma resposta de bate-papo bem-sucedida confirma a fiação.

Nota:se o utilizador ainda encontrar erros após a configuração e a CLI solicitar que o utilizador faça login, sigaClaude Code não consegue se conectar à Anthropicpara resolvê-lo.

3. Códice

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:logo após a instalação, esses três ficheiros geralmente não existem — o utilizador precisa criá-los manualmente e colar o conteúdo acima.

4. Verifique

Executarclaudeoucodexem um terminal — assim que o utilizador receber uma resposta no chat, a integração estará ativa.

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