Início Rápido

Execute sua primeira tarefa no terminal ou envie sua primeira requisição à API em menos de 60 segundos.

Opção 1: Via Terminal CLI

Instale globalmente o pacote zeus-dev e execute no diretório do seu projeto:

# 1. Instalação global do binário zeus (npm, pnpm, yarn ou bun)
npm install -g zeus-dev@latest
# ou pnpm: pnpm add -g zeus-dev@latest
# ou yarn: yarn global add zeus-dev@latest
# ou bun:  bun add -g zeus-dev@latest

# 2. Inicie a sessão interativa no seu repositório
zeus

# 3. Na interface, digite /login para autenticar no navegador
#    e /whoami para confirmar plano e chave ativa

Opção 2: Via Cloud Gateway REST

Envie uma requisição HTTP direta para o endpoint de chat completions:

curl https://zeus-code-five.vercel.app/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_CHAVE_ZEUS" \
  -d '{
    "model": "ID-DO-MODELO",
    "messages": [
      {"role": "user", "content": "Escreva uma função debounce em TypeScript"}
    ]
  }'

Instalação & Setup

Requisitos de sistema, opções de gerenciador de pacotes e verificação de ambiente.

Requisitos de Sistema

• Node.js: v20.x LTS, v22.x ou superior.
• Gerenciador de Pacotes: npm, pnpm ou yarn.
• Plataformas Suportadas: macOS (Apple Silicon / Intel), Linux (x64 / arm64) e Windows (PowerShell / WSL2).

Comando de Instalação

Você pode instalar a CLI globalmente utilizando seu gerenciador de pacotes preferido (npm, pnpm, yarn ou bun):

# Via npm
npm install -g zeus-dev@latest

# Via pnpm
pnpm add -g zeus-dev@latest

# Via yarn
yarn global add zeus-dev@latest

# Via bun
bun add -g zeus-dev@latest

# Validar instalação
zeus --version

Diagnóstico Automático

Execute o comando zeus /doctor para verificar a conectividade com os servidores da plataforma e a integridade das variáveis de ambiente.

Conceitos Fundamentais

Entenda como funciona o ciclo de raciocínio, execução e observação do Zeus Code.

O Ciclo do Agente (Agent Loop)

O Zeus Code opera em um loop contínuo de 3 estágios:

• Percepção & Planejamento: Analisa arquivos, dependências do projeto e histórico recente para planejar os próximos passos de forma não-destrutiva.
• Execução de Ferramentas: Aciona ferramentas controladas (edição pontual de arquivos, comandos de build, busca ripgrep).
• Verificação & Observação: Lê saídas de linters e testes unitários. Se ocorrer um erro de sintaxe, o próprio agente ajusta a correção antes de concluir a tarefa.

Visão Geral da API

Especificação técnica, URL base e compatibilidade com a especificação OpenAI v1.

URL Base de Produção

https://zeus-code-five.vercel.app/v1

Endpoints Disponíveis

Autenticação

Autenticação via cabeçalho HTTP Bearer e geração de tokens no painel de controle.

Cabeçalho Authorization

Todas as chamadas protegidas da API exigem um cabeçalho HTTP Authorization no formato Bearer:

Authorization: Bearer SUA_CHAVE_ZEUS

Listar Modelos

Consulte a lista dinâmica de modelos neurais disponíveis executados nos servidores da plataforma.

GET /v1/models

curl https://zeus-code-five.vercel.app/v1/models \
  -H "Authorization: Bearer SUA_CHAVE_ZEUS"

Exemplo de Resposta (200 OK)

{
  "provider": "Servidores da Plataforma Zeus Code",
  "cluster": "Infraestrutura Neural Proprietária",
  "status": "active",
  "models": [
    { "id": "modelo-sincronizado-do-provedor", "name": "Nome divulgado pelo provedor configurado" }
  ],
  "selectedModel": "modelo-sincronizado-do-provedor"
}

Chat Completions

Gere respostas de raciocínio, geração de código e conversação multi-turn.

POST /v1/chat/completions

Exemplo de Requisição

curl https://zeus-code-five.vercel.app/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_CHAVE_ZEUS" \
  -d '{
    "model": "ID-DO-MODELO",
    "messages": [
      {"role": "system", "content": "Você é o assistente técnico sênior Zeus Code."},
      {"role": "user", "content": "Explique o padrão Factory em TypeScript."}
    ],
    "temperature": 0.3
  }'

Streaming (Server-Sent Events)

Receba respostas token a token em tempo real para latência percebida imediata.

Protocolo SSE

Defina "stream": true no payload da requisição. O servidor responde com Content-Type: text/event-stream e envia deltas estruturados:

data: {"id":"chatcmpl_1","choices":[{"delta":{"content":"class"}}]}
data: {"id":"chatcmpl_1","choices":[{"delta":{"content":" User"}}]}
data: {"id":"chatcmpl_1","choices":[{"delta":{"content":"Service"}}]}
data: [DONE]

Tool Calling (Funções)

Capacite os modelos a invocar funções declarativas com validação por JSON Schema.

Declaração de Ferramentas

{
  "model": "ID-DO-MODELO",
  "messages": [{"role": "user", "content": "Verifique o status do deploy"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "check_deploy_status",
      "description": "Retorna o status atual da Vercel",
      "parameters": {
        "type": "object",
        "properties": {
          "environment": { "type": "string", "enum": ["production", "preview"] }
        },
        "required": ["environment"]
      }
    }
  }]
}

Structured Outputs

Garanta que as respostas do modelo retornem exclusivamente em JSON parseável.

Envie "response_format": { "type": "json_object" } na requisição para assegurar que a saída do modelo seja 100% aderente a JSON sem blocos de texto soltos.

Erros & Limites

Códigos de status HTTP, estruturas de erro padronizadas e limites de taxa.

Telemetria & Faturamento

Acompanhe o consumo de tokens e métricas da plataforma.

Acesse o Portal do Desenvolvedor no topo da página para auditar seu consumo e chaves em tempo real:

• Prompt Tokens vs Completion Tokens: Relação de entrada e saída.
• Custo Estimado: Calculado com base no consumo de tokens e quotas da conta.
• Latência Média: Medida em milissegundos ponta a ponta.

Migração Drop-in com OpenAI SDK

Como reutilizar seu código existente mudando apenas a baseURL.

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.ZEUS_API_KEY,
  baseURL: 'https://zeus-code-five.vercel.app/v1',
});

const res = await client.chat.completions.create({
  model: 'ID-DO-MODELO',
  messages: [{ role: 'user', content: 'Olá Zeus Code!' }],
});
console.log(res.choices[0].message.content);

Guia Python

Exemplo prático de integração com a biblioteca oficial da OpenAI em Python.

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ.get("ZEUS_API_KEY"),
    base_url="https://zeus-code-five.vercel.app/v1"
)

completion = client.chat.completions.create(
    model="ID-DO-MODELO",
    messages=[
        {"role": "user", "content": "Crie um algoritmo de ordenação rápida em Python"}
    ]
)
print(completion.choices[0].message.content)

Guia TypeScript / Node.js

Uso assíncrono moderno em TypeScript com tipagem estrita.

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.ZEUS_API_KEY,
  baseURL: 'https://zeus-code-five.vercel.app/v1',
});

async function run() {
  const completion = await client.chat.completions.create({
    model: 'ID-DO-MODELO',
    messages: [{ role: 'user', content: 'Como criar um generic type guard em TypeScript?' }],
  });
  console.log(completion.choices[0]?.message.content);
}

run();

Guia JavaScript Nativo (Fetch API)

Realize chamadas diretas sem necessidade de bibliotecas externas.

const res = await fetch('https://zeus-code-five.vercel.app/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer ' + apiKey
  },
  body: JSON.stringify({
    model: 'ID-DO-MODELO',
    messages: [{ role: 'user', content: 'Olá mundo!' }]
  })
});
const data = await res.json();
console.log(data);

Guia de Streaming SSE

Como iterar sobre chunks de texto em tempo real no Node.js.

const stream = await client.chat.completions.create({
  model: 'ID-DO-MODELO',
  messages: [{ role: 'user', content: 'Escreva um ensaio sobre engenharia de software' }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || '');
}

Guia de Implementação de Ferramentas

Como orquestrar execução de ferramentas locais e retornar resultados ao modelo.

Quando o modelo responde com finish_reason: "tool_calls", sua aplicação executa a função correspondente e envia uma nova mensagem com role: "tool" contendo a saída serializada.

Gestão de Janela de Contexto

Estratégias para manter conversas de longa duração dentro do limite de tokens.

O Zeus Code utiliza algoritmos de compactação que sumarizam turnos anteriores preservando assinaturas de funções e decisões de arquitetura cruciais.

Boas Práticas para Ambientes de Produção

Como configurar retentativas, monitorar custos e garantir alta disponibilidade.

• Retentativas com Exponential Backoff: Aplique atrasos incrementais com jitter para tratar respostas 429.
• Timeouts de Requisição: Estabeleça timeouts de 60 segundos por chamada.
• Monitoramento Centralizado: Audite métricas e quotas no Portal do Desenvolvedor em tempo real.

Referência do Zeus Code CLI

O assistente autônomo que vive no seu terminal com REPL interativo e interface web.

npm install -g zeus-dev@latest
zeus

Instalação do Pacote zeus-dev

Métodos para instalar via npm, pnpm ou rodar instantaneamente com npx.

# Instalação global
npm i -g zeus-dev@latest

# Ou sem instalar, direto via npx
npx zeus-dev@latest

Cheatsheet de Comandos do CLI

Lista completa de comandos integrados, flags e atalhos de terminal.

Configurações e Variáveis de Ambiente

Personalize o comportamento do CLI através de variáveis de ambiente.

export ZEUS_API_KEY="sua-chave-zeus"
export ZEUS_BASE_URL="https://zeus-code-five.vercel.app/v1"
export ZEUS_MODEL="ID-DO-MODELO"

Seleção de Modelos no Terminal

Como alternar modelos em tempo de execução dentro da sessão interativa.

Digite /model durante uma sessão interativa para abrir o seletor visual e alternar entre modelos rápidos de raciocínio ou modelos focados em geração de diffs pesados.

Persistência de Sessões & Checkpoints

Como o Zeus Code preserva o contexto mesmo após fechar o terminal.

Todas as conversas e ações são persistidas em arquivos estruturados JSON Lines sob ~/.zeus/sessions/, possibilitando reabrir ou desfazer alterações com facilidade.

Diagnóstico Automatizado (/doctor)

O comando oficial para validar conectividade e permissões locais.

zeus /doctor

O utilitário verifica permissões de escrita, versão do Node.js, tempo de resposta do Cloud Gateway e disponibilidade dos servidores da plataforma.

Integração com Cursor IDE

Como configurar o Cursor para direcionar o chat e inline-edits para o Zeus Code Gateway.

1. Pressione Cmd + Shift + J (macOS) ou Ctrl + Shift + J (Windows) no Cursor para abrir os Settings.
2. Acesse a aba Models.
3. Ative Override OpenAI Base URL e insira: https://zeus-code-five.vercel.app/v1.
4. Cole sua chave de API gerada no Portal do Desenvolvedor.
5. Adicione o ID do modelo retornado por GET /v1/models e clique em salvar.

Integração com VS Code (Continue & Cline)

Configuração do arquivo config.json para extensões populares de IA.

{
  "models": [
    {
      "title": "Zeus Code (Platform Neural)",
      "provider": "openai",
      "model": "ID-DO-MODELO",
      "apiKey": "SUA_CHAVE_ZEUS",
      "apiBase": "https://zeus-code-five.vercel.app/v1"
    }
  ]
}

Integração com OpenClaw & Agentes Autônomos

Conecte frameworks multi-agente ao gateway de alta disponibilidade.

Defina as variáveis padrão da comunidade em seu ambiente de execução:

OPENAI_API_BASE="https://zeus-code-five.vercel.app/v1"
OPENAI_API_KEY="SUA_CHAVE_ZEUS"

Model Context Protocol (MCP)

Conecte servidores MCP padronizados para ferramentas e contexto dinâmico.

O Zeus Code suporta o protocolo aberto MCP para integrar servidores de contexto em bancos de dados (SQLite, PostgreSQL), GitHub e sistemas de arquivos locais de maneira segura.

Outras Ferramentas (LangChain / LlamaIndex / Aider)

Conexão universal com ferramentas e frameworks compatíveis com OpenAI.

aider --openai-api-base https://zeus-code-five.vercel.app/v1 --openai-api-key SUA_CHAVE_ZEUS

Changelog da API

Histórico cronológico de versões e melhorias do Zeus Code Gateway.

v1.2.0 — Setembro 2026

• Lançamento oficial da Documentação Completa no padrão Verboo Code.
• Processamento neural direto e criptografado nos servidores próprios da plataforma.
• Descoberta dinâmica de modelos em tempo real pelo endpoint /api/models/discover.
• Telemetria e métricas de uso no Portal do Desenvolvedor (tokens e latências).

Catálogo de Modelos da Plataforma

Especificações técnicas dos modelos neurais executados nos servidores da plataforma Zeus Code.

Preços & Planos

Planos transparentes baseados no consumo real de tokens.

Limites da Plataforma

Quotas de concorrência, taxa de requisições e tamanhos máximos de carga.

• Tamanho Máximo do Payload HTTP: 10 MB por requisição.
• Timeout Máximo por Chamada: 60 segundos antes de cancelamento automático.
• Janela de Rate Limit: Janela deslizante de 60 segundos por IP e chave de API.

Status Operacional

Monitoramento em tempo real da saúde dos servidores da plataforma Zeus Code.

Você pode auditar o endpoint JSON automatizado de status em https://zeus-code-five.vercel.app/status.