OpenCode com Zed: como usar os dois juntos?
Dá pra rodar o OpenCode dentro do Zed sem largar o editor pra ir no terminal. A ponte é o ACP (Agent Client Protocol), o protocolo do Zed pra agentes externos: por baixo, o comando opencode acp sobe o OpenCode como subprocesso que fala com o editor por JSON-RPC via stdio. Na prática, a dupla opencode zed funciona assim: você instala o OpenCode pelo painel de extensões (ou pelo ACP Registry) e abre uma thread no Agent Panel. O melhor: o OpenCode controla a própria autenticação e seleção de modelo, igualzinho ao terminal 🙂
Dá pra usar o OpenCode dentro do Zed sem largar o editor toda hora pra abrir o terminal
Se liga: o OpenCode é um agente de codificação de IA open source, pensado pra viver no terminal ("AI coding agent built for the terminal", como eles mesmos dizem)
O ponto novo é que agora ele roda como agente externo dentro do Zed
Ou seja, o mesmo assistente que você chamaria no terminal passa a atender de dentro do editor, no painel de agente
O que a integração propõe (e o papel do ACP)
Antes de sair clicando, vale entender COMO os dois se conversam
O Zed fala com agentes de fora por um protocolo próprio, o ACP (Agent Client Protocol)
É ele que padroniza a ponte entre editor e agente
"E o que sobe o OpenCode nesse esquema?"
O comando opencode acp
Ele inicia o OpenCode como um subprocesso compatível com ACP, que se comunica com o editor por JSON-RPC via stdio
Se você conhece a ideia de um servidor de linguagem conversando com o editor nos bastidores, o clima é parecido: um processo rodando por trás, trocando mensagens com o Zed
O detalhe massa é que continua sendo o MESMO OpenCode do terminal
Não é uma versão capada nem um clone: funciona da mesma forma, só que dentro do Agent Panel do Zed
Antes de começar
A lista de pré-requisito aqui é curtinha:
- Ter o Zed instalado (é o editor que hospeda o agente)
- Ter o OpenCode disponível pra ser usado como agente externo
A parte boa: a instalação do OpenCode pode sair de dentro do próprio Zed, sem você ficar montando as coisas na mão
Como usar o OpenCode dentro do Zed
Agora a parte prática
São poucos passos e tem mais de um caminho pra chegar lá
- Instale o OpenCode como agente ACP no Zed. O Zed lançou as Agent Server Extensions, que deixam instalar agentes ACP com um clique pelo painel de extensões, e o OpenCode é uma das primeiras disponíveis. Dá também pra instalar pelo ACP Registry do Zed. Erro comum: procurar o OpenCode na lista de extensões "normais" e não achar. Ele entra como agente/extensão de agente, então olhe na área de agentes ACP
- Prefere configurar na mão? Use o
agent_serversno settings.json. O Zed permite adicionar agentes customizados pela configuraçãoagent_serversnosettings.json. É o caminho pra quem gosta de deixar tudo declarado no arquivo de config em vez de clicar no painel. Erro comum: mexer no arquivo errado. A chave éagent_servers, dentro dosettings.jsondo Zed, não em qualquer outro config solto por aí
- Abra uma thread do OpenCode. Com ele instalado, inicie uma thread do OpenCode pelo Agent Panel ou pela Threads Sidebar do Zed. É aqui que você começa a conversar com o agente de dentro do editor. Erro comum: esperar que ele apareça sozinho assim que instalou. A conversa não nasce do nada, você precisa abrir a thread
- Entenda o que roda por trás. Mesmo clicando por interface, o que o Zed dispara é o
opencode acp, aquele subprocesso compatível com ACP que fala JSON-RPC via stdio com o editor. Saber disso ajuda demais na hora de entender um comportamento estranho: é o OpenCode rodando, só que acoplado ao Zed
Um ponto que vale destacar: rodando via ACP no Zed, o OpenCode controla a PRÓPRIA autenticação, a seleção de modelo e o comportamento de assinatura
Ou seja, quem manda no login e no modelo é o OpenCode, não o editor
Quando vale trazer o OpenCode pro Zed
Essa integração não é pra todo mundo, e tá tudo bem
Ela brilha em uns cenários bem específicos:
- Você já vive dentro do Zed e quer o agente no mesmo lugar, sem ficar pulando pro terminal a cada tarefa
- Você quer manter o fluxo de edição e a conversa com o agente na mesma janela, com menos troca de contexto
- Você já usa o OpenCode e curte que ele siga mandando na própria auth e no próprio modelo, do mesmo jeito que faria no terminal
Se você é do time terminal raiz e não usa Zed, nada muda: o OpenCode segue sendo o agente de terminal de sempre
A integração é justamente pra quem quer o assistente onde o código já tá aberto
Conclusão
No fim, a história da dupla opencode zed é sobre uma ponte: o ACP
É ele que deixa o Zed conversar com o OpenCode como agente externo, com o comando opencode acp subindo tudo por trás
O próximo passo é simples: instalar o OpenCode pelo painel de extensões do Zed (ou pelo ACP Registry) e abrir a primeira thread no Agent Panel
A partir daí é só codar com o agente do lado, sem sair do editor
até o próximo post! 🙂
Perguntas frequentes
O OpenCode perde alguma função quando roda dentro do Zed em vez do terminal?
Não, é o mesmo agente. A integração via ACP não capota nada: o OpenCode funciona da mesma forma que no terminal, só que acoplado ao editor. O que muda é onde você abre a conversa, não o que o agente consegue fazer
Preciso pagar uma conta separada ou nova licença para usar o OpenCode dentro do Zed?
Não precisa de nada novo. Rodando via ACP no Zed, o OpenCode controla a própria autenticação, a seleção de modelo e o comportamento de assinatura. É o mesmo login e o mesmo plano que você já usa no terminal, sem precisar configurar nada do lado do editor
Por que o OpenCode não aparece quando procuro nas extensões normais do Zed?
Porque ele não é uma extensão comum: entra como Agent Server Extension, que o Zed separa das extensões normais. A área certa pra procurar é a de agentes ACP, onde ele aparece como opção de instalação com um clique. Procurar na lista geral vai dar nada mesmo
Como adicionar o OpenCode manualmente no Zed sem usar o painel de extensões?
Pela chave agent_servers dentro do settings.json do Zed. É o caminho pra quem prefere deixar tudo declarado no arquivo de configuração. O cuidado é mexer no settings.json certo, o do Zed, e não em qualquer config solto por aí
O que o Zed dispara por baixo dos panos quando inicio uma thread do OpenCode?
O comando opencode acp, que sobe o OpenCode como subprocesso compatível com ACP e o conecta ao editor por JSON-RPC via stdio. Se você conhece a ideia de um servidor de linguagem conversando com o editor nos bastidores, o clima é bem parecido. Você clica na interface, mas o processo rodando por trás é esse
Dá para usar o OpenCode em modo ACP com outros editores além do Zed?
O comando opencode acp foi pensado pra qualquer editor que suporte ACP: a ideia é configurar o editor pra rodar opencode acp e deixar ele subir o agente como subprocesso. O Zed é o caso mais documentado até agora, com instalação via painel e ACP Registry, mas o protocolo não é exclusivo dele
Formações
Formação Vibe Coding
Do Prompt ao Produto: Crie Software Real com IA
- 473 aulas
- 20 projetos
- 39h 26min
Blog | Mais populares
As diferenças de var, let e const
Como fazer redirecionamento com PHP
Neste artigo você vai aprender a como fazer redirecionamento com PHP, utilizaremos abordagens fáceis de entender e de aplicar Fala programador(a), beleza? Bora aprender mais […]
Checklist de segurança n8n VPS pública: guia essencial para proteger sua instalação
Checklist de segurança n8n VPS pública: guia essencial para proteger sua instalação A popularidade da automação de processos com o n8n está em alta, principalmente […]
