ConectarInstalação

Instalação

Conecte uma estação de trabalho ao AgentKeeper, confirme que os hooks carregaram e veja o primeiro evento chegar ao dashboard.

Instalar o AgentKeeper em uma estação registra o dispositivo na sua organização e carrega os hooks que avaliam as ações do agente. Leva alguns minutos e não exige MDM.

Para distribuição em frota, use Instalação enterprise depois de validar em uma máquina.

Pré-requisitos

  • Uma conta AgentKeeper com permissão para registrar dispositivos
  • macOS 13+, Ubuntu 22.04+ ou Windows 11
  • Saída HTTPS na porta 443 para a origem da sua aplicação AgentKeeper
  • Acesso administrativo na máquina, para instalações a nível de sistema

Resolva Requisitos de rede antes de instalar em uma rede com proxy autenticado ou inspeção TLS.

Instalar

Instale o plugin

No Claude Code:

/plugin marketplace add rad-security/claude-code-plugin
/plugin install agentkeeper
/reload-plugins

Para outras IDEs, use o instalador público com a flag correspondente:

export AGENTKEEPER_API_URL="https://www.agentkeeper.dev"
bash <(curl -fsSL "$AGENTKEEPER_API_URL/install-hooks.sh") --ide cursor

Valores aceitos: cursor, codex, gemini, antigravity, windsurf, copilot.

Autentique

/agentkeeper:connect

O fluxo abre o navegador para aprovação do dispositivo. Em hosts sem interface, informe a chave diretamente:

/agentkeeper:connect --api-key ak_live_...

Não versione a chave de API em repositório nem a exponha em logs de CI.

Reinicie o agente

Os hooks são carregados na inicialização. Sem o reinício, o agente continua rodando sem avaliação de política.

Execute agentkeeper status. Você deve ver Shield: active e o nome da sua organização.

Confirme que está funcionando

Dispare uma ação que a sua política deva capturar e verifique se a decisão aparece em Activity, com a superfície, o detector ou control e o resultado.

Se nada aparecer, veja Eventos de atividade ausentes.

Próximos passos

Was this page helpful?