Guia de Integração com IDEs

PT

Guia para integrar o AIOS com IDEs e plataformas de desenvolvimento com IA suportadas.

Versão: 2.1.0 Última Atualização: 2026-01-28

IDEs Suportadas

O AIOS suporta 6 plataformas de desenvolvimento com IA. Escolha a que melhor se adapta ao seu fluxo de trabalho.

Tabela de Comparação Rápida

Funcionalidade	Claude Code	Codex CLI	Cursor	Copilot	AntiGravity	Gemini CLI
Ativação de Agente	/command	/skills	@mention	chat modes	workflow-based	prompt mention
Suporte MCP	Native	Native	Config	Config	Provider-specific	Native
Tarefas de Subagente	Yes	Yes	No	No	Yes	No
Auto-sync	Yes	Yes	Yes	Yes	Yes	Yes
Sistema de Hooks	Yes	Limited	No	No	No	Yes
Skills/Commands	Native	Native	No	No	No	Native
Recomendação	Best	Best	Best	Good	Good	Good

Paridade de Hooks e Impacto Funcional

IDE	Paridade de Hooks vs Claude	O que degrada sem hooks completos	Mitigação no AIOS
Claude Code	Completa	Nenhum (comportamento de referência)	Hooks nativos + pipeline completo do AIOS
Gemini CLI	Alta	Pequenas diferenças de modelo de eventos	Hooks nativos do Gemini + mapeamento unificado
Codex CLI	Limitada/parcial	Menor automação de ciclo de sessão e menor enforcement pre/post-tool	`AGENTS.md` + `/skills` + MCP + scripts de sync/validação
Cursor	Sem hooks de ciclo equivalentes	Sem interceptação nativa pre/post-tool e trilha automática mais fraca	Regras sincronizadas + MCP + disciplina de workflow
GitHub Copilot	Sem hooks de ciclo equivalentes	Mesmo impacto do Cursor, com maior dependência de fluxo manual	Instruções de repo, chat modes e MCP no VS Code
AntiGravity	Baseado em workflow (não em hooks)	Sem paridade de ciclo de vida ao estilo Claude	Geração de workflows + sync de agentes

Consequências Práticas por Capacidade

Automação SessionStart/SessionEnd:
- Forte em Claude/Gemini.
- Parcial ou manual em Codex/Cursor/Copilot/AntiGravity.
Guardrails BeforeTool/AfterTool:
- Mais robustos em Claude/Gemini.
- Limitados no Codex.
- Predominantemente processuais em Cursor/Copilot/AntiGravity.
Riqueza de auditoria e telemetria automáticas:
- Maior onde há hooks de ciclo de vida.
- Menor onde a integração é majoritariamente por regras/instruções.

Instruções de Configuração

Claude Code

Nível de Recomendação: Melhor integração com AIOS


config_file: .claude/CLAUDE.md
agent_folder: .claude/commands/AIOS/agents
activation: /agent-name (slash commands)
format: full-markdown-yaml
mcp_support: native
special_features:
  - Task tool for subagents
  - Native MCP integration
  - Hooks system (pre/post)
  - Custom skills
  - Memory persistence

Configuração:

AIOS cria automaticamente o diretório .claude/ durante a inicialização
Agentes ficam disponíveis como slash commands: /dev, /qa, /architect
Configure servidores MCP em ~/.claude.json

Configuração:


# Sincronizar todos os alvos habilitados (inclui Claude)
npm run sync:ide
 
# Verificar configuração
ls -la .claude/commands/AIOS/agents/

Codex CLI

Nível de Recomendação: Melhor (workflow terminal-first)


config_file: AGENTS.md
agent_folder: .codex/agents
activation: /skills + atalhos AGENTS.md
skills_folder: .codex/skills (local), ~/.codex/skills (global)
format: markdown
mcp_support: nativo via Codex
special_features:
  - AGENTS.md como contrato operacional
  - Skills locais versionadas no projeto
  - Pipeline de greeting compartilhado com Claude
  - Comando de notify e hooks de ferramenta emergentes nas releases recentes do Codex

Configuração:

Mantenha AGENTS.md na raiz do repositório
Execute npm run sync:ide:codex
Execute npm run sync:skills:codex
Use /skills e selecione aios-<agent-id>
Use sync:skills:codex:global só quando quiser instalação global


npm run sync:ide:codex
npm run sync:skills:codex
ls -la AGENTS.md .codex/agents/ .codex/skills/

Cursor

Nível de Recomendação: Melhor (IDE com IA popular)


config_file: .cursor/rules.md
agent_folder: .cursor/rules
activation: @agent-name
format: condensed-rules
mcp_support: via configuration
special_features:
  - Composer integration
  - Chat modes
  - @codebase context
  - Multi-file editing
  - Suporte a subagents e handoff para cloud agents
  - Fluxos de agente de longa duracao (preview)

Configuração:

AIOS cria o diretório .cursor/ durante a inicialização
Agentes ativados com @mention: @dev, @qa
Regras sincronizadas para .cursor/rules/

Configuração:


# Sincronizar Cursor
npm run sync:ide:cursor
 
# Verificar configuração
ls -la .cursor/rules/

Configuração MCP (.cursor/mcp.json):


{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/sse"
    }
  }
}

GitHub Copilot

Nível de Recomendação: Bom (integração com GitHub)


config_file: .github/copilot-instructions.md
agent_folder: .github/agents
activation: chat modes
format: text
mcp_support: via VS Code MCP config
special_features:
  - GitHub integration
  - PR assistance
  - Code review
  - Integracao com instrucoes de repositorio e MCP no VS Code

Configuração:

Habilite GitHub Copilot em seu repositório
AIOS cria .github/copilot-instructions.md
Instruções de agentes sincronizadas

Configuração:


# Sincronizar todos os alvos habilitados
npm run sync:ide
 
# Verificar configuração
cat .github/copilot-instructions.md

AntiGravity

Nível de Recomendação: Bom (integração com Google)


config_file: .antigravity/rules.md
config_json: .antigravity/antigravity.json
agent_folder: .agent/workflows
activation: workflow-based
format: cursor-style
mcp_support: native (Google)
special_features:
  - Google Cloud integration
  - Workflow system
  - Native Firebase tools

Configuração:

AIOS cria o diretório .antigravity/
Configure credenciais do Google Cloud
Agentes sincronizados como workflows

Gemini CLI

Nível de Recomendação: Bom


config_file: .gemini/rules.md
agent_folder: .gemini/rules/AIOS/agents
activation: prompt mention
format: text
mcp_support: native
special_features:
  - Google AI models
  - CLI-based workflow
  - Multimodal support
  - Eventos de hooks nativos e comandos de hooks
  - Suporte nativo a servidores MCP
  - UX de comandos/ferramentas em evolucao acelerada

Sistema de Sincronização

Como Funciona a Sincronização

O AIOS mantém uma única fonte de verdade para definições de agentes e as sincroniza com todas as IDEs configuradas:


┌─────────────────────────────────────────────────────┐
│                    AIOS Core                         │
│  .aios-core/development/agents/  (Source of Truth)  │
│                        │                             │
│            ┌───────────┼───────────┐                │
│            ▼           ▼           ▼                │
│  .claude/     .codex/      .cursor/                  │
│  .antigravity/ .gemini/                              │
└─────────────────────────────────────────────────────┘

Comandos de Sincronização


# Sincronizar todos os alvos habilitados
npm run sync:ide
 
# Sincronizar alvos específicos
npm run sync:ide:cursor
npm run sync:ide:codex
npm run sync:ide:gemini
npm run sync:ide:github-copilot
npm run sync:ide:antigravity
 
# Dry run (visualizar mudanças)
npm run sync:ide -- --dry-run
 
# Sincronização padrão
npm run sync:ide

Sincronização Automática

O AIOS pode ser configurado para sincronizar automaticamente quando houver mudanças nos agentes:


# .aios-core/core/config/sync.yaml
auto_sync:
  enabled: true
  watch_paths:
    - .aios-core/development/agents/
  platforms:
    - claude
    - codex
    - cursor
    - gemini

Solução de Problemas

Agente Não Aparece na IDE


# Verificar se o agente existe na fonte
ls .aios-core/development/agents/
 
# Sincronizar e validar
npm run sync:ide
npm run sync:ide:check
 
# Verificar diretório específico da plataforma
ls .cursor/rules/  # Para Cursor
ls .claude/commands/AIOS/agents/  # Para Claude Code

Conflitos de Sincronização


# Visualizar o que seria alterado
npm run sync:ide -- --dry-run
 
# Fazer backup antes de sincronização
cp -r .cursor/rules/ .cursor/rules.backup/
npm run sync:ide

MCP Não Está Funcionando


# Verificar status do MCP
aios mcp status
 
# Verificar configuração MCP para a IDE
cat ~/.claude.json  # Para Claude Code
cat .cursor/mcp.json  # Para Cursor

Problemas Específicos da IDE

Claude Code:

Certifique-se de que .claude/ está na raiz do projeto
Verifique permissões dos hooks: chmod +x .claude/hooks/*.py

Cursor:

Reinicie o Cursor após sincronização
Verifique permissões de .cursor/rules/

Guia de Decisão de Plataforma

Use este guia para escolher a plataforma certa:


Você usa Claude/Anthropic API?
├── Sim --> Claude Code (Melhor integração com AIOS)
└── Não
    └── Você prefere VS Code?
        ├── Sim --> Quer uma extensão?
        │   ├── Sim --> GitHub Copilot (Recursos nativos do GitHub)
        │   └── Não --> GitHub Copilot (Recursos nativos do GitHub)
        └── Não --> Quer uma IDE dedicada com IA?
            ├── Sim --> Qual modelo você prefere?
            │   ├── Claude/GPT --> Cursor (IDE com IA mais popular)
            └── Não --> Usa Google Cloud?
                ├── Sim --> AntiGravity (integração com Google)
                └── Não --> Gemini CLI (Especializados)

Migração Entre IDEs

De Cursor para Claude Code


# Exportar regras atuais
cp -r .cursor/rules/ ./rules-backup/
 
# Inicializar Claude Code
npm run sync:ide
 
# Verificar migração
diff -r ./rules-backup/ .claude/commands/AIOS/agents/

De Claude Code para Cursor


# Sincronizar para Cursor
npm run sync:ide:cursor
 
# Configurar MCP (se necessário)
# Copiar configuração MCP para .cursor/mcp.json

Documentação Relacionada

Guia de Integração com IDEs do Synkra AIOS v4.0