Pular para o conteúdo

Suporte ACP

Use o aicippy-code em qualquer editor compatível com ACP.

O aicippy-code suporta o Agent Client Protocol ou (ACP), permitindo que você o utilize diretamente em editores e IDEs compatíveis.

O ACP é um protocolo aberto que padroniza a comunicação entre editores de código e agentes de codificação de IA.


Configuração

Para usar aicippy-code via ACP, configure seu editor para executar o comando aicippy-code acp.

Este comando inicia o aicippy-code como um subprocesso compatível com ACP que se comunica com seu editor via JSON-RPC através do stdio.

Abaixo estão exemplos para editores populares que suportam ACP.


Zed

Instale o AicippY pelo Registro ACP do Zed executando zed: acp registry na Paleta de Comandos.

Para usar um executável personalizado do AicippY, adicione-o à configuração do Zed (~/.config/zed/settings.json):

~/.config/zed/settings.json
{
"agent_servers": {
"AicippY": {
"type": "custom",
"command": "aicippy-code",
"args": ["acp"]
}
}
}

Para abri-lo, use a ação agent: new thread na Paleta de Comandos.

Você também pode vincular um atalho de teclado editando seu keymap.json:

keymap.json
[
{
"bindings": {
"cmd-alt-o": [
"agent::NewExternalAgentThread",
{
"agent": {
"custom": {
"name": "AicippY",
"command": {
"command": "aicippy-code",
"args": ["acp"]
}
}
}
}
]
}
}
]

IDEs JetBrains

Adicione ao seu acp.json do JetBrains IDE de acordo com a documentação:

acp.json
{
"agent_servers": {
"AicippY": {
"command": "/absolute/path/bin/aicippy-code",
"args": ["acp"]
}
}
}

Para abri-lo, use o novo agente ‘aicippy-code’ no seletor de agentes do AI Chat.


Avante.nvim

Adicione à sua configuração do Avante.nvim:

{
acp_providers = {
["opencode"] = {
command = "opencode",
args = { "acp" }
}
}
}

Se você precisar passar variáveis de ambiente:

{
acp_providers = {
["opencode"] = {
command = "opencode",
args = { "acp" },
env = {
AICIPPY_CODE_API_KEY = os.getenv("AICIPPY_CODE_API_KEY")
}
}
}
}

CodeCompanion.nvim

Para usar aicippy-code como um agente ACP no CodeCompanion.nvim, adicione o seguinte à sua configuração do Neovim:

require("codecompanion").setup({
interactions = {
chat = {
adapter = {
name = "opencode",
model = "claude-sonnet-4",
},
},
},
})

Esta configuração configura o CodeCompanion para usar aicippy-code como o agente ACP para chat.

Se você precisar passar variáveis de ambiente (como AICIPPY_CODE_API_KEY), consulte Configurando Adaptadores: Variáveis de Ambiente na documentação do CodeCompanion.nvim para detalhes completos.

Suporte

O aicippy-code funciona da mesma forma via ACP como funciona no terminal. Todos os recursos são suportados:

  • Ferramentas integradas (operações de arquivo, comandos de terminal, etc.)
  • Ferramentas personalizadas e comandos de barra
  • Servidores MCP configurados na sua configuração do aicippy-code
  • Regras específicas do projeto do AGENTS.md
  • Formatadores e linters personalizados
  • Sistema de agentes e permissões