OpenCode é um agente de programação aberto que fica no terminal. Ele pode ler arquivos de projeto, editar código, executar comandos e testes, pesquisar no repositório e trabalhar com git – quase a mesma coisa que Claude Code e outros agentes de console fazem. A principal diferença é que o OpenCode não está vinculado a um provedor modelo: dezenas de provedores podem ser conectados por meio dele, incluindo o DeepSeek. Neste post irei descrever a instalação do agente e a conexão do DeepSeek a ele.
O que você precisa
Você só precisa de duas coisas para funcionar:
- Terminal moderno. WezTerm, Alacritty, Ghostty, Kitty ou qualquer outro serve.
- Chave de API do provedor. No nosso caso, DeepSeek.
O Node.js não é necessário se você instalar o agente com um script de instalação padrão – o binário chega pronto.
Instalação
A maneira mais fácil é o script de instalação oficial:
curl -fsSL https://opencode.ai/install | bash
Ele detectará a própria plataforma e colocará o arquivo executável em PATH. Após a instalação, você deve verificar se tudo está no lugar:
opencode --version
Se o comando exibir a versão, a instalação foi bem-sucedida.
Instalação usando outros métodos
Se preferir gerenciadores de pacotes, existem várias opções. Através do Node.js:
npm install -g opencode-ai
Bun, pnpm e Yarn podem fazer o mesmo:
bun install -g opencode-ai
pnpm install -g opencode-ai
yarn global add opencode-ai
macOS e Linux possuem Homebrew. Observação: o que é recomendado é o toque dos desenvolvedores, e não a fórmula oficial – ela é atualizada com menos frequência:
brew install anomalyco/tap/opencode
No Arch Linux:
sudo pacman -S opencode
paru -S opencode-bin
O primeiro comando instala a versão estável do repositório, o segundo – a versão mais recente do AUR.
Instalação no Windows
No Windows é recomendado trabalhar via WSL: assim o desempenho é maior e a compatibilidade com as capacidades do agente é completa. Mas também existem métodos nativos. Via Chocolatey, Scoop ou npm:
choco install opencode
scoop install opencode
npm install -g opencode-ai
Também existe uma opção através do Mise, bem como um contêiner Docker:
mise use -g github:anomalyco/opencode
docker run -it --rm ghcr.io/anomalyco/opencode
Finalmente, o binário finalizado sempre pode ser obtido na página de lançamentos no GitHub.
Chave DeepSeek
A chave é criada em sua conta pessoal DeepSeek. Acesse platform.deepseek.com, abra a seção com chaves de API e clique em criar uma nova chave. É melhor salvar a string resultante imediatamente: ela será mostrada apenas uma vez.
Conexão DeepSeek
Depois tudo é feito dentro do próprio agente. Inicie o OpenCode no terminal:
opencode
Na interface executamos o comando de conexão:
/connect
Na lista de provedores que se abre, procure por DeepSeek, selecione-o e insira a chave API. As chaves adicionadas desta forma são salvas em um arquivo:
~/.local/share/opencode/auth.json
Após a conexão, resta selecionar o modelo com o comando:
/models
Os modelos DeepSeek estarão disponíveis na lista, incluindo deepseek-v4-pro, deepseek-flash e deepseek-v4-flash. Para trabalhos rotineiros no repositório, a opção flash é suficiente; Para tarefas complexas, faz sentido mudar para o profissional.
Configuração via config
Se você não deseja armazenar a chave através de um mestre ou precisa definir seu próprio endereço API, o provedor é descrito diretamente no arquivo de configuração opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"deepseek": {
"options": {
"baseURL": "https://api.deepseek.com"
}
}
}
}
O campo baseURL é útil se você usar um proxy ou seu próprio gateway. Neste caso, é conveniente transferir a própria chave para uma variável de ambiente:
export DEEPSEEK_API_KEY=ваш_ключ_deepseek
opencode
Essa opção é boa para CI e lançamentos únicos: a chave não vai para o armazenamento, mas fica apenas no ambiente do processo.
Primeiro lançamento do projeto
Vá para o diretório do projeto e inicie o agente:
cd ваш_проект
opencode
O primeiro passo é inicializá-lo:
/init
OpenCode analisará a estrutura do projeto e criará um arquivo AGENTS.md – um análogo das instruções para o agente. Vale a pena comprometer esse arquivo com o git: ele ajuda o agente a entender as convenções e padrões adotados no projeto.
Como usar
O trabalho é estruturado da mesma forma que com outros agentes. Alguns truques que você deve saber imediatamente:
- Modo de planejamento. A tecla Tab alterna o agente entre os modos de planejamento e montagem. No primeiro, ele apenas sugere como resolver o problema e não altera nada – é conveniente verificar a ideia antes de fazer alterações.
- Links para arquivos. A tecla @ abre uma pesquisa difusa nos arquivos do projeto para transferir um arquivo específico para o agente no contexto.
- Reverter alterações. O comando /undo desfaz as últimas edições e retorna a solicitação original, /redo as retorna. Você pode reverter várias etapas seguidas.
- Compartilhando uma conversa. O comando /share cria um link para a conversa atual e o copia para a área de transferência. Por padrão, as conversas não são publicadas em lugar nenhum.
Para alterações simples, você não precisa mudar para o modo de planejamento, mas descrever imediatamente o que precisa ser feito e especificar os arquivos via @.
No que prestar atenção
Alguns pontos práticos. O OpenCode não requer assinatura: você paga diretamente ao provedor quando gasta tokens, portanto, sessões longas com DeepSeek são previsivelmente mais baratas do que os modelos principais. A chave é armazenada localmente em auth.json – vale a pena considerar isso em uma máquina compartilhada, mas para ambientes de outras pessoas uma variável de ambiente é mais confiável.
E mais uma coisa: a qualidade das respostas para problemas arquitetônicos complexos difere entre modelos de classes diferentes, então para o projeto faz sentido pegar um modelo mais forte e deixar a rotina para um modelo rápido e barato.
Links
https://opencode.ai/
https://opencode.ai/docs/
https://opencode.ai/docs/providers/
https://github.com/anomalyco/opencode
https://platform.deepseek.com/api_keys
https://api-docs.deepseek.com
Fontes
https://opencode.ai/docs/
https://opencode.ai/docs/providers/#deepseek
https://github.com/anomalyco/opencode/releases
https://models.dev/
Leave a Reply