Documentação / Primeiros passos
Conectar uma IA
Escolha entre a assinatura que você já paga ou a sua própria API key. O IDE e as suas regras são os mesmos.
O Yuli tem dois modos de IA. Muda apenas quem raciocina; o IDE, os seus painéis e as suas regras são os mesmos.
| Modo assinatura | Modo Platform | |
|---|---|---|
| Quem raciocina | O seu próprio Claude Code, Kiro, Codex ou Antigravity | O motor do Yuli (Yuli Platform) |
| Quem paga | A sua assinatura atual | A API key do provedor que você escolher |
| Como usa o IDE | Ferramentas yuli_* via MCP |
Ferramentas internas |
| Regras | Geradas pelo Yuli para cada agente, com hooks | Prompts e salvaguardas do motor |
Um IDE recém-instalado começa no Modo assinatura.
Escolher com quem você trabalha
Acima do chat há um único seletor: Com quem você trabalha?
| Grupo | Opções |
|---|---|
| Sua assinatura · sua conta | Claude Code, Kiro, Codex, Antigravity |
| Com a sua API key | Yuli Platform |
Cada agente mantém a sua própria sessão. Se um deles estiver trabalhando, a troca espera que ele termine.
Você também pode escolher em Opções globais → IA e modelos → Modo de IA:
- Modo Platform ou Modo assinatura.
- Agente: Claude Code, Kiro, Codex ou Antigravity.
- Escolher o modo só para este projeto: se você ativar, a escolha vale apenas para o projeto aberto. Caso contrário, é o valor para todos.
Com a sua assinatura
| Agente | A sua conta | Guia |
|---|---|---|
| Claude Code | Claude (Pro, Max ou Console) | Claude Code |
| Kiro | AWS Builder ID, Google ou GitHub | Kiro, Codex e Antigravity |
| Codex | ChatGPT | Kiro, Codex e Antigravity |
| Antigravity | Kiro, Codex e Antigravity |
Passos gerais:
- Instale o agente com o instalador oficial dele. O Yuli o detecta; nunca o baixa nem o redistribui.
- Leia o aviso inicial e continue.
- Faça login você mesmo, com o fluxo oficial do agente.
- Escreva o seu pedido.
Por padrão, o Yuli não escreve nada no seu projeto: a configuração dele é entregue ao agente ao iniciá-lo.
Neste modo, o Yuli nunca toca nas suas credenciais nem usa API keys. O que o seu agente lê vai para o provedor dele sob a sua conta, como fora do Yuli.
Com a sua API key
- Abra a configuração de modelos: cabeçalho do chat → Mais ações → Configurações do modelo.
- Escolha o provedor: Anthropic, OpenAI, Gemini, xAI, DeepSeek, Local, AWS Bedrock ou Vertex AI.
- Digite a sua API key e o modelo.
- Clique em Testar conexão e em Salvar configurações.
A chave é guardada no chaveiro do sistema e sempre aparece mascarada. Detalhes em Modelos e provedores.
Sem conexão com a nuvem? Use Local com Ollama, LM Studio, vLLM ou llama.cpp: o contexto não sai da sua rede.
O que muda entre os modos
| Função | Assinatura | Platform |
|---|---|---|
| Janela de alterações e desfazer | Sim | Sim |
| Missão, fases e medição | Sim | Sim |
| Git só se você pedir | Sim | Sim |
| Segredos protegidos | Sim | Sim |
| Modo autônomo | Não: as missões são interativas | Sim |
| Equipe de agentes | Iniciada com yuli_team_*, usando o provedor do Platform |
Sim |
| Indicador de consumo | Uso do plano (5 horas e semana) | Tokens e custo |
Responsabilidade
O Claude Code é um produto da Anthropic, o Kiro da Amazon Web Services, o Codex da OpenAI e o Antigravity do Google. O Yuli não é afiliado a nenhum deles nem endossado por eles. Cada pessoa usa a sua própria conta sob os termos do seu provedor.