Manual de Instalação AIOX

Pré-requisitos

Ferramentas necessárias antes de instalar o AIOX

Git

2.30+

Sistema de controle de versão

macOS brew install git

Windows Baixe em git-scm.com

Linux sudo apt install git

git --version Download

Node.js

18.0+

Runtime JavaScript

Recomendado nvm install 20

Windows Baixe LTS em nodejs.org

Linux curl nodesource

node --version Download

Verificar Instalação

Execute estes comandos para confirmar que está tudo instalado

# Verificar versões
node --version    # v18+ ou v20+
npm --version     # v9+
git --version     # v2.30+

# Configurar Git (obrigatório)
git config --global user.name "Seu Nome"
git config --global user.email "seu@email.com"

Windows

Instalação no Windows 10/11

1. Instalar Git

# Baixe o instalador em:
# https://git-scm.com/download/win

# Ou via winget (Windows 11):
winget install Git.Git

2. Instalar Node.js

# Baixe o instalador LTS em:
# https://nodejs.org/

# Ou via winget:
winget install OpenJS.NodeJS.LTS

3. Instalar Claude Code

# Abra o PowerShell como Admin e execute:
npm install -g @anthropic-ai/claude-code

# Testar instalação:
claude --version

macOS

Instalação no Mac (Intel/Apple Silicon)

1. Instalar Homebrew (se não tiver)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Instalar Git e Node.js

# Git (geralmente já vem no Mac)
brew install git

# Node.js via nvm (recomendado)
brew install nvm
nvm install 20
nvm use 20

3. Instalar Claude Code

npm install -g @anthropic-ai/claude-code

# Testar instalação:
claude --version

Linux

Instalação no Ubuntu/Debian

1. Instalar Git

sudo apt update
sudo apt install git -y

2. Instalar Node.js via nvm

# Instalar nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Recarregar terminal
source ~/.bashrc

# Instalar Node.js 20
nvm install 20
nvm use 20

3. Instalar Claude Code

npm install -g @anthropic-ai/claude-code

# Testar instalação:
claude --version

IDEs & Ferramentas de IA

Escolha pelo menos uma ferramenta para usar com o AIOX

Recomendado

Claude Code

CLI oficial da Anthropic

# Instalar
npm install -g @anthropic-ai/claude-code

# Usar
cd seu-projeto && claude

Planos: Pro ($20/mês) ou API

Link: console.anthropic.com

Cursor

IDE com IA integrada (VS Code fork)

Download: cursor.com

Planos: Hobby (grátis) ou Pro ($20/mês)

Uso: @dev, @qa, @architect no chat

Gratuito

Gemini CLI

CLI do Google com tier gratuito generoso

# Obter API Key (grátis)
# https://aistudio.google.com/app/apikey

# Configurar
export GEMINI_API_KEY="sua-chave"

VS Code + Continue

Editor gratuito + extensão de IA

VS Code: code.visualstudio.com

Continue: continue.dev

Atalho: Ctrl+L para chat

Instalação do AIOX

Passos para instalar o framework no seu projeto

Instalar AIOX no seu projeto

Execute na pasta do seu projeto

GitHub

npx @synkra/aios-core install

Importante: Sempre execute o instalador DENTRO da pasta do projeto. Nunca da home (~).

1

Navegue para seu projeto

# Projeto existente
cd /caminho/do/seu/projeto

# Ou crie um novo
mkdir meu-projeto && cd meu-projeto

2

Execute o instalador

npx @synkra/aios-core install

Documentação oficial

3

Siga os prompts

Selecione componentes (Core + Squads), configure IDE e documentação.

4

Verifique a instalação

npx @synkra/aios-core doctor

Comandos Úteis

npx @synkra/aios-core init nome Criar projeto

npx @synkra/aios-core install --force-upgrade Atualizar

npx @synkra/aios-core doctor --fix Corrigir

npx @synkra/aios-core --version Ver versão

Estrutura Criada

meu-projeto/
├── .aios-core/      # Framework (READ-ONLY)
│   ├── agents/      # Agentes do sistema
│   ├── tasks/       # Tasks reutilizáveis
│   └── workflows/   # Fluxos de trabalho
├── .claude/         # Config Claude Code
├── agents/          # Seus agentes customizados
├── tasks/           # Suas tasks
├── docs/            # Documentação
└── .env             # API Keys (gitignored)

Configuração

Configure suas API Keys e comece a usar

Arquivo .env

Crie na raiz do projeto. Escolha pelo menos um provider de IA.

# Anthropic (Claude) - Recomendado
# Obter em: https://console.anthropic.com/
ANTHROPIC_API_KEY=sk-ant-api03-...

# Google (Gemini) - Gratuito
# Obter em: https://aistudio.google.com/app/apikey
GEMINI_API_KEY=...

# OpenAI (GPT) - Opcional
# Obter em: https://platform.openai.com/api-keys
OPENAI_API_KEY=sk-...

Agentes Disponíveis

@dev Implementar features, corrigir bugs

@qa Testar, revisar código

@architect Design de sistema

@pm Especificacoes, requisitos

@po Stories, priorização

@devops CI/CD, deploys, git push

Primeiros Comandos

# Iniciar Claude Code
claude

# Ativar agente dev
> @dev

# Pedir algo
> Crie um componente de botão com variantes primary e secondary

# Comandos do sistema
*help           # Ver todos os comandos
*list-agents    # Listar agentes
*exit           # Sair do modo agente

Perguntas Frequentes

Respostas para as dúvidas mais comuns

Execute o instalador DENTRO da pasta do projeto, não da home (~).

cd /seu/projeto
npx @synkra/aios-core install

Atualize o Node.js para versão 18 ou superior.

# Via nvm (recomendado)
nvm install 20 && nvm use 20

# Ou baixe em nodejs.org

# Usar Opus (mais capaz)
claude --model claude-opus-4-5-alan

# Usar Haiku (mais barato)
claude --model claude-haiku-4-5-20251001

Sim! O AIOX é instalado por projeto para permitir configuracoes independentes e versionamento específico.

@dev implementa código (git add, commit). @devops cuida de infraestrutura (git push, deploy). Só @devops pode fazer push!

Sim! O processamento pesado acontece nos servidores da IA. Sua máquina so roda o terminal e IDE.

Sim! O AIOX é agnóstico de linguagem. Os agentes entendem qualquer stack.

GitHub Issues

Academia Lendária

Manual de Instalação

Pré-requisitos

Git

Node.js

Verificar Instalação

Windows

macOS

Linux

IDEs & Ferramentas de IA

Claude Code

Cursor

Gemini CLI

VS Code + Continue

Instalação do AIOX

Instalar AIOX no seu projeto

Comandos Úteis

Estrutura Criada

Configuração

Arquivo .env

Agentes Disponíveis

Primeiros Comandos

Perguntas Frequentes

Links Úteis

Downloads

API Keys

Comunidade