# Configuração de agentes ## Escolha seu agente Selecione um agente para ver as instruções de configuração passo a passo. - [Claude Code](/pt-br/documentacao/agent-setup/claude-code.md) (Anthropic, Terminal): Agente de terminal que lê sua base de código, executa comandos e edita arquivos. Um comando da CLI conecta cada servidor MCP da Azion. - [Cursor](/pt-br/documentacao/agent-setup/cursor.md) (Cursor, IDE): IDE AI-first construída sobre o VS Code, com edições multiarquivo no Composer e agentes em segundo plano. A Azion entra nas suas configurações de MCP. - [GitHub Copilot](/pt-br/documentacao/agent-setup/github-copilot.md) (GitHub, Extension, IDE): Modo agente dentro do VS Code, com contexto do workspace e integração nativa com pull requests. Um arquivo no projeto conecta a Azion. - [Windsurf](/pt-br/documentacao/agent-setup/windsurf.md) (Cognition, IDE): IDE agêntica construída em torno do Cascade para tarefas em várias etapas. Conecta-se à Azion por meio do mcp-remote. - [Codex](/pt-br/documentacao/agent-setup/codex.md) (OpenAI, Terminal): Agente de terminal que executa comandos em um sandbox e lê AGENTS.md nativamente. A Azion entra no config.toml. - [Gemini CLI](/pt-br/documentacao/agent-setup/gemini-cli.md) (Google, Terminal): Agente de terminal de código aberto com um plano gratuito. Declare a Azion uma vez no settings.json e verifique com /mcp. - [OpenCode](/pt-br/documentacao/agent-setup/opencode.md) (SST, Terminal): Agente de terminal de código aberto e agnóstico de provedor. A Azion é uma entrada no bloco MCP dele, qualquer que seja o modelo que você apontar. - [Claude Desktop](/pt-br/documentacao/agent-setup/claude-desktop.md) (Anthropic, Desktop): App de desktop para conversar com o Claude no macOS e no Windows. Conecta-se à Azion por meio do mcp-remote. - [Warp](/pt-br/documentacao/agent-setup/warp.md) (Warp, Terminal): Terminal agêntico de código aberto, com plano gratuito e escolha de modelos. A Azion entra nas configurações de servidores MCP dele. - [Kiro](/pt-br/documentacao/agent-setup/kiro.md) (AWS, IDE): IDE agêntica com plano gratuito e modelos de vários provedores. A Azion entra em .kiro/settings/mcp.json. Usa outra ferramenta que fala MCP? Cada servidor é um único endpoint HTTP — aponte seu cliente para `https://docs-mcp.azion.com/mcp`, ou outro dos cinco servidores, com seu Personal Token em um cabeçalho `Authorization: Token`, e as ferramentas dele aparecem. ## Compare os agentes | Agente | Terminal | IDE | Extensão | Desktop | Código aberto | Preço | Modelo | Contexto | | ------------------------------------------------------------------- | -------- | --- | -------- | ------- | ------------- | ---------- | ------------- | ------------------ | | [Claude Code](/pt-br/documentacao/agent-setup/claude-code.md) | Sim | Não | Não | Não | Não | Assinatura | Fixo | Memória de projeto | | [Cursor](/pt-br/documentacao/agent-setup/cursor.md) | Não | Sim | Não | Não | Não | Assinatura | Multiprovedor | Codebase indexado | | [GitHub Copilot](/pt-br/documentacao/agent-setup/github-copilot.md) | Não | Sim | Sim | Não | Não | Assinatura | Multiprovedor | Codebase indexado | | [Windsurf](/pt-br/documentacao/agent-setup/windsurf.md) | Não | Sim | Não | Não | Não | Assinatura | Multiprovedor | Codebase indexado | | [Codex](/pt-br/documentacao/agent-setup/codex.md) | Sim | Não | Não | Não | Sim | Híbrido | Fixo | Memória de projeto | | [Gemini CLI](/pt-br/documentacao/agent-setup/gemini-cli.md) | Sim | Não | Não | Não | Sim | Híbrido | Fixo | Memória de projeto | | [OpenCode](/pt-br/documentacao/agent-setup/opencode.md) | Sim | Não | Não | Não | Sim | BYOK | Multiprovedor | Memória de projeto | | [Claude Desktop](/pt-br/documentacao/agent-setup/claude-desktop.md) | Não | Não | Não | Sim | Não | Assinatura | Fixo | Sessão | | [Warp](/pt-br/documentacao/agent-setup/warp.md) | Sim | Não | Não | Não | Sim | Híbrido | Multiprovedor | Memória de projeto | | [Kiro](/pt-br/documentacao/agent-setup/kiro.md) | Não | Sim | Não | Não | Não | Híbrido | Multiprovedor | Memória de projeto | > **Nota** > > Todo agente listado se conecta aos servidores MCP da Azion. As colunas de fluxo de trabalho dizem onde a ferramenta roda, não o que ela pode fazer. ## Entendendo os agentes Tipos, conceitos e compromissos comuns. ### Fluxo de trabalho - **Terminal**: Roda em um shell. Ideal para automação, scripts e pipelines de CI. - **IDE**: Um editor completo com o agente em primeiro plano: diffs visuais e edições multiarquivo. - **Extensão**: Encaixa-se no editor que você já usa. Instalação mais leve, mantém sua configuração. - **Desktop**: Um app de chat instalado no seu computador, fora do editor e do terminal. Conecta-se aos servidores MCP como qualquer outro cliente. - **Nuvem**: Hospedado, sem instalação local. Ideal para trabalho assíncrono e de longa duração — e a forma que o Assistente de IA do Console assume. ### Conceitos-chave - **MCP**: O Model Context Protocol — o padrão que permite a um agente chamar ferramentas externas. A Azion publica cinco servidores MCP, um por área da plataforma, e todo agente desta página fala com eles. - **Contexto do agente**: Os arquivos que um agente lê antes de responder: llms.txt para o índice da documentação, AGENTS.md para as convenções do seu projeto. - **Flexibilidade de modelo**: Fixo prende você aos modelos do próprio fabricante. BYOK usa a chave do seu provedor. Multiprovedor alterna entre vários. - **Contexto**: Sessão esquece ao fim de uma conversa. Memória de projeto persiste em um arquivo que você commita. Codebase indexado mantém um índice pesquisável de todo o repositório. ### Compromissos comuns - **Nuvem vs. local**: A nuvem executa tarefas longas sem ocupar sua máquina, e envia seu código para algum lugar. Local mantém tudo em disco, e para quando seu laptop para. - **Proprietário vs. código aberto**: Código aberto pode ser auditado, bifurcado e hospedado por você. Proprietário tende a entregar a capacidade mais nova primeiro. - **Modelo fixo vs. BYOK**: Um modelo fixo é ajustado para o próprio agente e cobrado como uma assinatura. BYOK permite escolher o modelo por tarefa e pagar por token. - **Sessão vs. codebase indexado**: Um índice responde perguntas sobre código que ninguém abriu, ao custo de uma cópia do repositório. Uma sessão só sabe o que lhe foi mostrado.