OpenCode: Ferramentas Integradas do OpenCode
Última atualização: 2026-10-13
O poder do OpenCode vem do seu sistema de ferramentas integradas — a IA chama ferramentas para executar operações específicas.
1. O Que Você Vai Aprender
- Visão geral das ferramentas integradas
- Ferramentas de operação de arquivos
- Ferramenta de execução Shell
- Ferramentas de busca e análise
- Configuração e permissões de ferramentas
2. Visão Geral das Ferramentas Integradas
| Ferramenta | Função | Nível de Permissão |
|---|---|---|
read |
Ler conteúdo de arquivo | Somente leitura |
write |
Escrever/criar arquivos | Escrita |
edit |
Editar/patch arquivos | Escrita |
bash |
Executar comandos Shell | Execução |
grep |
Buscar conteúdo de arquivos | Somente leitura |
glob |
Encontrar arquivos por padrão | Somente leitura |
list |
Listar conteúdo de diretório | Somente leitura |
webfetch |
Obter conteúdo web | Rede |
task |
Chamar sub-agente | Agente |
3. Ferramentas de Operação de Arquivos
- read: A IA lê automaticamente arquivos do projeto para contexto
- write: Criar novos arquivos ou sobrescrever existentes
- edit: Modificar precisamente conteúdo usando busca+substituição
4. Ferramenta de Execução Shell
Execute qualquer comando Shell:
TEXT
Execute npm test e analise os testes falhando
A IA: executa o comando → analisa erros → identifica problemas → sugere correções → pode modificar o código diretamente.
5. Ferramentas de Busca e Análise
- grep: Buscar conteúdo em arquivos do projeto
- glob: Encontrar arquivos por padrões de nome
- list: Listar estrutura de diretórios
6. Configuração de Ferramentas
Interruptores globais:
JSON
{
"tools": {
"write": true,
"edit": true,
"bash": true,
"webfetch": false
}
}
Nível de agente:
JSON
{
"agent": {
"review": {
"tools": { "write": false, "edit": false }
}
}
}
Valores de permissão: allow (automático), ask (confirmar), deny (rejeitar)
❓ FAQ
P Como impedir a IA de executar operações perigosas?
R Configure bash como ask ou deny. Use padrões Glob para controle fino: permita
git status, negue rm -rf.P A IA fez modificações erradas?
R Use /undo imediatamente. Recomendamos configurar edit e write como ask para confirmação antes de mudanças.
P Alice permite todas as ferramentas, Bob só permite somente leitura. Quem está mais seguro?
R Bob. Configuração somente leitura impede qualquer modificação pela IA — ideal para revisão de código. Alice é mais eficiente mas mais arriscada.
📖 Resumo
- Ferramentas integradas: read, write, edit, bash, grep, glob, list, webfetch, task
- Níveis de permissão: allow, ask, deny
- Configurável em nível global e por agente
- Permissões bash suportam padrões Glob
- Expanda mais ferramentas via MCP
📝 Exercícios
-
Básico: Configure permissões de ferramentas no opencode.json, defina edit como ask.
-
Intermediário: Crie um agente somente leitura com todas as ferramentas de escrita/execução desabilitadas.
-
Avançado: Use padrões Glob para permitir operações git mas negar rm e outros comandos perigosos.
